{ "info": { "title": "Cognigy.AI REST-ful-API Reference", "version": "4.81.0", "description": "\n### Introduction\nThis is the [OpenAPI 3.0](https://swagger.io/specification/) documentation of the [REST](https://en.wikipedia.org/wiki/Representational_state_transfer)-ful Cognigy.AI API.\n\n### Cross-Origin Resource Sharing\nThis API features Cross-Origin Resource Sharing (CORS) implemented in compliance with [W3C spec](https://www.w3.org/TR/cors/), which allows cross-domain communication from the browser. All responses have a wildcard same-origin header which makes the API completely accessible.\n\n### Authentication\nCognigy.AI offers three forms of authentication:\n- API Key\n- OAuth2\n- BasicAuth\n\nAn API Key is a security token. You can use API Keys in your path or HTTP header. Never expose your API Key and keep it safe and secure. Revoke the API Key if it got exposed or stolen.\n\nOAuth2 is an open protocol to allow secure authorization by web, mobile and desktop applications. For further information see [RFC 6749 - \"The OAuth 2.0 Authorization Framework\"](https://tools.ietf.org/html/rfc6749) and [RFC 6750 - \"The OAuth 2.0 Authorization Framework: Bearer Token Usage\"](https://tools.ietf.org/html/rfc6750).\n\nBasic Auth is only used for API calls regarding the Management-UI.\n\n### Error Handling\nThis API uses HTTP status codes equal or above 400 to indicate errors. Error details are generated in compliance with [RFC 7807 - \"Problem Details for HTTP APIs\"](https://tools.ietf.org/html/rfc7807).\n\nEvery error response contains a traceId, which should be provided to the Cognigy.AI Technical Support when reporting an error.\n", "contact": { "name": "Cognigy Technical Support", "url": "https://www.cognigy.com", "email": "support@cognigy.com" } }, "servers": [ { "url": "https://api-dev.cognigy.ai/new/", "description": "Cognigy.AI API" } ], "components": { "securitySchemes": { "APIKeyHeader": { "type": "apiKey", "in": "header", "name": "X-API-Key", "description": "Supply the API Key in the HTTP-Header" }, "APIKeyQueryParam": { "type": "apiKey", "in": "query", "name": "api_key", "description": "Supply the API Key in the Url-Query" }, "OAuth2": { "type": "oauth2", "flows": { "password": { "tokenUrl": "/auth/oauth2/token", "refreshUrl": "/auth/oauth2/token", "scopes": {} }, "authorizationCode": { "authorizationUrl": "/auth/oauth2/authorize", "tokenUrl": "/auth/oauth2/token", "scopes": {} } } }, "BasicAuth": { "type": "http", "scheme": "basic", "description": "Basic Authentication used by routes designed for the Management-UI." } }, "parameters": { "userIdPathParam": { "in": "path", "name": "userId", "description": "The Id of the User", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "apiKeyIdPathParam": { "in": "path", "name": "apiKeyId", "description": "The Id of an Api Key", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "skillIdPathParam": { "in": "path", "name": "skillId", "description": "The Id of the Alexa-Skill", "required": true, "schema": { "type": "string" } }, "organisationIdPathParam": { "in": "path", "name": "organisationId", "description": "The Id of the Organisation", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "yearQueryParam": { "in": "query", "name": "year", "required": true, "schema": { "type": "number" } }, "monthQueryParam": { "in": "query", "name": "month", "required": false, "schema": { "type": "number" } }, "nonConversationalQueryParam": { "in": "query", "name": "nonConversational", "required": false, "description": "Deprecated. Please no longer use this parameter. Use channel=nonConversational instead.", "schema": { "type": "boolean" } }, "channelQueryParam": { "in": "query", "name": "channel", "required": false, "schema": { "type": "string", "enum": [ "facebook", "alexa", "slack", "generic", "inject", "rest", "realtime", "socket", "webchat", "webchat2", "dialogflow", "twilio", "twilio-sms", "line", "intercom", "microsoftBotFramework", "microsoftTeams", "sunshineConversations", "avaya", "nonConversational", "voiceGateway2" ] } }, "sessionIdPathParam": { "in": "path", "name": "sessionId", "description": "The Id of the Session", "required": true, "schema": { "type": "string" } }, "logEntryIdPathParam": { "in": "path", "name": "logEntryId", "description": "The Id of the Log Entry", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "profileIdPathParam": { "in": "path", "name": "profileId", "description": "The Id of the Profile", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "taskIdPathParam": { "in": "path", "name": "taskId", "description": "The Id of the Task", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "recordIdPathParam": { "in": "path", "name": "recordId", "description": "The Id of the Record", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "fileTokenPathParam": { "in": "path", "name": "fileToken", "description": "The token of the File", "required": true, "schema": { "type": "string", "pattern": "/[a-fA-F0-9]{64}/" } }, "configIdPathParam": { "in": "path", "name": "configId", "description": "The Id of the Ai Copilot config", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "connectionIdPathParam": { "in": "path", "name": "connectionId", "description": "The Id of the Connection", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "connectionFieldNamePathParam": { "in": "path", "name": "fieldName", "description": "The name of the Connection field", "required": true, "schema": { "type": "string" } }, "endpointIdPathParam": { "in": "path", "name": "endpointId", "description": "The Id of the Endpoint", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "extensionIdPathParam": { "in": "path", "name": "extensionId", "description": "The Id of the Extension", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "fileIdPathParam": { "in": "path", "name": "fileId", "description": "The Id of the File", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "flowIdPathParam": { "in": "path", "name": "flowId", "description": "The Id of the Flow", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "nodeIdPathParam": { "in": "path", "name": "nodeId", "description": "The Id of the Node", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "intentIdPathParam": { "in": "path", "name": "intentId", "description": "The Id of the Intent", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "learningSentenceIdPathParam": { "in": "path", "name": "learningSentenceId", "description": "The Id of the LearningSentence", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "slotFillerIdPathParam": { "in": "path", "name": "slotFillerId", "description": "The Id of the SlotFiller", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "sentenceIdPathParam": { "in": "path", "name": "sentenceId", "description": "The Id of the Sentence", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "stateIdPathParam": { "in": "path", "name": "stateId", "description": "The Id of the State", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "preferredLocaleIdQueryParam": { "in": "query", "name": "preferredLocaleId", "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "functionIdPathParam": { "in": "path", "name": "functionId", "description": "The Id of the Function", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "functionInstanceIdPathParam": { "in": "path", "name": "functionInstanceId", "description": "The Id of the Function Instance", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "knowledgeStoreIdPathParam": { "in": "path", "name": "knowledgeStoreId", "description": "The Id of the KnowledgeStore", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "sourceIdPathParam": { "in": "path", "name": "sourceId", "description": "The Id of the KnowledgeSource", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "chunkIdPathParam": { "in": "path", "name": "chunkId", "description": "The Id of the KnowledgeChunk", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "documentUrlParam": { "in": "query", "name": "documentUrl", "required": false, "schema": { "type": "string" } }, "projectIdParam": { "in": "query", "name": "projectId", "required": false, "schema": { "type": "string" } }, "languageParam": { "in": "query", "name": "language", "required": false, "schema": { "type": "string", "example": "en-US" } }, "largeLanguageModelIdPathParam": { "in": "path", "name": "largeLanguageModelId", "description": "Id for the LargeLangugeModel", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "lexiconIdPathParam": { "in": "path", "name": "lexiconId", "description": "The Id of the Lexicon", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "entryIdPathParam": { "in": "path", "name": "entryId", "description": "The id of an entry in the Lexicon", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "keyphraseIdPathParam": { "in": "path", "name": "keyphraseId", "description": "The id of a keyphrase in the Lexicon", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "slotIdPathParam": { "in": "path", "name": "slotId", "description": "The id of a slot in the Lexicon", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "metaOnlyQueryParam": { "in": "query", "name": "metaOnly", "description": "Return only the lexicon meta data if set to true", "required": false, "schema": { "type": "boolean", "enum": [ true, false ] } }, "localeIdPathParam": { "in": "path", "name": "localeId", "description": "The Id of the Locale", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "milestoneIdPathParam": { "in": "path", "name": "milestoneId", "description": "The Id of the Milestone", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "milestoneStepIdPathParam": { "in": "path", "name": "stepId", "description": "The Id of the Milestone Step", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "milestoneStepMetricIdPathParam": { "in": "path", "name": "metricId", "description": "The Id of the Milestone Step Metric", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "nluConnectorIdPathParam": { "in": "path", "name": "nluConnectorId", "description": "The Id of the NLUConnector", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "packageIdPathParam": { "in": "path", "name": "packageId", "description": "The Id of the Package", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "playbookIdPathParam": { "in": "path", "name": "playbookId", "description": "The Id of the Playbook", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "playbookRunIdPathParam": { "in": "path", "name": "playbookRunId", "description": "The Id of the Playbook Run", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "playbookStepIdPathParam": { "in": "path", "name": "stepId", "description": "The Id of the Playbook Step", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "playbookStepAssertIdPathParam": { "in": "path", "name": "assertId", "description": "The Id of the Playbook Step Assert", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "projectIdPathParam": { "in": "path", "name": "projectId", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "projectIdQueryParam": { "in": "query", "name": "projectId", "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "snapshotIdPathParam": { "in": "path", "name": "snapshotId", "description": "The Id of the Snapshot", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "acceptHeader": { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, "copyResourceIdQueryParam": { "in": "query", "name": "resourceId", "description": "An Id of a resource within the corresponding project to copy from", "required": false, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "filterUserParam": { "in": "query", "name": "user", "required": false, "schema": { "type": "string" } }, "filterTypeParam": { "in": "query", "name": "type", "required": false, "schema": { "type": "string", "enum": [ "action", "create", "replace", "patch", "delete", "unauthorized" ] } }, "organisationIdParam": { "in": "query", "name": "organisationId", "required": false, "schema": { "type": "string" } }, "webfingerResourceQueryParam": { "in": "query", "name": "resource", "required": true, "schema": { "type": "string", "format": "uri" } }, "webfingerRelQueryParam": { "in": "query", "name": "rel", "schema": { "type": "array", "items": { "type": "array", "items": { "type": "string", "enum": [ "idp" ] } } } }, "searchParam": { "in": "query", "name": "search", "required": false, "schema": { "type": "string" } }, "messageTypeSearchParam": { "in": "query", "name": "messageType", "required": true, "schema": { "type": "string", "enum": [ "current", "next", "previous" ] } }, "organisationDeletionTokenParam": { "in": "query", "name": "verificationToken", "required": true, "schema": { "type": "string" } }, "logTypeParam": { "in": "query", "name": "type", "required": false, "schema": { "type": "array", "items": { "type": "string", "enum": [ "fatal", "error", "warn", "info", "debug", "trace" ] } } }, "userIdParam": { "in": "query", "name": "userId", "required": false, "schema": { "type": "string" } }, "flowNameParam": { "in": "query", "name": "flowName", "required": false, "schema": { "type": "string" } }, "understoodParam": { "in": "query", "name": "understood", "required": false, "schema": { "type": "string", "enum": [ false, true ] } }, "intentFoundParam": { "in": "query", "name": "intentFound", "required": false, "schema": { "type": "string", "enum": [ false, true ] } }, "slotFoundParam": { "in": "query", "name": "slotFound", "required": false, "schema": { "type": "string", "enum": [ false, true ] } }, "userSlotsFoundParam": { "in": "query", "name": "userSlotsFound", "required": false, "schema": { "type": "string", "enum": [ false, true ] } }, "systemSlotsFoundParam": { "in": "query", "name": "systemSlotsFound", "required": false, "schema": { "type": "string", "enum": [ false, true ] } }, "typeParam": { "in": "query", "name": "type", "required": false, "schema": { "type": "array", "items": { "type": "string", "enum": [ "Greeting", "pAnswer", "nAnswer", "BGreeting" ] } } }, "scoreRangeParam": { "in": "query", "name": "scoreRange", "required": false, "description": "A minimum and maximum range to filter with intent score. Example [0.3,0.6]", "schema": { "type": "array", "items": { "type": "number" }, "minItems": 2, "maxItems": 2 } }, "shouldGenerateSentencesParam": { "in": "query", "name": "shouldGenerateSentences", "required": false, "schema": { "type": "boolean" } }, "generateSentenceLimitParam": { "in": "query", "name": "generateSentenceLimit", "required": false, "schema": { "type": "integer", "minimum": 5, "maximum": 20 } }, "localeIdParam": { "in": "query", "name": "localeId", "required": false, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "limitSentencesParam": { "in": "query", "name": "limit", "required": false, "schema": { "type": "integer", "minimum": 5, "maximum": 20 } }, "shouldGenerateLexiconEntriesParams": { "in": "query", "name": "shouldGenerateLexiconEntries", "description": "Flag to allow the Lexicon creation to use the generative AI to generate entries.", "example": true, "required": false, "schema": { "type": "boolean" } }, "shouldGenerateSynonymsParams": { "in": "query", "name": "shouldGenerateSynonyms", "description": "Flag to allow the Lexicon creation to use the generative AI to generate synonyms.", "example": false, "required": false, "schema": { "type": "boolean" } }, "generateLexiconEntriesLimitParam": { "in": "query", "name": "generateLexiconEntriesLimit", "description": "Number of entries to be generated by the Generative AI.", "example": 8, "required": false, "schema": { "type": "integer" } }, "defaultSlotParam": { "in": "query", "name": "defaultSlot", "description": "Default Slot where to associate the generated Lexicon entries.", "example": "testSlot", "required": false, "schema": { "type": "string" } }, "languageCode": { "in": "query", "name": "languageCode", "description": "Language code.", "required": false, "schema": { "type": "string", "example": "en-US" } }, "projectQueryParam": { "in": "query", "name": "projectId", "description": "Filter by projectId", "required": false, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "resourceTypePathParam": { "in": "query", "name": "resourceType", "description": "The type of a resource", "required": true, "schema": { "type": "string", "enum": [ "flow", "nluconnector", "locale", "flowState" ] } }, "filterParam": { "in": "query", "name": "filter", "required": false, "schema": { "type": "string" }, "description": "Filter records by specific field eg:name." }, "limitParam": { "in": "query", "name": "limit", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100 }, "description": "The maximum number of items to return. The default is 25." }, "skipParam": { "in": "query", "name": "skip", "required": false, "schema": { "type": "integer", "minimum": 0 }, "description": "The number of items to skip. The default is 0. Used along with a limit of a pagination." }, "sortParam": { "in": "query", "name": "sort", "required": false, "schema": { "type": "string", "minLength": 1 }, "description": "The order of the sorting items-`Desc` (descending) or `Asc` (ascending). For example, to sort the records by name in ascending order, specify `name:Asc`." }, "nextParam": { "in": "query", "name": "next", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the nextCursor value from the response to get the next set of records. Used along with limit for pagination." }, "previousParam": { "in": "query", "name": "previous", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the previousCursor value from the response to get the previous set of records. Used along with limit for pagination." } }, "schemas": { "intentDownload": { "type": "string", "description": "Stringified CSV or JSON.", "example": "" }, "IBatchCreateOperation": { "type": "object", "properties": { "op": { "type": "string", "enum": [ "create" ] } } }, "IBatchUpdateOperation": { "type": "object", "properties": { "op": { "type": "string", "enum": [ "update" ] }, "id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "value": { "type": "object" } } }, "IBatchActionOperation": { "type": "object", "properties": { "op": { "type": "string" }, "id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "value": { "type": "object" } } }, "IBatchDeleteOperation": { "type": "object", "properties": { "op": { "type": "string", "enum": [ "delete" ] }, "id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } }, "TGenerativeAIModels": { "type": "string", "enum": [ "gpt-3.5-turbo", "gpt-3.5-turbo-instruct", "text-davinci-003", "gpt-4", "text-embedding-ada-002", "luminous-extended-control", "luminous-embedding-128", "claude-v1-100k", "claude-instant-v1", "claude-3-opus-20240229", "text-bison@001", "custom-model", "gemini-1.0-pro" ] }, "TGenerativeAIProviders": { "type": "string", "enum": [ "azureOpenAI", "openAI", "anthropic", "googleVertexAI", "googleGemini", "alephAlpha" ] }, "TModelGroups": { "type": "string", "enum": [ "chat", "completion" ] }, "TLicenseState": { "type": "string", "description": "The state of the license", "example": "valid", "enum": [ "invalid", "valid", "valid3MonthsLeft", "willExpireSoon", "expiredRenewRequired", "expired" ] }, "TChannelType": { "type": "string", "example": "webchat2", "enum": [ "facebook", "alexa", "slack", "generic", "inject", "rest", "realtime", "socket", "adminconsole", "webchat2", "dialogflow", "twilio", "twilio-sms", "line", "intercom", "microsoftBotFramework", "microsoftTeams", "sunshineConversations", "admin-webchat", "avaya", "nonConversational", "voiceGateway2", "amazonLex", "workplace", "webhook", "abstractRest", "userlike", "ringCentralEngage", "audioCodes", "bandwidth", "whatsapp", "eightByEight", "genesysBotConnector", "niceCXOne", "agentAssistVoice", "webchat3" ] }, "IMediaAttachment": { "type": "object", "properties": { "name": { "type": "string" }, "caption": { "type": "string" }, "url": { "type": "string" }, "type": { "type": "string" } }, "required": [ "name", "url", "type" ] }, "IFileAttachment": { "type": "object", "properties": { "name": { "type": "string" }, "caption": { "type": "string" }, "url": { "type": "string" }, "type": { "type": "string", "enum": [ "file", "document" ] } }, "required": [ "name", "url", "type" ] }, "IImageAttachment": { "type": "object", "properties": { "name": { "type": "string" }, "caption": { "type": "string" }, "url": { "type": "string" }, "type": { "type": "string", "enum": [ "image" ] } }, "required": [ "name", "url", "type" ] }, "IStickerAttachment": { "type": "object", "properties": { "name": { "type": "string" }, "caption": { "type": "string" }, "url": { "type": "string" }, "type": { "type": "string", "enum": [ "sticker" ] } }, "required": [ "name", "url", "type" ] }, "IVideoAttachment": { "type": "object", "properties": { "name": { "type": "string" }, "caption": { "type": "string" }, "url": { "type": "string" }, "type": { "type": "string", "enum": [ "video" ] } }, "required": [ "name", "url", "type" ] }, "IAudioAttachment": { "type": "object", "properties": { "name": { "type": "string" }, "caption": { "type": "string" }, "url": { "type": "string" }, "type": { "type": "string", "enum": [ "audio" ] } }, "required": [ "name", "url", "type" ] }, "IContactAttachment": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "contact" ] }, "addresses": { "type": "array", "items": { "type": "object", "properties": { "city": { "type": "string" }, "country": { "type": "string" }, "countryCode": { "type": "string" }, "state": { "type": "string" }, "street": { "type": "string" }, "type": { "type": "string", "enum": [ "HOME", "WORK" ] }, "zip": { "type": "string" }, "postOfficeBox": { "type": "string" }, "extendedAddress": { "type": "string" }, "latitude": { "type": "number" }, "longitude": { "type": "number" } } } }, "birthday": { "type": "string" }, "emails": { "type": "array", "items": { "type": "object", "properties": { "email": { "type": "string" }, "type": { "type": "string", "enum": [ "HOME", "WORK" ] } } } }, "urls": { "type": "array", "items": { "type": "object", "properties": { "url": { "type": "string" }, "type": { "type": "string", "enum": [ "HOME", "WORK" ] } } } }, "photos": { "type": "array", "items": { "type": "string" } }, "gender": { "type": "string" }, "languages": { "type": "array", "items": { "type": "string" } }, "timeZone": { "type": "string" }, "notes": { "type": "array", "items": { "type": "string" } } }, "required": [ "type" ] }, "ILocationAttachment": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "location" ] }, "latitude": { "type": "number" }, "longitude": { "type": "number" }, "name": { "type": "string" }, "title": { "type": "string" }, "address": { "type": "string" } }, "required": [ "type", "latitude", "longitude" ] }, "TAttachments": { "oneOf": [ { "type": "object", "properties": { "name": { "type": "string" }, "caption": { "type": "string" }, "url": { "type": "string" }, "type": { "type": "string", "enum": [ "file", "document" ] } }, "required": [ "name", "url", "type" ] }, { "type": "object", "properties": { "name": { "type": "string" }, "caption": { "type": "string" }, "url": { "type": "string" }, "type": { "type": "string", "enum": [ "image" ] } }, "required": [ "name", "url", "type" ] }, { "type": "object", "properties": { "name": { "type": "string" }, "caption": { "type": "string" }, "url": { "type": "string" }, "type": { "type": "string", "enum": [ "video" ] } }, "required": [ "name", "url", "type" ] }, { "type": "object", "properties": { "name": { "type": "string" }, "caption": { "type": "string" }, "url": { "type": "string" }, "type": { "type": "string", "enum": [ "audio" ] } }, "required": [ "name", "url", "type" ] }, { "type": "object", "properties": { "name": { "type": "string" }, "caption": { "type": "string" }, "url": { "type": "string" }, "type": { "type": "string", "enum": [ "sticker" ] } }, "required": [ "name", "url", "type" ] }, { "type": "object", "properties": { "type": { "type": "string", "enum": [ "contact" ] }, "addresses": { "type": "array", "items": { "type": "object", "properties": { "city": { "type": "string" }, "country": { "type": "string" }, "countryCode": { "type": "string" }, "state": { "type": "string" }, "street": { "type": "string" }, "type": { "type": "string", "enum": [ "HOME", "WORK" ] }, "zip": { "type": "string" }, "postOfficeBox": { "type": "string" }, "extendedAddress": { "type": "string" }, "latitude": { "type": "number" }, "longitude": { "type": "number" } } } }, "birthday": { "type": "string" }, "emails": { "type": "array", "items": { "type": "object", "properties": { "email": { "type": "string" }, "type": { "type": "string", "enum": [ "HOME", "WORK" ] } } } }, "urls": { "type": "array", "items": { "type": "object", "properties": { "url": { "type": "string" }, "type": { "type": "string", "enum": [ "HOME", "WORK" ] } } } }, "photos": { "type": "array", "items": { "type": "string" } }, "gender": { "type": "string" }, "languages": { "type": "array", "items": { "type": "string" } }, "timeZone": { "type": "string" }, "notes": { "type": "array", "items": { "type": "string" } } }, "required": [ "type" ] }, { "type": "object", "properties": { "type": { "type": "string", "enum": [ "location" ] }, "latitude": { "type": "number" }, "longitude": { "type": "number" }, "name": { "type": "string" }, "title": { "type": "string" }, "address": { "type": "string" } }, "required": [ "type", "latitude", "longitude" ] } ] }, "TAuditEventType": { "type": "string", "description": "The type of operation that was performed", "example": "create", "enum": [ "action", "create", "replace", "patch", "delete", "unauthorized" ] }, "TResourceTypeAdditional": { "type": "string", "description": "Additional resource types for audit purposes", "example": "node", "enum": [ "aicopilotconfig", "apiKey", "analytics", "connectionField", "conversation", "examplesentence", "flowState", "functionInstance", "intent", "keyphrase", "learningsentence", "lexiconEntry", "lexiconKeyphrase", "lexiconSlot", "node", "playbookStep", "playbookStepAssert", "profile", "profileSchema", "project", "projectsettings", "slotFiller", "snippet", "synonym", "tag", "task", "trainerRecord", "user", "yesNoIntent" ] }, "TAuditEventChainElementType": { "type": "string", "description": "Additional resource types for audit purposes", "example": "node", "enum": [ "agentassistconfig", "agentSettings", "chart", "connection", "connectionSchema", "endpoint", "extension", "file", "flow", "flowSettings", "flowState", "function", "intent", "intentDefaultReply", "intentLearningSentence", "intentRelation", "intentSentence", "intentTrainGroup", "knowledgeStore", "largeLanguageModel", "lexicon", "lexiconEntry", "lexiconKeyphrase", "lexiconSlot", "locale", "milestone", "nluconnector", "nodeData", "nodeDescriptorSet", "package", "playbook", "slotFiller", "snapshot", "snippet", "aicopilotconfig", "apiKey", "analytics", "connectionField", "conversation", "examplesentence", "functionInstance", "keyphrase", "learningsentence", "node", "playbookStep", "playbookStepAssert", "profile", "profileSchema", "project", "projectsettings", "synonym", "tag", "task", "trainerRecord", "user", "yesNoIntent" ] }, "IAuditEventModificationChainElement": { "type": "object", "properties": { "elementId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "elementType": { "type": "string", "description": "Additional resource types for audit purposes", "example": "node", "enum": [ "agentassistconfig", "agentSettings", "chart", "connection", "connectionSchema", "endpoint", "extension", "file", "flow", "flowSettings", "flowState", "function", "intent", "intentDefaultReply", "intentLearningSentence", "intentRelation", "intentSentence", "intentTrainGroup", "knowledgeStore", "largeLanguageModel", "lexicon", "lexiconEntry", "lexiconKeyphrase", "lexiconSlot", "locale", "milestone", "nluconnector", "nodeData", "nodeDescriptorSet", "package", "playbook", "slotFiller", "snapshot", "snippet", "aicopilotconfig", "apiKey", "analytics", "connectionField", "conversation", "examplesentence", "functionInstance", "keyphrase", "learningsentence", "node", "playbookStep", "playbookStepAssert", "profile", "profileSchema", "project", "projectsettings", "synonym", "tag", "task", "trainerRecord", "user", "yesNoIntent" ] } } }, "IEntityMeta": { "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n", "type": "object", "properties": { "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } }, "IGenerativeAIUseCase": { "type": "object", "properties": { "useCase": { "enum": [ "intentSentenceGeneration", "aiEnhancedOutputs", "lexiconGeneration", "flowGeneration", "gptConversation", "gptPromptNode", "generateNodeOutput", "knowledgeSearch", "sentimentAnalysis" ] } } }, "TResourceType": { "type": "string", "description": "The type of a resource", "example": "flow", "enum": [ "agentassistconfig", "agentSettings", "chart", "connection", "connectionSchema", "endpoint", "extension", "file", "flow", "flowSettings", "flowState", "function", "intent", "intentDefaultReply", "intentLearningSentence", "intentRelation", "intentSentence", "intentTrainGroup", "knowledgeStore", "largeLanguageModel", "lexicon", "lexiconEntry", "lexiconKeyphrase", "lexiconSlot", "locale", "milestone", "nluconnector", "nodeData", "nodeDescriptorSet", "package", "playbook", "slotFiller", "snapshot", "snippet" ] }, "TSearchableResourceType": { "type": "string", "description": "The type of a resource", "example": "endpoint", "enum": [ "endpoint", "extension", "flow", "function", "lexicon", "milestone", "nluconnector", "playbook", "project", "snapshot" ] }, "TSlotFillerType": { "type": "string", "example": "age", "enum": [ "age", "date", "duration", "email", "intent", "slot", "money", "number", "percentage", "regex", "temperature" ] }, "IAuditEvent_2_0": { "type": "object", "properties": { "id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "timestamp": { "type": "string", "description": "The timestamp when the action happened", "example": "2020-04-27T14:22:11.000Z" }, "type": { "type": "string", "description": "The type of operation that was performed", "example": "create", "enum": [ "action", "create", "replace", "patch", "delete", "unauthorized" ] }, "user": { "type": "string", "description": "The email of the user who performed the operation", "example": "hans.mustermann@xyz.com" }, "modifiedResources": { "type": "array", "description": "An list of resources in the chain of the modification", "items": { "type": "object", "properties": { "resourceId": { "type": "string", "description": "The id of the resource in the modification chain", "example": "5e997f0cdcfc57730cf32941" }, "resourceType": { "type": "string", "description": "Additional resource types for audit purposes", "example": "node", "enum": [ "agentassistconfig", "agentSettings", "chart", "connection", "connectionSchema", "endpoint", "extension", "file", "flow", "flowSettings", "flowState", "function", "intent", "intentDefaultReply", "intentLearningSentence", "intentRelation", "intentSentence", "intentTrainGroup", "knowledgeStore", "largeLanguageModel", "lexicon", "lexiconEntry", "lexiconKeyphrase", "lexiconSlot", "locale", "milestone", "nluconnector", "nodeData", "nodeDescriptorSet", "package", "playbook", "slotFiller", "snapshot", "snippet", "aicopilotconfig", "apiKey", "analytics", "connectionField", "conversation", "examplesentence", "functionInstance", "keyphrase", "learningsentence", "node", "playbookStep", "playbookStepAssert", "profile", "profileSchema", "project", "projectsettings", "synonym", "tag", "task", "trainerRecord", "user", "yesNoIntent" ] } } } }, "payload": { "type": "object", "description": "The raw payload of the operation in case it was tracked", "example": { "name": "new resource name" } } } }, "IAuditEventIndexItem_2_0": { "type": "object", "properties": { "id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "timestamp": { "type": "string", "format": "date-time", "description": "The timestamp when the action happened", "example": "2020-04-27T14:22:11.000Z" }, "type": { "type": "string", "description": "The type of operation that was performed", "example": "create", "enum": [ "action", "create", "replace", "patch", "delete", "unauthorized" ] }, "user": { "type": "string", "description": "The email of the user who performed the operation", "example": "hans.mustermann@xyz.com" }, "modifiedResources": { "type": "array", "description": "A list of resources in the chain of the modification", "items": { "type": "object", "properties": { "elementId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "elementType": { "type": "string", "description": "Additional resource types for audit purposes", "example": "node", "enum": [ "agentassistconfig", "agentSettings", "chart", "connection", "connectionSchema", "endpoint", "extension", "file", "flow", "flowSettings", "flowState", "function", "intent", "intentDefaultReply", "intentLearningSentence", "intentRelation", "intentSentence", "intentTrainGroup", "knowledgeStore", "largeLanguageModel", "lexicon", "lexiconEntry", "lexiconKeyphrase", "lexiconSlot", "locale", "milestone", "nluconnector", "nodeData", "nodeDescriptorSet", "package", "playbook", "slotFiller", "snapshot", "snippet", "aicopilotconfig", "apiKey", "analytics", "connectionField", "conversation", "examplesentence", "functionInstance", "keyphrase", "learningsentence", "node", "playbookStep", "playbookStepAssert", "profile", "profileSchema", "project", "projectsettings", "synonym", "tag", "task", "trainerRecord", "user", "yesNoIntent" ] } } } } } }, "IApiKeyData_2_0": { "type": "object", "properties": { "name": { "type": "string" } } }, "IApiKey_2_0": { "type": "object", "properties": { "name": { "type": "string" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "minimum": 0, "maximum": 2147483647, "example": 1527621049 }, "apiKey": { "type": "string" } } }, "IApiKeyIndexItem_2_0": { "type": "object", "properties": { "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "name": { "type": "string" }, "apiKey": { "type": "string" }, "createdAt": { "type": "number" } } }, "ILoginAttempt_2_0": { "type": "object", "properties": { "status": { "type": "string", "enum": [ "success", "failed" ] }, "timestamp": { "type": "number" }, "location": { "type": "string" } } }, "ILoginAttemptIndexItem_2_0": { "type": "object", "properties": { "status": { "type": "string", "enum": [ "success", "failed" ] }, "timestamp": { "type": "number" }, "location": { "type": "string" } } }, "IProjectMemberData_2_0": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "roles": { "type": "array", "items": { "type": "string", "enum": [ "agentAssistConfigAdmin", "agentAssistConfigViewer", "analytics", "basic", "connection_admin", "contact_profile_admin", "contact_profile_editor", "contact_profile_viewer", "conversationHistory", "developer", "endpoint_admin", "extension_admin", "extension_editor", "flowEditor", "flowNodeComments", "flowNodeDescriptions", "followUser", "intents", "data_privacy_admin", "data_privacy_editor", "data_privacy_viewer", "knowledgeAdmin", "large_language_model_admin,", "lexicon_admin", "lexicon_editor", "localesAdmin", "logs", "memberManager", "nlu_connector_admin", "packages_admin", "playbook_admin", "playbook_editor", "projectAdmin", "snapshot_admin", "tokenAdmin", "tokenEditor", "function_admin", "function_editor", "admin" ] } }, "acceptedTOS": { "type": "boolean" }, "disabled": { "type": "boolean" }, "acl": { "type": "object" }, "allowedLocales": { "type": "array", "nullable": true, "items": { "type": "object", "properties": { "localeId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } } } }, "IProjectMember_2_0": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "roles": { "type": "array", "items": { "type": "string", "enum": [ "agentAssistConfigAdmin", "agentAssistConfigViewer", "analytics", "basic", "connection_admin", "contact_profile_admin", "contact_profile_editor", "contact_profile_viewer", "conversationHistory", "developer", "endpoint_admin", "extension_admin", "extension_editor", "flowEditor", "flowNodeComments", "flowNodeDescriptions", "followUser", "intents", "data_privacy_admin", "data_privacy_editor", "data_privacy_viewer", "knowledgeAdmin", "large_language_model_admin,", "lexicon_admin", "lexicon_editor", "localesAdmin", "logs", "memberManager", "nlu_connector_admin", "packages_admin", "playbook_admin", "playbook_editor", "projectAdmin", "snapshot_admin", "tokenAdmin", "tokenEditor", "function_admin", "function_editor", "admin" ] } }, "acceptedTOS": { "type": "boolean" }, "disabled": { "type": "boolean" }, "acl": { "type": "object" }, "allowedLocales": { "type": "array", "nullable": true, "items": { "type": "object", "properties": { "localeId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" }, "IProjectMemberIndexItem_2_0": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "roles": { "type": "array", "items": { "type": "string" } }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" }, "IUserData_2_0": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "organisation": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "roles": { "type": "array", "items": { "type": "string", "enum": [ "admin", "apiKeys", "base_role", "basicSupportUser", "fullSupportUser", "liveAgentAdmin", "liveAgentAgent", "liveAgentSupervisor", "odata", "projectAssigner", "projectManager", "userManager", "userDetailsViewer", "voiceGatewayUser" ] } }, "projects": { "type": "array", "items": { "type": "string" } }, "acceptedTOS": { "type": "boolean" }, "disabled": { "type": "boolean" } } }, "IUserDataCreate_2_0": { "type": "object", "required": [ "id", "name", "password" ], "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "roles": { "type": "array", "items": { "type": "string", "enum": [ "admin", "apiKeys", "base_role", "basicSupportUser", "fullSupportUser", "liveAgentAdmin", "liveAgentAgent", "liveAgentSupervisor", "odata", "projectAssigner", "projectManager", "userManager", "userDetailsViewer", "voiceGatewayUser" ] } }, "password": { "type": "string", "description": "Enter password in case of non-sso user" } } }, "IUser_2_0": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "organisation": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "roles": { "type": "array", "items": { "type": "string", "enum": [ "admin", "apiKeys", "base_role", "basicSupportUser", "fullSupportUser", "liveAgentAdmin", "liveAgentAgent", "liveAgentSupervisor", "odata", "projectAssigner", "projectManager", "userManager", "userDetailsViewer", "voiceGatewayUser" ] } }, "projects": { "type": "array", "items": { "type": "string" } }, "acceptedTOS": { "type": "boolean" }, "disabled": { "type": "boolean" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" }, "IUserAcl_2_0": { "type": "object", "properties": { "organisationWide": { "type": "object", "properties": { "rights": { "type": "object", "properties": { "analyticsOdata": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "apiKeys": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "liveAgentAccount": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "projects": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "userDetails": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "users": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "connections": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "contactProfiles": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "conversationHistory": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "endpoints": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "extensions": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "flowNodeComments": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "flowNodeDescription": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "flowNodes": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "flows": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "intents": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "knowledgeStores": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "lexicons": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "liveAgentInbox": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "locales": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "logs": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "memberDetails": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "members": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "milestones": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "nluConnectors": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "playbooks": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "project": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "projectSettings": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "snapshots": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "states": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "tasks": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "tokens": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "voiceGatewayAccount": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } } } }, "roles": { "type": "array", "items": { "type": "string", "enum": [ "admin", "apiKeys", "base_role", "basicSupportUser", "fullSupportUser", "liveAgentAdmin", "liveAgentAgent", "liveAgentSupervisor", "odata", "projectAssigner", "projectManager", "userManager", "userDetailsViewer", "voiceGatewayUser" ] } } } }, "projectWide": { "type": "object", "additionalProperties": { "type": "object", "properties": { "rights": { "type": "object", "properties": { "agentAssistConfigs": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "analytics": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "connections": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "contactProfiles": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "conversationHistory": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "endpoints": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "extensions": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "extensionsTrust": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "flowNodeComments": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "flowNodeDescription": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "flowNodes": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "flows": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "intents": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "largeLanguageModels": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "knowledgeStores": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "lexicons": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "liveAgentInbox": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "locales": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "logs": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "memberDetails": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "members": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "milestones": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "nluConnectors": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "playbooks": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "project": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "projectSettings": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "snapshots": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "states": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "tasks": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "tokens": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "analyticsOdata": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "apiKeys": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "projects": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "userDetails": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "users": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } } }, "additionalProperties": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } } }, "roles": { "type": "array", "items": { "type": "string", "enum": [ "agentAssistConfigAdmin", "agentAssistConfigViewer", "analytics", "basic", "connection_admin", "contact_profile_admin", "contact_profile_editor", "contact_profile_viewer", "conversationHistory", "developer", "endpoint_admin", "extension_admin", "extension_editor", "flowEditor", "flowNodeComments", "flowNodeDescriptions", "followUser", "intents", "data_privacy_admin", "data_privacy_editor", "data_privacy_viewer", "knowledgeAdmin", "large_language_model_admin,", "lexicon_admin", "lexicon_editor", "localesAdmin", "logs", "memberManager", "nlu_connector_admin", "packages_admin", "playbook_admin", "playbook_editor", "projectAdmin", "snapshot_admin", "tokenAdmin", "tokenEditor", "function_admin", "function_editor" ] } }, "allowedLocales": { "type": "array", "items": { "type": "object", "properties": { "localeId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "primary": { "type": "boolean" } } } } } } } } }, "IUserIndexItem_2_0": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "lastActive": { "type": "number" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" }, "IUserAdditional_2_0": { "type": "object", "properties": { "newPassword": { "type": "string" } } }, "IUserMeAdditional_2_0": { "type": "object", "properties": { "oldPassword": { "type": "string" }, "newPassword": { "type": "string" } } }, "IUserUpdate_2_0": { "type": "object", "properties": { "name": { "type": "string" }, "newPassword": { "type": "string" } } }, "IUserUpdateMe_2_0": { "type": "object", "properties": { "name": { "type": "string" }, "oldPassword": { "type": "string" }, "newPassword": { "type": "string" } } }, "IApiKeyData_2_1": { "type": "object", "properties": { "name": { "type": "string" } } }, "IApiKey_2_1": { "type": "object", "properties": { "name": { "type": "string" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "minimum": 0, "maximum": 2147483647, "example": 1527621049 }, "apiKey": { "type": "string" } } }, "IApiKeyIndexItem_2_1": { "type": "object", "properties": { "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "name": { "type": "string" }, "createdAt": { "type": "number" } } }, "IDeleteAnalyticsRecordsRestDataBody_2_0": { "type": "object", "properties": { "contactIds": { "type": "array", "nullable": true, "items": { "type": "string" } }, "timestampStart": { "type": "string", "example": "2020-01-01T00:00:00Z" }, "timestampEnd": { "type": "string", "example": "2020-01-31T23:59:00Z" } } }, "IUpdateAnalyticsRecordProperties_2_0": { "type": "object", "properties": { "state": { "type": "string" }, "mode": { "type": "string" }, "userType": { "type": "string" }, "channel": { "type": "string" }, "flowLanguage": { "type": "string" }, "intent": { "type": "string" }, "intentScore": { "type": "number" }, "intentFlow": { "type": "string" }, "flowName": { "type": "string" }, "inHandoverRequest": { "type": "boolean" }, "inHandoverConversation": { "type": "boolean" }, "localeName": { "type": "string" }, "rating": { "type": "number" }, "ratingComment": { "type": "string" }, "entrypointType": { "type": "string" }, "trackedGoals": { "type": "array", "items": { "type": "string" } }, "endpointName": { "type": "string" }, "endpointUrlToken": { "type": "string" }, "handoverEscalations": { "type": "number" }, "snapshotName": { "type": "string" }, "slots": { "type": "object" }, "custom1": { "type": "string" }, "custom2": { "type": "string" }, "custom3": { "type": "string" }, "custom4": { "type": "string" }, "custom5": { "type": "string" }, "custom6": { "type": "string" }, "custom7": { "type": "string" }, "custom8": { "type": "string" }, "custom9": { "type": "string" }, "custom10": { "type": "string" } } }, "IAudioPreviewLanguages_2_0": { "type": "object", "properties": { "audioPreviewLanguages": { "type": "array", "items": { "type": "object", "properties": { "voiceId": { "type": "string", "maxLength": 50, "description": "Audio preview provided voice Id. This is the ID that you specify when calling the SynthesizeSpeech operation." }, "languageCode": { "type": "string", "maxLength": 10, "description": "Language code of the voice." } } } } } }, "ITestVoiceProvider_2_0": { "type": "object", "properties": { "voiceProvider": { "type": "string" }, "isCredentialsValid": { "type": "boolean" }, "msg": { "type": "string" }, "msgErr": { "type": "string" } } }, "IVGCallSettings_2_0": { "type": "object", "properties": { "sipRealm": { "type": "string" }, "username": { "type": "string" }, "password": { "type": "string" }, "userId": { "description": "temporary user id", "type": "string" } } }, "IVoicePrepareCall_2_0": { "type": "object", "properties": { "entrypoint": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "flowId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "localeId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "nluConnectorId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "language": { "type": "string" }, "voice": { "type": "string" } } }, "TRelType": { "type": "array", "items": { "type": "string", "enum": [ "idp" ] } }, "IWebfingerRestReturnValue": { "type": "object", "properties": { "subject": { "type": "string", "example": "org:5ce7c2d833ea1e04d7e6c432" }, "links": { "type": "array", "items": { "type": "object", "properties": { "rel": { "type": "string", "enum": [ "idp" ] }, "properties": { "type": "object", "oneOf": [ { "type": "object", "properties": { "idp:type": { "type": "string", "enum": [ "none" ] } } }, { "type": "object", "properties": { "idp:type": { "type": "string", "enum": [ "oidc" ] }, "idp:callback": { "type": "string", "format": "url" }, "idp:login": { "type": "string", "format": "url" }, "idp:logout": { "type": "string", "format": "url" }, "idp:logout:fc": { "type": "string", "format": "url" } } }, { "type": "object", "properties": { "idp:type": { "type": "string", "enum": [ "oidc" ] }, "idp:login": { "type": "string", "format": "url" }, "idp:logout": { "type": "string", "format": "url" } } } ] } } } } } }, "TRel": { "type": "object", "properties": { "rel": { "type": "string", "enum": [ "idp" ] }, "properties": { "type": "object", "oneOf": [ { "type": "object", "properties": { "idp:type": { "type": "string", "enum": [ "none" ] } } }, { "type": "object", "properties": { "idp:type": { "type": "string", "enum": [ "oidc" ] }, "idp:callback": { "type": "string", "format": "url" }, "idp:login": { "type": "string", "format": "url" }, "idp:logout": { "type": "string", "format": "url" }, "idp:logout:fc": { "type": "string", "format": "url" } } }, { "type": "object", "properties": { "idp:type": { "type": "string", "enum": [ "oidc" ] }, "idp:login": { "type": "string", "format": "url" }, "idp:logout": { "type": "string", "format": "url" } } } ] } } }, "IIdpRel": { "type": "object", "properties": { "rel": { "type": "string", "enum": [ "idp" ] }, "properties": { "type": "object", "oneOf": [ { "type": "object", "properties": { "idp:type": { "type": "string", "enum": [ "none" ] } } }, { "type": "object", "properties": { "idp:type": { "type": "string", "enum": [ "oidc" ] }, "idp:callback": { "type": "string", "format": "url" }, "idp:login": { "type": "string", "format": "url" }, "idp:logout": { "type": "string", "format": "url" }, "idp:logout:fc": { "type": "string", "format": "url" } } }, { "type": "object", "properties": { "idp:type": { "type": "string", "enum": [ "oidc" ] }, "idp:login": { "type": "string", "format": "url" }, "idp:logout": { "type": "string", "format": "url" } } } ] } } }, "TIdpWebfingerProperties": { "type": "object", "oneOf": [ { "type": "object", "properties": { "idp:type": { "type": "string", "enum": [ "none" ] } } }, { "type": "object", "properties": { "idp:type": { "type": "string", "enum": [ "oidc" ] }, "idp:callback": { "type": "string", "format": "url" }, "idp:login": { "type": "string", "format": "url" }, "idp:logout": { "type": "string", "format": "url" }, "idp:logout:fc": { "type": "string", "format": "url" } } }, { "type": "object", "properties": { "idp:type": { "type": "string", "enum": [ "oidc" ] }, "idp:login": { "type": "string", "format": "url" }, "idp:logout": { "type": "string", "format": "url" } } } ] }, "INoneIdpWebfingerProperties": { "type": "object", "properties": { "idp:type": { "type": "string", "enum": [ "none" ] } } }, "IOidcIdpWebfingerProperties": { "type": "object", "properties": { "idp:type": { "type": "string", "enum": [ "oidc" ] }, "idp:callback": { "type": "string", "format": "url" }, "idp:login": { "type": "string", "format": "url" }, "idp:logout": { "type": "string", "format": "url" }, "idp:logout:fc": { "type": "string", "format": "url" } } }, "ISamlIdpWebfingerProperties": { "type": "object", "properties": { "idp:type": { "type": "string", "enum": [ "oidc" ] }, "idp:login": { "type": "string", "format": "url" }, "idp:logout": { "type": "string", "format": "url" } } }, "IAlexaSkill_2_0": { "type": "object", "properties": { "lastUpdated": { "type": "string", "description": "When the skill was last updated" }, "nameByLocale": { "type": "object", "description": "Gives the name of the skill for different locales", "properties": { "en-US": { "type": "string" }, "de-DE": { "type": "string" }, "ja-JP": { "type": "string" }, "en-GB": { "type": "string" }, "en-IN": { "type": "string" } } }, "skillId": { "type": "string", "description": "The unique id of the skill" }, "stage": { "type": "string", "description": "The current stage of the skills life cycle (e.g. is it in development, production..)" } } }, "IAmazonUser_2_0": { "type": "object", "properties": { "userId": { "type": "string", "description": "The userId of the amazon user in the platform." }, "accessToken": { "type": "string", "description": "The user's access token that allows platform to make requests to Amazon." }, "refreshToken": { "type": "string", "description": "A refresh token that is used to generate a new access token refresh token pair." } } }, "IAnalyticsQueryFilter_2_0": { "type": "object", "properties": { "filters": { "type": "array", "items": { "type": "object", "properties": { "field": { "type": "string" }, "operator": { "type": "string", "enum": [ "equals", "notEquals", "gt", "gte", "lt", "lte" ] }, "values": { "type": "array", "items": { "type": "string" } } } } } } }, "ILoadMessagesReportByQueryHashResponse_2_0": { "type": "object", "properties": { "status": { "type": "string", "enum": [ "pending", "done", "error" ] }, "data": { "type": "array", "items": { "type": "object", "properties": { "message": { "type": "string" }, "count": { "type": "number" }, "source": { "type": "string" } }, "example": { "message": "I want pizza", "count": 12345, "source": "bot" } } } }, "example": { "status": "done", "data": [ { "message": "I want pizza", "count": 12345, "source": "bot" } ] } }, "ITopNMessages_2_0": { "type": "object", "properties": { "message": { "type": "string" }, "count": { "type": "number" }, "source": { "type": "string" } }, "example": { "message": "I want pizza", "count": 12345, "source": "bot" } }, "IGenerateReportResponse_2_0": { "type": "object", "properties": { "queryHash": { "type": "string" } } }, "ILoadReportByQueryHashResponse_2_0": { "type": "object", "properties": { "status": { "type": "string", "enum": [ "pending", "done", "error" ] }, "data": { "type": "array", "items": { "type": "object", "properties": { "dimension": { "type": "string" }, "measure": { "type": "number" }, "value": { "type": "string" } } } } }, "example": { "status": "done", "data": [ { "dimension": "2021-01", "measure": 0 }, { "dimension": "2021-02", "measure": 1 }, { "dimension": "2021-03", "measure": 0 }, { "dimension": "2021-04", "measure": 1 } ] } }, "ILoadStepReportByQueryHashResponse_2_0": { "type": "object", "properties": { "status": { "type": "string", "enum": [ "pending", "done", "error" ] }, "data": { "type": "object", "properties": { "_id": { "type": "string" }, "step": { "type": "string" }, "type": { "type": "string", "enum": [ "intent", "node" ] }, "count": { "type": "number" }, "flowReferenceId": { "type": "string" }, "flowName": { "type": "string" }, "entityReferenceId": { "type": "string" }, "children": { "type": "array", "items": { "type": "object" } } }, "example": { "step": "Collect Email", "type": "node", "count": 10, "flowReferenceId": "5dcf4edd-e5da-4bdc-837f-f482f8b90f47", "flowName": "Main", "entityReferenceId": "9f5078b4-2c0e-4e62-a1a3-9f5c1db89ee9", "children": [ { "step": "Find Bookings", "type": "node", "count": 8, "flowReferenceId": "5dcf4edd-e5da-4bdc-837f-f482f8b90f47", "flowName": "Main", "entityReferenceId": "d623f450-ce35-4872-9842-3071ade1430f" }, { "step": "Help", "type": "intent", "count": 2, "flowReferenceId": "5dcf4edd-e5da-4bdc-837f-f482f8b90f47", "flowName": "Main", "entityReferenceId": "bfdb0179-32c2-4d5c-bf42-8882f14824a2" } ] } } } }, "IStep_2_0": { "type": "object", "properties": { "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "label": { "type": "string" }, "type": { "type": "string", "enum": [ "intent", "node" ] }, "entityReferenceId": { "type": "string" }, "flowReferenceId": { "type": "string" }, "flowName": { "type": "string" }, "projectName": { "type": "string" }, "projectId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "organisationId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "snapshotName": { "type": "string" }, "snapshotId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } }, "IStepIndexItem_2_0": { "type": "object", "properties": { "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "label": { "type": "string" }, "type": { "type": "string", "enum": [ "intent", "node" ] }, "entityReferenceId": { "type": "string" }, "flowReferenceId": { "type": "string" }, "flowName": { "type": "string" }, "snapshotName": { "type": "string" }, "snapshotId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } }, "IStepReport_2_0": { "type": "object", "properties": { "_id": { "type": "string" }, "step": { "type": "string" }, "type": { "type": "string", "enum": [ "intent", "node" ] }, "count": { "type": "number" }, "flowReferenceId": { "type": "string" }, "flowName": { "type": "string" }, "entityReferenceId": { "type": "string" }, "children": { "type": "array", "items": { "type": "object" } } }, "example": { "step": "Collect Email", "type": "node", "count": 10, "flowReferenceId": "5dcf4edd-e5da-4bdc-837f-f482f8b90f47", "flowName": "Main", "entityReferenceId": "9f5078b4-2c0e-4e62-a1a3-9f5c1db89ee9", "children": [ { "step": "Find Bookings", "type": "node", "count": 8, "flowReferenceId": "5dcf4edd-e5da-4bdc-837f-f482f8b90f47", "flowName": "Main", "entityReferenceId": "d623f450-ce35-4872-9842-3071ade1430f" }, { "step": "Help", "type": "intent", "count": 2, "flowReferenceId": "5dcf4edd-e5da-4bdc-837f-f482f8b90f47", "flowName": "Main", "entityReferenceId": "bfdb0179-32c2-4d5c-bf42-8882f14824a2" } ] } }, "TAnalyticsQueryFilterOperator_2_0": { "type": "string", "enum": [ "equals", "notEquals", "gt", "gte", "lt", "lte" ] }, "ILoadTranscriptsReportByQueryHashResponse_2_0": { "type": "object", "properties": { "status": { "type": "string", "enum": [ "pending", "done", "error" ] }, "data": { "type": "array", "items": { "type": "object", "properties": { "_id": { "type": "string" }, "contactId": { "type": "string" }, "channel": { "type": "string", "example": "webchat2", "enum": [ "facebook", "alexa", "slack", "generic", "inject", "rest", "realtime", "socket", "adminconsole", "webchat2", "dialogflow", "twilio", "twilio-sms", "line", "intercom", "microsoftBotFramework", "microsoftTeams", "sunshineConversations", "admin-webchat", "avaya", "nonConversational", "voiceGateway2", "amazonLex", "workplace", "webhook", "abstractRest", "userlike", "ringCentralEngage", "audioCodes", "bandwidth", "whatsapp", "eightByEight", "genesysBotConnector", "niceCXOne", "agentAssistVoice", "webchat3" ] }, "projectId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "projectName": { "type": "string" }, "flowName": { "type": "string" }, "messages": { "type": "integer" }, "startTime": { "type": "string" }, "endTime": { "type": "string" }, "ratings": { "type": "array", "items": { "type": "number" } }, "ratingComments": { "type": "array", "items": { "type": "string" } }, "endpointName": { "type": "string" } } } } } }, "IStepPath_2_0": { "type": "object", "properties": { "value": { "type": "string" }, "match": { "type": "string" } } }, "IOrganisationData_2_0": { "type": "object", "properties": { "disabled": { "type": "boolean", "description": "Flag whether this organisation is currently disabled" }, "quotaMaxProjects": { "type": "number" }, "quotaMaxUsers": { "type": "number" }, "quotaMaxChannelsPerProject": { "type": "number" }, "quotaMaxMessagesPerDay": { "type": "number" }, "quotaMaxKnowledgeChunks": { "type": "number" }, "passwordPolicy": { "type": "object", "properties": { "minLength": { "type": "integer" }, "maxLength": { "type": "integer" }, "minAmountLowerCase": { "type": "integer" }, "minAmountUpperCase": { "type": "integer" }, "minAmountSpecialCharacters": { "type": "integer" }, "minAmountNumbers": { "type": "integer" }, "maxAmountIdenticalCharacters": { "type": "integer" }, "minAmountFailedAttemptsAutoDisable": { "type": "integer" } } }, "sessionStateTTLInMinutes": { "type": "number" }, "contactProfileTTLInMinutes": { "type": "number" }, "conversationTTLInMinutes": { "type": "number" }, "billingTimezone": { "type": "string", "description": "Timezone according to IANA Timezone Database (2020a)", "example": "Europe/Berlin", "enum": [ "Africa/Abidjan", "Africa/Accra", "Africa/Addis_Ababa", "Africa/Algiers", "Africa/Asmara", "Africa/Asmera", "Africa/Bamako", "Africa/Bangui", "Africa/Banjul", "Africa/Bissau", "Africa/Blantyre", "Africa/Brazzaville", "Africa/Bujumbura", "Africa/Cairo", "Africa/Casablanca", "Africa/Ceuta", "Africa/Conakry", "Africa/Dakar", "Africa/Dar_es_Salaam", "Africa/Djibouti", "Africa/Douala", "Africa/El_Aaiun", "Africa/Freetown", "Africa/Gaborone", "Africa/Harare", "Africa/Johannesburg", "Africa/Juba", "Africa/Kampala", "Africa/Khartoum", "Africa/Kigali", "Africa/Kinshasa", "Africa/Lagos", "Africa/Libreville", "Africa/Lome", "Africa/Luanda", "Africa/Lubumbashi", "Africa/Lusaka", "Africa/Malabo", "Africa/Maputo", "Africa/Maseru", "Africa/Mbabane", "Africa/Mogadishu", "Africa/Monrovia", "Africa/Nairobi", "Africa/Ndjamena", "Africa/Niamey", "Africa/Nouakchott", "Africa/Ouagadougou", "Africa/Porto-Novo", "Africa/Sao_Tome", "Africa/Timbuktu", "Africa/Tripoli", "Africa/Tunis", "Africa/Windhoek", "America/Adak", "America/Anchorage", "America/Anguilla", "America/Antigua", "America/Araguaina", "America/Argentina/Buenos_Aires", "America/Argentina/Catamarca", "America/Argentina/ComodRivadavia", "America/Argentina/Cordoba", "America/Argentina/Jujuy", "America/Argentina/La_Rioja", "America/Argentina/Mendoza", "America/Argentina/Rio_Gallegos", "America/Argentina/Salta", "America/Argentina/San_Juan", "America/Argentina/San_Luis", "America/Argentina/Tucuman", "America/Argentina/Ushuaia", "America/Aruba", "America/Asuncion", "America/Atikokan", "America/Atka", "America/Bahia", "America/Bahia_Banderas", "America/Barbados", "America/Belem", "America/Belize", "America/Blanc-Sablon", "America/Boa_Vista", "America/Bogota", "America/Boise", "America/Buenos_Aires", "America/Cambridge_Bay", "America/Campo_Grande", "America/Cancun", "America/Caracas", "America/Catamarca", "America/Cayenne", "America/Cayman", "America/Chicago", "America/Chihuahua", "America/Coral_Harbour", "America/Cordoba", "America/Costa_Rica", "America/Creston", "America/Cuiaba", "America/Curacao", "America/Danmarkshavn", "America/Dawson", "America/Dawson_Creek", "America/Denver", "America/Detroit", "America/Dominica", "America/Edmonton", "America/Eirunepe", "America/El_Salvador", "America/Ensenada", "America/Fort_Nelson", "America/Fort_Wayne", "America/Fortaleza", "America/Glace_Bay", "America/Godthab", "America/Goose_Bay", "America/Grand_Turk", "America/Grenada", "America/Guadeloupe", "America/Guatemala", "America/Guayaquil", "America/Guyana", "America/Halifax", "America/Havana", "America/Hermosillo", "America/Indiana/Indianapolis", "America/Indiana/Knox", "America/Indiana/Marengo", "America/Indiana/Petersburg", "America/Indiana/Tell_City", "America/Indiana/Vevay", "America/Indiana/Vincennes", "America/Indiana/Winamac", "America/Indianapolis", "America/Inuvik", "America/Iqaluit", "America/Jamaica", "America/Jujuy", "America/Juneau", "America/Kentucky/Louisville", "America/Kentucky/Monticello", "America/Knox_IN", "America/Kralendijk", "America/La_Paz", "America/Lima", "America/Los_Angeles", "America/Louisville", "America/Lower_Princes", "America/Maceio", "America/Managua", "America/Manaus", "America/Marigot", "America/Martinique", "America/Matamoros", "America/Mazatlan", "America/Mendoza", "America/Menominee", "America/Merida", "America/Metlakatla", "America/Mexico_City", "America/Miquelon", "America/Moncton", "America/Monterrey", "America/Montevideo", "America/Montreal", "America/Montserrat", "America/Nassau", "America/New_York", "America/Nipigon", "America/Nome", "America/Noronha", "America/North_Dakota/Beulah", "America/North_Dakota/Center", "America/North_Dakota/New_Salem", "America/Ojinaga", "America/Panama", "America/Pangnirtung", "America/Paramaribo", "America/Phoenix", "America/Port-au-Prince", "America/Port_of_Spain", "America/Porto_Acre", "America/Porto_Velho", "America/Puerto_Rico", "America/Punta_Arenas", "America/Rainy_River", "America/Rankin_Inlet", "America/Recife", "America/Regina", "America/Resolute", "America/Rio_Branco", "America/Rosario", "America/Santa_Isabel", "America/Santarem", "America/Santiago", "America/Santo_Domingo", "America/Sao_Paulo", "America/Scoresbysund", "America/Shiprock", "America/Sitka", "America/St_Barthelemy", "America/St_Johns", "America/St_Kitts", "America/St_Lucia", "America/St_Thomas", "America/St_Vincent", "America/Swift_Current", "America/Tegucigalpa", "America/Thule", "America/Thunder_Bay", "America/Tijuana", "America/Toronto", "America/Tortola", "America/Vancouver", "America/Virgin", "America/Whitehorse", "America/Winnipeg", "America/Yakutat", "America/Yellowknife", "Antarctica/Casey", "Antarctica/Davis", "Antarctica/DumontDUrville", "Antarctica/Macquarie", "Antarctica/Mawson", "Antarctica/McMurdo", "Antarctica/Palmer", "Antarctica/Rothera", "Antarctica/South_Pole", "Antarctica/Syowa", "Antarctica/Troll", "Antarctica/Vostok", "Arctic/Longyearbyen", "Asia/Aden", "Asia/Almaty", "Asia/Amman", "Asia/Anadyr", "Asia/Aqtau", "Asia/Aqtobe", "Asia/Ashgabat", "Asia/Ashkhabad", "Asia/Atyrau", "Asia/Baghdad", "Asia/Bahrain", "Asia/Baku", "Asia/Bangkok", "Asia/Barnaul", "Asia/Beirut", "Asia/Bishkek", "Asia/Brunei", "Asia/Calcutta", "Asia/Chita", "Asia/Choibalsan", "Asia/Chongqing", "Asia/Chungking", "Asia/Colombo", "Asia/Dacca", "Asia/Damascus", "Asia/Dhaka", "Asia/Dili", "Asia/Dubai", "Asia/Dushanbe", "Asia/Famagusta", "Asia/Gaza", "Asia/Harbin", "Asia/Hebron", "Asia/Ho_Chi_Minh", "Asia/Hong_Kong", "Asia/Hovd", "Asia/Irkutsk", "Asia/Istanbul", "Asia/Jakarta", "Asia/Jayapura", "Asia/Jerusalem", "Asia/Kabul", "Asia/Kamchatka", "Asia/Karachi", "Asia/Kashgar", "Asia/Kathmandu", "Asia/Katmandu", "Asia/Khandyga", "Asia/Kolkata", "Asia/Krasnoyarsk", "Asia/Kuala_Lumpur", "Asia/Kuching", "Asia/Kuwait", "Asia/Macao", "Asia/Macau", "Asia/Magadan", "Asia/Makassar", "Asia/Manila", "Asia/Muscat", "Asia/Nicosia", "Asia/Novokuznetsk", "Asia/Novosibirsk", "Asia/Omsk", "Asia/Oral", "Asia/Phnom_Penh", "Asia/Pontianak", "Asia/Pyongyang", "Asia/Qatar", "Asia/Qyzylorda", "Asia/Rangoon", "Asia/Riyadh", "Asia/Saigon", "Asia/Sakhalin", "Asia/Samarkand", "Asia/Seoul", "Asia/Shanghai", "Asia/Singapore", "Asia/Srednekolymsk", "Asia/Taipei", "Asia/Tashkent", "Asia/Tbilisi", "Asia/Tehran", "Asia/Tel_Aviv", "Asia/Thimbu", "Asia/Thimphu", "Asia/Tokyo", "Asia/Tomsk", "Asia/Ujung_Pandang", "Asia/Ulaanbaatar", "Asia/Ulan_Bator", "Asia/Urumqi", "Asia/Ust-Nera", "Asia/Vientiane", "Asia/Vladivostok", "Asia/Yakutsk", "Asia/Yangon", "Asia/Yekaterinburg", "Asia/Yerevan", "Atlantic/Azores", "Atlantic/Bermuda", "Atlantic/Canary", "Atlantic/Cape_Verde", "Atlantic/Faeroe", "Atlantic/Faroe", "Atlantic/Jan_Mayen", "Atlantic/Madeira", "Atlantic/Reykjavik", "Atlantic/South_Georgia", "Atlantic/St_Helena", "Atlantic/Stanley", "Australia/ACT", "Australia/Adelaide", "Australia/Brisbane", "Australia/Broken_Hill", "Australia/Canberra", "Australia/Currie", "Australia/Darwin", "Australia/Eucla", "Australia/Hobart", "Australia/LHI", "Australia/Lindeman", "Australia/Lord_Howe", "Australia/Melbourne", "Australia/NSW", "Australia/North", "Australia/Perth", "Australia/Queensland", "Australia/South", "Australia/Sydney", "Australia/Tasmania", "Australia/Victoria", "Australia/West", "Australia/Yancowinna", "Brazil/Acre", "Brazil/DeNoronha", "Brazil/East", "Brazil/West", "CET", "CST6CDT", "Canada/Atlantic", "Canada/Central", "Canada/Eastern", "Canada/Mountain", "Canada/Newfoundland", "Canada/Pacific", "Canada/Saskatchewan", "Canada/Yukon", "Chile/Continental", "Chile/EasterIsland", "Cuba", "EET", "EST", "EST5EDT", "Egypt", "Eire", "Etc/GMT", "Etc/GMT+0", "Etc/GMT+1", "Etc/GMT+10", "Etc/GMT+11", "Etc/GMT+12", "Etc/GMT+2", "Etc/GMT+3", "Etc/GMT+4", "Etc/GMT+5", "Etc/GMT+6", "Etc/GMT+7", "Etc/GMT+8", "Etc/GMT+9", "Etc/GMT-0", "Etc/GMT-1", "Etc/GMT-10", "Etc/GMT-11", "Etc/GMT-12", "Etc/GMT-13", "Etc/GMT-14", "Etc/GMT-2", "Etc/GMT-3", "Etc/GMT-4", "Etc/GMT-5", "Etc/GMT-6", "Etc/GMT-7", "Etc/GMT-8", "Etc/GMT-9", "Etc/GMT0", "Etc/Greenwich", "Etc/UCT", "Etc/UTC", "Etc/Universal", "Etc/Zulu", "Europe/Amsterdam", "Europe/Andorra", "Europe/Astrakhan", "Europe/Athens", "Europe/Belfast", "Europe/Belgrade", "Europe/Berlin", "Europe/Bratislava", "Europe/Brussels", "Europe/Bucharest", "Europe/Budapest", "Europe/Busingen", "Europe/Chisinau", "Europe/Copenhagen", "Europe/Dublin", "Europe/Gibraltar", "Europe/Guernsey", "Europe/Helsinki", "Europe/Isle_of_Man", "Europe/Istanbul", "Europe/Jersey", "Europe/Kaliningrad", "Europe/Kiev", "Europe/Kirov", "Europe/Lisbon", "Europe/Ljubljana", "Europe/London", "Europe/Luxembourg", "Europe/Madrid", "Europe/Malta", "Europe/Mariehamn", "Europe/Minsk", "Europe/Monaco", "Europe/Moscow", "Europe/Nicosia", "Europe/Oslo", "Europe/Paris", "Europe/Podgorica", "Europe/Prague", "Europe/Riga", "Europe/Rome", "Europe/Samara", "Europe/San_Marino", "Europe/Sarajevo", "Europe/Saratov", "Europe/Simferopol", "Europe/Skopje", "Europe/Sofia", "Europe/Stockholm", "Europe/Tallinn", "Europe/Tirane", "Europe/Tiraspol", "Europe/Ulyanovsk", "Europe/Uzhgorod", "Europe/Vaduz", "Europe/Vatican", "Europe/Vienna", "Europe/Vilnius", "Europe/Volgograd", "Europe/Warsaw", "Europe/Zagreb", "Europe/Zaporozhye", "Europe/Zurich", "GB", "GB-Eire", "GMT", "GMT+0", "GMT-0", "GMT0", "Greenwich", "HST", "Hongkong", "Iceland", "Indian/Antananarivo", "Indian/Chagos", "Indian/Christmas", "Indian/Cocos", "Indian/Comoro", "Indian/Kerguelen", "Indian/Mahe", "Indian/Maldives", "Indian/Mauritius", "Indian/Mayotte", "Indian/Reunion", "Iran", "Israel", "Jamaica", "Japan", "Kwajalein", "Libya", "MET", "MST", "MST7MDT", "Mexico/BajaNorte", "Mexico/BajaSur", "Mexico/General", "NZ", "NZ-CHAT", "Navajo", "PRC", "PST8PDT", "Pacific/Apia", "Pacific/Auckland", "Pacific/Bougainville", "Pacific/Chatham", "Pacific/Chuuk", "Pacific/Easter", "Pacific/Efate", "Pacific/Enderbury", "Pacific/Fakaofo", "Pacific/Fiji", "Pacific/Funafuti", "Pacific/Galapagos", "Pacific/Gambier", "Pacific/Guadalcanal", "Pacific/Guam", "Pacific/Honolulu", "Pacific/Johnston", "Pacific/Kiritimati", "Pacific/Kosrae", "Pacific/Kwajalein", "Pacific/Majuro", "Pacific/Marquesas", "Pacific/Midway", "Pacific/Nauru", "Pacific/Niue", "Pacific/Norfolk", "Pacific/Noumea", "Pacific/Pago_Pago", "Pacific/Palau", "Pacific/Pitcairn", "Pacific/Pohnpei", "Pacific/Ponape", "Pacific/Port_Moresby", "Pacific/Rarotonga", "Pacific/Saipan", "Pacific/Samoa", "Pacific/Tahiti", "Pacific/Tarawa", "Pacific/Tongatapu", "Pacific/Truk", "Pacific/Wake", "Pacific/Wallis", "Pacific/Yap", "Poland", "Portugal", "ROC", "ROK", "Singapore", "Turkey", "UCT", "US/Alaska", "US/Aleutian", "US/Arizona", "US/Central", "US/East-Indiana", "US/Eastern", "US/Hawaii", "US/Indiana-Starke", "US/Michigan", "US/Mountain", "US/Pacific", "US/Pacific-New", "US/Samoa", "UTC", "Universal", "W-SU", "WET", "Zulu" ] }, "dataPrivacySettings": { "type": "object", "properties": { "enabled": { "type": "boolean" }, "useAnalytics": { "type": "boolean" }, "useContactProfiles": { "type": "boolean" }, "useConversations": { "type": "boolean" }, "maskAnalytics": { "type": "boolean" }, "maskLogging": { "type": "boolean" }, "ignoreList": { "type": "array", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } } } }, "IOrganisation_2_0": { "properties": { "name": { "type": "string", "description": "The name of this organisation" }, "disabled": { "type": "boolean", "description": "Flag whether this organisation is currently disabled" }, "quotaMaxProjects": { "type": "number" }, "quotaMaxUsers": { "type": "number" }, "quotaMaxChannelsPerProject": { "type": "number" }, "quotaMaxMessagesPerDay": { "type": "number" }, "quotaMaxKnowledgeChunks": { "type": "number" }, "passwordPolicy": { "type": "object", "properties": { "minLength": { "type": "integer" }, "maxLength": { "type": "integer" }, "minAmountLowerCase": { "type": "integer" }, "minAmountUpperCase": { "type": "integer" }, "minAmountSpecialCharacters": { "type": "integer" }, "minAmountNumbers": { "type": "integer" }, "maxAmountIdenticalCharacters": { "type": "integer" }, "minAmountFailedAttemptsAutoDisable": { "type": "integer" } } }, "sessionStateTTLInMinutes": { "type": "number" }, "contactProfileTTLInMinutes": { "type": "number" }, "conversationTTLInMinutes": { "type": "number" }, "billingTimezone": { "type": "string", "description": "Timezone according to IANA Timezone Database (2020a)", "example": "Europe/Berlin", "enum": [ "Africa/Abidjan", "Africa/Accra", "Africa/Addis_Ababa", "Africa/Algiers", "Africa/Asmara", "Africa/Asmera", "Africa/Bamako", "Africa/Bangui", "Africa/Banjul", "Africa/Bissau", "Africa/Blantyre", "Africa/Brazzaville", "Africa/Bujumbura", "Africa/Cairo", "Africa/Casablanca", "Africa/Ceuta", "Africa/Conakry", "Africa/Dakar", "Africa/Dar_es_Salaam", "Africa/Djibouti", "Africa/Douala", "Africa/El_Aaiun", "Africa/Freetown", "Africa/Gaborone", "Africa/Harare", "Africa/Johannesburg", "Africa/Juba", "Africa/Kampala", "Africa/Khartoum", "Africa/Kigali", "Africa/Kinshasa", "Africa/Lagos", "Africa/Libreville", "Africa/Lome", "Africa/Luanda", "Africa/Lubumbashi", "Africa/Lusaka", "Africa/Malabo", "Africa/Maputo", "Africa/Maseru", "Africa/Mbabane", "Africa/Mogadishu", "Africa/Monrovia", "Africa/Nairobi", "Africa/Ndjamena", "Africa/Niamey", "Africa/Nouakchott", "Africa/Ouagadougou", "Africa/Porto-Novo", "Africa/Sao_Tome", "Africa/Timbuktu", "Africa/Tripoli", "Africa/Tunis", "Africa/Windhoek", "America/Adak", "America/Anchorage", "America/Anguilla", "America/Antigua", "America/Araguaina", "America/Argentina/Buenos_Aires", "America/Argentina/Catamarca", "America/Argentina/ComodRivadavia", "America/Argentina/Cordoba", "America/Argentina/Jujuy", "America/Argentina/La_Rioja", "America/Argentina/Mendoza", "America/Argentina/Rio_Gallegos", "America/Argentina/Salta", "America/Argentina/San_Juan", "America/Argentina/San_Luis", "America/Argentina/Tucuman", "America/Argentina/Ushuaia", "America/Aruba", "America/Asuncion", "America/Atikokan", "America/Atka", "America/Bahia", "America/Bahia_Banderas", "America/Barbados", "America/Belem", "America/Belize", "America/Blanc-Sablon", "America/Boa_Vista", "America/Bogota", "America/Boise", "America/Buenos_Aires", "America/Cambridge_Bay", "America/Campo_Grande", "America/Cancun", "America/Caracas", "America/Catamarca", "America/Cayenne", "America/Cayman", "America/Chicago", "America/Chihuahua", "America/Coral_Harbour", "America/Cordoba", "America/Costa_Rica", "America/Creston", "America/Cuiaba", "America/Curacao", "America/Danmarkshavn", "America/Dawson", "America/Dawson_Creek", "America/Denver", "America/Detroit", "America/Dominica", "America/Edmonton", "America/Eirunepe", "America/El_Salvador", "America/Ensenada", "America/Fort_Nelson", "America/Fort_Wayne", "America/Fortaleza", "America/Glace_Bay", "America/Godthab", "America/Goose_Bay", "America/Grand_Turk", "America/Grenada", "America/Guadeloupe", "America/Guatemala", "America/Guayaquil", "America/Guyana", "America/Halifax", "America/Havana", "America/Hermosillo", "America/Indiana/Indianapolis", "America/Indiana/Knox", "America/Indiana/Marengo", "America/Indiana/Petersburg", "America/Indiana/Tell_City", "America/Indiana/Vevay", "America/Indiana/Vincennes", "America/Indiana/Winamac", "America/Indianapolis", "America/Inuvik", "America/Iqaluit", "America/Jamaica", "America/Jujuy", "America/Juneau", "America/Kentucky/Louisville", "America/Kentucky/Monticello", "America/Knox_IN", "America/Kralendijk", "America/La_Paz", "America/Lima", "America/Los_Angeles", "America/Louisville", "America/Lower_Princes", "America/Maceio", "America/Managua", "America/Manaus", "America/Marigot", "America/Martinique", "America/Matamoros", "America/Mazatlan", "America/Mendoza", "America/Menominee", "America/Merida", "America/Metlakatla", "America/Mexico_City", "America/Miquelon", "America/Moncton", "America/Monterrey", "America/Montevideo", "America/Montreal", "America/Montserrat", "America/Nassau", "America/New_York", "America/Nipigon", "America/Nome", "America/Noronha", "America/North_Dakota/Beulah", "America/North_Dakota/Center", "America/North_Dakota/New_Salem", "America/Ojinaga", "America/Panama", "America/Pangnirtung", "America/Paramaribo", "America/Phoenix", "America/Port-au-Prince", "America/Port_of_Spain", "America/Porto_Acre", "America/Porto_Velho", "America/Puerto_Rico", "America/Punta_Arenas", "America/Rainy_River", "America/Rankin_Inlet", "America/Recife", "America/Regina", "America/Resolute", "America/Rio_Branco", "America/Rosario", "America/Santa_Isabel", "America/Santarem", "America/Santiago", "America/Santo_Domingo", "America/Sao_Paulo", "America/Scoresbysund", "America/Shiprock", "America/Sitka", "America/St_Barthelemy", "America/St_Johns", "America/St_Kitts", "America/St_Lucia", "America/St_Thomas", "America/St_Vincent", "America/Swift_Current", "America/Tegucigalpa", "America/Thule", "America/Thunder_Bay", "America/Tijuana", "America/Toronto", "America/Tortola", "America/Vancouver", "America/Virgin", "America/Whitehorse", "America/Winnipeg", "America/Yakutat", "America/Yellowknife", "Antarctica/Casey", "Antarctica/Davis", "Antarctica/DumontDUrville", "Antarctica/Macquarie", "Antarctica/Mawson", "Antarctica/McMurdo", "Antarctica/Palmer", "Antarctica/Rothera", "Antarctica/South_Pole", "Antarctica/Syowa", "Antarctica/Troll", "Antarctica/Vostok", "Arctic/Longyearbyen", "Asia/Aden", "Asia/Almaty", "Asia/Amman", "Asia/Anadyr", "Asia/Aqtau", "Asia/Aqtobe", "Asia/Ashgabat", "Asia/Ashkhabad", "Asia/Atyrau", "Asia/Baghdad", "Asia/Bahrain", "Asia/Baku", "Asia/Bangkok", "Asia/Barnaul", "Asia/Beirut", "Asia/Bishkek", "Asia/Brunei", "Asia/Calcutta", "Asia/Chita", "Asia/Choibalsan", "Asia/Chongqing", "Asia/Chungking", "Asia/Colombo", "Asia/Dacca", "Asia/Damascus", "Asia/Dhaka", "Asia/Dili", "Asia/Dubai", "Asia/Dushanbe", "Asia/Famagusta", "Asia/Gaza", "Asia/Harbin", "Asia/Hebron", "Asia/Ho_Chi_Minh", "Asia/Hong_Kong", "Asia/Hovd", "Asia/Irkutsk", "Asia/Istanbul", "Asia/Jakarta", "Asia/Jayapura", "Asia/Jerusalem", "Asia/Kabul", "Asia/Kamchatka", "Asia/Karachi", "Asia/Kashgar", "Asia/Kathmandu", "Asia/Katmandu", "Asia/Khandyga", "Asia/Kolkata", "Asia/Krasnoyarsk", "Asia/Kuala_Lumpur", "Asia/Kuching", "Asia/Kuwait", "Asia/Macao", "Asia/Macau", "Asia/Magadan", "Asia/Makassar", "Asia/Manila", "Asia/Muscat", "Asia/Nicosia", "Asia/Novokuznetsk", "Asia/Novosibirsk", "Asia/Omsk", "Asia/Oral", "Asia/Phnom_Penh", "Asia/Pontianak", "Asia/Pyongyang", "Asia/Qatar", "Asia/Qyzylorda", "Asia/Rangoon", "Asia/Riyadh", "Asia/Saigon", "Asia/Sakhalin", "Asia/Samarkand", "Asia/Seoul", "Asia/Shanghai", "Asia/Singapore", "Asia/Srednekolymsk", "Asia/Taipei", "Asia/Tashkent", "Asia/Tbilisi", "Asia/Tehran", "Asia/Tel_Aviv", "Asia/Thimbu", "Asia/Thimphu", "Asia/Tokyo", "Asia/Tomsk", "Asia/Ujung_Pandang", "Asia/Ulaanbaatar", "Asia/Ulan_Bator", "Asia/Urumqi", "Asia/Ust-Nera", "Asia/Vientiane", "Asia/Vladivostok", "Asia/Yakutsk", "Asia/Yangon", "Asia/Yekaterinburg", "Asia/Yerevan", "Atlantic/Azores", "Atlantic/Bermuda", "Atlantic/Canary", "Atlantic/Cape_Verde", "Atlantic/Faeroe", "Atlantic/Faroe", "Atlantic/Jan_Mayen", "Atlantic/Madeira", "Atlantic/Reykjavik", "Atlantic/South_Georgia", "Atlantic/St_Helena", "Atlantic/Stanley", "Australia/ACT", "Australia/Adelaide", "Australia/Brisbane", "Australia/Broken_Hill", "Australia/Canberra", "Australia/Currie", "Australia/Darwin", "Australia/Eucla", "Australia/Hobart", "Australia/LHI", "Australia/Lindeman", "Australia/Lord_Howe", "Australia/Melbourne", "Australia/NSW", "Australia/North", "Australia/Perth", "Australia/Queensland", "Australia/South", "Australia/Sydney", "Australia/Tasmania", "Australia/Victoria", "Australia/West", "Australia/Yancowinna", "Brazil/Acre", "Brazil/DeNoronha", "Brazil/East", "Brazil/West", "CET", "CST6CDT", "Canada/Atlantic", "Canada/Central", "Canada/Eastern", "Canada/Mountain", "Canada/Newfoundland", "Canada/Pacific", "Canada/Saskatchewan", "Canada/Yukon", "Chile/Continental", "Chile/EasterIsland", "Cuba", "EET", "EST", "EST5EDT", "Egypt", "Eire", "Etc/GMT", "Etc/GMT+0", "Etc/GMT+1", "Etc/GMT+10", "Etc/GMT+11", "Etc/GMT+12", "Etc/GMT+2", "Etc/GMT+3", "Etc/GMT+4", "Etc/GMT+5", "Etc/GMT+6", "Etc/GMT+7", "Etc/GMT+8", "Etc/GMT+9", "Etc/GMT-0", "Etc/GMT-1", "Etc/GMT-10", "Etc/GMT-11", "Etc/GMT-12", "Etc/GMT-13", "Etc/GMT-14", "Etc/GMT-2", "Etc/GMT-3", "Etc/GMT-4", "Etc/GMT-5", "Etc/GMT-6", "Etc/GMT-7", "Etc/GMT-8", "Etc/GMT-9", "Etc/GMT0", "Etc/Greenwich", "Etc/UCT", "Etc/UTC", "Etc/Universal", "Etc/Zulu", "Europe/Amsterdam", "Europe/Andorra", "Europe/Astrakhan", "Europe/Athens", "Europe/Belfast", "Europe/Belgrade", "Europe/Berlin", "Europe/Bratislava", "Europe/Brussels", "Europe/Bucharest", "Europe/Budapest", "Europe/Busingen", "Europe/Chisinau", "Europe/Copenhagen", "Europe/Dublin", "Europe/Gibraltar", "Europe/Guernsey", "Europe/Helsinki", "Europe/Isle_of_Man", "Europe/Istanbul", "Europe/Jersey", "Europe/Kaliningrad", "Europe/Kiev", "Europe/Kirov", "Europe/Lisbon", "Europe/Ljubljana", "Europe/London", "Europe/Luxembourg", "Europe/Madrid", "Europe/Malta", "Europe/Mariehamn", "Europe/Minsk", "Europe/Monaco", "Europe/Moscow", "Europe/Nicosia", "Europe/Oslo", "Europe/Paris", "Europe/Podgorica", "Europe/Prague", "Europe/Riga", "Europe/Rome", "Europe/Samara", "Europe/San_Marino", "Europe/Sarajevo", "Europe/Saratov", "Europe/Simferopol", "Europe/Skopje", "Europe/Sofia", "Europe/Stockholm", "Europe/Tallinn", "Europe/Tirane", "Europe/Tiraspol", "Europe/Ulyanovsk", "Europe/Uzhgorod", "Europe/Vaduz", "Europe/Vatican", "Europe/Vienna", "Europe/Vilnius", "Europe/Volgograd", "Europe/Warsaw", "Europe/Zagreb", "Europe/Zaporozhye", "Europe/Zurich", "GB", "GB-Eire", "GMT", "GMT+0", "GMT-0", "GMT0", "Greenwich", "HST", "Hongkong", "Iceland", "Indian/Antananarivo", "Indian/Chagos", "Indian/Christmas", "Indian/Cocos", "Indian/Comoro", "Indian/Kerguelen", "Indian/Mahe", "Indian/Maldives", "Indian/Mauritius", "Indian/Mayotte", "Indian/Reunion", "Iran", "Israel", "Jamaica", "Japan", "Kwajalein", "Libya", "MET", "MST", "MST7MDT", "Mexico/BajaNorte", "Mexico/BajaSur", "Mexico/General", "NZ", "NZ-CHAT", "Navajo", "PRC", "PST8PDT", "Pacific/Apia", "Pacific/Auckland", "Pacific/Bougainville", "Pacific/Chatham", "Pacific/Chuuk", "Pacific/Easter", "Pacific/Efate", "Pacific/Enderbury", "Pacific/Fakaofo", "Pacific/Fiji", "Pacific/Funafuti", "Pacific/Galapagos", "Pacific/Gambier", "Pacific/Guadalcanal", "Pacific/Guam", "Pacific/Honolulu", "Pacific/Johnston", "Pacific/Kiritimati", "Pacific/Kosrae", "Pacific/Kwajalein", "Pacific/Majuro", "Pacific/Marquesas", "Pacific/Midway", "Pacific/Nauru", "Pacific/Niue", "Pacific/Norfolk", "Pacific/Noumea", "Pacific/Pago_Pago", "Pacific/Palau", "Pacific/Pitcairn", "Pacific/Pohnpei", "Pacific/Ponape", "Pacific/Port_Moresby", "Pacific/Rarotonga", "Pacific/Saipan", "Pacific/Samoa", "Pacific/Tahiti", "Pacific/Tarawa", "Pacific/Tongatapu", "Pacific/Truk", "Pacific/Wake", "Pacific/Wallis", "Pacific/Yap", "Poland", "Portugal", "ROC", "ROK", "Singapore", "Turkey", "UCT", "US/Alaska", "US/Aleutian", "US/Arizona", "US/Central", "US/East-Indiana", "US/Eastern", "US/Hawaii", "US/Indiana-Starke", "US/Michigan", "US/Mountain", "US/Pacific", "US/Pacific-New", "US/Samoa", "UTC", "Universal", "W-SU", "WET", "Zulu" ] }, "dataPrivacySettings": { "type": "object", "properties": { "enabled": { "type": "boolean" }, "useAnalytics": { "type": "boolean" }, "useContactProfiles": { "type": "boolean" }, "useConversations": { "type": "boolean" }, "maskAnalytics": { "type": "boolean" }, "maskLogging": { "type": "boolean" }, "ignoreList": { "type": "array", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } } }, "required": [ "name" ], "type": "object" }, "IUpdateOrganisation_2_0": { "properties": { "name": { "type": "string", "description": "The name of this organisation" }, "disabled": { "type": "boolean", "description": "Flag whether this organisation is currently disabled" }, "quotaMaxProjects": { "type": "number" }, "quotaMaxUsers": { "type": "number" }, "quotaMaxChannelsPerProject": { "type": "number" }, "quotaMaxMessagesPerDay": { "type": "number" }, "quotaMaxKnowledgeChunks": { "type": "number" }, "passwordPolicy": { "type": "object", "properties": { "minLength": { "type": "integer" }, "maxLength": { "type": "integer" }, "minAmountLowerCase": { "type": "integer" }, "minAmountUpperCase": { "type": "integer" }, "minAmountSpecialCharacters": { "type": "integer" }, "minAmountNumbers": { "type": "integer" }, "maxAmountIdenticalCharacters": { "type": "integer" }, "minAmountFailedAttemptsAutoDisable": { "type": "integer" } } }, "sessionStateTTLInMinutes": { "type": "number" }, "contactProfileTTLInMinutes": { "type": "number" }, "conversationTTLInMinutes": { "type": "number" }, "billingTimezone": { "type": "string", "description": "Timezone according to IANA Timezone Database (2020a)", "example": "Europe/Berlin", "enum": [ "Africa/Abidjan", "Africa/Accra", "Africa/Addis_Ababa", "Africa/Algiers", "Africa/Asmara", "Africa/Asmera", "Africa/Bamako", "Africa/Bangui", "Africa/Banjul", "Africa/Bissau", "Africa/Blantyre", "Africa/Brazzaville", "Africa/Bujumbura", "Africa/Cairo", "Africa/Casablanca", "Africa/Ceuta", "Africa/Conakry", "Africa/Dakar", "Africa/Dar_es_Salaam", "Africa/Djibouti", "Africa/Douala", "Africa/El_Aaiun", "Africa/Freetown", "Africa/Gaborone", "Africa/Harare", "Africa/Johannesburg", "Africa/Juba", "Africa/Kampala", "Africa/Khartoum", "Africa/Kigali", "Africa/Kinshasa", "Africa/Lagos", "Africa/Libreville", "Africa/Lome", "Africa/Luanda", "Africa/Lubumbashi", "Africa/Lusaka", "Africa/Malabo", "Africa/Maputo", "Africa/Maseru", "Africa/Mbabane", "Africa/Mogadishu", "Africa/Monrovia", "Africa/Nairobi", "Africa/Ndjamena", "Africa/Niamey", "Africa/Nouakchott", "Africa/Ouagadougou", "Africa/Porto-Novo", "Africa/Sao_Tome", "Africa/Timbuktu", "Africa/Tripoli", "Africa/Tunis", "Africa/Windhoek", "America/Adak", "America/Anchorage", "America/Anguilla", "America/Antigua", "America/Araguaina", "America/Argentina/Buenos_Aires", "America/Argentina/Catamarca", "America/Argentina/ComodRivadavia", "America/Argentina/Cordoba", "America/Argentina/Jujuy", "America/Argentina/La_Rioja", "America/Argentina/Mendoza", "America/Argentina/Rio_Gallegos", "America/Argentina/Salta", "America/Argentina/San_Juan", "America/Argentina/San_Luis", "America/Argentina/Tucuman", "America/Argentina/Ushuaia", "America/Aruba", "America/Asuncion", "America/Atikokan", "America/Atka", "America/Bahia", "America/Bahia_Banderas", "America/Barbados", "America/Belem", "America/Belize", "America/Blanc-Sablon", "America/Boa_Vista", "America/Bogota", "America/Boise", "America/Buenos_Aires", "America/Cambridge_Bay", "America/Campo_Grande", "America/Cancun", "America/Caracas", "America/Catamarca", "America/Cayenne", "America/Cayman", "America/Chicago", "America/Chihuahua", "America/Coral_Harbour", "America/Cordoba", "America/Costa_Rica", "America/Creston", "America/Cuiaba", "America/Curacao", "America/Danmarkshavn", "America/Dawson", "America/Dawson_Creek", "America/Denver", "America/Detroit", "America/Dominica", "America/Edmonton", "America/Eirunepe", "America/El_Salvador", "America/Ensenada", "America/Fort_Nelson", "America/Fort_Wayne", "America/Fortaleza", "America/Glace_Bay", "America/Godthab", "America/Goose_Bay", "America/Grand_Turk", "America/Grenada", "America/Guadeloupe", "America/Guatemala", "America/Guayaquil", "America/Guyana", "America/Halifax", "America/Havana", "America/Hermosillo", "America/Indiana/Indianapolis", "America/Indiana/Knox", "America/Indiana/Marengo", "America/Indiana/Petersburg", "America/Indiana/Tell_City", "America/Indiana/Vevay", "America/Indiana/Vincennes", "America/Indiana/Winamac", "America/Indianapolis", "America/Inuvik", "America/Iqaluit", "America/Jamaica", "America/Jujuy", "America/Juneau", "America/Kentucky/Louisville", "America/Kentucky/Monticello", "America/Knox_IN", "America/Kralendijk", "America/La_Paz", "America/Lima", "America/Los_Angeles", "America/Louisville", "America/Lower_Princes", "America/Maceio", "America/Managua", "America/Manaus", "America/Marigot", "America/Martinique", "America/Matamoros", "America/Mazatlan", "America/Mendoza", "America/Menominee", "America/Merida", "America/Metlakatla", "America/Mexico_City", "America/Miquelon", "America/Moncton", "America/Monterrey", "America/Montevideo", "America/Montreal", "America/Montserrat", "America/Nassau", "America/New_York", "America/Nipigon", "America/Nome", "America/Noronha", "America/North_Dakota/Beulah", "America/North_Dakota/Center", "America/North_Dakota/New_Salem", "America/Ojinaga", "America/Panama", "America/Pangnirtung", "America/Paramaribo", "America/Phoenix", "America/Port-au-Prince", "America/Port_of_Spain", "America/Porto_Acre", "America/Porto_Velho", "America/Puerto_Rico", "America/Punta_Arenas", "America/Rainy_River", "America/Rankin_Inlet", "America/Recife", "America/Regina", "America/Resolute", "America/Rio_Branco", "America/Rosario", "America/Santa_Isabel", "America/Santarem", "America/Santiago", "America/Santo_Domingo", "America/Sao_Paulo", "America/Scoresbysund", "America/Shiprock", "America/Sitka", "America/St_Barthelemy", "America/St_Johns", "America/St_Kitts", "America/St_Lucia", "America/St_Thomas", "America/St_Vincent", "America/Swift_Current", "America/Tegucigalpa", "America/Thule", "America/Thunder_Bay", "America/Tijuana", "America/Toronto", "America/Tortola", "America/Vancouver", "America/Virgin", "America/Whitehorse", "America/Winnipeg", "America/Yakutat", "America/Yellowknife", "Antarctica/Casey", "Antarctica/Davis", "Antarctica/DumontDUrville", "Antarctica/Macquarie", "Antarctica/Mawson", "Antarctica/McMurdo", "Antarctica/Palmer", "Antarctica/Rothera", "Antarctica/South_Pole", "Antarctica/Syowa", "Antarctica/Troll", "Antarctica/Vostok", "Arctic/Longyearbyen", "Asia/Aden", "Asia/Almaty", "Asia/Amman", "Asia/Anadyr", "Asia/Aqtau", "Asia/Aqtobe", "Asia/Ashgabat", "Asia/Ashkhabad", "Asia/Atyrau", "Asia/Baghdad", "Asia/Bahrain", "Asia/Baku", "Asia/Bangkok", "Asia/Barnaul", "Asia/Beirut", "Asia/Bishkek", "Asia/Brunei", "Asia/Calcutta", "Asia/Chita", "Asia/Choibalsan", "Asia/Chongqing", "Asia/Chungking", "Asia/Colombo", "Asia/Dacca", "Asia/Damascus", "Asia/Dhaka", "Asia/Dili", "Asia/Dubai", "Asia/Dushanbe", "Asia/Famagusta", "Asia/Gaza", "Asia/Harbin", "Asia/Hebron", "Asia/Ho_Chi_Minh", "Asia/Hong_Kong", "Asia/Hovd", "Asia/Irkutsk", "Asia/Istanbul", "Asia/Jakarta", "Asia/Jayapura", "Asia/Jerusalem", "Asia/Kabul", "Asia/Kamchatka", "Asia/Karachi", "Asia/Kashgar", "Asia/Kathmandu", "Asia/Katmandu", "Asia/Khandyga", "Asia/Kolkata", "Asia/Krasnoyarsk", "Asia/Kuala_Lumpur", "Asia/Kuching", "Asia/Kuwait", "Asia/Macao", "Asia/Macau", "Asia/Magadan", "Asia/Makassar", "Asia/Manila", "Asia/Muscat", "Asia/Nicosia", "Asia/Novokuznetsk", "Asia/Novosibirsk", "Asia/Omsk", "Asia/Oral", "Asia/Phnom_Penh", "Asia/Pontianak", "Asia/Pyongyang", "Asia/Qatar", "Asia/Qyzylorda", "Asia/Rangoon", "Asia/Riyadh", "Asia/Saigon", "Asia/Sakhalin", "Asia/Samarkand", "Asia/Seoul", "Asia/Shanghai", "Asia/Singapore", "Asia/Srednekolymsk", "Asia/Taipei", "Asia/Tashkent", "Asia/Tbilisi", "Asia/Tehran", "Asia/Tel_Aviv", "Asia/Thimbu", "Asia/Thimphu", "Asia/Tokyo", "Asia/Tomsk", "Asia/Ujung_Pandang", "Asia/Ulaanbaatar", "Asia/Ulan_Bator", "Asia/Urumqi", "Asia/Ust-Nera", "Asia/Vientiane", "Asia/Vladivostok", "Asia/Yakutsk", "Asia/Yangon", "Asia/Yekaterinburg", "Asia/Yerevan", "Atlantic/Azores", "Atlantic/Bermuda", "Atlantic/Canary", "Atlantic/Cape_Verde", "Atlantic/Faeroe", "Atlantic/Faroe", "Atlantic/Jan_Mayen", "Atlantic/Madeira", "Atlantic/Reykjavik", "Atlantic/South_Georgia", "Atlantic/St_Helena", "Atlantic/Stanley", "Australia/ACT", "Australia/Adelaide", "Australia/Brisbane", "Australia/Broken_Hill", "Australia/Canberra", "Australia/Currie", "Australia/Darwin", "Australia/Eucla", "Australia/Hobart", "Australia/LHI", "Australia/Lindeman", "Australia/Lord_Howe", "Australia/Melbourne", "Australia/NSW", "Australia/North", "Australia/Perth", "Australia/Queensland", "Australia/South", "Australia/Sydney", "Australia/Tasmania", "Australia/Victoria", "Australia/West", "Australia/Yancowinna", "Brazil/Acre", "Brazil/DeNoronha", "Brazil/East", "Brazil/West", "CET", "CST6CDT", "Canada/Atlantic", "Canada/Central", "Canada/Eastern", "Canada/Mountain", "Canada/Newfoundland", "Canada/Pacific", "Canada/Saskatchewan", "Canada/Yukon", "Chile/Continental", "Chile/EasterIsland", "Cuba", "EET", "EST", "EST5EDT", "Egypt", "Eire", "Etc/GMT", "Etc/GMT+0", "Etc/GMT+1", "Etc/GMT+10", "Etc/GMT+11", "Etc/GMT+12", "Etc/GMT+2", "Etc/GMT+3", "Etc/GMT+4", "Etc/GMT+5", "Etc/GMT+6", "Etc/GMT+7", "Etc/GMT+8", "Etc/GMT+9", "Etc/GMT-0", "Etc/GMT-1", "Etc/GMT-10", "Etc/GMT-11", "Etc/GMT-12", "Etc/GMT-13", "Etc/GMT-14", "Etc/GMT-2", "Etc/GMT-3", "Etc/GMT-4", "Etc/GMT-5", "Etc/GMT-6", "Etc/GMT-7", "Etc/GMT-8", "Etc/GMT-9", "Etc/GMT0", "Etc/Greenwich", "Etc/UCT", "Etc/UTC", "Etc/Universal", "Etc/Zulu", "Europe/Amsterdam", "Europe/Andorra", "Europe/Astrakhan", "Europe/Athens", "Europe/Belfast", "Europe/Belgrade", "Europe/Berlin", "Europe/Bratislava", "Europe/Brussels", "Europe/Bucharest", "Europe/Budapest", "Europe/Busingen", "Europe/Chisinau", "Europe/Copenhagen", "Europe/Dublin", "Europe/Gibraltar", "Europe/Guernsey", "Europe/Helsinki", "Europe/Isle_of_Man", "Europe/Istanbul", "Europe/Jersey", "Europe/Kaliningrad", "Europe/Kiev", "Europe/Kirov", "Europe/Lisbon", "Europe/Ljubljana", "Europe/London", "Europe/Luxembourg", "Europe/Madrid", "Europe/Malta", "Europe/Mariehamn", "Europe/Minsk", "Europe/Monaco", "Europe/Moscow", "Europe/Nicosia", "Europe/Oslo", "Europe/Paris", "Europe/Podgorica", "Europe/Prague", "Europe/Riga", "Europe/Rome", "Europe/Samara", "Europe/San_Marino", "Europe/Sarajevo", "Europe/Saratov", "Europe/Simferopol", "Europe/Skopje", "Europe/Sofia", "Europe/Stockholm", "Europe/Tallinn", "Europe/Tirane", "Europe/Tiraspol", "Europe/Ulyanovsk", "Europe/Uzhgorod", "Europe/Vaduz", "Europe/Vatican", "Europe/Vienna", "Europe/Vilnius", "Europe/Volgograd", "Europe/Warsaw", "Europe/Zagreb", "Europe/Zaporozhye", "Europe/Zurich", "GB", "GB-Eire", "GMT", "GMT+0", "GMT-0", "GMT0", "Greenwich", "HST", "Hongkong", "Iceland", "Indian/Antananarivo", "Indian/Chagos", "Indian/Christmas", "Indian/Cocos", "Indian/Comoro", "Indian/Kerguelen", "Indian/Mahe", "Indian/Maldives", "Indian/Mauritius", "Indian/Mayotte", "Indian/Reunion", "Iran", "Israel", "Jamaica", "Japan", "Kwajalein", "Libya", "MET", "MST", "MST7MDT", "Mexico/BajaNorte", "Mexico/BajaSur", "Mexico/General", "NZ", "NZ-CHAT", "Navajo", "PRC", "PST8PDT", "Pacific/Apia", "Pacific/Auckland", "Pacific/Bougainville", "Pacific/Chatham", "Pacific/Chuuk", "Pacific/Easter", "Pacific/Efate", "Pacific/Enderbury", "Pacific/Fakaofo", "Pacific/Fiji", "Pacific/Funafuti", "Pacific/Galapagos", "Pacific/Gambier", "Pacific/Guadalcanal", "Pacific/Guam", "Pacific/Honolulu", "Pacific/Johnston", "Pacific/Kiritimati", "Pacific/Kosrae", "Pacific/Kwajalein", "Pacific/Majuro", "Pacific/Marquesas", "Pacific/Midway", "Pacific/Nauru", "Pacific/Niue", "Pacific/Norfolk", "Pacific/Noumea", "Pacific/Pago_Pago", "Pacific/Palau", "Pacific/Pitcairn", "Pacific/Pohnpei", "Pacific/Ponape", "Pacific/Port_Moresby", "Pacific/Rarotonga", "Pacific/Saipan", "Pacific/Samoa", "Pacific/Tahiti", "Pacific/Tarawa", "Pacific/Tongatapu", "Pacific/Truk", "Pacific/Wake", "Pacific/Wallis", "Pacific/Yap", "Poland", "Portugal", "ROC", "ROK", "Singapore", "Turkey", "UCT", "US/Alaska", "US/Aleutian", "US/Arizona", "US/Central", "US/East-Indiana", "US/Eastern", "US/Hawaii", "US/Indiana-Starke", "US/Michigan", "US/Mountain", "US/Pacific", "US/Pacific-New", "US/Samoa", "UTC", "Universal", "W-SU", "WET", "Zulu" ] }, "dataPrivacySettings": { "type": "object", "properties": { "enabled": { "type": "boolean" }, "useAnalytics": { "type": "boolean" }, "useContactProfiles": { "type": "boolean" }, "useConversations": { "type": "boolean" }, "maskAnalytics": { "type": "boolean" }, "maskLogging": { "type": "boolean" }, "ignoreList": { "type": "array", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } } }, "type": "object" }, "IOrganisationPasswordPolicy_2_0": { "type": "object", "properties": { "minLength": { "type": "integer" }, "maxLength": { "type": "integer" }, "minAmountLowerCase": { "type": "integer" }, "minAmountUpperCase": { "type": "integer" }, "minAmountSpecialCharacters": { "type": "integer" }, "minAmountNumbers": { "type": "integer" }, "maxAmountIdenticalCharacters": { "type": "integer" }, "minAmountFailedAttemptsAutoDisable": { "type": "integer" } } }, "IOrganisationDataPrivacySettings_2_0": { "type": "object", "properties": { "enabled": { "type": "boolean" }, "useAnalytics": { "type": "boolean" }, "useContactProfiles": { "type": "boolean" }, "useConversations": { "type": "boolean" }, "maskAnalytics": { "type": "boolean" }, "maskLogging": { "type": "boolean" }, "ignoreList": { "type": "array", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } }, "IOrganisationIndexItem_2_0": { "type": "object", "properties": { "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "name": { "type": "string", "description": "The name of this organisation" }, "disabled": { "type": "boolean", "description": "Flag whether this organisation is currently disabled" }, "quotaMaxProjects": { "type": "number" }, "quotaMaxUsers": { "type": "number" }, "quotaMaxChannelsPerProject": { "type": "number" }, "quotaMaxMessagesPerDay": { "type": "number" }, "quotaMaxKnowledgeChunks": { "type": "number" }, "passwordPolicy": { "type": "object", "properties": { "minLength": { "type": "integer" }, "maxLength": { "type": "integer" }, "minAmountLowerCase": { "type": "integer" }, "minAmountUpperCase": { "type": "integer" }, "minAmountSpecialCharacters": { "type": "integer" }, "minAmountNumbers": { "type": "integer" }, "maxAmountIdenticalCharacters": { "type": "integer" }, "minAmountFailedAttemptsAutoDisable": { "type": "integer" } } }, "sessionStateTTLInMinutes": { "type": "number" }, "contactProfileTTLInMinutes": { "type": "number" }, "conversationTTLInMinutes": { "type": "number" }, "liveAgentAccount": { "type": "number" }, "billingTimezone": { "type": "string", "description": "Timezone according to IANA Timezone Database (2020a)", "example": "Europe/Berlin", "enum": [ "Africa/Abidjan", "Africa/Accra", "Africa/Addis_Ababa", "Africa/Algiers", "Africa/Asmara", "Africa/Asmera", "Africa/Bamako", "Africa/Bangui", "Africa/Banjul", "Africa/Bissau", "Africa/Blantyre", "Africa/Brazzaville", "Africa/Bujumbura", "Africa/Cairo", "Africa/Casablanca", "Africa/Ceuta", "Africa/Conakry", "Africa/Dakar", "Africa/Dar_es_Salaam", "Africa/Djibouti", "Africa/Douala", "Africa/El_Aaiun", "Africa/Freetown", "Africa/Gaborone", "Africa/Harare", "Africa/Johannesburg", "Africa/Juba", "Africa/Kampala", "Africa/Khartoum", "Africa/Kigali", "Africa/Kinshasa", "Africa/Lagos", "Africa/Libreville", "Africa/Lome", "Africa/Luanda", "Africa/Lubumbashi", "Africa/Lusaka", "Africa/Malabo", "Africa/Maputo", "Africa/Maseru", "Africa/Mbabane", "Africa/Mogadishu", "Africa/Monrovia", "Africa/Nairobi", "Africa/Ndjamena", "Africa/Niamey", "Africa/Nouakchott", "Africa/Ouagadougou", "Africa/Porto-Novo", "Africa/Sao_Tome", "Africa/Timbuktu", "Africa/Tripoli", "Africa/Tunis", "Africa/Windhoek", "America/Adak", "America/Anchorage", "America/Anguilla", "America/Antigua", "America/Araguaina", "America/Argentina/Buenos_Aires", "America/Argentina/Catamarca", "America/Argentina/ComodRivadavia", "America/Argentina/Cordoba", "America/Argentina/Jujuy", "America/Argentina/La_Rioja", "America/Argentina/Mendoza", "America/Argentina/Rio_Gallegos", "America/Argentina/Salta", "America/Argentina/San_Juan", "America/Argentina/San_Luis", "America/Argentina/Tucuman", "America/Argentina/Ushuaia", "America/Aruba", "America/Asuncion", "America/Atikokan", "America/Atka", "America/Bahia", "America/Bahia_Banderas", "America/Barbados", "America/Belem", "America/Belize", "America/Blanc-Sablon", "America/Boa_Vista", "America/Bogota", "America/Boise", "America/Buenos_Aires", "America/Cambridge_Bay", "America/Campo_Grande", "America/Cancun", "America/Caracas", "America/Catamarca", "America/Cayenne", "America/Cayman", "America/Chicago", "America/Chihuahua", "America/Coral_Harbour", "America/Cordoba", "America/Costa_Rica", "America/Creston", "America/Cuiaba", "America/Curacao", "America/Danmarkshavn", "America/Dawson", "America/Dawson_Creek", "America/Denver", "America/Detroit", "America/Dominica", "America/Edmonton", "America/Eirunepe", "America/El_Salvador", "America/Ensenada", "America/Fort_Nelson", "America/Fort_Wayne", "America/Fortaleza", "America/Glace_Bay", "America/Godthab", "America/Goose_Bay", "America/Grand_Turk", "America/Grenada", "America/Guadeloupe", "America/Guatemala", "America/Guayaquil", "America/Guyana", "America/Halifax", "America/Havana", "America/Hermosillo", "America/Indiana/Indianapolis", "America/Indiana/Knox", "America/Indiana/Marengo", "America/Indiana/Petersburg", "America/Indiana/Tell_City", "America/Indiana/Vevay", "America/Indiana/Vincennes", "America/Indiana/Winamac", "America/Indianapolis", "America/Inuvik", "America/Iqaluit", "America/Jamaica", "America/Jujuy", "America/Juneau", "America/Kentucky/Louisville", "America/Kentucky/Monticello", "America/Knox_IN", "America/Kralendijk", "America/La_Paz", "America/Lima", "America/Los_Angeles", "America/Louisville", "America/Lower_Princes", "America/Maceio", "America/Managua", "America/Manaus", "America/Marigot", "America/Martinique", "America/Matamoros", "America/Mazatlan", "America/Mendoza", "America/Menominee", "America/Merida", "America/Metlakatla", "America/Mexico_City", "America/Miquelon", "America/Moncton", "America/Monterrey", "America/Montevideo", "America/Montreal", "America/Montserrat", "America/Nassau", "America/New_York", "America/Nipigon", "America/Nome", "America/Noronha", "America/North_Dakota/Beulah", "America/North_Dakota/Center", "America/North_Dakota/New_Salem", "America/Ojinaga", "America/Panama", "America/Pangnirtung", "America/Paramaribo", "America/Phoenix", "America/Port-au-Prince", "America/Port_of_Spain", "America/Porto_Acre", "America/Porto_Velho", "America/Puerto_Rico", "America/Punta_Arenas", "America/Rainy_River", "America/Rankin_Inlet", "America/Recife", "America/Regina", "America/Resolute", "America/Rio_Branco", "America/Rosario", "America/Santa_Isabel", "America/Santarem", "America/Santiago", "America/Santo_Domingo", "America/Sao_Paulo", "America/Scoresbysund", "America/Shiprock", "America/Sitka", "America/St_Barthelemy", "America/St_Johns", "America/St_Kitts", "America/St_Lucia", "America/St_Thomas", "America/St_Vincent", "America/Swift_Current", "America/Tegucigalpa", "America/Thule", "America/Thunder_Bay", "America/Tijuana", "America/Toronto", "America/Tortola", "America/Vancouver", "America/Virgin", "America/Whitehorse", "America/Winnipeg", "America/Yakutat", "America/Yellowknife", "Antarctica/Casey", "Antarctica/Davis", "Antarctica/DumontDUrville", "Antarctica/Macquarie", "Antarctica/Mawson", "Antarctica/McMurdo", "Antarctica/Palmer", "Antarctica/Rothera", "Antarctica/South_Pole", "Antarctica/Syowa", "Antarctica/Troll", "Antarctica/Vostok", "Arctic/Longyearbyen", "Asia/Aden", "Asia/Almaty", "Asia/Amman", "Asia/Anadyr", "Asia/Aqtau", "Asia/Aqtobe", "Asia/Ashgabat", "Asia/Ashkhabad", "Asia/Atyrau", "Asia/Baghdad", "Asia/Bahrain", "Asia/Baku", "Asia/Bangkok", "Asia/Barnaul", "Asia/Beirut", "Asia/Bishkek", "Asia/Brunei", "Asia/Calcutta", "Asia/Chita", "Asia/Choibalsan", "Asia/Chongqing", "Asia/Chungking", "Asia/Colombo", "Asia/Dacca", "Asia/Damascus", "Asia/Dhaka", "Asia/Dili", "Asia/Dubai", "Asia/Dushanbe", "Asia/Famagusta", "Asia/Gaza", "Asia/Harbin", "Asia/Hebron", "Asia/Ho_Chi_Minh", "Asia/Hong_Kong", "Asia/Hovd", "Asia/Irkutsk", "Asia/Istanbul", "Asia/Jakarta", "Asia/Jayapura", "Asia/Jerusalem", "Asia/Kabul", "Asia/Kamchatka", "Asia/Karachi", "Asia/Kashgar", "Asia/Kathmandu", "Asia/Katmandu", "Asia/Khandyga", "Asia/Kolkata", "Asia/Krasnoyarsk", "Asia/Kuala_Lumpur", "Asia/Kuching", "Asia/Kuwait", "Asia/Macao", "Asia/Macau", "Asia/Magadan", "Asia/Makassar", "Asia/Manila", "Asia/Muscat", "Asia/Nicosia", "Asia/Novokuznetsk", "Asia/Novosibirsk", "Asia/Omsk", "Asia/Oral", "Asia/Phnom_Penh", "Asia/Pontianak", "Asia/Pyongyang", "Asia/Qatar", "Asia/Qyzylorda", "Asia/Rangoon", "Asia/Riyadh", "Asia/Saigon", "Asia/Sakhalin", "Asia/Samarkand", "Asia/Seoul", "Asia/Shanghai", "Asia/Singapore", "Asia/Srednekolymsk", "Asia/Taipei", "Asia/Tashkent", "Asia/Tbilisi", "Asia/Tehran", "Asia/Tel_Aviv", "Asia/Thimbu", "Asia/Thimphu", "Asia/Tokyo", "Asia/Tomsk", "Asia/Ujung_Pandang", "Asia/Ulaanbaatar", "Asia/Ulan_Bator", "Asia/Urumqi", "Asia/Ust-Nera", "Asia/Vientiane", "Asia/Vladivostok", "Asia/Yakutsk", "Asia/Yangon", "Asia/Yekaterinburg", "Asia/Yerevan", "Atlantic/Azores", "Atlantic/Bermuda", "Atlantic/Canary", "Atlantic/Cape_Verde", "Atlantic/Faeroe", "Atlantic/Faroe", "Atlantic/Jan_Mayen", "Atlantic/Madeira", "Atlantic/Reykjavik", "Atlantic/South_Georgia", "Atlantic/St_Helena", "Atlantic/Stanley", "Australia/ACT", "Australia/Adelaide", "Australia/Brisbane", "Australia/Broken_Hill", "Australia/Canberra", "Australia/Currie", "Australia/Darwin", "Australia/Eucla", "Australia/Hobart", "Australia/LHI", "Australia/Lindeman", "Australia/Lord_Howe", "Australia/Melbourne", "Australia/NSW", "Australia/North", "Australia/Perth", "Australia/Queensland", "Australia/South", "Australia/Sydney", "Australia/Tasmania", "Australia/Victoria", "Australia/West", "Australia/Yancowinna", "Brazil/Acre", "Brazil/DeNoronha", "Brazil/East", "Brazil/West", "CET", "CST6CDT", "Canada/Atlantic", "Canada/Central", "Canada/Eastern", "Canada/Mountain", "Canada/Newfoundland", "Canada/Pacific", "Canada/Saskatchewan", "Canada/Yukon", "Chile/Continental", "Chile/EasterIsland", "Cuba", "EET", "EST", "EST5EDT", "Egypt", "Eire", "Etc/GMT", "Etc/GMT+0", "Etc/GMT+1", "Etc/GMT+10", "Etc/GMT+11", "Etc/GMT+12", "Etc/GMT+2", "Etc/GMT+3", "Etc/GMT+4", "Etc/GMT+5", "Etc/GMT+6", "Etc/GMT+7", "Etc/GMT+8", "Etc/GMT+9", "Etc/GMT-0", "Etc/GMT-1", "Etc/GMT-10", "Etc/GMT-11", "Etc/GMT-12", "Etc/GMT-13", "Etc/GMT-14", "Etc/GMT-2", "Etc/GMT-3", "Etc/GMT-4", "Etc/GMT-5", "Etc/GMT-6", "Etc/GMT-7", "Etc/GMT-8", "Etc/GMT-9", "Etc/GMT0", "Etc/Greenwich", "Etc/UCT", "Etc/UTC", "Etc/Universal", "Etc/Zulu", "Europe/Amsterdam", "Europe/Andorra", "Europe/Astrakhan", "Europe/Athens", "Europe/Belfast", "Europe/Belgrade", "Europe/Berlin", "Europe/Bratislava", "Europe/Brussels", "Europe/Bucharest", "Europe/Budapest", "Europe/Busingen", "Europe/Chisinau", "Europe/Copenhagen", "Europe/Dublin", "Europe/Gibraltar", "Europe/Guernsey", "Europe/Helsinki", "Europe/Isle_of_Man", "Europe/Istanbul", "Europe/Jersey", "Europe/Kaliningrad", "Europe/Kiev", "Europe/Kirov", "Europe/Lisbon", "Europe/Ljubljana", "Europe/London", "Europe/Luxembourg", "Europe/Madrid", "Europe/Malta", "Europe/Mariehamn", "Europe/Minsk", "Europe/Monaco", "Europe/Moscow", "Europe/Nicosia", "Europe/Oslo", "Europe/Paris", "Europe/Podgorica", "Europe/Prague", "Europe/Riga", "Europe/Rome", "Europe/Samara", "Europe/San_Marino", "Europe/Sarajevo", "Europe/Saratov", "Europe/Simferopol", "Europe/Skopje", "Europe/Sofia", "Europe/Stockholm", "Europe/Tallinn", "Europe/Tirane", "Europe/Tiraspol", "Europe/Ulyanovsk", "Europe/Uzhgorod", "Europe/Vaduz", "Europe/Vatican", "Europe/Vienna", "Europe/Vilnius", "Europe/Volgograd", "Europe/Warsaw", "Europe/Zagreb", "Europe/Zaporozhye", "Europe/Zurich", "GB", "GB-Eire", "GMT", "GMT+0", "GMT-0", "GMT0", "Greenwich", "HST", "Hongkong", "Iceland", "Indian/Antananarivo", "Indian/Chagos", "Indian/Christmas", "Indian/Cocos", "Indian/Comoro", "Indian/Kerguelen", "Indian/Mahe", "Indian/Maldives", "Indian/Mauritius", "Indian/Mayotte", "Indian/Reunion", "Iran", "Israel", "Jamaica", "Japan", "Kwajalein", "Libya", "MET", "MST", "MST7MDT", "Mexico/BajaNorte", "Mexico/BajaSur", "Mexico/General", "NZ", "NZ-CHAT", "Navajo", "PRC", "PST8PDT", "Pacific/Apia", "Pacific/Auckland", "Pacific/Bougainville", "Pacific/Chatham", "Pacific/Chuuk", "Pacific/Easter", "Pacific/Efate", "Pacific/Enderbury", "Pacific/Fakaofo", "Pacific/Fiji", "Pacific/Funafuti", "Pacific/Galapagos", "Pacific/Gambier", "Pacific/Guadalcanal", "Pacific/Guam", "Pacific/Honolulu", "Pacific/Johnston", "Pacific/Kiritimati", "Pacific/Kosrae", "Pacific/Kwajalein", "Pacific/Majuro", "Pacific/Marquesas", "Pacific/Midway", "Pacific/Nauru", "Pacific/Niue", "Pacific/Norfolk", "Pacific/Noumea", "Pacific/Pago_Pago", "Pacific/Palau", "Pacific/Pitcairn", "Pacific/Pohnpei", "Pacific/Ponape", "Pacific/Port_Moresby", "Pacific/Rarotonga", "Pacific/Saipan", "Pacific/Samoa", "Pacific/Tahiti", "Pacific/Tarawa", "Pacific/Tongatapu", "Pacific/Truk", "Pacific/Wake", "Pacific/Wallis", "Pacific/Yap", "Poland", "Portugal", "ROC", "ROK", "Singapore", "Turkey", "UCT", "US/Alaska", "US/Aleutian", "US/Arizona", "US/Central", "US/East-Indiana", "US/Eastern", "US/Hawaii", "US/Indiana-Starke", "US/Michigan", "US/Mountain", "US/Pacific", "US/Pacific-New", "US/Samoa", "UTC", "Universal", "W-SU", "WET", "Zulu" ] }, "dataPrivacySettings": { "type": "object", "properties": { "enabled": { "type": "boolean" }, "useAnalytics": { "type": "boolean" }, "useContactProfiles": { "type": "boolean" }, "useConversations": { "type": "boolean" }, "maskAnalytics": { "type": "boolean" }, "maskLogging": { "type": "boolean" }, "ignoreList": { "type": "array", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } } } }, "IUserDataManagement_2_0": { "type": "object", "required": [ "id", "name", "password", "organisation" ], "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "password": { "type": "string" }, "organisation": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "roles": { "type": "array", "items": { "type": "string", "enum": [ "admin", "apiKeys", "base_role", "basicSupportUser", "fullSupportUser", "liveAgentAdmin", "liveAgentAgent", "liveAgentSupervisor", "odata", "projectAssigner", "projectManager", "userManager", "userDetailsViewer", "voiceGatewayUser" ] } }, "acceptedTOS": { "type": "boolean" }, "disabled": { "type": "boolean" } } }, "IUserUpdateDataManagement_2_0": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "acceptedTOS": { "type": "boolean" }, "disabled": { "type": "boolean" } } }, "IManagementUserAdditional_2_0": { "type": "object", "properties": { "newPassword": { "type": "string" } } }, "IManagementUserUpdate_2_0": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "acceptedTOS": { "type": "boolean" }, "disabled": { "type": "boolean" }, "newPassword": { "type": "string" } } }, "IUserManagement_2_0": { "type": "object", "required": [ "id", "name", "password", "organisation" ], "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "password": { "type": "string" }, "organisation": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "roles": { "type": "array", "items": { "type": "string", "enum": [ "admin", "apiKeys", "base_role", "basicSupportUser", "fullSupportUser", "liveAgentAdmin", "liveAgentAgent", "liveAgentSupervisor", "odata", "projectAssigner", "projectManager", "userManager", "userDetailsViewer", "voiceGatewayUser" ] } }, "acceptedTOS": { "type": "boolean" }, "disabled": { "type": "boolean" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" }, "IUserManagementIndexItem_2_0": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" }, "IVendor_2_0": { "type": "object", "properties": { "version": { "type": "string", "description": "The product version we are running" }, "frontendBaseUrl": { "type": "string", "description": "Base URL to the frontend UI" }, "hasLicenseAgreement": { "type": "string", "description": "Flag whether users need to agree the license agreement within this env" }, "maxContactProfileTTL": { "type": "number" }, "maxConversationTTL": { "type": "number" }, "maxSessionStateTTL": { "type": "number" } } }, "ICallCounterAggregatedValue_2_0": { "type": "object", "properties": { "calls": { "type": "number" }, "duration": { "type": "number" }, "concurrentCalls": { "type": "number" }, "day": { "type": "number" }, "month": { "type": "number" }, "year": { "type": "number" } } }, "IConversationCounterAggregatedValue_2_0": { "type": "object", "properties": { "conversations": { "type": "number" }, "day": { "type": "number" }, "month": { "type": "number" }, "year": { "type": "number" }, "channel": { "type": "string" } } }, "IConversationData_2_0": { "type": "object", "properties": { "projectId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "projectName": { "type": "string" }, "inputId": { "type": "string" }, "sessionId": { "type": "string" }, "contactId": { "type": "string" }, "organisation": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "inputText": { "type": "string" }, "inputData": { "type": "object" }, "type": { "type": "string", "example": "user", "enum": [ "input", "output" ] }, "source": { "type": "string", "example": "user", "enum": [ "user", "bot", "agent", "suggestion" ] }, "flowName": { "type": "string" }, "flowReferenceId": { "type": "string" }, "channel": { "type": "string", "example": "webchat2", "enum": [ "facebook", "alexa", "slack", "generic", "inject", "rest", "realtime", "socket", "adminconsole", "webchat2", "dialogflow", "twilio", "twilio-sms", "line", "intercom", "microsoftBotFramework", "microsoftTeams", "sunshineConversations", "admin-webchat", "avaya", "nonConversational", "voiceGateway2", "amazonLex", "workplace", "webhook", "abstractRest", "userlike", "ringCentralEngage", "audioCodes", "bandwidth", "whatsapp", "eightByEight", "genesysBotConnector", "niceCXOne", "agentAssistVoice", "webchat3" ] }, "timestamp": { "type": "object" }, "inHandoverRequest": { "type": "boolean" }, "inHandoverConversation": { "type": "boolean" }, "outputId": { "type": "string" }, "expiresAt": { "type": "object" }, "endpointUrlToken": { "type": "string" }, "endpointName": { "type": "string" }, "localeReferenceId": { "type": "string" }, "localeName": { "type": "string" }, "snapshotId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "snapshotName": { "type": "string" }, "rating": { "type": "number" }, "ratingComment": { "type": "string" } } }, "IConversationSession_2_0": { "type": "object", "properties": { "_id": { "type": "string" }, "contactId": { "type": "string" }, "channel": { "type": "string", "example": "webchat2", "enum": [ "facebook", "alexa", "slack", "generic", "inject", "rest", "realtime", "socket", "adminconsole", "webchat2", "dialogflow", "twilio", "twilio-sms", "line", "intercom", "microsoftBotFramework", "microsoftTeams", "sunshineConversations", "admin-webchat", "avaya", "nonConversational", "voiceGateway2", "amazonLex", "workplace", "webhook", "abstractRest", "userlike", "ringCentralEngage", "audioCodes", "bandwidth", "whatsapp", "eightByEight", "genesysBotConnector", "niceCXOne", "agentAssistVoice", "webchat3" ] }, "projectId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "projectName": { "type": "string" }, "flowName": { "type": "string" }, "messages": { "type": "integer" }, "startTime": { "type": "string" }, "endTime": { "type": "string" }, "ratings": { "type": "array", "items": { "type": "number" } }, "ratingComments": { "type": "array", "items": { "type": "string" } }, "endpointName": { "type": "string" } } }, "TAnalyticsSource_2_0": { "type": "string", "example": "user", "enum": [ "user", "bot", "agent", "suggestion" ] }, "TAnalyticsType_2_0": { "type": "string", "example": "user", "enum": [ "input", "output" ] }, "IKnowledgeQueryCounterAggregatedValue_2_0": { "type": "object", "properties": { "queries": { "type": "number" }, "day": { "type": "number" }, "month": { "type": "number" }, "year": { "type": "number" } } }, "ILogEntry_2_0": { "type": "object", "properties": { "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "timestamp": { "type": "string", "format": "date-time" }, "msg": { "type": "string" }, "meta": { "type": "object" }, "traceId": { "type": "string" } } }, "ILogEntryIndexItem_2_0": { "type": "object", "properties": { "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "timestamp": { "type": "string", "format": "date-time" }, "msg": { "type": "string" }, "meta": { "type": "object" }, "traceId": { "type": "string" } } }, "IProfileData_2_0": { "type": "object", "properties": { "profile": { "type": "object", "properties": { "prevent_data_collection": { "type": "boolean" }, "accepted_gdpr": { "type": "boolean" }, "privacy_policy": { "type": "object" }, "goals": { "type": "array", "items": { "type": "string", "example": "buyer" } }, "firstname": { "type": "string", "example": "Max" }, "lastname": { "type": "string", "example": "Mustermann" }, "email": { "type": "string", "format": "email" }, "profilepic": { "type": "string", "example": "" } } }, "active": { "type": "boolean" }, "contactIds": { "type": "array", "items": { "type": "string", "example": "mail@example.com" } } } }, "IProfile_2_0": { "type": "object", "properties": { "profile": { "type": "object", "properties": { "prevent_data_collection": { "type": "boolean" }, "accepted_gdpr": { "type": "boolean" }, "privacy_policy": { "type": "object" }, "goals": { "type": "array", "items": { "type": "string", "example": "buyer" } }, "firstname": { "type": "string", "example": "Max" }, "lastname": { "type": "string", "example": "Mustermann" }, "email": { "type": "string", "format": "email" }, "profilepic": { "type": "string", "example": "" } } }, "active": { "type": "boolean" }, "contactIds": { "type": "array", "items": { "type": "string", "example": "mail@example.com" } }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" }, "IFlattenedProfile_2_0": { "type": "object", "properties": { "prevent_data_collection": { "type": "boolean" }, "accepted_gdpr": { "type": "boolean" }, "privacy_policy": { "type": "object" }, "goals": { "type": "array", "items": { "type": "string", "example": "buyer" } }, "firstname": { "type": "string", "example": "Max" }, "lastname": { "type": "string", "example": "Mustermann" }, "email": { "type": "string", "format": "email" }, "profilepic": { "type": "string", "example": "" } } }, "IProfileIndexItem_2_0": { "type": "object", "properties": { "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "profile": { "type": "object", "properties": { "prevent_data_collection": { "type": "boolean" }, "accepted_gdpr": { "type": "boolean" }, "privacy_policy": { "type": "object" }, "goals": { "type": "array", "items": { "type": "string", "example": "buyer" } }, "firstname": { "type": "string", "example": "Max" }, "lastname": { "type": "string", "example": "Mustermann" }, "email": { "type": "string", "format": "email" }, "profilepic": { "type": "string", "example": "" } } }, "active": { "type": "boolean" }, "contactIds": { "type": "array", "items": { "type": "string" } }, "lastChanged": { "type": "number" }, "projectId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } }, "IProfileSchemaData_2_0": { "type": "object", "properties": { "schema": { "type": "object" }, "details": { "type": "array", "items": { "type": "object", "properties": { "field": { "type": "string" }, "internal": { "type": "string" }, "type": { "type": "string", "enum": [ "string", "object", "number", "boolean" ] } } } } } }, "IProfileSchema_2_0": { "type": "object", "properties": { "profile": { "type": "object", "properties": { "prevent_data_collection": { "type": "boolean" }, "accepted_gdpr": { "type": "boolean" }, "privacy_policy": { "type": "object" }, "goals": { "type": "array", "items": { "type": "string", "example": "buyer" } }, "firstname": { "type": "string", "example": "Max" }, "lastname": { "type": "string", "example": "Mustermann" }, "email": { "type": "string", "format": "email" }, "profilepic": { "type": "string", "example": "" } } }, "active": { "type": "boolean" }, "contactIds": { "type": "array", "items": { "type": "string", "example": "mail@example.com" } } } }, "IProfileSchemaEntry_2_0": { "type": "object", "properties": { "field": { "type": "string" }, "internal": { "type": "string" }, "type": { "type": "string", "enum": [ "string", "object", "number", "boolean" ] } } }, "ITaskData_2_0": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the task" }, "data": { "type": "object", "description": "The parameters of the task" }, "status": { "type": "string", "description": "The status of the task", "example": "queued", "enum": [ "queued", "active", "done", "cancelling", "cancelled", "error" ] }, "currentStep": { "type": "integer" }, "totalStep": { "type": "integer" }, "failReason": { "type": "string" }, "lastRunAt": { "type": "string", "format": "date-time" }, "lastFinishedAt": { "type": "string", "format": "date-time" } } }, "ITask_2_0": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the task" }, "data": { "type": "object", "description": "The parameters of the task" }, "status": { "type": "string", "description": "The status of the task", "example": "queued", "enum": [ "queued", "active", "done", "cancelling", "cancelled", "error" ] }, "currentStep": { "type": "integer" }, "totalStep": { "type": "integer" }, "failReason": { "type": "string" }, "lastRunAt": { "type": "string", "format": "date-time" }, "lastFinishedAt": { "type": "string", "format": "date-time" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" }, "TTaskStatus_2_0": { "type": "string", "description": "The status of the task", "example": "queued", "enum": [ "queued", "active", "done", "cancelling", "cancelled", "error" ] }, "ICreatedTask_2_0": { "type": "object", "properties": { "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "status": { "type": "string", "description": "The status of the task", "example": "queued", "enum": [ "queued", "active", "done", "cancelling", "cancelled", "error" ] }, "type": { "type": "string", "example": "trainIntents" }, "parameters": { "type": "object" }, "lastChangedAt": { "type": "number", "example": 1594243850 }, "lastCreatedAt": { "type": "number", "example": 1594243850 }, "currentStep": { "type": "integer", "example": 0 }, "totalStep": { "type": "integer", "example": 100 } } }, "ITaskIndexItemData_2_0": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the task" }, "data": { "type": "object", "description": "The parameters of the task" }, "status": { "type": "string", "enum": [ "queued", "active", "done", "cancelling", "cancelled", "error" ] }, "currentStep": { "type": "integer" }, "lastRunAt": { "type": "string", "format": "date-time" }, "lastFinishedAt": { "type": "string", "format": "date-time" }, "totalStep": { "type": "integer" }, "failReason": { "type": "string" } } }, "ITaskIndexItem_2_0": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the task" }, "data": { "type": "object", "description": "The parameters of the task" }, "status": { "type": "string", "description": "The status of the task", "example": "queued", "enum": [ "queued", "active", "done", "cancelling", "cancelled", "error" ] }, "currentStep": { "type": "integer" }, "totalStep": { "type": "integer" }, "failReason": { "type": "string" }, "lastRunAt": { "type": "string", "format": "date-time" }, "lastFinishedAt": { "type": "string", "format": "date-time" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" }, "ITaskData_2_1": { "type": "object", "properties": { "type": { "type": "string", "description": "The name of the task" }, "data": { "type": "object", "description": "The parameters of the task" }, "status": { "type": "string", "description": "The status of the task", "example": "queued", "enum": [ "queued", "active", "done", "cancelling", "cancelled", "error" ] }, "progress": { "type": "integer", "minimum": 0, "maximum": 100 }, "runAt": { "type": "string", "format": "date-time" }, "finishedAt": { "type": "string", "format": "date-time" }, "failReason": { "type": "string" }, "failedAt": { "type": "string", "format": "date-time" } } }, "ITask_2_1": { "type": "object", "properties": { "type": { "type": "string", "description": "The name of the task" }, "data": { "type": "object", "description": "The parameters of the task" }, "status": { "type": "string", "description": "The status of the task", "example": "queued", "enum": [ "queued", "active", "done", "cancelling", "cancelled", "error" ] }, "progress": { "type": "integer", "minimum": 0, "maximum": 100 }, "runAt": { "type": "string", "format": "date-time" }, "finishedAt": { "type": "string", "format": "date-time" }, "failReason": { "type": "string" }, "failedAt": { "type": "string", "format": "date-time" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" }, "TTaskStatus_2_1": { "type": "string", "description": "The status of the task", "example": "queued", "enum": [ "queued", "active", "done", "cancelling", "cancelled", "error" ] }, "ICreatedTask_2_1": { "type": "object", "properties": { "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "status": { "type": "string", "description": "The status of the task", "example": "queued", "enum": [ "queued", "active", "done", "cancelling", "cancelled", "error" ] }, "type": { "type": "string", "example": "trainIntents" }, "parameters": { "type": "object" }, "lastChangedAt": { "type": "number", "example": 1594243850 }, "lastCreatedAt": { "type": "number", "example": 1594243850 }, "progress": { "type": "integer", "example": 0 } } }, "ITaskIndexItemData_2_1": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the task" }, "data": { "type": "object", "description": "The parameters of the task" }, "status": { "type": "string", "enum": [ "queued", "active", "done", "cancelling", "cancelled", "error" ] }, "progress": { "type": "integer", "minimum": 0, "maximum": 100 }, "runAt": { "type": "string", "format": "date-time" }, "finishedAt": { "type": "string", "format": "date-time" }, "failReason": { "type": "string" }, "failedAt": { "type": "string", "format": "date-time" } } }, "ITaskIndexItem_2_1": { "type": "object", "properties": { "type": { "type": "string", "description": "The name of the task" }, "data": { "type": "object", "description": "The parameters of the task" }, "status": { "type": "string", "description": "The status of the task", "example": "queued", "enum": [ "queued", "active", "done", "cancelling", "cancelled", "error" ] }, "progress": { "type": "integer", "minimum": 0, "maximum": 100 }, "runAt": { "type": "string", "format": "date-time" }, "finishedAt": { "type": "string", "format": "date-time" }, "failReason": { "type": "string" }, "failedAt": { "type": "string", "format": "date-time" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" }, "ITrainerRecordData_2_0": { "type": "object", "properties": { "text": { "type": "string", "description": "The text of the user", "example": "I want a Pizza" }, "count": { "type": "number", "description": "How often the text was used as an input", "example": 2 }, "flowReferenceId": { "type": "string", "format": "uuid" }, "handled": { "type": "boolean" }, "handleAction": { "type": "string", "enum": [ "addedToIntent", "skip", "ignored" ] }, "nlu": { "type": "object", "description": "The last NLU object that was created (from InputObject) based on the message" }, "meta": { "type": "object" }, "snapshotReference": { "type": "string", "description": "Reference to a snapshot in case this record was created because a user talked to a snapshot" } } }, "ITrainerRecord_2_0": { "type": "object", "properties": { "text": { "type": "string", "description": "The text of the user", "example": "I want a Pizza" }, "count": { "type": "number", "description": "How often the text was used as an input", "example": 2 }, "flowReferenceId": { "type": "string", "format": "uuid" }, "handled": { "type": "boolean" }, "handleAction": { "type": "string", "enum": [ "addedToIntent", "skip", "ignored" ] }, "nlu": { "type": "object", "description": "The last NLU object that was created (from InputObject) based on the message" }, "meta": { "type": "object" }, "snapshotReference": { "type": "string", "description": "Reference to a snapshot in case this record was created because a user talked to a snapshot" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" }, "ITrainerRecordIndexItem_2_0": { "type": "object", "properties": { "text": { "type": "string", "description": "The text of the user", "example": "I want a Pizza" }, "count": { "type": "number", "description": "How often the text was used as an input", "example": 2 }, "flowReferenceId": { "type": "string", "format": "uuid" }, "handled": { "type": "boolean" }, "handleAction": { "type": "string", "enum": [ "addedToIntent", "skip", "ignored" ] }, "nlu": { "type": "object", "description": "The last NLU object that was created (from InputObject) based on the message" }, "meta": { "type": "object" }, "snapshotReference": { "type": "string", "description": "Reference to a snapshot in case this record was created because a user talked to a snapshot" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" }, "IGenerateNluScoreData_2_0": { "type": "object", "required": [ "flowReferenceId", "localeReferenceId", "sentence" ], "properties": { "flowReferenceId": { "type": "string", "format": "uuid", "description": "UUID of the flow reference." }, "localeReferenceId": { "type": "string", "format": "uuid", "description": "UUID of the locale reference." }, "sentence": { "type": "string", "description": "Sentence to analyze for NLU scoring." } } }, "IGeneratedNluScore_2_0": { "type": "object", "properties": { "id": { "type": "string", "description": "Unique identifier of the score." }, "name": { "type": "string", "description": "Name of the score type." }, "score": { "type": "number", "description": "Numerical value of the score." }, "negated": { "type": "boolean", "description": "Indicates if the score is negated." }, "confirmationSentence": { "type": "string", "description": "Sentence used to confirm the score." }, "confirmationSentences": { "type": "array", "items": { "type": "string" }, "description": "Multiple sentences for confirmation if applicable." }, "disambiguationSentence": { "type": "string", "description": "Sentence used for disambiguation." }, "flow": { "type": "string", "description": "UUID of the flow associated with the score." } } }, "IAgentAssistGridConfig_2_0": { "type": "object", "properties": { "grid": { "type": "object", "properties": { "columns": { "type": "number", "description": "Number of columns in the grid." }, "rows": { "type": "number", "description": "Number of rows in the grid." }, "gap": { "type": "number", "description": "Padding between tiles in pixels. The default value is 10. If you set it to 0, the default will be used." } } }, "tiles": { "type": "object", "properties": { "tile-id": { "type": "object", "description": "The Tile ID is used in the Flow Nodes to fill in this specific tile.", "properties": { "x": { "type": "number", "description": "The row number where the tile is located, starting from 1." }, "y": { "type": "number", "description": "The column number where the tile is located, starting from 1." }, "columns": { "type": "number", "description": "The number of columns the tile should occupy. The default value is 1." }, "rows": { "type": "number", "description": "The number of rows the tile should occupy. The default value is 1." } } } } } } }, "IAgentAssistConfigData_2_0": { "type": "object", "properties": { "name": { "type": "string", "description": "The human readable name of the config." }, "description": { "type": "string", "description": "The description which can be used to understand what the agent assist config contains in terms of tiles." }, "config": { "type": "object", "description": "The actual grid-config.", "properties": { "grid": { "type": "object", "properties": { "columns": { "type": "number", "description": "Number of columns in the grid." }, "rows": { "type": "number", "description": "Number of rows in the grid." }, "gap": { "type": "number", "description": "Padding between tiles in pixels. The default value is 10. If you set it to 0, the default will be used." } } }, "tiles": { "type": "object", "properties": { "tile-id": { "type": "object", "description": "The Tile ID is used in the Flow Nodes to fill in this specific tile.", "properties": { "x": { "type": "number", "description": "The row number where the tile is located, starting from 1." }, "y": { "type": "number", "description": "The column number where the tile is located, starting from 1." }, "columns": { "type": "number", "description": "The number of columns the tile should occupy. The default value is 1." }, "rows": { "type": "number", "description": "The number of rows the tile should occupy. The default value is 1." } } } } } } } } }, "IAgentAssistConfigGeneratedData_2_0": { "type": "object", "properties": { "referenceId": { "type": "string", "format": "uuid" } } }, "IAgentAssistConfig_2_0": { "type": "object", "properties": { "name": { "type": "string", "description": "The human readable name of the config." }, "description": { "type": "string", "description": "The description which can be used to understand what the agent assist config contains in terms of tiles." }, "config": { "type": "object", "description": "The actual grid-config.", "properties": { "grid": { "type": "object", "properties": { "columns": { "type": "number", "description": "Number of columns in the grid." }, "rows": { "type": "number", "description": "Number of rows in the grid." }, "gap": { "type": "number", "description": "Padding between tiles in pixels. The default value is 10. If you set it to 0, the default will be used." } } }, "tiles": { "type": "object", "properties": { "tile-id": { "type": "object", "description": "The Tile ID is used in the Flow Nodes to fill in this specific tile.", "properties": { "x": { "type": "number", "description": "The row number where the tile is located, starting from 1." }, "y": { "type": "number", "description": "The column number where the tile is located, starting from 1." }, "columns": { "type": "number", "description": "The number of columns the tile should occupy. The default value is 1." }, "rows": { "type": "number", "description": "The number of rows the tile should occupy. The default value is 1." } } } } } } }, "referenceId": { "type": "string", "format": "uuid" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" }, "IChart_2_0": { "type": "object", "properties": { "nodes": { "type": "array", "items": { "type": "object", "properties": { "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "type": { "type": "string", "example": "if" }, "referenceId": { "type": "string", "format": "uuid" }, "extension": { "type": "string", "example": "@cognigy/basic-nodes" }, "label": { "type": "string", "example": "A new Node" }, "analyticsLabel": { "type": "string", "example": "Step name" }, "comment": { "type": "string", "example": "this is a very important node" }, "commentColor": { "oneOf": [ { "oneOf": [ { "type": "string", "pattern": "^#(?:[0-9a-fA-F]{3}){1,2}$", "example": "#ff8a80" }, { "type": "string", "example": "none", "enum": [ "aliceBlue", "antiqueWhite", "aqua", "aquamarine", "azure", "beige", "bisque", "black", "blanchedAlmond", "blue", "blueViolet", "brown", "burlyWood", "cadetBlue", "chartreuse", "chocolate", "coral", "cornflowerBlue", "cornsilk", "crimson", "cyan", "darkBlue", "darkCyan", "darkGoldenRod", "darkGray", "darkGrey", "darkGreen", "darkKhaki", "darkMagenta", "darkOliveGreen", "darkOrange", "darkOrchid", "darkRed", "darkSalmon", "darkSeaGreen", "darkSlateBlue", "darkSlateGray", "darkSlateGrey", "darkTurquoise", "darkViolet", "deepPink", "deepSkyBlue", "dimGray", "dimGrey", "dodgerBlue", "fireBrick", "floralWhite", "forestGreen", "fuchsia", "gainsboro", "ghostWhite", "gold", "goldenRod", "gray", "grey", "green", "greenYellow", "honeyDew", "hotPink", "indianRed", "indigo", "ivory", "khaki", "lavender", "lavenderBlush", "lawnGreen", "lemonChiffon", "lightBlue", "lightCoral", "lightCyan", "lightGoldenRodYellow", "lightGray", "lightGrey", "lightGreen", "lightPink", "lightSalmon", "lightSeaGreen", "lightSkyBlue", "lightSlateGray", "lightSlateGrey", "lightSteelBlue", "lightYellow", "lime", "limeGreen", "linen", "magenta", "maroon", "mediumAquaMarine", "mediumBlue", "mediumOrchid", "mediumPurple", "mediumSeaGreen", "mediumSlateBlue", "mediumSpringGreen", "mediumTurquoise", "mediumVioletRed", "midnightBlue", "mintCream", "mistyRose", "moccasin", "navajoWhite", "navy", "oldLace", "olive", "oliveDrab", "orange", "orangeRed", "orchid", "paleGoldenRod", "paleGreen", "paleTurquoise", "paleVioletRed", "papayaWhip", "peachPuff", "peru", "pink", "plum", "powderBlue", "purple", "rebeccaPurple", "red", "rosyBrown", "royalBlue", "saddleBrown", "salmon", "sandyBrown", "seaGreen", "seaShell", "sienna", "silver", "skyBlue", "slateBlue", "slateGray", "slateGrey", "snow", "springGreen", "steelBlue", "tan", "teal", "thistle", "tomato", "turquoise", "violet", "wheat", "white", "whiteSmoke", "yellow", "yellowGreen", "none", "transparent" ] } ] }, { "type": "string", "nullable": false, "enum": [ "" ] } ] }, "isCollapsed": { "type": "boolean", "example": false }, "isEntryPoint": { "type": "boolean", "example": false }, "isDisabled": { "type": "boolean", "example": false } } } }, "relations": { "type": "array", "items": { "type": "object", "properties": { "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "node": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "children": { "type": "array", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "next": { "oneOf": [ { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, { "nullable": true } ] } } } } } }, "IChartNodeData_2_0": { "type": "object", "properties": { "type": { "type": "string", "example": "if", "description": "Type of the Node" }, "extension": { "type": "string", "example": "@cognigy/basic-nodes", "enum": [ "@cognigy/basic-nodes", "@cognigy/mongodb", "@cognigy/mssql", "@cognigy/smtp", "@cognigy/voicegateway", "@cognigy/microsoft", "@cognigy/voiceGateway2" ] }, "label": { "type": "string", "example": "A new Node", "description": "Replaces the default name of the Node displayed in the Flow Editor." }, "comment": { "type": "string", "example": "this is a very important node", "description": "Adds additional information about Nodes, for example, a specific of the Node." }, "commentColor": { "oneOf": [ { "oneOf": [ { "type": "string", "pattern": "^#(?:[0-9a-fA-F]{3}){1,2}$", "example": "#ff8a80" }, { "type": "string", "example": "none", "enum": [ "aliceBlue", "antiqueWhite", "aqua", "aquamarine", "azure", "beige", "bisque", "black", "blanchedAlmond", "blue", "blueViolet", "brown", "burlyWood", "cadetBlue", "chartreuse", "chocolate", "coral", "cornflowerBlue", "cornsilk", "crimson", "cyan", "darkBlue", "darkCyan", "darkGoldenRod", "darkGray", "darkGrey", "darkGreen", "darkKhaki", "darkMagenta", "darkOliveGreen", "darkOrange", "darkOrchid", "darkRed", "darkSalmon", "darkSeaGreen", "darkSlateBlue", "darkSlateGray", "darkSlateGrey", "darkTurquoise", "darkViolet", "deepPink", "deepSkyBlue", "dimGray", "dimGrey", "dodgerBlue", "fireBrick", "floralWhite", "forestGreen", "fuchsia", "gainsboro", "ghostWhite", "gold", "goldenRod", "gray", "grey", "green", "greenYellow", "honeyDew", "hotPink", "indianRed", "indigo", "ivory", "khaki", "lavender", "lavenderBlush", "lawnGreen", "lemonChiffon", "lightBlue", "lightCoral", "lightCyan", "lightGoldenRodYellow", "lightGray", "lightGrey", "lightGreen", "lightPink", "lightSalmon", "lightSeaGreen", "lightSkyBlue", "lightSlateGray", "lightSlateGrey", "lightSteelBlue", "lightYellow", "lime", "limeGreen", "linen", "magenta", "maroon", "mediumAquaMarine", "mediumBlue", "mediumOrchid", "mediumPurple", "mediumSeaGreen", "mediumSlateBlue", "mediumSpringGreen", "mediumTurquoise", "mediumVioletRed", "midnightBlue", "mintCream", "mistyRose", "moccasin", "navajoWhite", "navy", "oldLace", "olive", "oliveDrab", "orange", "orangeRed", "orchid", "paleGoldenRod", "paleGreen", "paleTurquoise", "paleVioletRed", "papayaWhip", "peachPuff", "peru", "pink", "plum", "powderBlue", "purple", "rebeccaPurple", "red", "rosyBrown", "royalBlue", "saddleBrown", "salmon", "sandyBrown", "seaGreen", "seaShell", "sienna", "silver", "skyBlue", "slateBlue", "slateGray", "slateGrey", "snow", "springGreen", "steelBlue", "tan", "teal", "thistle", "tomato", "turquoise", "violet", "wheat", "white", "whiteSmoke", "yellow", "yellowGreen", "none", "transparent" ] } ] }, { "type": "string", "nullable": false, "enum": [ "" ] } ] }, "isEntryPoint": { "type": "boolean", "example": false }, "isDisabled": { "type": "boolean", "example": false }, "config": { "type": "object", "example": { "condition": { "type": "rule", "condition": "", "rule": { "left": "1", "operand": "gt", "right": "2" } } } }, "localeReference": { "type": "string", "example": "63bd8ebb648e6e739f1bbd82" }, "analyticsLabel": { "type": "string", "example": "condition" } } }, "IChartNode_2_0": { "type": "object", "properties": { "type": { "type": "string", "example": "if", "description": "Type of the Node" }, "extension": { "type": "string", "example": "@cognigy/basic-nodes", "enum": [ "@cognigy/basic-nodes", "@cognigy/mongodb", "@cognigy/mssql", "@cognigy/smtp", "@cognigy/voicegateway", "@cognigy/microsoft", "@cognigy/voiceGateway2" ] }, "label": { "type": "string", "example": "A new Node", "description": "Replaces the default name of the Node displayed in the Flow Editor." }, "comment": { "type": "string", "example": "this is a very important node", "description": "Adds additional information about Nodes, for example, a specific of the Node." }, "commentColor": { "oneOf": [ { "oneOf": [ { "type": "string", "pattern": "^#(?:[0-9a-fA-F]{3}){1,2}$", "example": "#ff8a80" }, { "type": "string", "example": "none", "enum": [ "aliceBlue", "antiqueWhite", "aqua", "aquamarine", "azure", "beige", "bisque", "black", "blanchedAlmond", "blue", "blueViolet", "brown", "burlyWood", "cadetBlue", "chartreuse", "chocolate", "coral", "cornflowerBlue", "cornsilk", "crimson", "cyan", "darkBlue", "darkCyan", "darkGoldenRod", "darkGray", "darkGrey", "darkGreen", "darkKhaki", "darkMagenta", "darkOliveGreen", "darkOrange", "darkOrchid", "darkRed", "darkSalmon", "darkSeaGreen", "darkSlateBlue", "darkSlateGray", "darkSlateGrey", "darkTurquoise", "darkViolet", "deepPink", "deepSkyBlue", "dimGray", "dimGrey", "dodgerBlue", "fireBrick", "floralWhite", "forestGreen", "fuchsia", "gainsboro", "ghostWhite", "gold", "goldenRod", "gray", "grey", "green", "greenYellow", "honeyDew", "hotPink", "indianRed", "indigo", "ivory", "khaki", "lavender", "lavenderBlush", "lawnGreen", "lemonChiffon", "lightBlue", "lightCoral", "lightCyan", "lightGoldenRodYellow", "lightGray", "lightGrey", "lightGreen", "lightPink", "lightSalmon", "lightSeaGreen", "lightSkyBlue", "lightSlateGray", "lightSlateGrey", "lightSteelBlue", "lightYellow", "lime", "limeGreen", "linen", "magenta", "maroon", "mediumAquaMarine", "mediumBlue", "mediumOrchid", "mediumPurple", "mediumSeaGreen", "mediumSlateBlue", "mediumSpringGreen", "mediumTurquoise", "mediumVioletRed", "midnightBlue", "mintCream", "mistyRose", "moccasin", "navajoWhite", "navy", "oldLace", "olive", "oliveDrab", "orange", "orangeRed", "orchid", "paleGoldenRod", "paleGreen", "paleTurquoise", "paleVioletRed", "papayaWhip", "peachPuff", "peru", "pink", "plum", "powderBlue", "purple", "rebeccaPurple", "red", "rosyBrown", "royalBlue", "saddleBrown", "salmon", "sandyBrown", "seaGreen", "seaShell", "sienna", "silver", "skyBlue", "slateBlue", "slateGray", "slateGrey", "snow", "springGreen", "steelBlue", "tan", "teal", "thistle", "tomato", "turquoise", "violet", "wheat", "white", "whiteSmoke", "yellow", "yellowGreen", "none", "transparent" ] } ] }, { "type": "string", "nullable": false, "enum": [ "" ] } ] }, "isEntryPoint": { "type": "boolean", "example": false }, "isDisabled": { "type": "boolean", "example": false }, "config": { "type": "object", "example": { "condition": { "type": "rule", "condition": "", "rule": { "left": "1", "operand": "gt", "right": "2" } } } }, "localeReference": { "type": "string", "example": "63bd8ebb648e6e739f1bbd82" }, "analyticsLabel": { "type": "string", "example": "condition" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } }, "IChartNodeIndexItemData_2_0": { "type": "object", "properties": { "type": { "type": "string", "example": "if" }, "referenceId": { "type": "string", "format": "uuid" }, "extension": { "type": "string", "example": "@cognigy/basic-nodes" }, "label": { "type": "string", "example": "A new Node" }, "analyticsLabel": { "type": "string", "example": "Step name" }, "comment": { "type": "string", "example": "this is a very important node" }, "commentColor": { "oneOf": [ { "oneOf": [ { "type": "string", "pattern": "^#(?:[0-9a-fA-F]{3}){1,2}$", "example": "#ff8a80" }, { "type": "string", "example": "none", "enum": [ "aliceBlue", "antiqueWhite", "aqua", "aquamarine", "azure", "beige", "bisque", "black", "blanchedAlmond", "blue", "blueViolet", "brown", "burlyWood", "cadetBlue", "chartreuse", "chocolate", "coral", "cornflowerBlue", "cornsilk", "crimson", "cyan", "darkBlue", "darkCyan", "darkGoldenRod", "darkGray", "darkGrey", "darkGreen", "darkKhaki", "darkMagenta", "darkOliveGreen", "darkOrange", "darkOrchid", "darkRed", "darkSalmon", "darkSeaGreen", "darkSlateBlue", "darkSlateGray", "darkSlateGrey", "darkTurquoise", "darkViolet", "deepPink", "deepSkyBlue", "dimGray", "dimGrey", "dodgerBlue", "fireBrick", "floralWhite", "forestGreen", "fuchsia", "gainsboro", "ghostWhite", "gold", "goldenRod", "gray", "grey", "green", "greenYellow", "honeyDew", "hotPink", "indianRed", "indigo", "ivory", "khaki", "lavender", "lavenderBlush", "lawnGreen", "lemonChiffon", "lightBlue", "lightCoral", "lightCyan", "lightGoldenRodYellow", "lightGray", "lightGrey", "lightGreen", "lightPink", "lightSalmon", "lightSeaGreen", "lightSkyBlue", "lightSlateGray", "lightSlateGrey", "lightSteelBlue", "lightYellow", "lime", "limeGreen", "linen", "magenta", "maroon", "mediumAquaMarine", "mediumBlue", "mediumOrchid", "mediumPurple", "mediumSeaGreen", "mediumSlateBlue", "mediumSpringGreen", "mediumTurquoise", "mediumVioletRed", "midnightBlue", "mintCream", "mistyRose", "moccasin", "navajoWhite", "navy", "oldLace", "olive", "oliveDrab", "orange", "orangeRed", "orchid", "paleGoldenRod", "paleGreen", "paleTurquoise", "paleVioletRed", "papayaWhip", "peachPuff", "peru", "pink", "plum", "powderBlue", "purple", "rebeccaPurple", "red", "rosyBrown", "royalBlue", "saddleBrown", "salmon", "sandyBrown", "seaGreen", "seaShell", "sienna", "silver", "skyBlue", "slateBlue", "slateGray", "slateGrey", "snow", "springGreen", "steelBlue", "tan", "teal", "thistle", "tomato", "turquoise", "violet", "wheat", "white", "whiteSmoke", "yellow", "yellowGreen", "none", "transparent" ] } ] }, { "type": "string", "nullable": false, "enum": [ "" ] } ] }, "isCollapsed": { "type": "boolean", "example": false }, "isEntryPoint": { "type": "boolean", "example": false }, "isDisabled": { "type": "boolean", "example": false } } }, "IChartNodeIndexItem_2_0": { "type": "object", "properties": { "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "type": { "type": "string", "example": "if" }, "referenceId": { "type": "string", "format": "uuid" }, "extension": { "type": "string", "example": "@cognigy/basic-nodes" }, "label": { "type": "string", "example": "A new Node" }, "analyticsLabel": { "type": "string", "example": "Step name" }, "comment": { "type": "string", "example": "this is a very important node" }, "commentColor": { "oneOf": [ { "oneOf": [ { "type": "string", "pattern": "^#(?:[0-9a-fA-F]{3}){1,2}$", "example": "#ff8a80" }, { "type": "string", "example": "none", "enum": [ "aliceBlue", "antiqueWhite", "aqua", "aquamarine", "azure", "beige", "bisque", "black", "blanchedAlmond", "blue", "blueViolet", "brown", "burlyWood", "cadetBlue", "chartreuse", "chocolate", "coral", "cornflowerBlue", "cornsilk", "crimson", "cyan", "darkBlue", "darkCyan", "darkGoldenRod", "darkGray", "darkGrey", "darkGreen", "darkKhaki", "darkMagenta", "darkOliveGreen", "darkOrange", "darkOrchid", "darkRed", "darkSalmon", "darkSeaGreen", "darkSlateBlue", "darkSlateGray", "darkSlateGrey", "darkTurquoise", "darkViolet", "deepPink", "deepSkyBlue", "dimGray", "dimGrey", "dodgerBlue", "fireBrick", "floralWhite", "forestGreen", "fuchsia", "gainsboro", "ghostWhite", "gold", "goldenRod", "gray", "grey", "green", "greenYellow", "honeyDew", "hotPink", "indianRed", "indigo", "ivory", "khaki", "lavender", "lavenderBlush", "lawnGreen", "lemonChiffon", "lightBlue", "lightCoral", "lightCyan", "lightGoldenRodYellow", "lightGray", "lightGrey", "lightGreen", "lightPink", "lightSalmon", "lightSeaGreen", "lightSkyBlue", "lightSlateGray", "lightSlateGrey", "lightSteelBlue", "lightYellow", "lime", "limeGreen", "linen", "magenta", "maroon", "mediumAquaMarine", "mediumBlue", "mediumOrchid", "mediumPurple", "mediumSeaGreen", "mediumSlateBlue", "mediumSpringGreen", "mediumTurquoise", "mediumVioletRed", "midnightBlue", "mintCream", "mistyRose", "moccasin", "navajoWhite", "navy", "oldLace", "olive", "oliveDrab", "orange", "orangeRed", "orchid", "paleGoldenRod", "paleGreen", "paleTurquoise", "paleVioletRed", "papayaWhip", "peachPuff", "peru", "pink", "plum", "powderBlue", "purple", "rebeccaPurple", "red", "rosyBrown", "royalBlue", "saddleBrown", "salmon", "sandyBrown", "seaGreen", "seaShell", "sienna", "silver", "skyBlue", "slateBlue", "slateGray", "slateGrey", "snow", "springGreen", "steelBlue", "tan", "teal", "thistle", "tomato", "turquoise", "violet", "wheat", "white", "whiteSmoke", "yellow", "yellowGreen", "none", "transparent" ] } ] }, { "type": "string", "nullable": false, "enum": [ "" ] } ] }, "isCollapsed": { "type": "boolean", "example": false }, "isEntryPoint": { "type": "boolean", "example": false }, "isDisabled": { "type": "boolean", "example": false } } }, "IChartNodeRelation_2_0": { "type": "object", "properties": { "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "node": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "children": { "type": "array", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "next": { "oneOf": [ { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, { "nullable": true } ] } } }, "IGenerateNodeOutput_2_0": { "type": "object", "properties": { "localeId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "userText": { "type": "string", "example": "greetings" }, "outputType": { "type": "string", "example": "text", "enum": [ "text", "adaptiveCard" ] }, "lastOutput": { "type": "string", "description": "Last adaptive card output", "example": "{\"$schema\":\"http://adaptivecards.io/schemas/adaptive-card.json\", ...}" }, "generateContentLimit": { "type": "number", "description": "The number of sentences to be generated", "example": 3 } } }, "IGenerateTextNodeOutputResponse_2_0": { "type": "object", "properties": { "output": { "type": "array", "items": { "type": "string", "example": "Greetings" } }, "outputType": { "type": "string", "example": "text" } } }, "IGenerateAdaptiveCardNodeOutputResponse_2_0": { "type": "object", "properties": { "output": { "type": "object", "properties": { "type": { "type": "string", "example": "AdaptiveCard" }, "body": { "type": "array", "items": { "type": "object" } }, "actions": { "type": "array", "items": { "type": "object" } }, "version": { "type": "string", "example": 1 }, "speak": { "type": "string", "example": "create a poll for playing football on saturday at 3pm with the following options: yes, no, maybe" } } }, "outputType": { "type": "string", "example": "adaptiveCard" } } }, "IChartNodeSearchResult_2_0": { "type": "object", "properties": { "nodeId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "nodeReferenceId": { "type": "string", "format": "uuid" }, "matches": { "type": "array", "items": { "type": "object", "properties": { "fieldType": { "type": "string" }, "matchPath": { "type": "string" } } } } } }, "IConnectionDataFields_2_0": { "type": "object", "properties": { "fields": { "type": "object", "description": "The fields of the Connection. Key-Value pairs. The key should match the connection schema of the specific connection type.", "minProperties": 1, "maxProperties": 10, "example": { "some-key-from-connection-schema": "x123sdfu12312" } } } }, "IConnectionDataCreate_2_0": { "type": "object", "properties": { "name": { "type": "string", "example": "some name" }, "isDeprecated": { "type": "boolean", "description": "Marked 'true' if the connection type is deprecated" }, "type": { "type": "string", "example": "http_basic" }, "extension": { "type": "string", "example": "@cognigy/basic-nodes" }, "fields": { "type": "object", "description": "The fields of the Connection. Key-Value pairs. The key should match the connection schema of the specific connection type.", "minProperties": 1, "maxProperties": 10, "example": { "some-key-from-connection-schema": "x123sdfu12312" } } } }, "IConnectionData": { "type": "object", "properties": { "referenceId": { "type": "string", "description": "The reference id of the Connection", "format": "uuid" }, "name": { "type": "string", "description": "The name of the Connection", "example": "Azure API" }, "isDeprecated": { "type": "boolean", "description": "Marked 'true' if the connection type is deprecated" }, "connectionSchema": { "type": "object", "description": "Identifies the schema which should be used to validate the connection fields.", "properties": { "extension": { "type": "string", "description": "The package-name of the extension.", "example": "azure" }, "type": { "type": "string", "description": "The type of the connection defined in the extension.", "example": "oauth2" } } }, "fields": { "type": "object", "description": "The fields of the Connection. Key-Value pairs. The key should match the connection schema of the specific connection type.", "minProperties": 1, "maxProperties": 10, "example": { "some-key-from-connection-schema": "x123sdfu12312" } } } }, "IConnection_2_0": { "type": "object", "properties": { "key": { "type": "string", "description": "The key of the connection field. The key should match the connection schema of the specific connection type.", "example": "some-key-from-connection-schema" }, "value": { "type": "string", "description": "The value of the connection field", "example": "x123w123" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" }, "IConnectionData_2_0": { "type": "object", "properties": { "key": { "type": "string", "description": "The key of the connection field. The key should match the connection schema of the specific connection type.", "example": "some-key-from-connection-schema" }, "value": { "type": "string", "description": "The value of the connection field", "example": "x123w123" } } }, "IConnectionIndexItem_2_0": { "type": "object", "properties": { "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "referenceId": { "type": "string", "description": "The reference id of the Connection", "example": "0f7b5514-e7a5-4947-ae44-7519a23c7403" }, "name": { "type": "string", "description": "The name of the Connection", "example": "azure" }, "isDeprecated": { "type": "boolean", "description": "Marked 'true' if the connection type is deprecated" }, "connectionSchema": { "type": "object", "properties": { "extension": { "type": "string", "description": "The package-name of the extension." }, "type": { "type": "string", "description": "The type of connection." } } }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" }, "IConnectionSchemaData_2_0": { "type": "object", "properties": { "extension": { "type": "string", "description": "The package name of the extension", "example": "azure" }, "type": { "type": "string", "description": "The type of the connection within the extension", "example": "oauth-2" }, "label": { "type": "string", "description": "The label for the connection type", "example": "OAuth-2" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "fieldName": { "type": "string", "description": "The name of the field", "example": "client_secret" } } } } } }, "IConnectionSchema_2_0": { "type": "object", "properties": { "extension": { "type": "string", "description": "The package name of the extension", "example": "azure" }, "type": { "type": "string", "description": "The type of the connection within the extension", "example": "oauth-2" }, "label": { "type": "string", "description": "The label for the connection type", "example": "OAuth-2" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "fieldName": { "type": "string", "description": "The name of the field", "example": "client_secret" } } } }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" }, "IConnectionSchemaIndexItem_2_0": { "type": "object", "properties": { "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "extension": { "type": "string", "description": "The package name of the extension this schema was found", "example": "azure" }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" }, "IEndpointData_2_0": { "type": "object", "properties": { "foreignId": { "type": "string" }, "channel": { "type": "string", "example": "webchat2", "enum": [ "facebook", "alexa", "slack", "generic", "inject", "rest", "realtime", "socket", "adminconsole", "webchat2", "dialogflow", "twilio", "twilio-sms", "line", "intercom", "microsoftBotFramework", "microsoftTeams", "sunshineConversations", "admin-webchat", "avaya", "nonConversational", "voiceGateway2", "amazonLex", "workplace", "webhook", "abstractRest", "userlike", "ringCentralEngage", "audioCodes", "bandwidth", "whatsapp", "eightByEight", "genesysBotConnector", "niceCXOne", "agentAssistVoice", "webchat3" ] }, "flowId": { "type": "string" }, "localeId": { "type": "string" }, "URLToken": { "type": "string", "description": "The URLToken of the endpoint", "example": "f65b289912c929c2a09523dd48eedb1249bb74384f6561f84b4ffc5e84d2f15f" }, "name": { "type": "string", "description": "The name of the endpoint", "example": "New Endpoint" }, "entrypoint": { "type": "string", "description": "The ID can be either a Snapshot ID or a Project ID. The Endpoint will refer to the chosen one.", "example": "667ed4ae16d66f47dc2a9400" }, "active": { "type": "boolean", "description": "Toggle whether the endpoint is active or not" }, "nluConnectorId": { "oneOf": [ { "type": "string", "description": "The NLUConnector type", "example": "cognigy", "enum": [ "alexa", "dialogflow", "dialogflowBuiltIn", "amazonLexBuiltIn", "luis", "watson", "noNlu", "cognigy", "code", "generativeAI", "lex" ] }, { "type": "string" } ] }, "useConversations": { "type": "boolean", "description": "Whether to collect conversations history for this endpoint" }, "maskIPAddress": { "type": "boolean", "description": "Whether to mask sensitive IP address in input object and analytics data for this endpoint" }, "maskAnalytics": { "type": "boolean", "description": "Whether to mask sensitive data in analytics for this endpoint" }, "maskLogging": { "type": "boolean", "description": "Whether to mask sensitive data in logs for this endpoint" }, "useContactProfiles": { "type": "boolean", "description": "Whether to use contact profiles for this endpoint" }, "useAnalytics": { "type": "boolean", "description": "Whether we should store analytics for this endpoint" }, "useChatbaseAnalytics": { "type": "boolean", "description": "Whether we should use Chatbase to collect analytics" }, "chatbaseApikey": { "type": "string", "description": "The apikey for the Chatbase bot" }, "useDashbotAnalytics": { "type": "boolean", "description": "Whether we should use Dashbot to collect analytics" }, "dashbotApikey": { "type": "string", "description": "The apikey for the dashbot bot" }, "dashbotPlatform": { "type": "string" }, "disableInputSanitization": { "type": "string", "description": "If true, disables input text sanitization after Input Transformer" }, "overrideSnapshotConnections": { "type": "boolean" }, "settings": { "type": "object", "properties": { "accessScope": { "type": "string" }, "accessToken": { "type": "string" }, "appId": { "type": "string" }, "appSecret": { "type": "string" }, "backgroundImageUrl": { "type": "string" }, "basicAuthPassword": { "type": "string" }, "basicAuthUser": { "type": "string" }, "botUserId": { "type": "string" }, "businessHours": { "type": "object", "properties": { "businessHours": { "type": "array", "items": { "type": "object", "properties": { "startTime": { "type": "string" }, "endTime": { "type": "string" }, "weekDay": { "type": "string" } } } }, "enabled": { "type": "boolean" }, "text": { "type": "string" }, "mode": { "type": "string" }, "timeZone": { "type": "string" }, "title": { "type": "string" } } }, "colorScheme": { "type": "string" }, "connectionName": { "type": "string" }, "customJSON": { "type": "string" }, "designTemplate": { "type": "integer" }, "disableHtmlContentSanitization": { "type": "boolean" }, "disableInputAutocomplete": { "type": "boolean" }, "disableInputAutogrow": { "type": "boolean" }, "disableUrlButtonSanitization": { "type": "boolean" }, "enableGenericHTMLStyling": { "type": "boolean" }, "enableAsyncCommunication": { "type": "boolean" }, "engagementMessageText": { "type": "string" }, "displayGetStartedButton": { "type": "boolean" }, "dynamicImageAspectRatio": { "type": "boolean" }, "enableCollectMetadata": { "type": "boolean" }, "enableConnectionStatusIndicator": { "type": "boolean" }, "enableDemoWebchat": { "type": "boolean" }, "enableFileUpload": { "type": "boolean" }, "enablePersistentMenu": { "type": "boolean" }, "enableRating": { "type": "string", "enum": [ "onRequest", "always", "once" ] }, "enableSTT": { "type": "boolean" }, "enableTTS": { "type": "boolean" }, "enableUnreadMessageBadge": { "type": "boolean" }, "enableUnreadMessagePreview": { "type": "boolean" }, "enableUnreadMessageSound": { "type": "boolean" }, "enableUnreadMessageTitleIndicator": { "type": "boolean" }, "enableTypingIndicator": { "type": "boolean" }, "facebookPageToken": { "type": "string" }, "focusInputAfterPostback": { "type": "boolean" }, "getStartedButtonText": { "type": "string" }, "getStartedPayload": { "type": "string" }, "getStartedText": { "type": "string" }, "getStartedData": { "type": "string" }, "headerLogoUrl": { "type": "string" }, "hubSecret": { "type": "string" }, "inputAutogrowMaxRows": { "type": "number" }, "inputPlaceholder": { "type": "string" }, "language": { "type": "string" }, "lineChannelAccessToken": { "type": "string" }, "lineChannelSecret": { "type": "string" }, "maintenance": { "type": "object", "properties": { "enabled": { "type": "boolean" }, "mode": { "type": "string" }, "text": { "type": "string" }, "title": { "type": "string" } } }, "mergeContactProfiles": { "type": "boolean" }, "messageDelay": { "type": "integer" }, "messageLogoUrl": { "type": "string" }, "overwriteWebchatBundleUrl": { "type": "string" }, "ratingTitleText": { "type": "string" }, "ratingCommentText": { "type": "string" }, "ratingMessageHistoryRatingText": { "type": "string" }, "ratingMessageHistoryCommentText": { "type": "string" }, "reparseAlexaSlots": { "type": "boolean" }, "requestFacebookProfileData": { "type": "boolean" }, "sessionExpiration": { "type": "integer" }, "shouldOverwriteWebchatBundleUrl": { "type": "boolean" }, "showEngagementMessagesInChat": { "type": "boolean" }, "slackOAuthAccessToken": { "type": "string" }, "slackVerifyToken": { "type": "string" }, "sunshineConversationsChannelKeyId": { "type": "string" }, "sunshineConversationsChannelSecret": { "type": "string" }, "sunshineConversationsChannelUri": { "type": "string", "format": "uri" }, "tenantId": { "type": "string" }, "updateContactProfileWithFacebookProfile": { "type": "boolean" }, "voice": { "type": "string" }, "webhookUrl": { "type": "string", "format": "uri" }, "skill": { "type": "object" }, "persistentMenu": { "type": "object" } } }, "transformerSettings": { "type": "object", "properties": { "abortOnError": { "type": "boolean", "description": "If true, then we will abort the message processing if the transformer throws an error. Otherwise, we will continue with normal message processing in the event of an error.\n" }, "transformer": { "type": "string", "description": "The transformer object as written by the user. This will be displayed in the UI since it includes typings.\n" }, "transpiledTransformer": { "type": "string", "description": "The transformer object written by the user, but without typings. This will be executed.\n" }, "inputTransformerEnabled": { "type": "boolean" }, "outputTransformerEnabled": { "type": "boolean" }, "finalPingTransformerEnabled": { "type": "boolean" }, "notifyTransformerEnabled": { "type": "boolean" }, "injectTransformerEnabled": { "type": "boolean" } } }, "handoverSettings": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "cognigy", "none", "rce" ] }, "providerSettings": { "type": "object", "properties": { "forwardOnlyHandoverConversations": { "type": "boolean", "description": "(rce) Whether to forward all conversations to the provider, or only the conversations that trigger a handover. If this setting is true, then we will only forward conversations were handover was triggered.\n" }, "getQueueUpdates": { "type": "boolean", "description": "(rce) Indicates if queue updates should be enabled to receive events about the estimated wait time\n" }, "apiVersion": { "type": "string", "description": "(salesforce) Salesforce LiveAgent API Version" }, "baseUrl": { "type": "string", "description": "Base URL of the LiveAgent API Deployment" }, "apiAccessToken": { "type": "string", "description": "(rce) The API access token you can create within RCE" }, "baseApiUrl": { "type": "string", "description": "(rce) The API URL to your RCE installation" }, "realtimeAccessToken": { "type": "string", "description": "(rce) The access token for your rce source sdk source" }, "realtimeEndpointUrl": { "type": "string", "description": "(rce) The endpoint URL of your rce source sdk source" }, "webhookSecret": { "type": "string", "description": "(rce) The secret used to secure webhooks in RCE" }, "botCategoryId": { "type": "string", "description": "(rce) The ID of the category you use as the 'bot category' within RCE" }, "agentCategoryId": { "type": "string", "description": "(rce) The ID of the category you use as the 'bot category' within RCE" }, "organizationId": { "type": "string", "description": "(salesforce) Salesforce Organization ID" }, "deploymentId": { "type": "string", "description": "(salesforce) Salesforce LiveAgent Deployment ID" }, "buttonId": { "type": "string", "description": "(salesforce) Salesforce LiveAgent Chat Button ID" } } }, "agentAssistSettings": { "type": "object", "properties": { "copilotType": { "type": "string", "enum": [ "none", "workspace", "whisper" ], "description": "Copilot Type" }, "agentAssistFlowId": { "type": "string", "description": "Copilot flow ID" }, "agentAssistConfigId": { "type": "string", "description": "Selected Copilot Config ReferenceId" }, "enableTranscriptTile": { "type": "boolean", "description": "Enable the transcript tile" }, "enableTranscriptTileChatInput": { "type": "boolean", "description": "Enable the chat input for transcript tile" }, "redactTranscriptTileMessages": { "type": "boolean", "description": "Enable redaction of messages in transcript tile" } } } } }, "orgDataPrivacySettings": { "description": "Organisation data privacy settings overwrite the ones defined on endpoint-level", "type": "object", "properties": { "enabled": { "type": "boolean", "description": "Whether or not organisation data privacy settings are enabled" }, "useAnalytics": { "type": "boolean" }, "storeDataPayload": { "type": "boolean" }, "useContactProfiles": { "type": "boolean" }, "useConversations": { "type": "boolean" }, "maskIPAddress": { "type": "boolean" }, "maskAnalytics": { "type": "boolean" }, "maskLogging": { "type": "boolean" } } } } }, "IEndpoint_2_0": { "type": "object", "properties": { "foreignId": { "type": "string" }, "channel": { "type": "string", "example": "webchat2", "enum": [ "facebook", "alexa", "slack", "generic", "inject", "rest", "realtime", "socket", "adminconsole", "webchat2", "dialogflow", "twilio", "twilio-sms", "line", "intercom", "microsoftBotFramework", "microsoftTeams", "sunshineConversations", "admin-webchat", "avaya", "nonConversational", "voiceGateway2", "amazonLex", "workplace", "webhook", "abstractRest", "userlike", "ringCentralEngage", "audioCodes", "bandwidth", "whatsapp", "eightByEight", "genesysBotConnector", "niceCXOne", "agentAssistVoice", "webchat3" ] }, "flowId": { "type": "string" }, "localeId": { "type": "string" }, "URLToken": { "type": "string", "description": "The URLToken of the endpoint", "example": "f65b289912c929c2a09523dd48eedb1249bb74384f6561f84b4ffc5e84d2f15f" }, "name": { "type": "string", "description": "The name of the endpoint", "example": "New Endpoint" }, "entrypoint": { "type": "string", "description": "The ID can be either a Snapshot ID or a Project ID. The Endpoint will refer to the chosen one.", "example": "667ed4ae16d66f47dc2a9400" }, "active": { "type": "boolean", "description": "Toggle whether the endpoint is active or not" }, "nluConnectorId": { "oneOf": [ { "type": "string", "description": "The NLUConnector type", "example": "cognigy", "enum": [ "alexa", "dialogflow", "dialogflowBuiltIn", "amazonLexBuiltIn", "luis", "watson", "noNlu", "cognigy", "code", "generativeAI", "lex" ] }, { "type": "string" } ] }, "useConversations": { "type": "boolean", "description": "Whether to collect conversations history for this endpoint" }, "maskIPAddress": { "type": "boolean", "description": "Whether to mask sensitive IP address in input object and analytics data for this endpoint" }, "maskAnalytics": { "type": "boolean", "description": "Whether to mask sensitive data in analytics for this endpoint" }, "maskLogging": { "type": "boolean", "description": "Whether to mask sensitive data in logs for this endpoint" }, "useContactProfiles": { "type": "boolean", "description": "Whether to use contact profiles for this endpoint" }, "useAnalytics": { "type": "boolean", "description": "Whether we should store analytics for this endpoint" }, "useChatbaseAnalytics": { "type": "boolean", "description": "Whether we should use Chatbase to collect analytics" }, "chatbaseApikey": { "type": "string", "description": "The apikey for the Chatbase bot" }, "useDashbotAnalytics": { "type": "boolean", "description": "Whether we should use Dashbot to collect analytics" }, "dashbotApikey": { "type": "string", "description": "The apikey for the dashbot bot" }, "dashbotPlatform": { "type": "string" }, "disableInputSanitization": { "type": "string", "description": "If true, disables input text sanitization after Input Transformer" }, "overrideSnapshotConnections": { "type": "boolean" }, "settings": { "type": "object", "properties": { "accessScope": { "type": "string" }, "accessToken": { "type": "string" }, "appId": { "type": "string" }, "appSecret": { "type": "string" }, "backgroundImageUrl": { "type": "string" }, "basicAuthPassword": { "type": "string" }, "basicAuthUser": { "type": "string" }, "botUserId": { "type": "string" }, "businessHours": { "type": "object", "properties": { "businessHours": { "type": "array", "items": { "type": "object", "properties": { "startTime": { "type": "string" }, "endTime": { "type": "string" }, "weekDay": { "type": "string" } } } }, "enabled": { "type": "boolean" }, "text": { "type": "string" }, "mode": { "type": "string" }, "timeZone": { "type": "string" }, "title": { "type": "string" } } }, "colorScheme": { "type": "string" }, "connectionName": { "type": "string" }, "customJSON": { "type": "string" }, "designTemplate": { "type": "integer" }, "disableHtmlContentSanitization": { "type": "boolean" }, "disableInputAutocomplete": { "type": "boolean" }, "disableInputAutogrow": { "type": "boolean" }, "disableUrlButtonSanitization": { "type": "boolean" }, "enableGenericHTMLStyling": { "type": "boolean" }, "enableAsyncCommunication": { "type": "boolean" }, "engagementMessageText": { "type": "string" }, "displayGetStartedButton": { "type": "boolean" }, "dynamicImageAspectRatio": { "type": "boolean" }, "enableCollectMetadata": { "type": "boolean" }, "enableConnectionStatusIndicator": { "type": "boolean" }, "enableDemoWebchat": { "type": "boolean" }, "enableFileUpload": { "type": "boolean" }, "enablePersistentMenu": { "type": "boolean" }, "enableRating": { "type": "string", "enum": [ "onRequest", "always", "once" ] }, "enableSTT": { "type": "boolean" }, "enableTTS": { "type": "boolean" }, "enableUnreadMessageBadge": { "type": "boolean" }, "enableUnreadMessagePreview": { "type": "boolean" }, "enableUnreadMessageSound": { "type": "boolean" }, "enableUnreadMessageTitleIndicator": { "type": "boolean" }, "enableTypingIndicator": { "type": "boolean" }, "facebookPageToken": { "type": "string" }, "focusInputAfterPostback": { "type": "boolean" }, "getStartedButtonText": { "type": "string" }, "getStartedPayload": { "type": "string" }, "getStartedText": { "type": "string" }, "getStartedData": { "type": "string" }, "headerLogoUrl": { "type": "string" }, "hubSecret": { "type": "string" }, "inputAutogrowMaxRows": { "type": "number" }, "inputPlaceholder": { "type": "string" }, "language": { "type": "string" }, "lineChannelAccessToken": { "type": "string" }, "lineChannelSecret": { "type": "string" }, "maintenance": { "type": "object", "properties": { "enabled": { "type": "boolean" }, "mode": { "type": "string" }, "text": { "type": "string" }, "title": { "type": "string" } } }, "mergeContactProfiles": { "type": "boolean" }, "messageDelay": { "type": "integer" }, "messageLogoUrl": { "type": "string" }, "overwriteWebchatBundleUrl": { "type": "string" }, "ratingTitleText": { "type": "string" }, "ratingCommentText": { "type": "string" }, "ratingMessageHistoryRatingText": { "type": "string" }, "ratingMessageHistoryCommentText": { "type": "string" }, "reparseAlexaSlots": { "type": "boolean" }, "requestFacebookProfileData": { "type": "boolean" }, "sessionExpiration": { "type": "integer" }, "shouldOverwriteWebchatBundleUrl": { "type": "boolean" }, "showEngagementMessagesInChat": { "type": "boolean" }, "slackOAuthAccessToken": { "type": "string" }, "slackVerifyToken": { "type": "string" }, "sunshineConversationsChannelKeyId": { "type": "string" }, "sunshineConversationsChannelSecret": { "type": "string" }, "sunshineConversationsChannelUri": { "type": "string", "format": "uri" }, "tenantId": { "type": "string" }, "updateContactProfileWithFacebookProfile": { "type": "boolean" }, "voice": { "type": "string" }, "webhookUrl": { "type": "string", "format": "uri" }, "skill": { "type": "object" }, "persistentMenu": { "type": "object" } } }, "transformerSettings": { "type": "object", "properties": { "abortOnError": { "type": "boolean", "description": "If true, then we will abort the message processing if the transformer throws an error. Otherwise, we will continue with normal message processing in the event of an error.\n" }, "transformer": { "type": "string", "description": "The transformer object as written by the user. This will be displayed in the UI since it includes typings.\n" }, "transpiledTransformer": { "type": "string", "description": "The transformer object written by the user, but without typings. This will be executed.\n" }, "inputTransformerEnabled": { "type": "boolean" }, "outputTransformerEnabled": { "type": "boolean" }, "finalPingTransformerEnabled": { "type": "boolean" }, "notifyTransformerEnabled": { "type": "boolean" }, "injectTransformerEnabled": { "type": "boolean" } } }, "handoverSettings": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "cognigy", "none", "rce" ] }, "providerSettings": { "type": "object", "properties": { "forwardOnlyHandoverConversations": { "type": "boolean", "description": "(rce) Whether to forward all conversations to the provider, or only the conversations that trigger a handover. If this setting is true, then we will only forward conversations were handover was triggered.\n" }, "getQueueUpdates": { "type": "boolean", "description": "(rce) Indicates if queue updates should be enabled to receive events about the estimated wait time\n" }, "apiVersion": { "type": "string", "description": "(salesforce) Salesforce LiveAgent API Version" }, "baseUrl": { "type": "string", "description": "Base URL of the LiveAgent API Deployment" }, "apiAccessToken": { "type": "string", "description": "(rce) The API access token you can create within RCE" }, "baseApiUrl": { "type": "string", "description": "(rce) The API URL to your RCE installation" }, "realtimeAccessToken": { "type": "string", "description": "(rce) The access token for your rce source sdk source" }, "realtimeEndpointUrl": { "type": "string", "description": "(rce) The endpoint URL of your rce source sdk source" }, "webhookSecret": { "type": "string", "description": "(rce) The secret used to secure webhooks in RCE" }, "botCategoryId": { "type": "string", "description": "(rce) The ID of the category you use as the 'bot category' within RCE" }, "agentCategoryId": { "type": "string", "description": "(rce) The ID of the category you use as the 'bot category' within RCE" }, "organizationId": { "type": "string", "description": "(salesforce) Salesforce Organization ID" }, "deploymentId": { "type": "string", "description": "(salesforce) Salesforce LiveAgent Deployment ID" }, "buttonId": { "type": "string", "description": "(salesforce) Salesforce LiveAgent Chat Button ID" } } }, "agentAssistSettings": { "type": "object", "properties": { "copilotType": { "type": "string", "enum": [ "none", "workspace", "whisper" ], "description": "Copilot Type" }, "agentAssistFlowId": { "type": "string", "description": "Copilot flow ID" }, "agentAssistConfigId": { "type": "string", "description": "Selected Copilot Config ReferenceId" }, "enableTranscriptTile": { "type": "boolean", "description": "Enable the transcript tile" }, "enableTranscriptTileChatInput": { "type": "boolean", "description": "Enable the chat input for transcript tile" }, "redactTranscriptTileMessages": { "type": "boolean", "description": "Enable redaction of messages in transcript tile" } } } } }, "orgDataPrivacySettings": { "description": "Organisation data privacy settings overwrite the ones defined on endpoint-level", "type": "object", "properties": { "enabled": { "type": "boolean", "description": "Whether or not organisation data privacy settings are enabled" }, "useAnalytics": { "type": "boolean" }, "storeDataPayload": { "type": "boolean" }, "useContactProfiles": { "type": "boolean" }, "useConversations": { "type": "boolean" }, "maskIPAddress": { "type": "boolean" }, "maskAnalytics": { "type": "boolean" }, "maskLogging": { "type": "boolean" } } }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" }, "IEndpointTranslationSettings_2_0": { "type": "object", "properties": { "translationEnabled": { "type": "boolean", "description": "Whether or not Translation is enabled for the Endpoint" }, "flowLanguage": { "type": "string", "description": "The language of the Flow outputs" }, "inputLanguage": { "type": "string", "description": "The language of the user inputs ('auto' for auto-detection)" }, "noTranslateMarker": { "type": "string", "description": "Don't translate inputs and outputs which are prefixed with this prefix" }, "glossaryId": { "type": "string", "description": "The glossary to use for the bot output translation" }, "glossaryIdInput": { "type": "string", "description": "The glossary to use for the user input translation" }, "formality": { "type": "string", "description": "Sets whether the translated text should lean towards formal or informal language" }, "padPayloads": { "type": "boolean", "description": "If true, prevents all user inputs based on payloads to be translated" }, "alwaysRemoveNoTranslateMarker": { "type": "boolean", "description": "Wether we remove No Translation Markers, even if translation is not enabled" }, "setInputLanguageOnExecutionCount": { "type": "boolean", "description": "If the input language is set to 'auto', it will be fixed to its current value on this execution count" } } }, "IEndpoitOrgDataPrivacySettings_2_0": { "description": "Organisation data privacy settings overwrite the ones defined on endpoint-level", "type": "object", "properties": { "enabled": { "type": "boolean", "description": "Whether or not organisation data privacy settings are enabled" }, "useAnalytics": { "type": "boolean" }, "storeDataPayload": { "type": "boolean" }, "useContactProfiles": { "type": "boolean" }, "useConversations": { "type": "boolean" }, "maskIPAddress": { "type": "boolean" }, "maskAnalytics": { "type": "boolean" }, "maskLogging": { "type": "boolean" } } }, "IEndpointIndexItem_2_0": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the endpoint", "example": "New Endpoint" }, "flowId": { "type": "string" }, "localeId": { "type": "string" }, "URLToken": { "type": "string", "description": "The URLToken of the endpoint", "example": "f65b289912c929c2a09523dd48eedb1249bb74384f6561f84b4ffc5e84d2f15f" }, "channel": { "type": "string", "example": "webchat2", "enum": [ "facebook", "alexa", "slack", "generic", "inject", "rest", "realtime", "socket", "adminconsole", "webchat2", "dialogflow", "twilio", "twilio-sms", "line", "intercom", "microsoftBotFramework", "microsoftTeams", "sunshineConversations", "admin-webchat", "avaya", "nonConversational", "voiceGateway2", "amazonLex", "workplace", "webhook", "abstractRest", "userlike", "ringCentralEngage", "audioCodes", "bandwidth", "whatsapp", "eightByEight", "genesysBotConnector", "niceCXOne", "agentAssistVoice", "webchat3" ] }, "overrideSnapshotConnections": { "type": "boolean" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" }, "IExtensionData_2_0": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the Extension", "example": "New Extension" }, "label": { "type": "string", "description": "The label of the Extension", "example": "New Extension" }, "version": { "type": "string", "description": "The version of the Extension", "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)(?:-((?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\\.(?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\\+([0-9a-zA-Z-]+(?:\\.[0-9a-zA-Z-]+)*))?$", "example": "1.0.0" }, "imageUrlToken": { "type": "string", "format": "alphanum-64", "description": "A fully qualified URL to an image/icon for the extension." }, "description": { "type": "string", "description": "Optional description of the extension" }, "tags": { "type": "array", "description": "Optional list of tags to find the extension", "items": { "type": "string" } }, "author": { "type": "string", "description": "Author of the extension" }, "extensionType": { "type": "string", "description": "Type of this extension", "enum": [ "nodes" ] }, "trustedCode": { "type": "boolean", "description": "Whether the code of the extension is trusted and runs without isolation" }, "nodes": { "type": "object", "properties": { "type": { "type": "string" }, "parentType": { "type": "string", "description": "The type of the node parent, if there is one" }, "defaultLabel": { "oneOf": [ { "type": "string", "description": "The label that should be used when a new Node of this type is created" }, { "type": "object", "description": "A localized version of the label that should be used when a new Node of this type is created", "properties": { "default": { "type": "string" }, "enUS": { "type": "string" }, "deDE": { "type": "string" }, "esES": { "type": "string" }, "jaJP": { "type": "string" }, "koKR": { "type": "string" } } } ] }, "summary": { "oneOf": [ { "type": "string", "description": "A short line of text that describes what this Node is used for" }, { "type": "object", "description": "A localized version of a short line of text that describes what this Node is used for", "properties": { "default": { "type": "string" }, "enUS": { "type": "string" }, "deDE": { "type": "string" }, "esES": { "type": "string" }, "jaJP": { "type": "string" }, "koKR": { "type": "string" } } } ] }, "extension": { "type": "string" }, "extensionImg": { "type": "string" }, "appearance": { "type": "object", "properties": { "logo": { "type": "string" }, "textColor": { "type": "string", "example": "blue", "oneOf": [ { "type": "string", "example": "none", "enum": [ "aliceBlue", "antiqueWhite", "aqua", "aquamarine", "azure", "beige", "bisque", "black", "blanchedAlmond", "blue", "blueViolet", "brown", "burlyWood", "cadetBlue", "chartreuse", "chocolate", "coral", "cornflowerBlue", "cornsilk", "crimson", "cyan", "darkBlue", "darkCyan", "darkGoldenRod", "darkGray", "darkGrey", "darkGreen", "darkKhaki", "darkMagenta", "darkOliveGreen", "darkOrange", "darkOrchid", "darkRed", "darkSalmon", "darkSeaGreen", "darkSlateBlue", "darkSlateGray", "darkSlateGrey", "darkTurquoise", "darkViolet", "deepPink", "deepSkyBlue", "dimGray", "dimGrey", "dodgerBlue", "fireBrick", "floralWhite", "forestGreen", "fuchsia", "gainsboro", "ghostWhite", "gold", "goldenRod", "gray", "grey", "green", "greenYellow", "honeyDew", "hotPink", "indianRed", "indigo", "ivory", "khaki", "lavender", "lavenderBlush", "lawnGreen", "lemonChiffon", "lightBlue", "lightCoral", "lightCyan", "lightGoldenRodYellow", "lightGray", "lightGrey", "lightGreen", "lightPink", "lightSalmon", "lightSeaGreen", "lightSkyBlue", "lightSlateGray", "lightSlateGrey", "lightSteelBlue", "lightYellow", "lime", "limeGreen", "linen", "magenta", "maroon", "mediumAquaMarine", "mediumBlue", "mediumOrchid", "mediumPurple", "mediumSeaGreen", "mediumSlateBlue", "mediumSpringGreen", "mediumTurquoise", "mediumVioletRed", "midnightBlue", "mintCream", "mistyRose", "moccasin", "navajoWhite", "navy", "oldLace", "olive", "oliveDrab", "orange", "orangeRed", "orchid", "paleGoldenRod", "paleGreen", "paleTurquoise", "paleVioletRed", "papayaWhip", "peachPuff", "peru", "pink", "plum", "powderBlue", "purple", "rebeccaPurple", "red", "rosyBrown", "royalBlue", "saddleBrown", "salmon", "sandyBrown", "seaGreen", "seaShell", "sienna", "silver", "skyBlue", "slateBlue", "slateGray", "slateGrey", "snow", "springGreen", "steelBlue", "tan", "teal", "thistle", "tomato", "turquoise", "violet", "wheat", "white", "whiteSmoke", "yellow", "yellowGreen", "none", "transparent" ] }, { "type": "string", "example": "cognigyGrey", "enum": [ "amber", "blueGrey", "cognigyBlue", "cognigyGrey", "deepOrange", "deepPurple", "lightBlue", "lightGreen" ] } ] }, "contrastTextColor": { "type": "string", "example": "blue", "oneOf": [ { "type": "string", "example": "none", "enum": [ "aliceBlue", "antiqueWhite", "aqua", "aquamarine", "azure", "beige", "bisque", "black", "blanchedAlmond", "blue", "blueViolet", "brown", "burlyWood", "cadetBlue", "chartreuse", "chocolate", "coral", "cornflowerBlue", "cornsilk", "crimson", "cyan", "darkBlue", "darkCyan", "darkGoldenRod", "darkGray", "darkGrey", "darkGreen", "darkKhaki", "darkMagenta", "darkOliveGreen", "darkOrange", "darkOrchid", "darkRed", "darkSalmon", "darkSeaGreen", "darkSlateBlue", "darkSlateGray", "darkSlateGrey", "darkTurquoise", "darkViolet", "deepPink", "deepSkyBlue", "dimGray", "dimGrey", "dodgerBlue", "fireBrick", "floralWhite", "forestGreen", "fuchsia", "gainsboro", "ghostWhite", "gold", "goldenRod", "gray", "grey", "green", "greenYellow", "honeyDew", "hotPink", "indianRed", "indigo", "ivory", "khaki", "lavender", "lavenderBlush", "lawnGreen", "lemonChiffon", "lightBlue", "lightCoral", "lightCyan", "lightGoldenRodYellow", "lightGray", "lightGrey", "lightGreen", "lightPink", "lightSalmon", "lightSeaGreen", "lightSkyBlue", "lightSlateGray", "lightSlateGrey", "lightSteelBlue", "lightYellow", "lime", "limeGreen", "linen", "magenta", "maroon", "mediumAquaMarine", "mediumBlue", "mediumOrchid", "mediumPurple", "mediumSeaGreen", "mediumSlateBlue", "mediumSpringGreen", "mediumTurquoise", "mediumVioletRed", "midnightBlue", "mintCream", "mistyRose", "moccasin", "navajoWhite", "navy", "oldLace", "olive", "oliveDrab", "orange", "orangeRed", "orchid", "paleGoldenRod", "paleGreen", "paleTurquoise", "paleVioletRed", "papayaWhip", "peachPuff", "peru", "pink", "plum", "powderBlue", "purple", "rebeccaPurple", "red", "rosyBrown", "royalBlue", "saddleBrown", "salmon", "sandyBrown", "seaGreen", "seaShell", "sienna", "silver", "skyBlue", "slateBlue", "slateGray", "slateGrey", "snow", "springGreen", "steelBlue", "tan", "teal", "thistle", "tomato", "turquoise", "violet", "wheat", "white", "whiteSmoke", "yellow", "yellowGreen", "none", "transparent" ] }, { "type": "string", "example": "cognigyGrey", "enum": [ "amber", "blueGrey", "cognigyBlue", "cognigyGrey", "deepOrange", "deepPurple", "lightBlue", "lightGreen" ] } ] }, "color": { "type": "string", "example": "red", "oneOf": [ { "type": "string", "example": "none", "enum": [ "aliceBlue", "antiqueWhite", "aqua", "aquamarine", "azure", "beige", "bisque", "black", "blanchedAlmond", "blue", "blueViolet", "brown", "burlyWood", "cadetBlue", "chartreuse", "chocolate", "coral", "cornflowerBlue", "cornsilk", "crimson", "cyan", "darkBlue", "darkCyan", "darkGoldenRod", "darkGray", "darkGrey", "darkGreen", "darkKhaki", "darkMagenta", "darkOliveGreen", "darkOrange", "darkOrchid", "darkRed", "darkSalmon", "darkSeaGreen", "darkSlateBlue", "darkSlateGray", "darkSlateGrey", "darkTurquoise", "darkViolet", "deepPink", "deepSkyBlue", "dimGray", "dimGrey", "dodgerBlue", "fireBrick", "floralWhite", "forestGreen", "fuchsia", "gainsboro", "ghostWhite", "gold", "goldenRod", "gray", "grey", "green", "greenYellow", "honeyDew", "hotPink", "indianRed", "indigo", "ivory", "khaki", "lavender", "lavenderBlush", "lawnGreen", "lemonChiffon", "lightBlue", "lightCoral", "lightCyan", "lightGoldenRodYellow", "lightGray", "lightGrey", "lightGreen", "lightPink", "lightSalmon", "lightSeaGreen", "lightSkyBlue", "lightSlateGray", "lightSlateGrey", "lightSteelBlue", "lightYellow", "lime", "limeGreen", "linen", "magenta", "maroon", "mediumAquaMarine", "mediumBlue", "mediumOrchid", "mediumPurple", "mediumSeaGreen", "mediumSlateBlue", "mediumSpringGreen", "mediumTurquoise", "mediumVioletRed", "midnightBlue", "mintCream", "mistyRose", "moccasin", "navajoWhite", "navy", "oldLace", "olive", "oliveDrab", "orange", "orangeRed", "orchid", "paleGoldenRod", "paleGreen", "paleTurquoise", "paleVioletRed", "papayaWhip", "peachPuff", "peru", "pink", "plum", "powderBlue", "purple", "rebeccaPurple", "red", "rosyBrown", "royalBlue", "saddleBrown", "salmon", "sandyBrown", "seaGreen", "seaShell", "sienna", "silver", "skyBlue", "slateBlue", "slateGray", "slateGrey", "snow", "springGreen", "steelBlue", "tan", "teal", "thistle", "tomato", "turquoise", "violet", "wheat", "white", "whiteSmoke", "yellow", "yellowGreen", "none", "transparent" ] }, { "type": "string", "example": "cognigyGrey", "enum": [ "amber", "blueGrey", "cognigyBlue", "cognigyGrey", "deepOrange", "deepPurple", "lightBlue", "lightGreen" ] } ] }, "variant": { "type": "string", "enum": [ "regular", "mini", "hexagon" ] } } }, "behavior": { "type": "object", "properties": { "stopping": { "type": "boolean" }, "entrypoint": { "type": "boolean" } } }, "constraints": { "type": "object", "properties": { "editable": { "type": "boolean", "description": "Should this node be editable" }, "deletable": { "type": "boolean", "description": "Should this node be deletable" }, "creatable": { "type": "boolean", "description": "Should this node be manually creatable" }, "collapsable": { "type": "boolean", "description": "Should this node be collapsable" }, "childFlowCreatable": { "type": "boolean", "description": "Should it be possible to create child flow from this node" }, "movable": { "type": "boolean", "description": "Should this node be movable" }, "placement": { "type": "object", "description": "Additional placement information", "properties": { "predecessor": { "type": "object", "properties": { "whitelist": { "items": { "type": "string" } }, "blacklist": { "items": { "type": "string" } } } }, "successor": { "type": "object", "properties": { "whitelist": { "items": { "type": "string" } }, "blacklist": { "items": { "type": "string" } } } }, "children": { "type": "object", "properties": { "whitelist": { "items": { "type": "string" } }, "blacklist": { "items": { "type": "string" } } } } } } } }, "dependencies": { "type": "object", "properties": { "children": { "type": "array", "items": { "type": "string" } } } }, "fields": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "text", "rule" ] }, "key": { "type": "string" }, "label": { "oneOf": [ { "type": "string" }, { "type": "object", "properties": { "default": { "type": "string" }, "enUS": { "type": "string" }, "deDE": { "type": "string" }, "esES": { "type": "string" }, "jaJP": { "type": "string" }, "koKR": { "type": "string" } } } ] }, "defaultValue": { "description": "The default value for that field" } } } }, "previews": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "message", "image", "code" ] }, "key": { "type": "string" } } } }, "tokens": { "type": "array", "items": { "type": "object", "properties": { "label": { "type": "string", "maxLength": 30, "example": "word count" }, "script": { "type": "string", "maxLength": 500, "example": "ci.text.split(' ').length" }, "type": { "type": "string", "enum": [ "profile", "input", "context", "custom", "answer", "flow-output", "flow-input" ], "example": "input" } } } }, "tags": { "type": "string", "enum": [ "basic", "logic", "message", "profile", "service", "nlu", "data" ] }, "sections": { "type": "array", "items": { "type": "object", "properties": { "key": { "type": "string", "description": "The key of the Field whose value should be matched" }, "value": { "description": "The expected value(s) that make this condition match" }, "negate": { "type": "boolean", "description": "If this is true, the condition result will be inverted" } } } }, "form": { "type": "array", "items": { "type": "object", "properties": { "key": { "type": "string", "description": "A key either pointing to a 'field -> key' or 'section -> key'" }, "type": { "type": "string", "description": "The type of the pointer, either 'field' or 'section'", "enum": [ "field", "section" ] } } } } } }, "connections": { "type": "object", "properties": { "extension": { "type": "string", "description": "The package name of the extension", "example": "azure" }, "type": { "type": "string", "description": "The type of the connection within the extension", "example": "oauth-2" }, "label": { "type": "string", "description": "The label for the connection type", "example": "OAuth-2" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "fieldName": { "type": "string", "description": "The name of the field", "example": "client_secret" } } } }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" } } }, "IExtension_2_0": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the Extension", "example": "New Extension" }, "label": { "type": "string", "description": "The label of the Extension", "example": "New Extension" }, "version": { "type": "string", "description": "The version of the Extension", "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)(?:-((?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\\.(?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\\+([0-9a-zA-Z-]+(?:\\.[0-9a-zA-Z-]+)*))?$", "example": "1.0.0" }, "imageUrlToken": { "type": "string", "format": "alphanum-64", "description": "A fully qualified URL to an image/icon for the extension." }, "description": { "type": "string", "description": "Optional description of the extension" }, "tags": { "type": "array", "description": "Optional list of tags to find the extension", "items": { "type": "string" } }, "author": { "type": "string", "description": "Author of the extension" }, "extensionType": { "type": "string", "description": "Type of this extension", "enum": [ "nodes" ] }, "trustedCode": { "type": "boolean", "description": "Whether the code of the extension is trusted and runs without isolation" }, "nodes": { "type": "object", "properties": { "type": { "type": "string" }, "parentType": { "type": "string", "description": "The type of the node parent, if there is one" }, "defaultLabel": { "oneOf": [ { "type": "string", "description": "The label that should be used when a new Node of this type is created" }, { "type": "object", "description": "A localized version of the label that should be used when a new Node of this type is created", "properties": { "default": { "type": "string" }, "enUS": { "type": "string" }, "deDE": { "type": "string" }, "esES": { "type": "string" }, "jaJP": { "type": "string" }, "koKR": { "type": "string" } } } ] }, "summary": { "oneOf": [ { "type": "string", "description": "A short line of text that describes what this Node is used for" }, { "type": "object", "description": "A localized version of a short line of text that describes what this Node is used for", "properties": { "default": { "type": "string" }, "enUS": { "type": "string" }, "deDE": { "type": "string" }, "esES": { "type": "string" }, "jaJP": { "type": "string" }, "koKR": { "type": "string" } } } ] }, "extension": { "type": "string" }, "extensionImg": { "type": "string" }, "appearance": { "type": "object", "properties": { "logo": { "type": "string" }, "textColor": { "type": "string", "example": "blue", "oneOf": [ { "type": "string", "example": "none", "enum": [ "aliceBlue", "antiqueWhite", "aqua", "aquamarine", "azure", "beige", "bisque", "black", "blanchedAlmond", "blue", "blueViolet", "brown", "burlyWood", "cadetBlue", "chartreuse", "chocolate", "coral", "cornflowerBlue", "cornsilk", "crimson", "cyan", "darkBlue", "darkCyan", "darkGoldenRod", "darkGray", "darkGrey", "darkGreen", "darkKhaki", "darkMagenta", "darkOliveGreen", "darkOrange", "darkOrchid", "darkRed", "darkSalmon", "darkSeaGreen", "darkSlateBlue", "darkSlateGray", "darkSlateGrey", "darkTurquoise", "darkViolet", "deepPink", "deepSkyBlue", "dimGray", "dimGrey", "dodgerBlue", "fireBrick", "floralWhite", "forestGreen", "fuchsia", "gainsboro", "ghostWhite", "gold", "goldenRod", "gray", "grey", "green", "greenYellow", "honeyDew", "hotPink", "indianRed", "indigo", "ivory", "khaki", "lavender", "lavenderBlush", "lawnGreen", "lemonChiffon", "lightBlue", "lightCoral", "lightCyan", "lightGoldenRodYellow", "lightGray", "lightGrey", "lightGreen", "lightPink", "lightSalmon", "lightSeaGreen", "lightSkyBlue", "lightSlateGray", "lightSlateGrey", "lightSteelBlue", "lightYellow", "lime", "limeGreen", "linen", "magenta", "maroon", "mediumAquaMarine", "mediumBlue", "mediumOrchid", "mediumPurple", "mediumSeaGreen", "mediumSlateBlue", "mediumSpringGreen", "mediumTurquoise", "mediumVioletRed", "midnightBlue", "mintCream", "mistyRose", "moccasin", "navajoWhite", "navy", "oldLace", "olive", "oliveDrab", "orange", "orangeRed", "orchid", "paleGoldenRod", "paleGreen", "paleTurquoise", "paleVioletRed", "papayaWhip", "peachPuff", "peru", "pink", "plum", "powderBlue", "purple", "rebeccaPurple", "red", "rosyBrown", "royalBlue", "saddleBrown", "salmon", "sandyBrown", "seaGreen", "seaShell", "sienna", "silver", "skyBlue", "slateBlue", "slateGray", "slateGrey", "snow", "springGreen", "steelBlue", "tan", "teal", "thistle", "tomato", "turquoise", "violet", "wheat", "white", "whiteSmoke", "yellow", "yellowGreen", "none", "transparent" ] }, { "type": "string", "example": "cognigyGrey", "enum": [ "amber", "blueGrey", "cognigyBlue", "cognigyGrey", "deepOrange", "deepPurple", "lightBlue", "lightGreen" ] } ] }, "contrastTextColor": { "type": "string", "example": "blue", "oneOf": [ { "type": "string", "example": "none", "enum": [ "aliceBlue", "antiqueWhite", "aqua", "aquamarine", "azure", "beige", "bisque", "black", "blanchedAlmond", "blue", "blueViolet", "brown", "burlyWood", "cadetBlue", "chartreuse", "chocolate", "coral", "cornflowerBlue", "cornsilk", "crimson", "cyan", "darkBlue", "darkCyan", "darkGoldenRod", "darkGray", "darkGrey", "darkGreen", "darkKhaki", "darkMagenta", "darkOliveGreen", "darkOrange", "darkOrchid", "darkRed", "darkSalmon", "darkSeaGreen", "darkSlateBlue", "darkSlateGray", "darkSlateGrey", "darkTurquoise", "darkViolet", "deepPink", "deepSkyBlue", "dimGray", "dimGrey", "dodgerBlue", "fireBrick", "floralWhite", "forestGreen", "fuchsia", "gainsboro", "ghostWhite", "gold", "goldenRod", "gray", "grey", "green", "greenYellow", "honeyDew", "hotPink", "indianRed", "indigo", "ivory", "khaki", "lavender", "lavenderBlush", "lawnGreen", "lemonChiffon", "lightBlue", "lightCoral", "lightCyan", "lightGoldenRodYellow", "lightGray", "lightGrey", "lightGreen", "lightPink", "lightSalmon", "lightSeaGreen", "lightSkyBlue", "lightSlateGray", "lightSlateGrey", "lightSteelBlue", "lightYellow", "lime", "limeGreen", "linen", "magenta", "maroon", "mediumAquaMarine", "mediumBlue", "mediumOrchid", "mediumPurple", "mediumSeaGreen", "mediumSlateBlue", "mediumSpringGreen", "mediumTurquoise", "mediumVioletRed", "midnightBlue", "mintCream", "mistyRose", "moccasin", "navajoWhite", "navy", "oldLace", "olive", "oliveDrab", "orange", "orangeRed", "orchid", "paleGoldenRod", "paleGreen", "paleTurquoise", "paleVioletRed", "papayaWhip", "peachPuff", "peru", "pink", "plum", "powderBlue", "purple", "rebeccaPurple", "red", "rosyBrown", "royalBlue", "saddleBrown", "salmon", "sandyBrown", "seaGreen", "seaShell", "sienna", "silver", "skyBlue", "slateBlue", "slateGray", "slateGrey", "snow", "springGreen", "steelBlue", "tan", "teal", "thistle", "tomato", "turquoise", "violet", "wheat", "white", "whiteSmoke", "yellow", "yellowGreen", "none", "transparent" ] }, { "type": "string", "example": "cognigyGrey", "enum": [ "amber", "blueGrey", "cognigyBlue", "cognigyGrey", "deepOrange", "deepPurple", "lightBlue", "lightGreen" ] } ] }, "color": { "type": "string", "example": "red", "oneOf": [ { "type": "string", "example": "none", "enum": [ "aliceBlue", "antiqueWhite", "aqua", "aquamarine", "azure", "beige", "bisque", "black", "blanchedAlmond", "blue", "blueViolet", "brown", "burlyWood", "cadetBlue", "chartreuse", "chocolate", "coral", "cornflowerBlue", "cornsilk", "crimson", "cyan", "darkBlue", "darkCyan", "darkGoldenRod", "darkGray", "darkGrey", "darkGreen", "darkKhaki", "darkMagenta", "darkOliveGreen", "darkOrange", "darkOrchid", "darkRed", "darkSalmon", "darkSeaGreen", "darkSlateBlue", "darkSlateGray", "darkSlateGrey", "darkTurquoise", "darkViolet", "deepPink", "deepSkyBlue", "dimGray", "dimGrey", "dodgerBlue", "fireBrick", "floralWhite", "forestGreen", "fuchsia", "gainsboro", "ghostWhite", "gold", "goldenRod", "gray", "grey", "green", "greenYellow", "honeyDew", "hotPink", "indianRed", "indigo", "ivory", "khaki", "lavender", "lavenderBlush", "lawnGreen", "lemonChiffon", "lightBlue", "lightCoral", "lightCyan", "lightGoldenRodYellow", "lightGray", "lightGrey", "lightGreen", "lightPink", "lightSalmon", "lightSeaGreen", "lightSkyBlue", "lightSlateGray", "lightSlateGrey", "lightSteelBlue", "lightYellow", "lime", "limeGreen", "linen", "magenta", "maroon", "mediumAquaMarine", "mediumBlue", "mediumOrchid", "mediumPurple", "mediumSeaGreen", "mediumSlateBlue", "mediumSpringGreen", "mediumTurquoise", "mediumVioletRed", "midnightBlue", "mintCream", "mistyRose", "moccasin", "navajoWhite", "navy", "oldLace", "olive", "oliveDrab", "orange", "orangeRed", "orchid", "paleGoldenRod", "paleGreen", "paleTurquoise", "paleVioletRed", "papayaWhip", "peachPuff", "peru", "pink", "plum", "powderBlue", "purple", "rebeccaPurple", "red", "rosyBrown", "royalBlue", "saddleBrown", "salmon", "sandyBrown", "seaGreen", "seaShell", "sienna", "silver", "skyBlue", "slateBlue", "slateGray", "slateGrey", "snow", "springGreen", "steelBlue", "tan", "teal", "thistle", "tomato", "turquoise", "violet", "wheat", "white", "whiteSmoke", "yellow", "yellowGreen", "none", "transparent" ] }, { "type": "string", "example": "cognigyGrey", "enum": [ "amber", "blueGrey", "cognigyBlue", "cognigyGrey", "deepOrange", "deepPurple", "lightBlue", "lightGreen" ] } ] }, "variant": { "type": "string", "enum": [ "regular", "mini", "hexagon" ] } } }, "behavior": { "type": "object", "properties": { "stopping": { "type": "boolean" }, "entrypoint": { "type": "boolean" } } }, "constraints": { "type": "object", "properties": { "editable": { "type": "boolean", "description": "Should this node be editable" }, "deletable": { "type": "boolean", "description": "Should this node be deletable" }, "creatable": { "type": "boolean", "description": "Should this node be manually creatable" }, "collapsable": { "type": "boolean", "description": "Should this node be collapsable" }, "childFlowCreatable": { "type": "boolean", "description": "Should it be possible to create child flow from this node" }, "movable": { "type": "boolean", "description": "Should this node be movable" }, "placement": { "type": "object", "description": "Additional placement information", "properties": { "predecessor": { "type": "object", "properties": { "whitelist": { "items": { "type": "string" } }, "blacklist": { "items": { "type": "string" } } } }, "successor": { "type": "object", "properties": { "whitelist": { "items": { "type": "string" } }, "blacklist": { "items": { "type": "string" } } } }, "children": { "type": "object", "properties": { "whitelist": { "items": { "type": "string" } }, "blacklist": { "items": { "type": "string" } } } } } } } }, "dependencies": { "type": "object", "properties": { "children": { "type": "array", "items": { "type": "string" } } } }, "fields": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "text", "rule" ] }, "key": { "type": "string" }, "label": { "oneOf": [ { "type": "string" }, { "type": "object", "properties": { "default": { "type": "string" }, "enUS": { "type": "string" }, "deDE": { "type": "string" }, "esES": { "type": "string" }, "jaJP": { "type": "string" }, "koKR": { "type": "string" } } } ] }, "defaultValue": { "description": "The default value for that field" } } } }, "previews": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "message", "image", "code" ] }, "key": { "type": "string" } } } }, "tokens": { "type": "array", "items": { "type": "object", "properties": { "label": { "type": "string", "maxLength": 30, "example": "word count" }, "script": { "type": "string", "maxLength": 500, "example": "ci.text.split(' ').length" }, "type": { "type": "string", "enum": [ "profile", "input", "context", "custom", "answer", "flow-output", "flow-input" ], "example": "input" } } } }, "tags": { "type": "string", "enum": [ "basic", "logic", "message", "profile", "service", "nlu", "data" ] }, "sections": { "type": "array", "items": { "type": "object", "properties": { "key": { "type": "string", "description": "The key of the Field whose value should be matched" }, "value": { "description": "The expected value(s) that make this condition match" }, "negate": { "type": "boolean", "description": "If this is true, the condition result will be inverted" } } } }, "form": { "type": "array", "items": { "type": "object", "properties": { "key": { "type": "string", "description": "A key either pointing to a 'field -> key' or 'section -> key'" }, "type": { "type": "string", "description": "The type of the pointer, either 'field' or 'section'", "enum": [ "field", "section" ] } } } } } }, "connections": { "type": "object", "properties": { "extension": { "type": "string", "description": "The package name of the extension", "example": "azure" }, "type": { "type": "string", "description": "The type of the connection within the extension", "example": "oauth-2" }, "label": { "type": "string", "description": "The label for the connection type", "example": "OAuth-2" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "fieldName": { "type": "string", "description": "The name of the field", "example": "client_secret" } } } }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" }, "IExtensionIndexItem_2_0": { "type": "object", "properties": { "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "name": { "type": "string", "description": "The name of the Extension", "example": "new-extension" }, "label": { "type": "string", "description": "Optional human readable extension name", "example": "New Extension" }, "version": { "type": "string", "description": "The version of the Extension", "example": "1.0.0" }, "imageUrlToken": { "type": "string", "format": "alphanum-64", "description": "A fully qualified URL to an image/icon for the extension." }, "description": { "type": "string", "description": "Optional description of the extension", "example": "This is a fancy extension" }, "trustedCode": { "type": "boolean", "description": "NodeDescriptors trusted flag." }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" }, "IFileData_2_0": { "type": "object", "properties": { "name": { "type": "string" } } }, "IFile_2_0": { "type": "object", "properties": { "name": { "type": "string" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" }, "IGenericIntentFeedbackFinding_2_0": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "poorFScore", "fairFScore", "goodFScore", "fewSentences", "unclearIntent", "noSiblings" ] } } }, "ILowDataIntentFeedbackFinding_2_0": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "lowDataIntents" ] }, "intents": { "type": "array", "items": { "properties": { "intentReferenceId": { "type": "string" }, "intentName": { "type": "string" }, "intentId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "flowName": { "type": "string" }, "flowId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } } } }, "IOverlapIntentFeedbackFinding_2_0": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "someOverlap", "strongOverlap" ] }, "overlappingIntentReferenceId": { "type": "string" }, "overlappingIntentName": { "type": "string" }, "overlappingIntentId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "overlappingFlowName": { "type": "string" }, "overlappingFlowId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } }, "IIntentFeedbackReport_2_0": { "type": "object", "properties": { "findings": { "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "type": { "type": "string", "enum": [ "poorFScore", "fairFScore", "goodFScore", "fewSentences", "unclearIntent", "noSiblings" ] } } }, { "type": "object", "properties": { "type": { "type": "string", "enum": [ "someOverlap", "strongOverlap" ] }, "overlappingIntentReferenceId": { "type": "string" }, "overlappingIntentName": { "type": "string" }, "overlappingIntentId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "overlappingFlowName": { "type": "string" }, "overlappingFlowId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } }, { "type": "object", "properties": { "type": { "type": "string", "enum": [ "lowDataIntents" ] }, "intents": { "type": "array", "items": { "properties": { "intentReferenceId": { "type": "string" }, "intentName": { "type": "string" }, "intentId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "flowName": { "type": "string" }, "flowId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } } } } ] } }, "info": { "type": "object", "properties": { "fScore": { "type": "number" } } } } }, "ISentenceFeedbackReport_2_0": { "type": "object", "properties": { "findings": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "poorScore", "fairScore", "goodScore", "overlap", "wrongIntent" ] } } } }, "info": { "type": "object", "properties": { "trueIntent": { "type": "string" }, "topIntent": { "type": "string" }, "runnerUp": { "type": "string" }, "topScore": { "type": "number" }, "runnerUpScore": { "type": "number" }, "difference": { "type": "number" }, "trueIntentName": { "type": "string" }, "topIntentName": { "type": "string" }, "runnerUpIntentName": { "type": "string" } } } } }, "TSentenceFeedbackFindingType_2_0": { "type": "string", "enum": [ "poorScore", "fairScore", "goodScore", "overlap", "wrongIntent" ] }, "TTrainGroupFeedbackFindingType_2_0": { "type": "string", "enum": [ "poorAccuracy", "fairAccuracy", "goodAccuracy", "lowDataIntents" ] }, "ITrainGroupGenericFinding_2_0": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "poorAccuracy", "fairAccuracy", "goodAccuracy", "lowDataIntents" ] } } }, "ITrainGroupLowDataFinding_2_0": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "lowDataIntents" ] }, "intents": { "type": "array", "items": { "properties": { "intentReferenceId": { "type": "string" }, "intentName": { "type": "string" }, "intentId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "flowName": { "type": "string" }, "flowId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } } } }, "ITrainGroupFeedbackReport_2_0": { "type": "object", "properties": { "findings": { "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "type": { "type": "string", "enum": [ "poorAccuracy", "fairAccuracy", "goodAccuracy", "lowDataIntents" ] } } }, { "type": "object", "properties": { "type": { "type": "string", "enum": [ "lowDataIntents" ] }, "intents": { "type": "array", "items": { "properties": { "intentReferenceId": { "type": "string" }, "intentName": { "type": "string" }, "intentId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "flowName": { "type": "string" }, "flowId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } } } } ] } }, "info": { "type": "object", "properties": { "fScore": { "type": "number" } } } } }, "IFlowData_2_0": { "type": "object", "properties": { "name": { "type": "string" }, "description": { "type": "string" }, "context": { "type": "object" }, "attachedFlows": { "type": "array", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "attachedLexicons": { "type": "array", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "img": { "type": "string" } } }, "IFlowGeneratedData_2_0": { "type": "object", "properties": { "referenceId": { "type": "string", "format": "uuid" }, "intentTrainGroupReference": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "feedbackReport": { "type": "object", "properties": { "findings": { "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "type": { "type": "string", "enum": [ "poorAccuracy", "fairAccuracy", "goodAccuracy", "lowDataIntents" ] } } }, { "type": "object", "properties": { "type": { "type": "string", "enum": [ "lowDataIntents" ] }, "intents": { "type": "array", "items": { "properties": { "intentReferenceId": { "type": "string" }, "intentName": { "type": "string" }, "intentId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "flowName": { "type": "string" }, "flowId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } } } } ] } }, "info": { "type": "object", "properties": { "fScore": { "type": "number" } } } } }, "isTrainingOutOfDate": { "type": "boolean" } } }, "IFlow_2_0": { "type": "object", "properties": { "referenceId": { "type": "string", "format": "uuid" }, "intentTrainGroupReference": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "feedbackReport": { "type": "object", "properties": { "findings": { "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "type": { "type": "string", "enum": [ "poorAccuracy", "fairAccuracy", "goodAccuracy", "lowDataIntents" ] } } }, { "type": "object", "properties": { "type": { "type": "string", "enum": [ "lowDataIntents" ] }, "intents": { "type": "array", "items": { "properties": { "intentReferenceId": { "type": "string" }, "intentName": { "type": "string" }, "intentId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "flowName": { "type": "string" }, "flowId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } } } } ] } }, "info": { "type": "object", "properties": { "fScore": { "type": "number" } } } } }, "isTrainingOutOfDate": { "type": "boolean" }, "name": { "type": "string" }, "description": { "type": "string" }, "context": { "type": "object" }, "attachedFlows": { "type": "array", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "attachedLexicons": { "type": "array", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "img": { "type": "string" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" }, "IUpdateFlowData_2_0": { "type": "object", "properties": { "name": { "type": "string" }, "description": { "type": "string" }, "context": { "type": "object" }, "attachedFlows": { "type": "array", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "attachedLexicons": { "type": "array", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "img": { "type": "string" }, "localeId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } }, "IFlowIndexItem_2_0": { "type": "object", "properties": { "name": { "type": "string" }, "description": { "type": "string" }, "referenceId": { "type": "string", "format": "uuid" }, "isTrainingOutOfDate": { "type": "boolean" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" }, "IIntentData_2_0": { "type": "object", "properties": { "name": { "type": "string", "example": "OrderFood" }, "description": { "type": "string", "example": "Intent to order food" }, "condition": { "type": "string" }, "rules": { "type": "array", "items": { "type": "string" } }, "isRejectIntent": { "type": "boolean" }, "isDisabled": { "type": "boolean" }, "tags": { "type": "array", "items": { "type": "string" } }, "confirmationSentences": { "type": "array", "items": { "type": "string" } }, "disambiguationSentence": { "type": "string" }, "data": { "type": "object" }, "localeReference": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "childFeatures": { "oneOf": [ { "type": "boolean" }, { "type": "array", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "example": false }, "biasTowardsParentOrChildIntents": { "type": "string", "enum": [ "parents", "children" ] }, "parentIntentId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "analyticsLabel": { "type": "string" }, "overrideIntentDefaultRepliesAsExamples": { "type": "string", "description": "Toggle overriding the flow setting for using default replies as training examples", "enum": [ "on", "off", "useFlowSettings" ] } } }, "IIntentGeneratedData_2_0": { "type": "object", "properties": { "referenceId": { "type": "string", "format": "uuid" }, "feedbackReport": { "type": "object", "properties": { "findings": { "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "type": { "type": "string", "enum": [ "poorFScore", "fairFScore", "goodFScore", "fewSentences", "unclearIntent", "noSiblings" ] } } }, { "type": "object", "properties": { "type": { "type": "string", "enum": [ "someOverlap", "strongOverlap" ] }, "overlappingIntentReferenceId": { "type": "string" }, "overlappingIntentName": { "type": "string" }, "overlappingIntentId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "overlappingFlowName": { "type": "string" }, "overlappingFlowId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } }, { "type": "object", "properties": { "type": { "type": "string", "enum": [ "lowDataIntents" ] }, "intents": { "type": "array", "items": { "properties": { "intentReferenceId": { "type": "string" }, "intentName": { "type": "string" }, "intentId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "flowName": { "type": "string" }, "flowId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } } } } ] } }, "info": { "type": "object", "properties": { "fScore": { "type": "number" } } } } } } }, "IIntent_2_0": { "type": "object", "properties": { "name": { "type": "string", "example": "OrderFood" }, "description": { "type": "string", "example": "Intent to order food" }, "condition": { "type": "string" }, "rules": { "type": "array", "items": { "type": "string" } }, "isRejectIntent": { "type": "boolean" }, "isDisabled": { "type": "boolean" }, "tags": { "type": "array", "items": { "type": "string" } }, "confirmationSentences": { "type": "array", "items": { "type": "string" } }, "disambiguationSentence": { "type": "string" }, "data": { "type": "object" }, "localeReference": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "childFeatures": { "oneOf": [ { "type": "boolean" }, { "type": "array", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "example": false }, "biasTowardsParentOrChildIntents": { "type": "string", "enum": [ "parents", "children" ] }, "parentIntentId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "analyticsLabel": { "type": "string" }, "overrideIntentDefaultRepliesAsExamples": { "type": "string", "description": "Toggle overriding the flow setting for using default replies as training examples", "enum": [ "on", "off", "useFlowSettings" ] }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" }, "IIntentIndexItem_2_0": { "type": "object", "properties": { "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "referenceId": { "type": "string", "format": "uuid" }, "name": { "type": "string", "example": "OrderFood" }, "description": { "type": "string", "example": "Intent to order food" }, "tags": { "type": "array", "items": { "type": "string" } }, "isRejectIntent": { "type": "boolean" }, "isDisabled": { "type": "boolean" }, "localeReference": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "parentIntentId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "feedbackReport": { "type": "object", "properties": { "findings": { "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "type": { "type": "string", "enum": [ "poorFScore", "fairFScore", "goodFScore", "fewSentences", "unclearIntent", "noSiblings" ] } } }, { "type": "object", "properties": { "type": { "type": "string", "enum": [ "someOverlap", "strongOverlap" ] }, "overlappingIntentReferenceId": { "type": "string" }, "overlappingIntentName": { "type": "string" }, "overlappingIntentId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "overlappingFlowName": { "type": "string" }, "overlappingFlowId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } }, { "type": "object", "properties": { "type": { "type": "string", "enum": [ "lowDataIntents" ] }, "intents": { "type": "array", "items": { "properties": { "intentReferenceId": { "type": "string" }, "intentName": { "type": "string" }, "intentId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "flowName": { "type": "string" }, "flowId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } } } } ] } }, "info": { "type": "object", "properties": { "fScore": { "type": "number" } } } } } } }, "ILearningSentenceData_2_0": { "type": "object", "properties": { "confirmationCount": { "type": "integer", "example": 42 }, "rejectedCount": { "type": "integer", "example": 42 }, "sentence": { "type": "string", "example": "How do you turn this on?" } } }, "ILearningSentence_2_0": { "type": "object", "properties": { "confirmationCount": { "type": "integer", "example": 42 }, "rejectedCount": { "type": "integer", "example": 42 }, "sentence": { "type": "string", "example": "How do you turn this on?" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" }, "ILearningSentenceIndexItem_2_0": { "type": "object", "properties": { "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "count": { "type": "integer", "example": 42 }, "sentence": { "type": "string", "example": "How do you turn this on?" } } }, "ISentenceData_2_0": { "type": "object", "properties": { "text": { "type": "string", "example": "I want to buy a pizza." }, "slots": { "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "type": { "type": "string", "enum": [ "anySlot" ] }, "name": { "type": "string" }, "start": { "type": "number" }, "end": { "type": "number" } } }, { "type": "object", "properties": { "type": { "type": "string", "enum": [ "systemSlot" ] }, "dimension": { "type": "string" }, "start": { "type": "number" }, "end": { "type": "number" } } }, { "type": "object", "properties": { "type": { "type": "string", "enum": [ "lexiconSlot" ] }, "lexiconReference": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "slotReference": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "name": { "type": "string" }, "start": { "type": "number" }, "end": { "type": "number" } } } ] } } } }, "ISentenceGeneratedData_2_0": { "type": "object", "properties": { "localeReference": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "feedbackReport": { "type": "object", "properties": { "findings": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "poorScore", "fairScore", "goodScore", "overlap", "wrongIntent" ] } } } }, "info": { "type": "object", "properties": { "trueIntent": { "type": "string" }, "topIntent": { "type": "string" }, "runnerUp": { "type": "string" }, "topScore": { "type": "number" }, "runnerUpScore": { "type": "number" }, "difference": { "type": "number" }, "trueIntentName": { "type": "string" }, "topIntentName": { "type": "string" }, "runnerUpIntentName": { "type": "string" } } } } } } }, "ISentence_2_0": { "type": "object", "properties": { "localeReference": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "feedbackReport": { "type": "object", "properties": { "findings": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "poorScore", "fairScore", "goodScore", "overlap", "wrongIntent" ] } } } }, "info": { "type": "object", "properties": { "trueIntent": { "type": "string" }, "topIntent": { "type": "string" }, "runnerUp": { "type": "string" }, "topScore": { "type": "number" }, "runnerUpScore": { "type": "number" }, "difference": { "type": "number" }, "trueIntentName": { "type": "string" }, "topIntentName": { "type": "string" }, "runnerUpIntentName": { "type": "string" } } } } }, "text": { "type": "string", "example": "I want to buy a pizza." }, "slots": { "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "type": { "type": "string", "enum": [ "anySlot" ] }, "name": { "type": "string" }, "start": { "type": "number" }, "end": { "type": "number" } } }, { "type": "object", "properties": { "type": { "type": "string", "enum": [ "systemSlot" ] }, "dimension": { "type": "string" }, "start": { "type": "number" }, "end": { "type": "number" } } }, { "type": "object", "properties": { "type": { "type": "string", "enum": [ "lexiconSlot" ] }, "lexiconReference": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "slotReference": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "name": { "type": "string" }, "start": { "type": "number" }, "end": { "type": "number" } } } ] } }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" }, "ILexiconSentenceSlot_2_0": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "lexiconSlot" ] }, "lexiconReference": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "slotReference": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "name": { "type": "string" }, "start": { "type": "number" }, "end": { "type": "number" } } }, "IAnySlot_2_0": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "anySlot" ] }, "name": { "type": "string" }, "start": { "type": "number" }, "end": { "type": "number" } } }, "ISystemSlot_2_0": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "systemSlot" ] }, "dimension": { "type": "string" }, "start": { "type": "number" }, "end": { "type": "number" } } }, "ISentenceIndexItemData_2_0": { "type": "object", "properties": { "text": { "type": "string", "example": "I want to buy a pizza." }, "localeReference": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "slots": { "type": "array", "items": { "type": "object", "additionalProperties": false, "properties": { "tagReference": { "type": "string" }, "lexiconReference": { "type": "string" } } } }, "feedbackReport": { "type": "object", "properties": { "findings": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "poorScore", "fairScore", "goodScore", "overlap", "wrongIntent" ] } } } }, "info": { "type": "object", "properties": { "trueIntent": { "type": "string" }, "topIntent": { "type": "string" }, "runnerUp": { "type": "string" }, "topScore": { "type": "number" }, "runnerUpScore": { "type": "number" }, "difference": { "type": "number" }, "trueIntentName": { "type": "string" }, "topIntentName": { "type": "string" }, "runnerUpIntentName": { "type": "string" } } } } } } }, "ISentenceIndexItem_2_0": { "type": "object", "properties": { "text": { "type": "string", "example": "I want to buy a pizza." }, "localeReference": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "slots": { "type": "array", "items": { "type": "object", "additionalProperties": false, "properties": { "tagReference": { "type": "string" }, "lexiconReference": { "type": "string" } } } }, "feedbackReport": { "type": "object", "properties": { "findings": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "poorScore", "fairScore", "goodScore", "overlap", "wrongIntent" ] } } } }, "info": { "type": "object", "properties": { "trueIntent": { "type": "string" }, "topIntent": { "type": "string" }, "runnerUp": { "type": "string" }, "topScore": { "type": "number" }, "runnerUpScore": { "type": "number" }, "difference": { "type": "number" }, "trueIntentName": { "type": "string" }, "topIntentName": { "type": "string" }, "runnerUpIntentName": { "type": "string" } } } } }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" }, "IYesNoSentenceData_2_0": { "type": "object", "properties": { "text": { "type": "string", "example": "I want to buy a pizza." } } }, "IYesNoSentenceGeneratedData_2_0": { "type": "object", "properties": { "localeReference": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "feedbackReport": { "type": "object", "properties": { "findings": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "poorScore", "fairScore", "goodScore", "overlap", "wrongIntent" ] } } } }, "info": { "type": "object", "properties": { "trueIntent": { "type": "string" }, "topIntent": { "type": "string" }, "runnerUp": { "type": "string" }, "topScore": { "type": "number" }, "runnerUpScore": { "type": "number" }, "difference": { "type": "number" }, "trueIntentName": { "type": "string" }, "topIntentName": { "type": "string" }, "runnerUpIntentName": { "type": "string" } } } } } } }, "IYesNoSentence_2_0": { "type": "object", "properties": { "localeReference": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "feedbackReport": { "type": "object", "properties": { "findings": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "poorScore", "fairScore", "goodScore", "overlap", "wrongIntent" ] } } } }, "info": { "type": "object", "properties": { "trueIntent": { "type": "string" }, "topIntent": { "type": "string" }, "runnerUp": { "type": "string" }, "topScore": { "type": "number" }, "runnerUpScore": { "type": "number" }, "difference": { "type": "number" }, "trueIntentName": { "type": "string" }, "topIntentName": { "type": "string" }, "runnerUpIntentName": { "type": "string" } } } } }, "text": { "type": "string", "example": "I want to buy a pizza." }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" }, "IFlowSettingsData_2_0": { "type": "object", "properties": { "continueExecutionAfterAttachedFlow": { "type": "boolean" }, "continueExecutionAterDefaultReply": { "type": "boolean" }, "continueExecutionAfterNegativeConfirmation": { "type": "boolean" }, "passDefaultRepliesIntoFlow": { "type": "boolean" }, "flowIntentMappingOrder": { "type": "string", "enum": [ "joint", "main", "attached" ] }, "useAttachedFlowThresholds": { "type": "boolean" }, "useAttachedFlowContinueAfterDefaultReply": { "type": "boolean" }, "useAttachedFlowPassDefaultRepliesIntoFlow": { "type": "boolean" }, "implicitSlotParsing": { "type": "string", "enum": [ "disabled", "full", "system", "lexicon" ] }, "useAttachedFlowImplicitSlotParsing": { "type": "boolean" }, "lexiconSlotsWithSubMatches": { "type": "boolean" }, "useIntentDefaultRepliesAsExamples": { "description": "Enable/Disable using default replies as training examples.", "type": "boolean" }, "localeSettings": { "type": "object", "properties": { "localeReference": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "inheritFallbackLocaleModel": { "type": "boolean" } } } } }, "IFlowSettingsResponse_2_0": { "type": "object", "properties": { "continueExecutionAfterAttachedFlow": { "type": "boolean" }, "continueExecutionAterDefaultReply": { "type": "boolean" }, "continueExecutionAfterNegativeConfirmation": { "type": "boolean" }, "passDefaultRepliesIntoFlow": { "type": "boolean" }, "flowIntentMappingOrder": { "type": "string", "enum": [ "joint", "main", "attached" ] }, "useAttachedFlowThresholds": { "type": "boolean" }, "useAttachedFlowContinueAfterDefaultReply": { "type": "boolean" }, "useAttachedFlowPassDefaultRepliesIntoFlow": { "type": "boolean" }, "implicitSlotParsing": { "type": "string", "enum": [ "disabled", "full", "system", "lexicon" ] }, "useAttachedFlowImplicitSlotParsing": { "type": "boolean" }, "lexiconSlotsWithSubMatches": { "type": "boolean" }, "useIntentDefaultRepliesAsExamples": { "description": "Enable/Disable using default replies as training examples.", "type": "boolean" }, "localeSettings": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "object", "properties": { "localeReference": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "inheritFallbackLocaleModel": { "type": "boolean" } } } } } } } }, "IFlowSettings_2_0": { "type": "object", "properties": { "continueExecutionAfterAttachedFlow": { "type": "boolean" }, "continueExecutionAterDefaultReply": { "type": "boolean" }, "continueExecutionAfterNegativeConfirmation": { "type": "boolean" }, "passDefaultRepliesIntoFlow": { "type": "boolean" }, "flowIntentMappingOrder": { "type": "string", "enum": [ "joint", "main", "attached" ] }, "useAttachedFlowThresholds": { "type": "boolean" }, "useAttachedFlowContinueAfterDefaultReply": { "type": "boolean" }, "useAttachedFlowPassDefaultRepliesIntoFlow": { "type": "boolean" }, "implicitSlotParsing": { "type": "string", "enum": [ "disabled", "full", "system", "lexicon" ] }, "useAttachedFlowImplicitSlotParsing": { "type": "boolean" }, "lexiconSlotsWithSubMatches": { "type": "boolean" }, "useIntentDefaultRepliesAsExamples": { "description": "Enable/Disable using default replies as training examples.", "type": "boolean" }, "localeSettings": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "object", "properties": { "localeReference": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "inheritFallbackLocaleModel": { "type": "boolean" } } } } } }, "intentThreshold": { "type": "object", "properties": { "lower": { "type": "number", "example": 0.4 }, "upper": { "type": "number", "example": 0.5 } } }, "learnNewExampleSentences": { "type": "boolean" }, "learnNewExampleSentencesThreshold": { "type": "integer" }, "negativeConfirmationWords": { "type": "array", "items": { "type": "string" } }, "positiveConfirmationWords": { "type": "array", "items": { "type": "string" } }, "systemSlots": { "type": "object", "properties": { "useAgeSlots": { "type": "boolean" }, "useDateSlots": { "type": "boolean" }, "useDistanceSlots": { "type": "boolean" }, "useDurationSlots": { "type": "boolean" }, "useEmailSlots": { "type": "boolean" }, "useMoneySlots": { "type": "boolean" }, "useNumberSlots": { "type": "boolean" }, "usePercentageSlots": { "type": "boolean" }, "useTemperatureSlots": { "type": "boolean" }, "useURLSlots": { "type": "boolean" } } }, "yesNoLogic": { "type": "string", "enum": [ "yesNoIntents", "yesNoIntentsWithRules", "confirmationWords" ] }, "yesNoIntentThreshold": { "type": "integer" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" }, "ILocaleSettings_2_0": { "type": "object", "properties": { "localeReference": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "inheritFallbackLocaleModel": { "type": "boolean" } } }, "ISlotFillerData_2_0": { "type": "object", "properties": { "name": { "type": "string" }, "type": { "type": "string", "example": "age", "enum": [ "age", "date", "duration", "email", "intent", "slot", "money", "number", "percentage", "regex", "temperature" ] }, "usePositiveOnly": { "type": "boolean" }, "removeNegated": { "type": "boolean" }, "storeResultInContext": { "type": "boolean" }, "contextKey": { "type": "string" }, "storeInContactProfile": { "type": "boolean" }, "profileKey": { "type": "string" }, "storeDetailedResults": { "type": "boolean" }, "skipIfResultInContext": { "type": "boolean" }, "additionalValidation": { "type": "string" }, "resultLocation": { "type": "string" }, "regex": { "type": "string" }, "slot": { "type": "string" } } }, "ISlotFillerGeneratedData_2_0": { "type": "object", "properties": { "referenceId": { "type": "string", "format": "uuid" } } }, "ISlotFiller_2_0": { "type": "object", "properties": { "name": { "type": "string" }, "type": { "type": "string", "example": "age", "enum": [ "age", "date", "duration", "email", "intent", "slot", "money", "number", "percentage", "regex", "temperature" ] }, "usePositiveOnly": { "type": "boolean" }, "removeNegated": { "type": "boolean" }, "storeResultInContext": { "type": "boolean" }, "contextKey": { "type": "string" }, "storeInContactProfile": { "type": "boolean" }, "profileKey": { "type": "string" }, "storeDetailedResults": { "type": "boolean" }, "skipIfResultInContext": { "type": "boolean" }, "additionalValidation": { "type": "string" }, "resultLocation": { "type": "string" }, "regex": { "type": "string" }, "slot": { "type": "string" }, "referenceId": { "type": "string", "format": "uuid" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" }, "ISlotFillerIndexItemData_2_0": { "type": "object", "properties": { "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "name": { "type": "string", "example": "pizza" }, "type": { "type": "string", "example": "age", "enum": [ "age", "date", "duration", "email", "intent", "slot", "money", "number", "percentage", "regex", "temperature" ] }, "referenceId": { "type": "string" } } }, "ISlotFillerIndexItem_2_0": { "type": "object", "properties": { "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "name": { "type": "string", "example": "pizza" }, "type": { "type": "string", "example": "age", "enum": [ "age", "date", "duration", "email", "intent", "slot", "money", "number", "percentage", "regex", "temperature" ] }, "referenceId": { "type": "string" }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" }, "IFlowStateData_2_0": { "type": "object", "properties": { "name": { "type": "string", "example": "default" }, "isDefault": { "type": "boolean" }, "type": { "type": "string", "enum": [ "blacklist", "whitelist" ], "example": "blacklist" }, "intentIds": { "type": "array", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } }, "IFlowStateGeneratedData_2_0": { "type": "object", "properties": { "referenceId": { "type": "string", "format": "uuid" } } }, "IFlowState_2_0": { "type": "object", "properties": { "name": { "type": "string", "example": "default" }, "isDefault": { "type": "boolean" }, "type": { "type": "string", "enum": [ "blacklist", "whitelist" ], "example": "blacklist" }, "intentIds": { "type": "array", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "referenceId": { "type": "string", "format": "uuid" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" }, "IFlowStateIndexItem_2_0": { "type": "object", "properties": { "name": { "type": "string", "example": "default" }, "referenceId": { "type": "string", "format": "uuid" }, "isDefault": { "type": "boolean" }, "type": { "type": "string", "enum": [ "blacklist", "whitelist" ], "example": "blacklist" }, "intentIds": { "type": "array", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" }, "IFunctionData_2_0": { "type": "object", "properties": { "name": { "type": "string" }, "code": { "type": "string" }, "isDisabled": { "type": "boolean" } } }, "IFunction_2_0": { "type": "object", "properties": { "name": { "type": "string" }, "code": { "type": "string" }, "isDisabled": { "type": "boolean" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" }, "IFunctionIndexItem_2_0": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the function", "example": "New Function" }, "code": { "type": "string", "description": "The code of the function", "example": "console.log('Hello World');" }, "referenceId": { "type": "string", "format": "uuid" }, "isDisabled": { "type": "boolean" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" }, "IFunctionInstanceData_2_0": { "type": "object", "properties": { "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "functionReference": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "trigger": { "type": "string", "enum": [ "flow", "manual" ], "description": "How was this function instance triggered, e.g. was it spawned while executing a Flow?", "example": "flow" }, "status": { "type": "string", "enum": [ "queued", "active", "done", "error" ], "description": "The current state of the instance. New instances are in the 'queued' state, while running ones are in 'active' state.", "example": "active" }, "error": { "type": "string" }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "finishedAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 } } }, "IFunctionInstance_2_0": { "type": "object", "properties": { "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "functionReference": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "trigger": { "type": "string", "enum": [ "flow", "manual" ], "description": "How was this function instance triggered, e.g. was it spawned while executing a Flow?", "example": "flow" }, "status": { "type": "string", "enum": [ "queued", "active", "done", "error" ], "description": "The current state of the instance. New instances are in the 'queued' state, while running ones are in 'active' state.", "example": "active" }, "error": { "type": "string" }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "finishedAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 } } }, "IFunctionInstanceIndexItem_2_0": { "type": "object", "properties": { "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "trigger": { "type": "string", "enum": [ "flow", "manual" ], "description": "How was this function instance triggered, e.g. was it spawned while executing a Flow?", "example": "flow" }, "status": { "type": "string", "enum": [ "queued", "active", "done", "error" ], "description": "The current state of the instance. New instances are in the 'queued' state, while running ones are in 'active' state.", "example": "active" }, "error": { "type": "string" }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "finishedAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 } } }, "TFunctionInstanceStatus_2_0": { "type": "string", "enum": [ "queued", "active", "done", "error" ], "description": "The current state of the instance. New instances are in the 'queued' state, while running ones are in 'active' state.", "example": "active" }, "TFunctionInstanceTrigger_2_0": { "type": "string", "enum": [ "flow", "manual" ], "description": "How was this function instance triggered, e.g. was it spawned while executing a Flow?", "example": "flow" }, "IKnowledgeSearchIngestData_2_0": { "type": "object", "properties": { "documentUrl": { "type": "string", "example": "https://some-website.com/knowledgebase.txt", "description": "The document url or the file name ingested for the knowledge store" }, "paragraphNumber": { "type": "number", "example": 3, "description": "The paragraph number of the document" }, "content": { "type": "string", "example": "some content", "description": "The content of the paragraph" }, "data": { "type": "object", "example": { "someKey": "someValue" }, "description": "The supporting data of the paragraph" } } }, "IKnowledgeStoreDataCreate_2_0": { "type": "object", "properties": { "name": { "type": "string", "example": "mystore", "description": "The name of the KnowledgeStore" }, "description": { "type": "string", "example": "mystore description", "description": "The description about what the knowledge store contains" } } }, "IKnowledgeStoreData_2_0": { "type": "object", "properties": { "name": { "type": "string", "example": "mystore", "description": "The name of the KnowledgeStore" }, "description": { "type": "string", "example": "mystore description", "description": "The description about what the knowledge store contains" }, "language": { "type": "string", "example": "en-US", "description": "The language code" }, "status": { "type": "string", "enum": [ "ready", "warning" ] }, "documents": { "type": "array", "items": { "type": "string", "example": "https://some-website.com/knowledgebase.txt", "description": "The document url or the file name ingested for the knowledge store" } } } }, "IKnowledgeStoreGeneratedData_2_0": { "type": "object", "properties": { "referenceId": { "type": "string", "format": "uuid" } } }, "IKnowledgeStore_2_0": { "type": "object", "properties": { "name": { "type": "string", "example": "mystore", "description": "The name of the KnowledgeStore" }, "description": { "type": "string", "example": "mystore description", "description": "The description about what the knowledge store contains" }, "language": { "type": "string", "example": "en-US", "description": "The language code" }, "status": { "type": "string", "enum": [ "ready", "warning" ] }, "documents": { "type": "array", "items": { "type": "string", "example": "https://some-website.com/knowledgebase.txt", "description": "The document url or the file name ingested for the knowledge store" } }, "referenceId": { "type": "string", "format": "uuid" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" }, "IKnowledgeChunkDataCreate_2_0": { "type": "object", "properties": { "order": { "type": "number", "example": 1, "description": "The name of the KnowledgeChunk" }, "text": { "type": "string", "example": "This is a paragraph from an article", "description": "The text that is the actual content of the chunk" }, "data": { "type": "object", "description": "The extended data of KnowledgeChunk" } } }, "IKnowledgeChunkData_2_0": { "type": "object", "properties": { "order": { "type": "number", "example": 1, "description": "The name of the KnowledgeChunk" }, "text": { "type": "string", "example": "This is a paragraph from an article", "description": "The text that is the actual content of the chunk" }, "data": { "type": "object", "description": "The extended data of KnowledgeChunk" }, "disabled": { "type": "boolean", "enum": [ false, true ], "description": "The status to check if knowledge chunk is disabled" } } }, "IKnowledgeChunkGeneratedData_2_0": { "type": "object", "properties": { "referenceId": { "type": "string", "format": "uuid" } } }, "IKnowledgeChunk_2_0": { "type": "object", "properties": { "order": { "type": "number", "example": 1, "description": "The name of the KnowledgeChunk" }, "text": { "type": "string", "example": "This is a paragraph from an article", "description": "The text that is the actual content of the chunk" }, "data": { "type": "object", "description": "The extended data of KnowledgeChunk" }, "disabled": { "type": "boolean", "enum": [ false, true ], "description": "The status to check if knowledge chunk is disabled" }, "referenceId": { "type": "string", "format": "uuid" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" }, "IKnowledgeSourceDataCreate_2_0": { "type": "object", "properties": { "name": { "type": "string", "example": "mysource", "description": "The name of the KnowledgeSource" }, "description": { "type": "string", "example": "mysource description", "description": "The description about what the knowledge source contains" }, "type": { "type": "string", "enum": [ "url", "manual", "pdf", "txt", "ctxt" ], "description": "The type of source for the Knowledge store" }, "metaData": { "type": "object", "properties": { "tags": { "type": "array", "items": { "type": "string", "example": "tag1" } } } } } }, "IKnowledgeSourceDataUpdate_2_0": { "type": "object", "properties": { "name": { "type": "string", "example": "mysource", "description": "The name of the KnowledgeSource" }, "description": { "type": "string", "example": "mysource description", "description": "The description about what the knowledge source contains" }, "status": { "type": "string", "enum": [ "ready", "ingesting", "disabled" ] } } }, "IKnowledgeSourceDataTypeWebsite_2_0": { "type": "object", "properties": { "url": { "type": "string", "example": "https://www.some-article.com", "description": "The url of the website to scrape the data from. This is only applicable for KnowledgeSources of type \"url\"" } } }, "IKnowledgeSourceData_2_0": { "type": "object", "properties": { "name": { "type": "string", "example": "mysource", "description": "The name of the KnowledgeSource" }, "description": { "type": "string", "example": "mysource description", "description": "The description about what the knowledge source contains" }, "type": { "type": "string", "enum": [ "url", "manual", "pdf", "txt", "ctxt" ], "description": "The type of source for the Knowledge store" }, "metaData": { "type": "object", "properties": { "tags": { "type": "array", "items": { "type": "string", "example": "tag1" } } } }, "chunkCount": { "type": "integer" }, "status": { "type": "string", "enum": [ "ready", "ingesting", "disabled" ] } } }, "IKnowledgeSourceGeneratedData_2_0": { "type": "object", "properties": { "referenceId": { "type": "string", "format": "uuid" } } }, "IKnowledgeSource_2_0": { "type": "object", "properties": { "name": { "type": "string", "example": "mysource", "description": "The name of the KnowledgeSource" }, "description": { "type": "string", "example": "mysource description", "description": "The description about what the knowledge source contains" }, "type": { "type": "string", "enum": [ "url", "manual", "pdf", "txt", "ctxt" ], "description": "The type of source for the Knowledge store" }, "metaData": { "type": "object", "properties": { "tags": { "type": "array", "items": { "type": "string", "example": "tag1" } } } }, "chunkCount": { "type": "integer" }, "status": { "type": "string", "enum": [ "ready", "ingesting", "disabled" ] }, "referenceId": { "type": "string", "format": "uuid" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" }, "ILargeLanguageModelFields_2_0": { "type": "object", "required": [ "name", "modelType", "provider", "connectionId" ], "properties": { "name": { "type": "string", "example": "LLM Name" }, "description": { "type": "string", "example": "LLM meaningful description" }, "modelType": { "type": "string", "enum": [ "gpt-3.5-turbo", "gpt-3.5-turbo-instruct", "text-davinci-003", "gpt-4", "text-embedding-ada-002", "luminous-extended-control", "luminous-embedding-128", "claude-v1-100k", "claude-instant-v1", "claude-3-opus-20240229", "text-bison@001", "custom-model", "gemini-1.0-pro" ] }, "modelGroup": { "type": "string", "enum": [ "chat", "completion" ] }, "isCustomModel": { "type": "boolean", "example": true }, "provider": { "type": "string", "enum": [ "azureOpenAI", "openAI", "anthropic", "googleVertexAI", "googleGemini", "alephAlpha" ] }, "connectionId": { "type": "string", "description": "The reference id of the GenerativeAI Provider Connection", "format": "uuid" }, "isDefault": { "type": "boolean", "description": "Sets the LLM to default (fallback) if no other LLM is set", "example": false }, "openAI": { "type": "object", "description": "OpenAI specific meta data", "properties": { "customModel": { "type": "string", "example": "gpt-4-32k-0613", "description": "The custom model name. This does not work with embedding models" } } }, "anthropic": { "type": "object", "description": "Anthropic specific meta data", "properties": { "customModel": { "type": "string", "example": "claude-3-opus-20240229", "description": "The custom model name. This does not work with embedding models" } } }, "azureOpenAI": { "type": "object", "description": "Azure OpenAI specific meta data", "properties": { "resourceName": { "type": "string" }, "deploymentName": { "type": "string" }, "apiVersion": { "type": "string" }, "baseCustomUrl": { "type": "string", "example": [ "https://.openai.azure.com/openai/deployments//chat/completions?api-version=", "https://.openai.azure.com/openai/deployments//completions?api-version=", "https://.openai.azure.com/openai/deployments//embeddings?api-version=" ] } } }, "googleVertexAI": { "type": "object", "description": "Google VertexAI specific meta data", "properties": { "location": { "type": "string" }, "apiEndpoint": { "type": "string" }, "publisher": { "type": "string" } } }, "googleGemini": { "type": "object", "description": "Google Gemini specific meta data", "properties": { "location": { "type": "string" } } }, "alephAlpha": { "type": "object", "description": "Aleph Alpha specific meta data", "properties": { "customModel": { "type": "string", "example": "luminous-003", "description": "The custom model name. This does not work with embedding models" }, "baseCustomUrl": { "type": "string", "example": "https://api.aleph-alpha.com" } } } } }, "ILargeLanguageModelCreate_2_0": { "type": "object", "required": [ "name", "modelType", "provider", "connectionId" ], "properties": { "name": { "type": "string", "example": "LLM Name" }, "description": { "type": "string", "example": "LLM meaningful description" }, "modelType": { "type": "string", "enum": [ "gpt-3.5-turbo", "gpt-3.5-turbo-instruct", "text-davinci-003", "gpt-4", "text-embedding-ada-002", "luminous-extended-control", "luminous-embedding-128", "claude-v1-100k", "claude-instant-v1", "claude-3-opus-20240229", "text-bison@001", "custom-model", "gemini-1.0-pro" ] }, "modelGroup": { "type": "string", "enum": [ "chat", "completion" ] }, "isCustomModel": { "type": "boolean", "example": true }, "provider": { "type": "string", "enum": [ "azureOpenAI", "openAI", "anthropic", "googleVertexAI", "googleGemini", "alephAlpha" ] }, "connectionId": { "type": "string", "description": "The reference id of the GenerativeAI Provider Connection", "format": "uuid" }, "isDefault": { "type": "boolean", "description": "Sets the LLM to default (fallback) if no other LLM is set", "example": false }, "openAI": { "type": "object", "description": "OpenAI specific meta data", "properties": { "customModel": { "type": "string", "example": "gpt-4-32k-0613", "description": "The custom model name. This does not work with embedding models" } } }, "anthropic": { "type": "object", "description": "Anthropic specific meta data", "properties": { "customModel": { "type": "string", "example": "claude-3-opus-20240229", "description": "The custom model name. This does not work with embedding models" } } }, "azureOpenAI": { "type": "object", "description": "Azure OpenAI specific meta data", "properties": { "resourceName": { "type": "string" }, "deploymentName": { "type": "string" }, "apiVersion": { "type": "string" }, "baseCustomUrl": { "type": "string", "example": [ "https://.openai.azure.com/openai/deployments//chat/completions?api-version=", "https://.openai.azure.com/openai/deployments//completions?api-version=", "https://.openai.azure.com/openai/deployments//embeddings?api-version=" ] } } }, "googleVertexAI": { "type": "object", "description": "Google VertexAI specific meta data", "properties": { "location": { "type": "string" }, "apiEndpoint": { "type": "string" }, "publisher": { "type": "string" } } }, "googleGemini": { "type": "object", "description": "Google Gemini specific meta data", "properties": { "location": { "type": "string" } } }, "alephAlpha": { "type": "object", "description": "Aleph Alpha specific meta data", "properties": { "customModel": { "type": "string", "example": "luminous-003", "description": "The custom model name. This does not work with embedding models" }, "baseCustomUrl": { "type": "string", "example": "https://api.aleph-alpha.com" } } } } }, "ILargeLanguageModelData_2_0": { "type": "object", "required": [ "name", "modelType", "provider", "connectionId" ], "properties": { "name": { "type": "string", "example": "LLM Name" }, "description": { "type": "string", "example": "LLM meaningful description" }, "modelType": { "type": "string", "enum": [ "gpt-3.5-turbo", "gpt-3.5-turbo-instruct", "text-davinci-003", "gpt-4", "text-embedding-ada-002", "luminous-extended-control", "luminous-embedding-128", "claude-v1-100k", "claude-instant-v1", "claude-3-opus-20240229", "text-bison@001", "custom-model", "gemini-1.0-pro" ] }, "modelGroup": { "type": "string", "enum": [ "chat", "completion" ] }, "isCustomModel": { "type": "boolean", "example": true }, "provider": { "type": "string", "enum": [ "azureOpenAI", "openAI", "anthropic", "googleVertexAI", "googleGemini", "alephAlpha" ] }, "connectionId": { "type": "string", "description": "The reference id of the GenerativeAI Provider Connection", "format": "uuid" }, "isDefault": { "type": "boolean", "description": "Sets the LLM to default (fallback) if no other LLM is set", "example": false }, "openAI": { "type": "object", "description": "OpenAI specific meta data", "properties": { "customModel": { "type": "string", "example": "gpt-4-32k-0613", "description": "The custom model name. This does not work with embedding models" } } }, "anthropic": { "type": "object", "description": "Anthropic specific meta data", "properties": { "customModel": { "type": "string", "example": "claude-3-opus-20240229", "description": "The custom model name. This does not work with embedding models" } } }, "azureOpenAI": { "type": "object", "description": "Azure OpenAI specific meta data", "properties": { "resourceName": { "type": "string" }, "deploymentName": { "type": "string" }, "apiVersion": { "type": "string" }, "baseCustomUrl": { "type": "string", "example": [ "https://.openai.azure.com/openai/deployments//chat/completions?api-version=", "https://.openai.azure.com/openai/deployments//completions?api-version=", "https://.openai.azure.com/openai/deployments//embeddings?api-version=" ] } } }, "googleVertexAI": { "type": "object", "description": "Google VertexAI specific meta data", "properties": { "location": { "type": "string" }, "apiEndpoint": { "type": "string" }, "publisher": { "type": "string" } } }, "googleGemini": { "type": "object", "description": "Google Gemini specific meta data", "properties": { "location": { "type": "string" } } }, "alephAlpha": { "type": "object", "description": "Aleph Alpha specific meta data", "properties": { "customModel": { "type": "string", "example": "luminous-003", "description": "The custom model name. This does not work with embedding models" }, "baseCustomUrl": { "type": "string", "example": "https://api.aleph-alpha.com" } } }, "referenceId": { "type": "string", "description": "The reference id of the LargeLanguageModel", "format": "uuid" } } }, "ILargeLanguageModel_2_0": { "type": "object", "required": [ "name", "modelType", "provider", "connectionId" ], "properties": { "name": { "type": "string", "example": "LLM Name" }, "description": { "type": "string", "example": "LLM meaningful description" }, "modelType": { "type": "string", "enum": [ "gpt-3.5-turbo", "gpt-3.5-turbo-instruct", "text-davinci-003", "gpt-4", "text-embedding-ada-002", "luminous-extended-control", "luminous-embedding-128", "claude-v1-100k", "claude-instant-v1", "claude-3-opus-20240229", "text-bison@001", "custom-model", "gemini-1.0-pro" ] }, "modelGroup": { "type": "string", "enum": [ "chat", "completion" ] }, "isCustomModel": { "type": "boolean", "example": true }, "provider": { "type": "string", "enum": [ "azureOpenAI", "openAI", "anthropic", "googleVertexAI", "googleGemini", "alephAlpha" ] }, "connectionId": { "type": "string", "description": "The reference id of the GenerativeAI Provider Connection", "format": "uuid" }, "isDefault": { "type": "boolean", "description": "Sets the LLM to default (fallback) if no other LLM is set", "example": false }, "openAI": { "type": "object", "description": "OpenAI specific meta data", "properties": { "customModel": { "type": "string", "example": "gpt-4-32k-0613", "description": "The custom model name. This does not work with embedding models" } } }, "anthropic": { "type": "object", "description": "Anthropic specific meta data", "properties": { "customModel": { "type": "string", "example": "claude-3-opus-20240229", "description": "The custom model name. This does not work with embedding models" } } }, "azureOpenAI": { "type": "object", "description": "Azure OpenAI specific meta data", "properties": { "resourceName": { "type": "string" }, "deploymentName": { "type": "string" }, "apiVersion": { "type": "string" }, "baseCustomUrl": { "type": "string", "example": [ "https://.openai.azure.com/openai/deployments//chat/completions?api-version=", "https://.openai.azure.com/openai/deployments//completions?api-version=", "https://.openai.azure.com/openai/deployments//embeddings?api-version=" ] } } }, "googleVertexAI": { "type": "object", "description": "Google VertexAI specific meta data", "properties": { "location": { "type": "string" }, "apiEndpoint": { "type": "string" }, "publisher": { "type": "string" } } }, "googleGemini": { "type": "object", "description": "Google Gemini specific meta data", "properties": { "location": { "type": "string" } } }, "alephAlpha": { "type": "object", "description": "Aleph Alpha specific meta data", "properties": { "customModel": { "type": "string", "example": "luminous-003", "description": "The custom model name. This does not work with embedding models" }, "baseCustomUrl": { "type": "string", "example": "https://api.aleph-alpha.com" } } }, "referenceId": { "type": "string", "description": "The reference id of the LargeLanguageModel", "format": "uuid" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" }, "ILargeLanguageModelIndexItem_2_0": { "type": "object", "properties": { "referenceId": { "type": "string", "description": "The reference id of the LargeLanguageModel", "format": "uuid" }, "name": { "type": "string", "example": "LLM Name" }, "description": { "type": "string", "example": "LLM Name" }, "modeltype": { "type": "string", "enum": [ "gpt-3.5-turbo", "gpt-3.5-turbo-instruct", "text-davinci-003", "gpt-4", "text-embedding-ada-002", "luminous-extended-control", "luminous-embedding-128", "claude-v1-100k", "claude-instant-v1", "claude-3-opus-20240229", "text-bison@001", "custom-model", "gemini-1.0-pro" ] }, "provider": { "type": "string", "enum": [ "azureOpenAI", "openAI", "anthropic", "googleVertexAI", "googleGemini", "alephAlpha" ] }, "connectionId": { "type": "string", "description": "The reference id of the GenerativeAI Provider Connection", "format": "uuid" }, "isDefault": { "type": "boolean", "description": "Sets the LLM to default (fallback) if no other LLM is set", "example": false }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" }, "TImportLexiconMode_2_0": { "type": "string", "example": "skip", "enum": [ "skip", "overwrite", "merge" ] }, "ILexiconData_2_0": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the lexicon", "example": "EU countries" }, "description": { "type": "string", "description": "A meaningful description of the lexicon", "example": "Countries members of the European Union, e.g. Spain" } } }, "ILexiconGeneratedData_2_0": { "type": "object", "properties": { "referenceId": { "type": "string", "format": "uuid" }, "values": { "deprecated": true } } }, "ILexicon_2_0": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the lexicon", "example": "EU countries" }, "description": { "type": "string", "description": "A meaningful description of the lexicon", "example": "Countries members of the European Union, e.g. Spain" }, "referenceId": { "type": "string", "format": "uuid" }, "values": { "deprecated": true }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" }, "ILexiconEntryData_2_0": { "type": "object", "required": [ "mainKeyphrase" ], "properties": { "data": { "type": "string", "description": "Additional JSON-data of the lexicon entry", "example": "{\"key1\": \"value1\" }" }, "slotReferences": { "type": "array", "description": "The used slots by the lexicon entry", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "mainKeyphrase": { "type": "string", "description": "the keyphrase value", "example": "pizza" } } }, "ILexiconEntryGeneratedData_2_0": { "type": "object", "properties": { "mainKeyphrase": { "type": "string", "description": "the keyphrase value", "example": "pizza" }, "keyphrases": { "type": "object", "properties": { "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "value": { "type": "string", "description": "the keyphrase value", "example": "pizza" }, "isMainKeyphrase": { "type": "boolean", "description": "Indicator if the Keyphrase is the mainKeyphrase", "example": true } } } } }, "ILexiconEntry_2_0": { "type": "object", "required": [ "mainKeyphrase" ], "properties": { "data": { "type": "string", "description": "Additional JSON-data of the lexicon entry", "example": "{\"key1\": \"value1\" }" }, "slotReferences": { "type": "array", "description": "The used slots by the lexicon entry", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "mainKeyphrase": { "type": "string", "description": "the keyphrase value", "example": "pizza" }, "keyphrases": { "type": "object", "properties": { "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "value": { "type": "string", "description": "the keyphrase value", "example": "pizza" }, "isMainKeyphrase": { "type": "boolean", "description": "Indicator if the Keyphrase is the mainKeyphrase", "example": true } } }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" }, "ILexiconEntryIndexItem_2_0": { "type": "object", "properties": { "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "mainKeyphrase": { "description": "the keyphrase value", "example": "pizza" }, "data": { "type": "string", "description": "Additional JSON-data of the lexicon entry", "example": {} }, "keyphrases": { "type": "object", "properties": { "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "value": { "type": "string", "description": "the keyphrase value", "example": "pizza" }, "isMainKeyphrase": { "type": "boolean", "description": "Indicator if the Keyphrase is the mainKeyphrase", "example": true } } }, "slotReferences": { "type": "array", "description": "The used slots by the lexicon entry", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } }, "ILexiconIndexItemData_2_0": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the lexicon", "example": "New Lexicon" }, "description": { "type": "string", "description": "A meaningful description of the lexicon", "example": "Countries members of the European Union, e.g. Spain" }, "referenceId": { "type": "string", "format": "uuid" } } }, "ILexiconIndexItem_2_0": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the lexicon", "example": "New Lexicon" }, "description": { "type": "string", "description": "A meaningful description of the lexicon", "example": "Countries members of the European Union, e.g. Spain" }, "referenceId": { "type": "string", "format": "uuid" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" }, "ILexiconKeyphraseData_2_0": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the slot", "example": "food" }, "isMainKeyphrase": { "type": "boolean", "description": "Indicates if it is main", "example": true } } }, "ILexiconKeyphrase_2_0": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the slot", "example": "food" }, "isMainKeyphrase": { "type": "boolean", "description": "Indicates if it is main", "example": true }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" }, "ILexiconKeyphraseIndexItem_2_0": { "type": "object", "properties": { "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "name": { "type": "string", "description": "The name of the slot", "example": "food" }, "isMainKeyphrase": { "type": "boolean", "description": "Indicates if it is main", "example": true }, "lexiconEntryReference": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } }, "ILexiconSlotData_2_0": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the slot", "example": "food" } } }, "ILexiconSlot_2_0": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the slot", "example": "food" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" }, "ILexiconSlotIndexItem_2_0": { "type": "object", "properties": { "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "name": { "type": "string", "description": "The name of the slot", "example": "food" } } }, "ILocaleData_2_0": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the Locale", "example": "English" }, "primary": { "type": "boolean" }, "nluLanguage": { "type": "string", "example": "en-US", "enum": [ "ge-GE", "da-DK", "en-AU", "en-CA", "en-IN", "en-GB", "en-US", "de-DE", "ja-JP", "ko-KR", "es-ES", "nl-NL", "ar-AE", "fi-FI", "fr-FR", "it-IT", "nn-NO", "pl-PL", "sv-SE", "th-TH", "zh-CN", "vi-VN", "pt-BR", "ru-RU", "pt-PT", "tr-TR", "hi-IN", "bn-IN", "ta-IN" ] }, "fallbackLocaleReference": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } }, "ILocale_2_0": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the Locale", "example": "English" }, "primary": { "type": "boolean" }, "nluLanguage": { "type": "string", "example": "en-US", "enum": [ "ge-GE", "da-DK", "en-AU", "en-CA", "en-IN", "en-GB", "en-US", "de-DE", "ja-JP", "ko-KR", "es-ES", "nl-NL", "ar-AE", "fi-FI", "fr-FR", "it-IT", "nn-NO", "pl-PL", "sv-SE", "th-TH", "zh-CN", "vi-VN", "pt-BR", "ru-RU", "pt-PT", "tr-TR", "hi-IN", "bn-IN", "ta-IN" ] }, "fallbackLocaleReference": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" }, "ILocaleIndexItem_2_0": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the Locale", "example": "English" }, "nluLanguage": { "type": "string", "example": "en-US", "enum": [ "ge-GE", "da-DK", "en-AU", "en-CA", "en-IN", "en-GB", "en-US", "de-DE", "ja-JP", "ko-KR", "es-ES", "nl-NL", "ar-AE", "fi-FI", "fr-FR", "it-IT", "nn-NO", "pl-PL", "sv-SE", "th-TH", "zh-CN", "vi-VN", "pt-BR", "ru-RU", "pt-PT", "tr-TR", "hi-IN", "bn-IN", "ta-IN" ] }, "primary": { "type": "boolean" }, "fallbackLocaleReference": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" }, "TNLULanguage_2_0": { "type": "string", "example": "en-US", "enum": [ "ge-GE", "da-DK", "en-AU", "en-CA", "en-IN", "en-GB", "en-US", "de-DE", "ja-JP", "ko-KR", "es-ES", "nl-NL", "ar-AE", "fi-FI", "fr-FR", "it-IT", "nn-NO", "pl-PL", "sv-SE", "th-TH", "zh-CN", "vi-VN", "pt-BR", "ru-RU", "pt-PT", "tr-TR", "hi-IN", "bn-IN", "ta-IN" ] }, "IYesNoIntentData_2_0": { "type": "object", "properties": { "isDisabled": { "type": "boolean" }, "name": { "type": "string", "example": "pizza" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "rules": { "type": "array", "items": { "type": "string" } } } }, "IYesNoIntentItem_2_0": { "type": "object", "properties": { "yesIntent": { "type": "object", "properties": { "isDisabled": { "type": "boolean" }, "name": { "type": "string", "example": "pizza" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "rules": { "type": "array", "items": { "type": "string" } } } }, "noIntent": { "type": "object", "properties": { "isDisabled": { "type": "boolean" }, "name": { "type": "string", "example": "pizza" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "rules": { "type": "array", "items": { "type": "string" } } } }, "rejectIntent": { "type": "object", "properties": { "isDisabled": { "type": "boolean" }, "name": { "type": "string", "example": "pizza" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "rules": { "type": "array", "items": { "type": "string" } } } } } }, "IYesNoIntentMetaData_2_0": { "type": "object", "properties": { "rules": { "type": "array", "items": { "type": "string" }, "description": "The intent rules", "example": [ "this should be a valid rule" ] }, "isDisabled": { "type": "boolean" } } }, "IMilestoneData_2_0": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the Milestone", "example": "New Milestone" }, "description": { "type": "string", "description": "The description of the milestone", "example": "This is a sample milestone" }, "steps": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the milestone step", "example": "Step 1" }, "description": { "type": "string", "description": "The description of the milestone step", "example": "This is the first step" }, "order": { "type": "number", "description": "Step order in the milestone configuration", "example": 1 }, "type": { "type": "string", "description": "Step type", "example": "start" }, "metrics": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the metric", "example": "Duration" }, "description": { "type": "string", "description": "The description of the metric", "example": "Time taken to complete the step" }, "type": { "type": "string", "description": "Metric type", "example": "duration" }, "value": { "type": "number", "description": "Metric value", "example": 30 } } } } } } } } }, "IMilestone_2_0": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the Milestone", "example": "New Milestone" }, "description": { "type": "string", "description": "The description of the milestone", "example": "This is a sample milestone" }, "steps": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the milestone step", "example": "Step 1" }, "description": { "type": "string", "description": "The description of the milestone step", "example": "This is the first step" }, "order": { "type": "number", "description": "Step order in the milestone configuration", "example": 1 }, "type": { "type": "string", "description": "Step type", "example": "start" }, "metrics": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the metric", "example": "Duration" }, "description": { "type": "string", "description": "The description of the metric", "example": "Time taken to complete the step" }, "type": { "type": "string", "description": "Metric type", "example": "duration" }, "value": { "type": "number", "description": "Metric value", "example": 30 } } } } } } }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" }, "IMilestoneIndexItem_2_0": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the milestone", "example": "New Milestone" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" }, "IMilestoneStep_2_0": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the milestone step", "example": "Step 1" }, "description": { "type": "string", "description": "The description of the milestone step", "example": "This is the first step" }, "order": { "type": "number", "description": "Step order in the milestone configuration", "example": 1 }, "type": { "type": "string", "description": "Step type", "example": "start" }, "metrics": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the metric", "example": "Duration" }, "description": { "type": "string", "description": "The description of the metric", "example": "Time taken to complete the step" }, "type": { "type": "string", "description": "Metric type", "example": "duration" }, "value": { "type": "number", "description": "Metric value", "example": 30 } } } } } }, "IMilestoneStepMetric_2_0": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the metric", "example": "Duration" }, "description": { "type": "string", "description": "The description of the metric", "example": "Time taken to complete the step" }, "type": { "type": "string", "description": "Metric type", "example": "duration" }, "value": { "type": "number", "description": "Metric value", "example": 30 } } }, "INLUConnectorData_2_0": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the NLUConnector", "example": "New NLUConnector" }, "type": { "type": "string", "description": "The NLUConnector type", "example": "cognigy", "enum": [ "alexa", "dialogflow", "dialogflowBuiltIn", "amazonLexBuiltIn", "luis", "watson", "noNlu", "cognigy", "code", "generativeAI", "lex" ] }, "settings": { "oneOf": [ { "type": "object", "description": "Settings used by the Alexa NLUConnector", "properties": { "invocationName": { "type": "string", "description": "The invocation name of the Alexa skill. Necessary to start Alexa simulations." }, "reparseAlexaSlots": { "type": "boolean", "description": "Whether to reparse slots from Alexa with our own keyphrase mapper. Used by Alexa." }, "skill": { "type": "object", "properties": { "lastUpdated": { "type": "string", "description": "When the skill was last updated" }, "nameByLocale": { "type": "object", "description": "Gives the name of the skill for different locales", "properties": { "en-US": { "type": "string" }, "de-DE": { "type": "string" }, "ja-JP": { "type": "string" }, "en-GB": { "type": "string" }, "en-IN": { "type": "string" } } }, "skillId": { "type": "string", "description": "The unique id of the skill" }, "stage": { "type": "string", "description": "The current stage of the skills life cycle (e.g. is it in development, production..)" } } } } }, { "type": "object", "description": "Settings used by the DialogFlow NLUConnector", "properties": { "dialogflowApiVersion": { "type": "integer", "description": "The version of the dialogflow API to use.", "enum": [ 1, 2 ] }, "dialogflowProjectId": { "type": "string", "description": "The projectId of the Dialogflow Agent." }, "accessToken": { "description": "The access token used to authenticate requests. Used by DialogFlow.", "type": "string" }, "privateKey": { "type": "string", "description": "The private key of a Google Service Account that has the access right to use the Dialogflow API. It is stored as a string." } } }, { "type": "object", "description": "Settings used by the LUIS NLUConnector", "properties": { "authenticationURL": { "type": "string", "description": "The URL Used to authenticate requests by LUIS." } } }, { "type": "object", "description": "Settings used by the Watson NLUConnector", "properties": { "apikey": { "type": "string", "description": "Apikey for accessing the Watson NLU Api" }, "workspaceid": { "type": "string", "description": "Skill ID for accessing the Assistant skill" }, "serviceURL": { "type": "string", "description": "The URL used to authenticate requests by Watson" } } }, { "type": "object", "description": "Settings used by the Lex NLUConnector", "properties": { "accessKeyId": { "type": "string", "description": "Apikey for accessing the Lex NLU Api" }, "secretAccessKey": { "type": "string", "description": "Secret Access Key for accessing the Lex NLU Api" }, "awsRegion": { "type": "string", "description": "The AWS region the Lex bot is deployed to" }, "botId": { "type": "string", "description": "Id of the Lex bot" }, "botAliasId": { "type": "string", "description": "Alias of the Lex bot" } } } ] }, "transformer": { "type": "object", "properties": { "abortOnError": { "type": "string", "description": "If true, then we will abort the message processing if the transformer throws an error. Otherwise, we will continue with normal message processing in the event of an error.", "example": false }, "transformerStackEnabled": { "type": "string", "description": "If true, then we will write the transformer stack in the input object, when the channel is adminconsole.", "example": false }, "transformer": { "type": "string", "description": "The transformer object as written by the user. This will be displayed in the UI since it includes typings." }, "preNluTransformerEnabled": { "type": "string", "example": false }, "postNluTransformerEnabled": { "type": "string", "example": false }, "nluCodeTransformerEnabled": { "type": "string", "example": false } } } } }, "INLUConnectorGeneratedData_2_0": { "type": "object", "properties": { "referenceId": { "type": "string", "format": "uuid" } } }, "INLUConnector_2_0": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the NLUConnector", "example": "New NLUConnector" }, "type": { "type": "string", "description": "The NLUConnector type", "example": "cognigy", "enum": [ "alexa", "dialogflow", "dialogflowBuiltIn", "amazonLexBuiltIn", "luis", "watson", "noNlu", "cognigy", "code", "generativeAI", "lex" ] }, "settings": { "oneOf": [ { "type": "object", "description": "Settings used by the Alexa NLUConnector", "properties": { "invocationName": { "type": "string", "description": "The invocation name of the Alexa skill. Necessary to start Alexa simulations." }, "reparseAlexaSlots": { "type": "boolean", "description": "Whether to reparse slots from Alexa with our own keyphrase mapper. Used by Alexa." }, "skill": { "type": "object", "properties": { "lastUpdated": { "type": "string", "description": "When the skill was last updated" }, "nameByLocale": { "type": "object", "description": "Gives the name of the skill for different locales", "properties": { "en-US": { "type": "string" }, "de-DE": { "type": "string" }, "ja-JP": { "type": "string" }, "en-GB": { "type": "string" }, "en-IN": { "type": "string" } } }, "skillId": { "type": "string", "description": "The unique id of the skill" }, "stage": { "type": "string", "description": "The current stage of the skills life cycle (e.g. is it in development, production..)" } } } } }, { "type": "object", "description": "Settings used by the DialogFlow NLUConnector", "properties": { "dialogflowApiVersion": { "type": "integer", "description": "The version of the dialogflow API to use.", "enum": [ 1, 2 ] }, "dialogflowProjectId": { "type": "string", "description": "The projectId of the Dialogflow Agent." }, "accessToken": { "description": "The access token used to authenticate requests. Used by DialogFlow.", "type": "string" }, "privateKey": { "type": "string", "description": "The private key of a Google Service Account that has the access right to use the Dialogflow API. It is stored as a string." } } }, { "type": "object", "description": "Settings used by the LUIS NLUConnector", "properties": { "authenticationURL": { "type": "string", "description": "The URL Used to authenticate requests by LUIS." } } }, { "type": "object", "description": "Settings used by the Watson NLUConnector", "properties": { "apikey": { "type": "string", "description": "Apikey for accessing the Watson NLU Api" }, "workspaceid": { "type": "string", "description": "Skill ID for accessing the Assistant skill" }, "serviceURL": { "type": "string", "description": "The URL used to authenticate requests by Watson" } } }, { "type": "object", "description": "Settings used by the Lex NLUConnector", "properties": { "accessKeyId": { "type": "string", "description": "Apikey for accessing the Lex NLU Api" }, "secretAccessKey": { "type": "string", "description": "Secret Access Key for accessing the Lex NLU Api" }, "awsRegion": { "type": "string", "description": "The AWS region the Lex bot is deployed to" }, "botId": { "type": "string", "description": "Id of the Lex bot" }, "botAliasId": { "type": "string", "description": "Alias of the Lex bot" } } } ] }, "transformer": { "type": "object", "properties": { "abortOnError": { "type": "string", "description": "If true, then we will abort the message processing if the transformer throws an error. Otherwise, we will continue with normal message processing in the event of an error.", "example": false }, "transformerStackEnabled": { "type": "string", "description": "If true, then we will write the transformer stack in the input object, when the channel is adminconsole.", "example": false }, "transformer": { "type": "string", "description": "The transformer object as written by the user. This will be displayed in the UI since it includes typings." }, "preNluTransformerEnabled": { "type": "string", "example": false }, "postNluTransformerEnabled": { "type": "string", "example": false }, "nluCodeTransformerEnabled": { "type": "string", "example": false } } }, "referenceId": { "type": "string", "format": "uuid" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" }, "INLUTransformerFunction_2_0": { "type": "object", "properties": { "abortOnError": { "type": "string", "description": "If true, then we will abort the message processing if the transformer throws an error. Otherwise, we will continue with normal message processing in the event of an error.", "example": false }, "transformerStackEnabled": { "type": "string", "description": "If true, then we will write the transformer stack in the input object, when the channel is adminconsole.", "example": false }, "transformer": { "type": "string", "description": "The transformer object as written by the user. This will be displayed in the UI since it includes typings." }, "preNluTransformerEnabled": { "type": "string", "example": false }, "postNluTransformerEnabled": { "type": "string", "example": false }, "nluCodeTransformerEnabled": { "type": "string", "example": false } } }, "IDialogFlowSettings_2_0": { "type": "object", "description": "Settings used by the DialogFlow NLUConnector", "properties": { "dialogflowApiVersion": { "type": "integer", "description": "The version of the dialogflow API to use.", "enum": [ 1, 2 ] }, "dialogflowProjectId": { "type": "string", "description": "The projectId of the Dialogflow Agent." }, "accessToken": { "description": "The access token used to authenticate requests. Used by DialogFlow.", "type": "string" }, "privateKey": { "type": "string", "description": "The private key of a Google Service Account that has the access right to use the Dialogflow API. It is stored as a string." } } }, "ILuisSettings_2_0": { "type": "object", "description": "Settings used by the LUIS NLUConnector", "properties": { "authenticationURL": { "type": "string", "description": "The URL Used to authenticate requests by LUIS." } } }, "IWatsonSettings_2_0": { "type": "object", "description": "Settings used by the Watson NLUConnector", "properties": { "apikey": { "type": "string", "description": "Apikey for accessing the Watson NLU Api" }, "workspaceid": { "type": "string", "description": "Skill ID for accessing the Assistant skill" }, "serviceURL": { "type": "string", "description": "The URL used to authenticate requests by Watson" } } }, "ILexSettings_2_0": { "type": "object", "description": "Settings used by the Lex NLUConnector", "properties": { "accessKeyId": { "type": "string", "description": "Apikey for accessing the Lex NLU Api" }, "secretAccessKey": { "type": "string", "description": "Secret Access Key for accessing the Lex NLU Api" }, "awsRegion": { "type": "string", "description": "The AWS region the Lex bot is deployed to" }, "botId": { "type": "string", "description": "Id of the Lex bot" }, "botAliasId": { "type": "string", "description": "Alias of the Lex bot" } } }, "IAlexaSettings_2_0": { "type": "object", "description": "Settings used by the Alexa NLUConnector", "properties": { "invocationName": { "type": "string", "description": "The invocation name of the Alexa skill. Necessary to start Alexa simulations." }, "reparseAlexaSlots": { "type": "boolean", "description": "Whether to reparse slots from Alexa with our own keyphrase mapper. Used by Alexa." }, "skill": { "type": "object", "properties": { "lastUpdated": { "type": "string", "description": "When the skill was last updated" }, "nameByLocale": { "type": "object", "description": "Gives the name of the skill for different locales", "properties": { "en-US": { "type": "string" }, "de-DE": { "type": "string" }, "ja-JP": { "type": "string" }, "en-GB": { "type": "string" }, "en-IN": { "type": "string" } } }, "skillId": { "type": "string", "description": "The unique id of the skill" }, "stage": { "type": "string", "description": "The current stage of the skills life cycle (e.g. is it in development, production..)" } } } } }, "ISkill_2_0": { "type": "object", "properties": { "lastUpdated": { "type": "string", "description": "When the skill was last updated" }, "nameByLocale": { "type": "object", "description": "Gives the name of the skill for different locales", "properties": { "en-US": { "type": "string" }, "de-DE": { "type": "string" }, "ja-JP": { "type": "string" }, "en-GB": { "type": "string" }, "en-IN": { "type": "string" } } }, "skillId": { "type": "string", "description": "The unique id of the skill" }, "stage": { "type": "string", "description": "The current stage of the skills life cycle (e.g. is it in development, production..)" } } }, "INLUConnectorIndexItem_2_0": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the NLUConnector", "example": "New NLUConnector" }, "referenceId": { "type": "string", "format": "uuid" }, "type": { "type": "string", "description": "The NLUConnector type", "example": "cognigy", "enum": [ "alexa", "dialogflow", "dialogflowBuiltIn", "amazonLexBuiltIn", "luis", "watson", "noNlu", "cognigy", "code", "generativeAI", "lex" ] }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" }, "TNLUConnectorType_2_0": { "type": "string", "description": "The NLUConnector type", "example": "cognigy", "enum": [ "alexa", "dialogflow", "dialogflowBuiltIn", "amazonLexBuiltIn", "luis", "watson", "noNlu", "cognigy", "code", "generativeAI", "lex" ] }, "INodeDescriptor_2_0": { "type": "object", "properties": { "type": { "type": "string" }, "parentType": { "type": "string", "description": "The type of the node parent, if there is one" }, "defaultLabel": { "oneOf": [ { "type": "string", "description": "The label that should be used when a new Node of this type is created" }, { "type": "object", "description": "A localized version of the label that should be used when a new Node of this type is created", "properties": { "default": { "type": "string" }, "enUS": { "type": "string" }, "deDE": { "type": "string" }, "esES": { "type": "string" }, "jaJP": { "type": "string" }, "koKR": { "type": "string" } } } ] }, "summary": { "oneOf": [ { "type": "string", "description": "A short line of text that describes what this Node is used for" }, { "type": "object", "description": "A localized version of a short line of text that describes what this Node is used for", "properties": { "default": { "type": "string" }, "enUS": { "type": "string" }, "deDE": { "type": "string" }, "esES": { "type": "string" }, "jaJP": { "type": "string" }, "koKR": { "type": "string" } } } ] }, "extension": { "type": "string" }, "extensionImg": { "type": "string" }, "appearance": { "type": "object", "properties": { "logo": { "type": "string" }, "textColor": { "type": "string", "example": "blue", "oneOf": [ { "type": "string", "example": "none", "enum": [ "aliceBlue", "antiqueWhite", "aqua", "aquamarine", "azure", "beige", "bisque", "black", "blanchedAlmond", "blue", "blueViolet", "brown", "burlyWood", "cadetBlue", "chartreuse", "chocolate", "coral", "cornflowerBlue", "cornsilk", "crimson", "cyan", "darkBlue", "darkCyan", "darkGoldenRod", "darkGray", "darkGrey", "darkGreen", "darkKhaki", "darkMagenta", "darkOliveGreen", "darkOrange", "darkOrchid", "darkRed", "darkSalmon", "darkSeaGreen", "darkSlateBlue", "darkSlateGray", "darkSlateGrey", "darkTurquoise", "darkViolet", "deepPink", "deepSkyBlue", "dimGray", "dimGrey", "dodgerBlue", "fireBrick", "floralWhite", "forestGreen", "fuchsia", "gainsboro", "ghostWhite", "gold", "goldenRod", "gray", "grey", "green", "greenYellow", "honeyDew", "hotPink", "indianRed", "indigo", "ivory", "khaki", "lavender", "lavenderBlush", "lawnGreen", "lemonChiffon", "lightBlue", "lightCoral", "lightCyan", "lightGoldenRodYellow", "lightGray", "lightGrey", "lightGreen", "lightPink", "lightSalmon", "lightSeaGreen", "lightSkyBlue", "lightSlateGray", "lightSlateGrey", "lightSteelBlue", "lightYellow", "lime", "limeGreen", "linen", "magenta", "maroon", "mediumAquaMarine", "mediumBlue", "mediumOrchid", "mediumPurple", "mediumSeaGreen", "mediumSlateBlue", "mediumSpringGreen", "mediumTurquoise", "mediumVioletRed", "midnightBlue", "mintCream", "mistyRose", "moccasin", "navajoWhite", "navy", "oldLace", "olive", "oliveDrab", "orange", "orangeRed", "orchid", "paleGoldenRod", "paleGreen", "paleTurquoise", "paleVioletRed", "papayaWhip", "peachPuff", "peru", "pink", "plum", "powderBlue", "purple", "rebeccaPurple", "red", "rosyBrown", "royalBlue", "saddleBrown", "salmon", "sandyBrown", "seaGreen", "seaShell", "sienna", "silver", "skyBlue", "slateBlue", "slateGray", "slateGrey", "snow", "springGreen", "steelBlue", "tan", "teal", "thistle", "tomato", "turquoise", "violet", "wheat", "white", "whiteSmoke", "yellow", "yellowGreen", "none", "transparent" ] }, { "type": "string", "example": "cognigyGrey", "enum": [ "amber", "blueGrey", "cognigyBlue", "cognigyGrey", "deepOrange", "deepPurple", "lightBlue", "lightGreen" ] } ] }, "contrastTextColor": { "type": "string", "example": "blue", "oneOf": [ { "type": "string", "example": "none", "enum": [ "aliceBlue", "antiqueWhite", "aqua", "aquamarine", "azure", "beige", "bisque", "black", "blanchedAlmond", "blue", "blueViolet", "brown", "burlyWood", "cadetBlue", "chartreuse", "chocolate", "coral", "cornflowerBlue", "cornsilk", "crimson", "cyan", "darkBlue", "darkCyan", "darkGoldenRod", "darkGray", "darkGrey", "darkGreen", "darkKhaki", "darkMagenta", "darkOliveGreen", "darkOrange", "darkOrchid", "darkRed", "darkSalmon", "darkSeaGreen", "darkSlateBlue", "darkSlateGray", "darkSlateGrey", "darkTurquoise", "darkViolet", "deepPink", "deepSkyBlue", "dimGray", "dimGrey", "dodgerBlue", "fireBrick", "floralWhite", "forestGreen", "fuchsia", "gainsboro", "ghostWhite", "gold", "goldenRod", "gray", "grey", "green", "greenYellow", "honeyDew", "hotPink", "indianRed", "indigo", "ivory", "khaki", "lavender", "lavenderBlush", "lawnGreen", "lemonChiffon", "lightBlue", "lightCoral", "lightCyan", "lightGoldenRodYellow", "lightGray", "lightGrey", "lightGreen", "lightPink", "lightSalmon", "lightSeaGreen", "lightSkyBlue", "lightSlateGray", "lightSlateGrey", "lightSteelBlue", "lightYellow", "lime", "limeGreen", "linen", "magenta", "maroon", "mediumAquaMarine", "mediumBlue", "mediumOrchid", "mediumPurple", "mediumSeaGreen", "mediumSlateBlue", "mediumSpringGreen", "mediumTurquoise", "mediumVioletRed", "midnightBlue", "mintCream", "mistyRose", "moccasin", "navajoWhite", "navy", "oldLace", "olive", "oliveDrab", "orange", "orangeRed", "orchid", "paleGoldenRod", "paleGreen", "paleTurquoise", "paleVioletRed", "papayaWhip", "peachPuff", "peru", "pink", "plum", "powderBlue", "purple", "rebeccaPurple", "red", "rosyBrown", "royalBlue", "saddleBrown", "salmon", "sandyBrown", "seaGreen", "seaShell", "sienna", "silver", "skyBlue", "slateBlue", "slateGray", "slateGrey", "snow", "springGreen", "steelBlue", "tan", "teal", "thistle", "tomato", "turquoise", "violet", "wheat", "white", "whiteSmoke", "yellow", "yellowGreen", "none", "transparent" ] }, { "type": "string", "example": "cognigyGrey", "enum": [ "amber", "blueGrey", "cognigyBlue", "cognigyGrey", "deepOrange", "deepPurple", "lightBlue", "lightGreen" ] } ] }, "color": { "type": "string", "example": "red", "oneOf": [ { "type": "string", "example": "none", "enum": [ "aliceBlue", "antiqueWhite", "aqua", "aquamarine", "azure", "beige", "bisque", "black", "blanchedAlmond", "blue", "blueViolet", "brown", "burlyWood", "cadetBlue", "chartreuse", "chocolate", "coral", "cornflowerBlue", "cornsilk", "crimson", "cyan", "darkBlue", "darkCyan", "darkGoldenRod", "darkGray", "darkGrey", "darkGreen", "darkKhaki", "darkMagenta", "darkOliveGreen", "darkOrange", "darkOrchid", "darkRed", "darkSalmon", "darkSeaGreen", "darkSlateBlue", "darkSlateGray", "darkSlateGrey", "darkTurquoise", "darkViolet", "deepPink", "deepSkyBlue", "dimGray", "dimGrey", "dodgerBlue", "fireBrick", "floralWhite", "forestGreen", "fuchsia", "gainsboro", "ghostWhite", "gold", "goldenRod", "gray", "grey", "green", "greenYellow", "honeyDew", "hotPink", "indianRed", "indigo", "ivory", "khaki", "lavender", "lavenderBlush", "lawnGreen", "lemonChiffon", "lightBlue", "lightCoral", "lightCyan", "lightGoldenRodYellow", "lightGray", "lightGrey", "lightGreen", "lightPink", "lightSalmon", "lightSeaGreen", "lightSkyBlue", "lightSlateGray", "lightSlateGrey", "lightSteelBlue", "lightYellow", "lime", "limeGreen", "linen", "magenta", "maroon", "mediumAquaMarine", "mediumBlue", "mediumOrchid", "mediumPurple", "mediumSeaGreen", "mediumSlateBlue", "mediumSpringGreen", "mediumTurquoise", "mediumVioletRed", "midnightBlue", "mintCream", "mistyRose", "moccasin", "navajoWhite", "navy", "oldLace", "olive", "oliveDrab", "orange", "orangeRed", "orchid", "paleGoldenRod", "paleGreen", "paleTurquoise", "paleVioletRed", "papayaWhip", "peachPuff", "peru", "pink", "plum", "powderBlue", "purple", "rebeccaPurple", "red", "rosyBrown", "royalBlue", "saddleBrown", "salmon", "sandyBrown", "seaGreen", "seaShell", "sienna", "silver", "skyBlue", "slateBlue", "slateGray", "slateGrey", "snow", "springGreen", "steelBlue", "tan", "teal", "thistle", "tomato", "turquoise", "violet", "wheat", "white", "whiteSmoke", "yellow", "yellowGreen", "none", "transparent" ] }, { "type": "string", "example": "cognigyGrey", "enum": [ "amber", "blueGrey", "cognigyBlue", "cognigyGrey", "deepOrange", "deepPurple", "lightBlue", "lightGreen" ] } ] }, "variant": { "type": "string", "enum": [ "regular", "mini", "hexagon" ] } } }, "behavior": { "type": "object", "properties": { "stopping": { "type": "boolean" }, "entrypoint": { "type": "boolean" } } }, "constraints": { "type": "object", "properties": { "editable": { "type": "boolean", "description": "Should this node be editable" }, "deletable": { "type": "boolean", "description": "Should this node be deletable" }, "creatable": { "type": "boolean", "description": "Should this node be manually creatable" }, "collapsable": { "type": "boolean", "description": "Should this node be collapsable" }, "childFlowCreatable": { "type": "boolean", "description": "Should it be possible to create child flow from this node" }, "movable": { "type": "boolean", "description": "Should this node be movable" }, "placement": { "type": "object", "description": "Additional placement information", "properties": { "predecessor": { "type": "object", "properties": { "whitelist": { "items": { "type": "string" } }, "blacklist": { "items": { "type": "string" } } } }, "successor": { "type": "object", "properties": { "whitelist": { "items": { "type": "string" } }, "blacklist": { "items": { "type": "string" } } } }, "children": { "type": "object", "properties": { "whitelist": { "items": { "type": "string" } }, "blacklist": { "items": { "type": "string" } } } } } } } }, "dependencies": { "type": "object", "properties": { "children": { "type": "array", "items": { "type": "string" } } } }, "fields": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "text", "rule" ] }, "key": { "type": "string" }, "label": { "oneOf": [ { "type": "string" }, { "type": "object", "properties": { "default": { "type": "string" }, "enUS": { "type": "string" }, "deDE": { "type": "string" }, "esES": { "type": "string" }, "jaJP": { "type": "string" }, "koKR": { "type": "string" } } } ] }, "defaultValue": { "description": "The default value for that field" } } } }, "previews": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "message", "image", "code" ] }, "key": { "type": "string" } } } }, "tokens": { "type": "array", "items": { "type": "object", "properties": { "label": { "type": "string", "maxLength": 30, "example": "word count" }, "script": { "type": "string", "maxLength": 500, "example": "ci.text.split(' ').length" }, "type": { "type": "string", "enum": [ "profile", "input", "context", "custom", "answer", "flow-output", "flow-input" ], "example": "input" } } } }, "tags": { "type": "string", "enum": [ "basic", "logic", "message", "profile", "service", "nlu", "data" ] }, "sections": { "type": "array", "items": { "type": "object", "properties": { "key": { "type": "string", "description": "The key of the Field whose value should be matched" }, "value": { "description": "The expected value(s) that make this condition match" }, "negate": { "type": "boolean", "description": "If this is true, the condition result will be inverted" } } } }, "form": { "type": "array", "items": { "type": "object", "properties": { "key": { "type": "string", "description": "A key either pointing to a 'field -> key' or 'section -> key'" }, "type": { "type": "string", "description": "The type of the pointer, either 'field' or 'section'", "enum": [ "field", "section" ] } } } } } }, "INodeDescriptorWithoutLocalization_2_0": { "type": "object", "properties": { "type": { "type": "string" }, "parentType": { "type": "string", "description": "The type of the node parent, if there is one" }, "defaultLabel": { "type": "string", "description": "The label that should be used when a new Node of this type is created" }, "summary": { "type": "string", "description": "A short line of text that describes what this Node is used for" }, "extension": { "type": "string" }, "extensionImg": { "type": "string" }, "appearance": { "type": "object", "properties": { "logo": { "type": "string" }, "textColor": { "type": "string", "example": "blue", "oneOf": [ { "type": "string", "example": "none", "enum": [ "aliceBlue", "antiqueWhite", "aqua", "aquamarine", "azure", "beige", "bisque", "black", "blanchedAlmond", "blue", "blueViolet", "brown", "burlyWood", "cadetBlue", "chartreuse", "chocolate", "coral", "cornflowerBlue", "cornsilk", "crimson", "cyan", "darkBlue", "darkCyan", "darkGoldenRod", "darkGray", "darkGrey", "darkGreen", "darkKhaki", "darkMagenta", "darkOliveGreen", "darkOrange", "darkOrchid", "darkRed", "darkSalmon", "darkSeaGreen", "darkSlateBlue", "darkSlateGray", "darkSlateGrey", "darkTurquoise", "darkViolet", "deepPink", "deepSkyBlue", "dimGray", "dimGrey", "dodgerBlue", "fireBrick", "floralWhite", "forestGreen", "fuchsia", "gainsboro", "ghostWhite", "gold", "goldenRod", "gray", "grey", "green", "greenYellow", "honeyDew", "hotPink", "indianRed", "indigo", "ivory", "khaki", "lavender", "lavenderBlush", "lawnGreen", "lemonChiffon", "lightBlue", "lightCoral", "lightCyan", "lightGoldenRodYellow", "lightGray", "lightGrey", "lightGreen", "lightPink", "lightSalmon", "lightSeaGreen", "lightSkyBlue", "lightSlateGray", "lightSlateGrey", "lightSteelBlue", "lightYellow", "lime", "limeGreen", "linen", "magenta", "maroon", "mediumAquaMarine", "mediumBlue", "mediumOrchid", "mediumPurple", "mediumSeaGreen", "mediumSlateBlue", "mediumSpringGreen", "mediumTurquoise", "mediumVioletRed", "midnightBlue", "mintCream", "mistyRose", "moccasin", "navajoWhite", "navy", "oldLace", "olive", "oliveDrab", "orange", "orangeRed", "orchid", "paleGoldenRod", "paleGreen", "paleTurquoise", "paleVioletRed", "papayaWhip", "peachPuff", "peru", "pink", "plum", "powderBlue", "purple", "rebeccaPurple", "red", "rosyBrown", "royalBlue", "saddleBrown", "salmon", "sandyBrown", "seaGreen", "seaShell", "sienna", "silver", "skyBlue", "slateBlue", "slateGray", "slateGrey", "snow", "springGreen", "steelBlue", "tan", "teal", "thistle", "tomato", "turquoise", "violet", "wheat", "white", "whiteSmoke", "yellow", "yellowGreen", "none", "transparent" ] }, { "type": "string", "example": "cognigyGrey", "enum": [ "amber", "blueGrey", "cognigyBlue", "cognigyGrey", "deepOrange", "deepPurple", "lightBlue", "lightGreen" ] } ] }, "contrastTextColor": { "type": "string", "example": "blue", "oneOf": [ { "type": "string", "example": "none", "enum": [ "aliceBlue", "antiqueWhite", "aqua", "aquamarine", "azure", "beige", "bisque", "black", "blanchedAlmond", "blue", "blueViolet", "brown", "burlyWood", "cadetBlue", "chartreuse", "chocolate", "coral", "cornflowerBlue", "cornsilk", "crimson", "cyan", "darkBlue", "darkCyan", "darkGoldenRod", "darkGray", "darkGrey", "darkGreen", "darkKhaki", "darkMagenta", "darkOliveGreen", "darkOrange", "darkOrchid", "darkRed", "darkSalmon", "darkSeaGreen", "darkSlateBlue", "darkSlateGray", "darkSlateGrey", "darkTurquoise", "darkViolet", "deepPink", "deepSkyBlue", "dimGray", "dimGrey", "dodgerBlue", "fireBrick", "floralWhite", "forestGreen", "fuchsia", "gainsboro", "ghostWhite", "gold", "goldenRod", "gray", "grey", "green", "greenYellow", "honeyDew", "hotPink", "indianRed", "indigo", "ivory", "khaki", "lavender", "lavenderBlush", "lawnGreen", "lemonChiffon", "lightBlue", "lightCoral", "lightCyan", "lightGoldenRodYellow", "lightGray", "lightGrey", "lightGreen", "lightPink", "lightSalmon", "lightSeaGreen", "lightSkyBlue", "lightSlateGray", "lightSlateGrey", "lightSteelBlue", "lightYellow", "lime", "limeGreen", "linen", "magenta", "maroon", "mediumAquaMarine", "mediumBlue", "mediumOrchid", "mediumPurple", "mediumSeaGreen", "mediumSlateBlue", "mediumSpringGreen", "mediumTurquoise", "mediumVioletRed", "midnightBlue", "mintCream", "mistyRose", "moccasin", "navajoWhite", "navy", "oldLace", "olive", "oliveDrab", "orange", "orangeRed", "orchid", "paleGoldenRod", "paleGreen", "paleTurquoise", "paleVioletRed", "papayaWhip", "peachPuff", "peru", "pink", "plum", "powderBlue", "purple", "rebeccaPurple", "red", "rosyBrown", "royalBlue", "saddleBrown", "salmon", "sandyBrown", "seaGreen", "seaShell", "sienna", "silver", "skyBlue", "slateBlue", "slateGray", "slateGrey", "snow", "springGreen", "steelBlue", "tan", "teal", "thistle", "tomato", "turquoise", "violet", "wheat", "white", "whiteSmoke", "yellow", "yellowGreen", "none", "transparent" ] }, { "type": "string", "example": "cognigyGrey", "enum": [ "amber", "blueGrey", "cognigyBlue", "cognigyGrey", "deepOrange", "deepPurple", "lightBlue", "lightGreen" ] } ] }, "color": { "type": "string", "example": "red", "oneOf": [ { "type": "string", "example": "none", "enum": [ "aliceBlue", "antiqueWhite", "aqua", "aquamarine", "azure", "beige", "bisque", "black", "blanchedAlmond", "blue", "blueViolet", "brown", "burlyWood", "cadetBlue", "chartreuse", "chocolate", "coral", "cornflowerBlue", "cornsilk", "crimson", "cyan", "darkBlue", "darkCyan", "darkGoldenRod", "darkGray", "darkGrey", "darkGreen", "darkKhaki", "darkMagenta", "darkOliveGreen", "darkOrange", "darkOrchid", "darkRed", "darkSalmon", "darkSeaGreen", "darkSlateBlue", "darkSlateGray", "darkSlateGrey", "darkTurquoise", "darkViolet", "deepPink", "deepSkyBlue", "dimGray", "dimGrey", "dodgerBlue", "fireBrick", "floralWhite", "forestGreen", "fuchsia", "gainsboro", "ghostWhite", "gold", "goldenRod", "gray", "grey", "green", "greenYellow", "honeyDew", "hotPink", "indianRed", "indigo", "ivory", "khaki", "lavender", "lavenderBlush", "lawnGreen", "lemonChiffon", "lightBlue", "lightCoral", "lightCyan", "lightGoldenRodYellow", "lightGray", "lightGrey", "lightGreen", "lightPink", "lightSalmon", "lightSeaGreen", "lightSkyBlue", "lightSlateGray", "lightSlateGrey", "lightSteelBlue", "lightYellow", "lime", "limeGreen", "linen", "magenta", "maroon", "mediumAquaMarine", "mediumBlue", "mediumOrchid", "mediumPurple", "mediumSeaGreen", "mediumSlateBlue", "mediumSpringGreen", "mediumTurquoise", "mediumVioletRed", "midnightBlue", "mintCream", "mistyRose", "moccasin", "navajoWhite", "navy", "oldLace", "olive", "oliveDrab", "orange", "orangeRed", "orchid", "paleGoldenRod", "paleGreen", "paleTurquoise", "paleVioletRed", "papayaWhip", "peachPuff", "peru", "pink", "plum", "powderBlue", "purple", "rebeccaPurple", "red", "rosyBrown", "royalBlue", "saddleBrown", "salmon", "sandyBrown", "seaGreen", "seaShell", "sienna", "silver", "skyBlue", "slateBlue", "slateGray", "slateGrey", "snow", "springGreen", "steelBlue", "tan", "teal", "thistle", "tomato", "turquoise", "violet", "wheat", "white", "whiteSmoke", "yellow", "yellowGreen", "none", "transparent" ] }, { "type": "string", "example": "cognigyGrey", "enum": [ "amber", "blueGrey", "cognigyBlue", "cognigyGrey", "deepOrange", "deepPurple", "lightBlue", "lightGreen" ] } ] }, "variant": { "type": "string", "enum": [ "regular", "mini", "hexagon" ] } } }, "behavior": { "type": "object", "properties": { "stopping": { "type": "boolean" }, "entrypoint": { "type": "boolean" } } }, "constraints": { "type": "object", "properties": { "editable": { "type": "boolean", "description": "Should this node be editable" }, "deletable": { "type": "boolean", "description": "Should this node be deletable" }, "creatable": { "type": "boolean", "description": "Should this node be manually creatable" }, "collapsable": { "type": "boolean", "description": "Should this node be collapsable" }, "childFlowCreatable": { "type": "boolean", "description": "Should it be possible to create child flow from this node" }, "movable": { "type": "boolean", "description": "Should this node be movable" }, "placement": { "type": "object", "description": "Additional placement information", "properties": { "predecessor": { "type": "object", "properties": { "whitelist": { "items": { "type": "string" } }, "blacklist": { "items": { "type": "string" } } } }, "successor": { "type": "object", "properties": { "whitelist": { "items": { "type": "string" } }, "blacklist": { "items": { "type": "string" } } } }, "children": { "type": "object", "properties": { "whitelist": { "items": { "type": "string" } }, "blacklist": { "items": { "type": "string" } } } } } } } }, "dependencies": { "type": "object", "properties": { "children": { "type": "array", "items": { "type": "string" } } } }, "fields": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "text", "rule" ] }, "key": { "type": "string" }, "label": { "type": "string" }, "defaultValue": { "description": "The default value for that field" } } } }, "previews": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "message", "image", "code" ] }, "key": { "type": "string" } } } }, "tokens": { "type": "array", "items": { "type": "object", "properties": { "label": { "type": "string", "maxLength": 30, "example": "word count" }, "script": { "type": "string", "maxLength": 500, "example": "ci.text.split(' ').length" }, "type": { "type": "string", "enum": [ "profile", "input", "context", "custom", "answer", "flow-output", "flow-input" ], "example": "input" } } } }, "tags": { "type": "string", "enum": [ "basic", "logic", "message", "profile", "service", "nlu", "data" ] }, "sections": { "type": "array", "items": { "type": "object", "properties": { "key": { "type": "string", "description": "The key of the Field whose value should be matched" }, "value": { "description": "The expected value(s) that make this condition match" }, "negate": { "type": "boolean", "description": "If this is true, the condition result will be inverted" } } } }, "form": { "type": "array", "items": { "type": "object", "properties": { "key": { "type": "string", "description": "A key either pointing to a 'field -> key' or 'section -> key'" }, "type": { "type": "string", "description": "The type of the pointer, either 'field' or 'section'", "enum": [ "field", "section" ] } } } } } }, "INodeFieldCondition_2_0": { "type": "object", "properties": { "key": { "type": "string", "description": "The key of the Field whose value should be matched" }, "value": { "description": "The expected value(s) that make this condition match" }, "negate": { "type": "boolean", "description": "If this is true, the condition result will be inverted" } } }, "INodeSection_2_0": { "type": "object", "properties": { "key": { "type": "string", "description": "Unique identifier for this section within all sections of a descriptor, e.g. 'authentication" }, "label": { "oneOf": [ { "type": "string", "description": "Condition whether this section should be rendered" }, { "type": "object", "description": "A localized Condition whether this section should be rendered", "properties": { "default": { "type": "string" }, "enUS": { "type": "string" }, "deDE": { "type": "string" }, "esES": { "type": "string" }, "jaJP": { "type": "string" }, "koKR": { "type": "string" } } } ] }, "condition": { "type": "object", "properties": { "key": { "type": "string", "description": "The key of the Field whose value should be matched" }, "value": { "description": "The expected value(s) that make this condition match" }, "negate": { "type": "boolean", "description": "If this is true, the condition result will be inverted" } } }, "defaultCollapsed": { "type": "boolean", "description": "Whether the sections should be collapsed by default", "default": false }, "fields": { "type": "array", "items": { "type": "string" } }, "theme": { "type": "string", "description": "Used to highlight sections if they contain new features" } } }, "INodeFieldAndSectionFormElement_2_0": { "type": "object", "properties": { "key": { "type": "string", "description": "A key either pointing to a 'field -> key' or 'section -> key'" }, "type": { "type": "string", "description": "The type of the pointer, either 'field' or 'section'", "enum": [ "field", "section" ] } } }, "IOptionsResolverRestReturnValue_2_0": { "type": "object", "properties": { "options": { "type": "array", "items": { "type": "object", "properties": { "label": { "type": "string" }, "value": { "type": "string" } } } } } }, "IPackageData_2_0": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the Package", "example": "New Package" }, "description": { "type": "string", "description": "The description of the Package", "example": "Version 1" } } }, "IPackageGeneratedData_2_0": { "type": "object", "properties": { "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "hash": { "type": "string", "description": "The hash identifying the contents of the Package", "example": "Version 1" }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 } } }, "IPackageDataCreate_2_0": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the Package", "example": "New Package" }, "description": { "type": "string", "description": "The description of the Package", "example": "Version 1" }, "resourceIds": { "type": "array", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } }, "IPackage_2_0": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the Package", "example": "New Package" }, "description": { "type": "string", "description": "The description of the Package", "example": "Version 1" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "hash": { "type": "string", "description": "The hash identifying the contents of the Package", "example": "Version 1" }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 } } }, "IPackageIndexItem_2_0": { "type": "object", "properties": { "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "name": { "type": "string", "description": "The name of the Package", "example": "New Package" }, "description": { "type": "string", "description": "The description of the Package", "example": "Version 1" }, "hash": { "type": "string", "description": "The hash of the Package identifying the contents of the Package" }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 } } }, "IStrategy_2_0": { "type": "object", "properties": { "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "rename": { "type": "string", "description": "explicitly sets a new name for the imported resource", "example": "new flow" }, "autoRename": { "type": "boolean", "description": "If set to true, will append a \"counter-suffix\" to the name in\ncase the name already exists in the agent.\n", "default": true, "example": true }, "identityConflictStrategy": { "type": "string", "description": "Defines what should be done in case the agent already contains a resource\nwith the same id.\n", "default": "abort", "enum": [ "replace", "re-identify", "abort", "merge" ] }, "mergeStrategy": { "type": "object", "properties": { "replaceContent": { "type": "boolean" }, "replaceStructure": { "type": "boolean" }, "localeOverrides": { "type": "array", "items": { "type": "object", "properties": { "replaceContent": { "type": "boolean" }, "localeId": { "type": "string" } } } } } } } }, "IPlaybookData_2_0": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the Playbook", "example": "New Playbook" }, "abortOnError": { "type": "boolean", "description": "Flag wheter to stop Playbook execution when an assert-error occured" }, "timeout": { "type": "integer", "description": "A time (in ms) after which a playbook step is 'invalid/failed'", "example": 2000, "minimum": 1 } } }, "IPlaybook_2_0": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the Playbook", "example": "New Playbook" }, "abortOnError": { "type": "boolean", "description": "Flag wheter to stop Playbook execution when an assert-error occured" }, "timeout": { "type": "integer", "description": "A time (in ms) after which a playbook step is 'invalid/failed'", "example": 2000, "minimum": 1 }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "steps": { "type": "array", "items": { "type": "object", "properties": { "text": { "type": "string", "description": "The text of the playbook step", "example": "hello world!" }, "data": { "type": "string", "description": "The data of this playbook step", "example": {} }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "asserts": { "type": "array", "items": { "type": "object", "properties": { "text": { "type": "string", "description": "The text of the playbook step", "example": "hello world!" }, "data": { "type": "string", "description": "The data of this playbook step", "example": {} }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } } } } } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" }, "IPlaybookIndexItem_2_0": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the playbook", "example": "New Playbook" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" }, "IPlaybookRunStepResultAssertData_2_0": { "type": "object", "properties": { "type": { "type": "string", "description": "Type of the assert", "example": "assertText" }, "status": { "type": "string", "enum": [ "successful", "failed" ], "description": "Whether this playbook step was successful or failed", "example": "failed" }, "params": { "type": "object", "description": "Parameters for the assert" }, "negate": { "type": "boolean", "description": "Whether the assert was negated", "example": false }, "actual": { "type": "object", "description": "Actual output" } } }, "IPlaybookRunStepResultAssert_2_0": { "type": "object", "properties": { "type": { "type": "string", "description": "Type of the assert", "example": "assertText" }, "status": { "type": "string", "enum": [ "successful", "failed" ], "description": "Whether this playbook step was successful or failed", "example": "failed" }, "params": { "type": "object", "description": "Parameters for the assert" }, "negate": { "type": "boolean", "description": "Whether the assert was negated", "example": false }, "actual": { "type": "object", "description": "Actual output" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } }, "IPlaybookRunStepResultData_2_0": { "type": "object", "properties": { "status": { "type": "string", "enum": [ "successful", "failed" ], "description": "Whether this playbook step was successful or failed", "example": "failed" }, "text": { "type": "string", "description": "Text which we shoot into the system", "example": "Hello, how are you?" }, "data": { "type": "object", "description": "Data which we shoot into the system" } } }, "IPlaybookRunStepResult_2_0": { "type": "object", "properties": { "status": { "type": "string", "enum": [ "successful", "failed" ], "description": "Whether this playbook step was successful or failed", "example": "failed" }, "text": { "type": "string", "description": "Text which we shoot into the system", "example": "Hello, how are you?" }, "data": { "type": "object", "description": "Data which we shoot into the system" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "asserts": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "string", "description": "Type of the assert", "example": "assertText" }, "status": { "type": "string", "enum": [ "successful", "failed" ], "description": "Whether this playbook step was successful or failed", "example": "failed" }, "params": { "type": "object", "description": "Parameters for the assert" }, "negate": { "type": "boolean", "description": "Whether the assert was negated", "example": false }, "actual": { "type": "object", "description": "Actual output" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } } } }, "IPlaybookRunData_2_0": { "type": "object", "properties": { "status": { "type": "string", "enum": [ "successful", "failed" ], "description": "Whether the playbook run was successful or failed", "example": "successful" } } }, "IPlaybookRun_2_0": { "type": "object", "properties": { "status": { "type": "string", "enum": [ "successful", "failed" ], "description": "Whether the playbook run was successful or failed", "example": "successful" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "stepResults": { "type": "array", "items": { "type": "object", "properties": { "status": { "type": "string", "enum": [ "successful", "failed" ], "description": "Whether this playbook step was successful or failed", "example": "failed" }, "text": { "type": "string", "description": "Text which we shoot into the system", "example": "Hello, how are you?" }, "data": { "type": "object", "description": "Data which we shoot into the system" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "asserts": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "string", "description": "Type of the assert", "example": "assertText" }, "status": { "type": "string", "enum": [ "successful", "failed" ], "description": "Whether this playbook step was successful or failed", "example": "failed" }, "params": { "type": "object", "description": "Parameters for the assert" }, "negate": { "type": "boolean", "description": "Whether the assert was negated", "example": false }, "actual": { "type": "object", "description": "Actual output" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } } } } }, "flowId": { "type": "string", "description": "Reference Id of the flow", "example": "uuid" }, "localeId": { "type": "string", "description": "Reference Id of the locale", "example": "uuid" }, "entrypoint": { "type": "string", "description": "snapshot or project ID", "example": "^[a-z0-9]{24}$" } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" }, "IPlaybookRunIndexItem_2_0": { "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n", "type": "object", "properties": { "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "status": { "type": "string", "enum": [ "successful", "failed" ], "description": "Status of the whole Playbook Run", "example": "successful" } } }, "IPlaybookStepData_2_0": { "type": "object", "properties": { "text": { "type": "string", "description": "The text of the playbook step", "example": "hello world!" }, "data": { "type": "string", "description": "The data of this playbook step", "example": {} } } }, "IPlaybookStep_2_0": { "type": "object", "properties": { "text": { "type": "string", "description": "The text of the playbook step", "example": "hello world!" }, "data": { "type": "string", "description": "The data of this playbook step", "example": {} }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "asserts": { "type": "array", "items": { "type": "object", "properties": { "text": { "type": "string", "description": "The text of the playbook step", "example": "hello world!" }, "data": { "type": "string", "description": "The data of this playbook step", "example": {} }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } } } }, "IPlaybookStepAssertData_2_0": { "type": "object", "properties": { "type": { "type": "string", "description": "The type of the Assert", "enum": [ "assertText", "assertData", "assertState", "assertContext", "assertIntent", "assertSlot" ] }, "params": { "type": "object" } } }, "IPlaybookStepAssert_2_0": { "type": "object", "properties": { "text": { "type": "string", "description": "The text of the playbook step", "example": "hello world!" }, "data": { "type": "string", "description": "The data of this playbook step", "example": {} }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } }, "ISchedulePlaybookRunRestDataBody_2_0": { "type": "object", "properties": { "entrypoint": { "type": "string", "description": "snapshot or project ID", "example": "61f25579055c2f43c249a181" }, "flowId": { "type": "string", "description": "The reference ID of the flow", "example": "010d1970-89b9-4012-892b-53c78ef6c117" }, "localeId": { "type": "string", "description": "The reference ID of locale", "example": "8b3b45e2-48f9-446d-a4c5-35d8284a01b2" } } }, "ICreateProjectByTemplateRestDataBody_2_0": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the Project", "example": "New Project" }, "color": { "type": "string", "example": "blue", "oneOf": [ { "type": "string", "example": "none", "enum": [ "aliceBlue", "antiqueWhite", "aqua", "aquamarine", "azure", "beige", "bisque", "black", "blanchedAlmond", "blue", "blueViolet", "brown", "burlyWood", "cadetBlue", "chartreuse", "chocolate", "coral", "cornflowerBlue", "cornsilk", "crimson", "cyan", "darkBlue", "darkCyan", "darkGoldenRod", "darkGray", "darkGrey", "darkGreen", "darkKhaki", "darkMagenta", "darkOliveGreen", "darkOrange", "darkOrchid", "darkRed", "darkSalmon", "darkSeaGreen", "darkSlateBlue", "darkSlateGray", "darkSlateGrey", "darkTurquoise", "darkViolet", "deepPink", "deepSkyBlue", "dimGray", "dimGrey", "dodgerBlue", "fireBrick", "floralWhite", "forestGreen", "fuchsia", "gainsboro", "ghostWhite", "gold", "goldenRod", "gray", "grey", "green", "greenYellow", "honeyDew", "hotPink", "indianRed", "indigo", "ivory", "khaki", "lavender", "lavenderBlush", "lawnGreen", "lemonChiffon", "lightBlue", "lightCoral", "lightCyan", "lightGoldenRodYellow", "lightGray", "lightGrey", "lightGreen", "lightPink", "lightSalmon", "lightSeaGreen", "lightSkyBlue", "lightSlateGray", "lightSlateGrey", "lightSteelBlue", "lightYellow", "lime", "limeGreen", "linen", "magenta", "maroon", "mediumAquaMarine", "mediumBlue", "mediumOrchid", "mediumPurple", "mediumSeaGreen", "mediumSlateBlue", "mediumSpringGreen", "mediumTurquoise", "mediumVioletRed", "midnightBlue", "mintCream", "mistyRose", "moccasin", "navajoWhite", "navy", "oldLace", "olive", "oliveDrab", "orange", "orangeRed", "orchid", "paleGoldenRod", "paleGreen", "paleTurquoise", "paleVioletRed", "papayaWhip", "peachPuff", "peru", "pink", "plum", "powderBlue", "purple", "rebeccaPurple", "red", "rosyBrown", "royalBlue", "saddleBrown", "salmon", "sandyBrown", "seaGreen", "seaShell", "sienna", "silver", "skyBlue", "slateBlue", "slateGray", "slateGrey", "snow", "springGreen", "steelBlue", "tan", "teal", "thistle", "tomato", "turquoise", "violet", "wheat", "white", "whiteSmoke", "yellow", "yellowGreen", "none", "transparent" ] }, { "type": "string", "example": "cognigyGrey", "enum": [ "amber", "blueGrey", "cognigyBlue", "cognigyGrey", "deepOrange", "deepPurple", "lightBlue", "lightGreen" ] } ] }, "handoverConfiguration": { "type": "object", "properties": { "setupLiveAgentInbox": { "type": "boolean" }, "whisperAssistConfiguration": { "type": "string", "enum": [ "none", "basic", "template" ] } } }, "locale": { "type": "string", "example": "en-US", "enum": [ "ge-GE", "da-DK", "en-AU", "en-CA", "en-IN", "en-GB", "en-US", "de-DE", "ja-JP", "ko-KR", "es-ES", "nl-NL", "ar-AE", "fi-FI", "fr-FR", "it-IT", "nn-NO", "pl-PL", "sv-SE", "th-TH", "zh-CN", "vi-VN", "pt-BR", "ru-RU", "pt-PT", "tr-TR", "hi-IN", "bn-IN", "ta-IN" ] }, "templateConfiguration": { "type": "object", "properties": { "endpoints": { "type": "array", "items": { "type": "object", "properties": { "channel": { "type": "string" } } } }, "skills": { "type": "array", "items": { "type": "string" } }, "template": { "type": "string" } } } } }, "IGraph_2_0": { "type": "object", "additionalProperties": { "oneOf": [ { "type": "object", "properties": { "type": { "type": "string", "example": "project", "enum": [ "project", "snapshot" ] }, "name": { "type": "string", "description": "The name of the Resource", "example": "lexicon" }, "resources": { "type": "array", "items": { "type": "object", "properties": { "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "name": { "type": "string", "description": "The name of the Resource", "example": "lexicon" }, "properties": { "type": "object" } } } } } } ] } }, "IGraphProject_2_0": { "type": "object", "properties": { "type": { "type": "string", "example": "project", "enum": [ "project", "snapshot" ] }, "name": { "type": "string", "description": "The name of the Resource", "example": "lexicon" }, "resources": { "type": "array", "items": { "type": "object", "properties": { "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "name": { "type": "string", "description": "The name of the Resource", "example": "lexicon" }, "properties": { "type": "object" } } } } } }, "IGraphResource_2_0": { "type": "object", "properties": { "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "name": { "type": "string", "description": "The name of the Resource", "example": "lexicon" }, "properties": { "type": "object" } } }, "IProjectData_2_0": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the Project", "example": "New Project" }, "color": { "type": "string", "example": "blue", "oneOf": [ { "type": "string", "example": "none", "enum": [ "aliceBlue", "antiqueWhite", "aqua", "aquamarine", "azure", "beige", "bisque", "black", "blanchedAlmond", "blue", "blueViolet", "brown", "burlyWood", "cadetBlue", "chartreuse", "chocolate", "coral", "cornflowerBlue", "cornsilk", "crimson", "cyan", "darkBlue", "darkCyan", "darkGoldenRod", "darkGray", "darkGrey", "darkGreen", "darkKhaki", "darkMagenta", "darkOliveGreen", "darkOrange", "darkOrchid", "darkRed", "darkSalmon", "darkSeaGreen", "darkSlateBlue", "darkSlateGray", "darkSlateGrey", "darkTurquoise", "darkViolet", "deepPink", "deepSkyBlue", "dimGray", "dimGrey", "dodgerBlue", "fireBrick", "floralWhite", "forestGreen", "fuchsia", "gainsboro", "ghostWhite", "gold", "goldenRod", "gray", "grey", "green", "greenYellow", "honeyDew", "hotPink", "indianRed", "indigo", "ivory", "khaki", "lavender", "lavenderBlush", "lawnGreen", "lemonChiffon", "lightBlue", "lightCoral", "lightCyan", "lightGoldenRodYellow", "lightGray", "lightGrey", "lightGreen", "lightPink", "lightSalmon", "lightSeaGreen", "lightSkyBlue", "lightSlateGray", "lightSlateGrey", "lightSteelBlue", "lightYellow", "lime", "limeGreen", "linen", "magenta", "maroon", "mediumAquaMarine", "mediumBlue", "mediumOrchid", "mediumPurple", "mediumSeaGreen", "mediumSlateBlue", "mediumSpringGreen", "mediumTurquoise", "mediumVioletRed", "midnightBlue", "mintCream", "mistyRose", "moccasin", "navajoWhite", "navy", "oldLace", "olive", "oliveDrab", "orange", "orangeRed", "orchid", "paleGoldenRod", "paleGreen", "paleTurquoise", "paleVioletRed", "papayaWhip", "peachPuff", "peru", "pink", "plum", "powderBlue", "purple", "rebeccaPurple", "red", "rosyBrown", "royalBlue", "saddleBrown", "salmon", "sandyBrown", "seaGreen", "seaShell", "sienna", "silver", "skyBlue", "slateBlue", "slateGray", "slateGrey", "snow", "springGreen", "steelBlue", "tan", "teal", "thistle", "tomato", "turquoise", "violet", "wheat", "white", "whiteSmoke", "yellow", "yellowGreen", "none", "transparent" ] }, { "type": "string", "example": "cognigyGrey", "enum": [ "amber", "blueGrey", "cognigyBlue", "cognigyGrey", "deepOrange", "deepPurple", "lightBlue", "lightGreen" ] } ] }, "handoverConfiguration": { "type": "object", "properties": { "setupLiveAgentInbox": { "type": "boolean" }, "whisperAssistConfiguration": { "type": "string", "enum": [ "none", "basic", "template" ] } } } } }, "IProjectGeneratedData_2_0": { "type": "object", "properties": { "primaryLocaleReference": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } }, "IHandoverConfiguration_2_0": { "type": "object", "properties": { "setupLiveAgentInbox": { "type": "boolean" }, "whisperAssistConfiguration": { "type": "string", "enum": [ "none", "basic", "template" ] } } }, "IProjectCreateData_2_0": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the Project", "example": "New Project" }, "color": { "type": "string", "example": "blue", "oneOf": [ { "type": "string", "example": "none", "enum": [ "aliceBlue", "antiqueWhite", "aqua", "aquamarine", "azure", "beige", "bisque", "black", "blanchedAlmond", "blue", "blueViolet", "brown", "burlyWood", "cadetBlue", "chartreuse", "chocolate", "coral", "cornflowerBlue", "cornsilk", "crimson", "cyan", "darkBlue", "darkCyan", "darkGoldenRod", "darkGray", "darkGrey", "darkGreen", "darkKhaki", "darkMagenta", "darkOliveGreen", "darkOrange", "darkOrchid", "darkRed", "darkSalmon", "darkSeaGreen", "darkSlateBlue", "darkSlateGray", "darkSlateGrey", "darkTurquoise", "darkViolet", "deepPink", "deepSkyBlue", "dimGray", "dimGrey", "dodgerBlue", "fireBrick", "floralWhite", "forestGreen", "fuchsia", "gainsboro", "ghostWhite", "gold", "goldenRod", "gray", "grey", "green", "greenYellow", "honeyDew", "hotPink", "indianRed", "indigo", "ivory", "khaki", "lavender", "lavenderBlush", "lawnGreen", "lemonChiffon", "lightBlue", "lightCoral", "lightCyan", "lightGoldenRodYellow", "lightGray", "lightGrey", "lightGreen", "lightPink", "lightSalmon", "lightSeaGreen", "lightSkyBlue", "lightSlateGray", "lightSlateGrey", "lightSteelBlue", "lightYellow", "lime", "limeGreen", "linen", "magenta", "maroon", "mediumAquaMarine", "mediumBlue", "mediumOrchid", "mediumPurple", "mediumSeaGreen", "mediumSlateBlue", "mediumSpringGreen", "mediumTurquoise", "mediumVioletRed", "midnightBlue", "mintCream", "mistyRose", "moccasin", "navajoWhite", "navy", "oldLace", "olive", "oliveDrab", "orange", "orangeRed", "orchid", "paleGoldenRod", "paleGreen", "paleTurquoise", "paleVioletRed", "papayaWhip", "peachPuff", "peru", "pink", "plum", "powderBlue", "purple", "rebeccaPurple", "red", "rosyBrown", "royalBlue", "saddleBrown", "salmon", "sandyBrown", "seaGreen", "seaShell", "sienna", "silver", "skyBlue", "slateBlue", "slateGray", "slateGrey", "snow", "springGreen", "steelBlue", "tan", "teal", "thistle", "tomato", "turquoise", "violet", "wheat", "white", "whiteSmoke", "yellow", "yellowGreen", "none", "transparent" ] }, { "type": "string", "example": "cognigyGrey", "enum": [ "amber", "blueGrey", "cognigyBlue", "cognigyGrey", "deepOrange", "deepPurple", "lightBlue", "lightGreen" ] } ] }, "handoverConfiguration": { "type": "object", "properties": { "setupLiveAgentInbox": { "type": "boolean" }, "whisperAssistConfiguration": { "type": "string", "enum": [ "none", "basic", "template" ] } } }, "locale": { "type": "string", "example": "en-US", "enum": [ "ge-GE", "da-DK", "en-AU", "en-CA", "en-IN", "en-GB", "en-US", "de-DE", "ja-JP", "ko-KR", "es-ES", "nl-NL", "ar-AE", "fi-FI", "fr-FR", "it-IT", "nn-NO", "pl-PL", "sv-SE", "th-TH", "zh-CN", "vi-VN", "pt-BR", "ru-RU", "pt-PT", "tr-TR", "hi-IN", "bn-IN", "ta-IN" ] } } }, "IProject_2_0": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the Project", "example": "New Project" }, "color": { "type": "string", "example": "blue", "oneOf": [ { "type": "string", "example": "none", "enum": [ "aliceBlue", "antiqueWhite", "aqua", "aquamarine", "azure", "beige", "bisque", "black", "blanchedAlmond", "blue", "blueViolet", "brown", "burlyWood", "cadetBlue", "chartreuse", "chocolate", "coral", "cornflowerBlue", "cornsilk", "crimson", "cyan", "darkBlue", "darkCyan", "darkGoldenRod", "darkGray", "darkGrey", "darkGreen", "darkKhaki", "darkMagenta", "darkOliveGreen", "darkOrange", "darkOrchid", "darkRed", "darkSalmon", "darkSeaGreen", "darkSlateBlue", "darkSlateGray", "darkSlateGrey", "darkTurquoise", "darkViolet", "deepPink", "deepSkyBlue", "dimGray", "dimGrey", "dodgerBlue", "fireBrick", "floralWhite", "forestGreen", "fuchsia", "gainsboro", "ghostWhite", "gold", "goldenRod", "gray", "grey", "green", "greenYellow", "honeyDew", "hotPink", "indianRed", "indigo", "ivory", "khaki", "lavender", "lavenderBlush", "lawnGreen", "lemonChiffon", "lightBlue", "lightCoral", "lightCyan", "lightGoldenRodYellow", "lightGray", "lightGrey", "lightGreen", "lightPink", "lightSalmon", "lightSeaGreen", "lightSkyBlue", "lightSlateGray", "lightSlateGrey", "lightSteelBlue", "lightYellow", "lime", "limeGreen", "linen", "magenta", "maroon", "mediumAquaMarine", "mediumBlue", "mediumOrchid", "mediumPurple", "mediumSeaGreen", "mediumSlateBlue", "mediumSpringGreen", "mediumTurquoise", "mediumVioletRed", "midnightBlue", "mintCream", "mistyRose", "moccasin", "navajoWhite", "navy", "oldLace", "olive", "oliveDrab", "orange", "orangeRed", "orchid", "paleGoldenRod", "paleGreen", "paleTurquoise", "paleVioletRed", "papayaWhip", "peachPuff", "peru", "pink", "plum", "powderBlue", "purple", "rebeccaPurple", "red", "rosyBrown", "royalBlue", "saddleBrown", "salmon", "sandyBrown", "seaGreen", "seaShell", "sienna", "silver", "skyBlue", "slateBlue", "slateGray", "slateGrey", "snow", "springGreen", "steelBlue", "tan", "teal", "thistle", "tomato", "turquoise", "violet", "wheat", "white", "whiteSmoke", "yellow", "yellowGreen", "none", "transparent" ] }, { "type": "string", "example": "cognigyGrey", "enum": [ "amber", "blueGrey", "cognigyBlue", "cognigyGrey", "deepOrange", "deepPurple", "lightBlue", "lightGreen" ] } ] }, "handoverConfiguration": { "type": "object", "properties": { "setupLiveAgentInbox": { "type": "boolean" }, "whisperAssistConfiguration": { "type": "string", "enum": [ "none", "basic", "template" ] } } }, "liveAgentDefaultInbox": { "type": "number", "description": "Live agent default inbox Id for the project" }, "primaryLocaleReference": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" }, "IProjectIndexItem_2_0": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the Project", "example": "New Project" }, "color": { "type": "string", "example": "blue", "oneOf": [ { "type": "string", "example": "none", "enum": [ "aliceBlue", "antiqueWhite", "aqua", "aquamarine", "azure", "beige", "bisque", "black", "blanchedAlmond", "blue", "blueViolet", "brown", "burlyWood", "cadetBlue", "chartreuse", "chocolate", "coral", "cornflowerBlue", "cornsilk", "crimson", "cyan", "darkBlue", "darkCyan", "darkGoldenRod", "darkGray", "darkGrey", "darkGreen", "darkKhaki", "darkMagenta", "darkOliveGreen", "darkOrange", "darkOrchid", "darkRed", "darkSalmon", "darkSeaGreen", "darkSlateBlue", "darkSlateGray", "darkSlateGrey", "darkTurquoise", "darkViolet", "deepPink", "deepSkyBlue", "dimGray", "dimGrey", "dodgerBlue", "fireBrick", "floralWhite", "forestGreen", "fuchsia", "gainsboro", "ghostWhite", "gold", "goldenRod", "gray", "grey", "green", "greenYellow", "honeyDew", "hotPink", "indianRed", "indigo", "ivory", "khaki", "lavender", "lavenderBlush", "lawnGreen", "lemonChiffon", "lightBlue", "lightCoral", "lightCyan", "lightGoldenRodYellow", "lightGray", "lightGrey", "lightGreen", "lightPink", "lightSalmon", "lightSeaGreen", "lightSkyBlue", "lightSlateGray", "lightSlateGrey", "lightSteelBlue", "lightYellow", "lime", "limeGreen", "linen", "magenta", "maroon", "mediumAquaMarine", "mediumBlue", "mediumOrchid", "mediumPurple", "mediumSeaGreen", "mediumSlateBlue", "mediumSpringGreen", "mediumTurquoise", "mediumVioletRed", "midnightBlue", "mintCream", "mistyRose", "moccasin", "navajoWhite", "navy", "oldLace", "olive", "oliveDrab", "orange", "orangeRed", "orchid", "paleGoldenRod", "paleGreen", "paleTurquoise", "paleVioletRed", "papayaWhip", "peachPuff", "peru", "pink", "plum", "powderBlue", "purple", "rebeccaPurple", "red", "rosyBrown", "royalBlue", "saddleBrown", "salmon", "sandyBrown", "seaGreen", "seaShell", "sienna", "silver", "skyBlue", "slateBlue", "slateGray", "slateGrey", "snow", "springGreen", "steelBlue", "tan", "teal", "thistle", "tomato", "turquoise", "violet", "wheat", "white", "whiteSmoke", "yellow", "yellowGreen", "none", "transparent" ] }, { "type": "string", "example": "cognigyGrey", "enum": [ "amber", "blueGrey", "cognigyBlue", "cognigyGrey", "deepOrange", "deepPurple", "lightBlue", "lightGreen" ] } ] }, "handoverConfiguration": { "type": "object", "properties": { "setupLiveAgentInbox": { "type": "boolean" }, "whisperAssistConfiguration": { "type": "string", "enum": [ "none", "basic", "template" ] } } }, "liveAgentDefaultInbox": { "type": "number", "description": "Live agent default inbox Id for the project" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" }, "IAgentSettingsData_2_0": { "type": "object", "properties": { "timezone": { "type": "string", "description": "Timezone according to IANA Timezone Database (2020a)", "example": "Europe/Berlin", "enum": [ "Africa/Abidjan", "Africa/Accra", "Africa/Addis_Ababa", "Africa/Algiers", "Africa/Asmara", "Africa/Asmera", "Africa/Bamako", "Africa/Bangui", "Africa/Banjul", "Africa/Bissau", "Africa/Blantyre", "Africa/Brazzaville", "Africa/Bujumbura", "Africa/Cairo", "Africa/Casablanca", "Africa/Ceuta", "Africa/Conakry", "Africa/Dakar", "Africa/Dar_es_Salaam", "Africa/Djibouti", "Africa/Douala", "Africa/El_Aaiun", "Africa/Freetown", "Africa/Gaborone", "Africa/Harare", "Africa/Johannesburg", "Africa/Juba", "Africa/Kampala", "Africa/Khartoum", "Africa/Kigali", "Africa/Kinshasa", "Africa/Lagos", "Africa/Libreville", "Africa/Lome", "Africa/Luanda", "Africa/Lubumbashi", "Africa/Lusaka", "Africa/Malabo", "Africa/Maputo", "Africa/Maseru", "Africa/Mbabane", "Africa/Mogadishu", "Africa/Monrovia", "Africa/Nairobi", "Africa/Ndjamena", "Africa/Niamey", "Africa/Nouakchott", "Africa/Ouagadougou", "Africa/Porto-Novo", "Africa/Sao_Tome", "Africa/Timbuktu", "Africa/Tripoli", "Africa/Tunis", "Africa/Windhoek", "America/Adak", "America/Anchorage", "America/Anguilla", "America/Antigua", "America/Araguaina", "America/Argentina/Buenos_Aires", "America/Argentina/Catamarca", "America/Argentina/ComodRivadavia", "America/Argentina/Cordoba", "America/Argentina/Jujuy", "America/Argentina/La_Rioja", "America/Argentina/Mendoza", "America/Argentina/Rio_Gallegos", "America/Argentina/Salta", "America/Argentina/San_Juan", "America/Argentina/San_Luis", "America/Argentina/Tucuman", "America/Argentina/Ushuaia", "America/Aruba", "America/Asuncion", "America/Atikokan", "America/Atka", "America/Bahia", "America/Bahia_Banderas", "America/Barbados", "America/Belem", "America/Belize", "America/Blanc-Sablon", "America/Boa_Vista", "America/Bogota", "America/Boise", "America/Buenos_Aires", "America/Cambridge_Bay", "America/Campo_Grande", "America/Cancun", "America/Caracas", "America/Catamarca", "America/Cayenne", "America/Cayman", "America/Chicago", "America/Chihuahua", "America/Coral_Harbour", "America/Cordoba", "America/Costa_Rica", "America/Creston", "America/Cuiaba", "America/Curacao", "America/Danmarkshavn", "America/Dawson", "America/Dawson_Creek", "America/Denver", "America/Detroit", "America/Dominica", "America/Edmonton", "America/Eirunepe", "America/El_Salvador", "America/Ensenada", "America/Fort_Nelson", "America/Fort_Wayne", "America/Fortaleza", "America/Glace_Bay", "America/Godthab", "America/Goose_Bay", "America/Grand_Turk", "America/Grenada", "America/Guadeloupe", "America/Guatemala", "America/Guayaquil", "America/Guyana", "America/Halifax", "America/Havana", "America/Hermosillo", "America/Indiana/Indianapolis", "America/Indiana/Knox", "America/Indiana/Marengo", "America/Indiana/Petersburg", "America/Indiana/Tell_City", "America/Indiana/Vevay", "America/Indiana/Vincennes", "America/Indiana/Winamac", "America/Indianapolis", "America/Inuvik", "America/Iqaluit", "America/Jamaica", "America/Jujuy", "America/Juneau", "America/Kentucky/Louisville", "America/Kentucky/Monticello", "America/Knox_IN", "America/Kralendijk", "America/La_Paz", "America/Lima", "America/Los_Angeles", "America/Louisville", "America/Lower_Princes", "America/Maceio", "America/Managua", "America/Manaus", "America/Marigot", "America/Martinique", "America/Matamoros", "America/Mazatlan", "America/Mendoza", "America/Menominee", "America/Merida", "America/Metlakatla", "America/Mexico_City", "America/Miquelon", "America/Moncton", "America/Monterrey", "America/Montevideo", "America/Montreal", "America/Montserrat", "America/Nassau", "America/New_York", "America/Nipigon", "America/Nome", "America/Noronha", "America/North_Dakota/Beulah", "America/North_Dakota/Center", "America/North_Dakota/New_Salem", "America/Ojinaga", "America/Panama", "America/Pangnirtung", "America/Paramaribo", "America/Phoenix", "America/Port-au-Prince", "America/Port_of_Spain", "America/Porto_Acre", "America/Porto_Velho", "America/Puerto_Rico", "America/Punta_Arenas", "America/Rainy_River", "America/Rankin_Inlet", "America/Recife", "America/Regina", "America/Resolute", "America/Rio_Branco", "America/Rosario", "America/Santa_Isabel", "America/Santarem", "America/Santiago", "America/Santo_Domingo", "America/Sao_Paulo", "America/Scoresbysund", "America/Shiprock", "America/Sitka", "America/St_Barthelemy", "America/St_Johns", "America/St_Kitts", "America/St_Lucia", "America/St_Thomas", "America/St_Vincent", "America/Swift_Current", "America/Tegucigalpa", "America/Thule", "America/Thunder_Bay", "America/Tijuana", "America/Toronto", "America/Tortola", "America/Vancouver", "America/Virgin", "America/Whitehorse", "America/Winnipeg", "America/Yakutat", "America/Yellowknife", "Antarctica/Casey", "Antarctica/Davis", "Antarctica/DumontDUrville", "Antarctica/Macquarie", "Antarctica/Mawson", "Antarctica/McMurdo", "Antarctica/Palmer", "Antarctica/Rothera", "Antarctica/South_Pole", "Antarctica/Syowa", "Antarctica/Troll", "Antarctica/Vostok", "Arctic/Longyearbyen", "Asia/Aden", "Asia/Almaty", "Asia/Amman", "Asia/Anadyr", "Asia/Aqtau", "Asia/Aqtobe", "Asia/Ashgabat", "Asia/Ashkhabad", "Asia/Atyrau", "Asia/Baghdad", "Asia/Bahrain", "Asia/Baku", "Asia/Bangkok", "Asia/Barnaul", "Asia/Beirut", "Asia/Bishkek", "Asia/Brunei", "Asia/Calcutta", "Asia/Chita", "Asia/Choibalsan", "Asia/Chongqing", "Asia/Chungking", "Asia/Colombo", "Asia/Dacca", "Asia/Damascus", "Asia/Dhaka", "Asia/Dili", "Asia/Dubai", "Asia/Dushanbe", "Asia/Famagusta", "Asia/Gaza", "Asia/Harbin", "Asia/Hebron", "Asia/Ho_Chi_Minh", "Asia/Hong_Kong", "Asia/Hovd", "Asia/Irkutsk", "Asia/Istanbul", "Asia/Jakarta", "Asia/Jayapura", "Asia/Jerusalem", "Asia/Kabul", "Asia/Kamchatka", "Asia/Karachi", "Asia/Kashgar", "Asia/Kathmandu", "Asia/Katmandu", "Asia/Khandyga", "Asia/Kolkata", "Asia/Krasnoyarsk", "Asia/Kuala_Lumpur", "Asia/Kuching", "Asia/Kuwait", "Asia/Macao", "Asia/Macau", "Asia/Magadan", "Asia/Makassar", "Asia/Manila", "Asia/Muscat", "Asia/Nicosia", "Asia/Novokuznetsk", "Asia/Novosibirsk", "Asia/Omsk", "Asia/Oral", "Asia/Phnom_Penh", "Asia/Pontianak", "Asia/Pyongyang", "Asia/Qatar", "Asia/Qyzylorda", "Asia/Rangoon", "Asia/Riyadh", "Asia/Saigon", "Asia/Sakhalin", "Asia/Samarkand", "Asia/Seoul", "Asia/Shanghai", "Asia/Singapore", "Asia/Srednekolymsk", "Asia/Taipei", "Asia/Tashkent", "Asia/Tbilisi", "Asia/Tehran", "Asia/Tel_Aviv", "Asia/Thimbu", "Asia/Thimphu", "Asia/Tokyo", "Asia/Tomsk", "Asia/Ujung_Pandang", "Asia/Ulaanbaatar", "Asia/Ulan_Bator", "Asia/Urumqi", "Asia/Ust-Nera", "Asia/Vientiane", "Asia/Vladivostok", "Asia/Yakutsk", "Asia/Yangon", "Asia/Yekaterinburg", "Asia/Yerevan", "Atlantic/Azores", "Atlantic/Bermuda", "Atlantic/Canary", "Atlantic/Cape_Verde", "Atlantic/Faeroe", "Atlantic/Faroe", "Atlantic/Jan_Mayen", "Atlantic/Madeira", "Atlantic/Reykjavik", "Atlantic/South_Georgia", "Atlantic/St_Helena", "Atlantic/Stanley", "Australia/ACT", "Australia/Adelaide", "Australia/Brisbane", "Australia/Broken_Hill", "Australia/Canberra", "Australia/Currie", "Australia/Darwin", "Australia/Eucla", "Australia/Hobart", "Australia/LHI", "Australia/Lindeman", "Australia/Lord_Howe", "Australia/Melbourne", "Australia/NSW", "Australia/North", "Australia/Perth", "Australia/Queensland", "Australia/South", "Australia/Sydney", "Australia/Tasmania", "Australia/Victoria", "Australia/West", "Australia/Yancowinna", "Brazil/Acre", "Brazil/DeNoronha", "Brazil/East", "Brazil/West", "CET", "CST6CDT", "Canada/Atlantic", "Canada/Central", "Canada/Eastern", "Canada/Mountain", "Canada/Newfoundland", "Canada/Pacific", "Canada/Saskatchewan", "Canada/Yukon", "Chile/Continental", "Chile/EasterIsland", "Cuba", "EET", "EST", "EST5EDT", "Egypt", "Eire", "Etc/GMT", "Etc/GMT+0", "Etc/GMT+1", "Etc/GMT+10", "Etc/GMT+11", "Etc/GMT+12", "Etc/GMT+2", "Etc/GMT+3", "Etc/GMT+4", "Etc/GMT+5", "Etc/GMT+6", "Etc/GMT+7", "Etc/GMT+8", "Etc/GMT+9", "Etc/GMT-0", "Etc/GMT-1", "Etc/GMT-10", "Etc/GMT-11", "Etc/GMT-12", "Etc/GMT-13", "Etc/GMT-14", "Etc/GMT-2", "Etc/GMT-3", "Etc/GMT-4", "Etc/GMT-5", "Etc/GMT-6", "Etc/GMT-7", "Etc/GMT-8", "Etc/GMT-9", "Etc/GMT0", "Etc/Greenwich", "Etc/UCT", "Etc/UTC", "Etc/Universal", "Etc/Zulu", "Europe/Amsterdam", "Europe/Andorra", "Europe/Astrakhan", "Europe/Athens", "Europe/Belfast", "Europe/Belgrade", "Europe/Berlin", "Europe/Bratislava", "Europe/Brussels", "Europe/Bucharest", "Europe/Budapest", "Europe/Busingen", "Europe/Chisinau", "Europe/Copenhagen", "Europe/Dublin", "Europe/Gibraltar", "Europe/Guernsey", "Europe/Helsinki", "Europe/Isle_of_Man", "Europe/Istanbul", "Europe/Jersey", "Europe/Kaliningrad", "Europe/Kiev", "Europe/Kirov", "Europe/Lisbon", "Europe/Ljubljana", "Europe/London", "Europe/Luxembourg", "Europe/Madrid", "Europe/Malta", "Europe/Mariehamn", "Europe/Minsk", "Europe/Monaco", "Europe/Moscow", "Europe/Nicosia", "Europe/Oslo", "Europe/Paris", "Europe/Podgorica", "Europe/Prague", "Europe/Riga", "Europe/Rome", "Europe/Samara", "Europe/San_Marino", "Europe/Sarajevo", "Europe/Saratov", "Europe/Simferopol", "Europe/Skopje", "Europe/Sofia", "Europe/Stockholm", "Europe/Tallinn", "Europe/Tirane", "Europe/Tiraspol", "Europe/Ulyanovsk", "Europe/Uzhgorod", "Europe/Vaduz", "Europe/Vatican", "Europe/Vienna", "Europe/Vilnius", "Europe/Volgograd", "Europe/Warsaw", "Europe/Zagreb", "Europe/Zaporozhye", "Europe/Zurich", "GB", "GB-Eire", "GMT", "GMT+0", "GMT-0", "GMT0", "Greenwich", "HST", "Hongkong", "Iceland", "Indian/Antananarivo", "Indian/Chagos", "Indian/Christmas", "Indian/Cocos", "Indian/Comoro", "Indian/Kerguelen", "Indian/Mahe", "Indian/Maldives", "Indian/Mauritius", "Indian/Mayotte", "Indian/Reunion", "Iran", "Israel", "Jamaica", "Japan", "Kwajalein", "Libya", "MET", "MST", "MST7MDT", "Mexico/BajaNorte", "Mexico/BajaSur", "Mexico/General", "NZ", "NZ-CHAT", "Navajo", "PRC", "PST8PDT", "Pacific/Apia", "Pacific/Auckland", "Pacific/Bougainville", "Pacific/Chatham", "Pacific/Chuuk", "Pacific/Easter", "Pacific/Efate", "Pacific/Enderbury", "Pacific/Fakaofo", "Pacific/Fiji", "Pacific/Funafuti", "Pacific/Galapagos", "Pacific/Gambier", "Pacific/Guadalcanal", "Pacific/Guam", "Pacific/Honolulu", "Pacific/Johnston", "Pacific/Kiritimati", "Pacific/Kosrae", "Pacific/Kwajalein", "Pacific/Majuro", "Pacific/Marquesas", "Pacific/Midway", "Pacific/Nauru", "Pacific/Niue", "Pacific/Norfolk", "Pacific/Noumea", "Pacific/Pago_Pago", "Pacific/Palau", "Pacific/Pitcairn", "Pacific/Pohnpei", "Pacific/Ponape", "Pacific/Port_Moresby", "Pacific/Rarotonga", "Pacific/Saipan", "Pacific/Samoa", "Pacific/Tahiti", "Pacific/Tarawa", "Pacific/Tongatapu", "Pacific/Truk", "Pacific/Wake", "Pacific/Wallis", "Pacific/Yap", "Poland", "Portugal", "ROC", "ROK", "Singapore", "Turkey", "UCT", "US/Alaska", "US/Aleutian", "US/Arizona", "US/Central", "US/East-Indiana", "US/Eastern", "US/Hawaii", "US/Indiana-Starke", "US/Michigan", "US/Mountain", "US/Pacific", "US/Pacific-New", "US/Samoa", "UTC", "Universal", "W-SU", "WET", "Zulu" ] }, "useCaseSensitiveIntentMapping": { "type": "boolean" }, "collectAnalytics": { "type": "boolean" }, "trackDataOnlyInputs": { "type": "boolean" }, "translationSettings": { "type": "object", "properties": { "provider": { "type": "string", "description": "Supported Translation Providers", "enum": [ "none", "microsoft", "google", "deepl" ] }, "connections": { "type": "object", "properties": { "microsoft": { "type": "object", "properties": { "connecionId": { "type": "string", "description": "ReferenceId to the connection provider" }, "retries": { "type": "string", "description": "Number of retries", "default": 1 }, "timeout": { "type": "string", "description": "Timeout in milliseconds", "default": 3000 }, "cacheExpiry": { "type": "string", "description": "Cache expiry in milliseconds", "default": 0 }, "customBaseUrl": { "type": "string", "description": "Custom base url", "default": "" } } }, "deepl": { "type": "object", "properties": { "connecionId": { "type": "string", "description": "ReferenceId to the connection provider" }, "retries": { "type": "string", "description": "Number of retries", "default": 1 }, "timeout": { "type": "string", "description": "Timeout in milliseconds", "default": 3000 }, "cacheExpiry": { "type": "string", "description": "Cache expiry in milliseconds", "default": 0 }, "customBaseUrl": { "type": "string", "description": "Custom base url", "default": "" } } }, "google": { "type": "object", "properties": { "connecionId": { "type": "string", "description": "ReferenceId to the connection provider" }, "retries": { "type": "string", "description": "Number of retries", "default": 1 }, "timeout": { "type": "string", "description": "Timeout in milliseconds", "default": 3000 }, "cacheExpiry": { "type": "string", "description": "Cache expiry in milliseconds", "default": 0 }, "customBaseUrl": { "type": "string", "description": "Custom base url", "default": "" } } } } } } }, "audioPreviewSettings": { "type": "object", "properties": { "provider": { "type": "string", "description": "Supported AudioPreview Providers", "enum": [ null, "microsoft", "google", "aws" ] }, "connections": { "type": "object", "properties": { "microsoft": { "type": "object", "properties": { "connecionId": { "type": "string", "description": "ReferenceId to the connection provider" } } }, "aws": { "type": "object", "properties": { "connecionId": { "type": "string", "description": "ReferenceId to the connection provider" } } }, "google": { "type": "object", "properties": { "connecionId": { "type": "string", "description": "ReferenceId to the connection provider" } } } } } } }, "generativeAISettings": { "type": "object", "properties": { "enabled": { "type": "boolean" }, "useCasesSettings": { "type": "object", "properties": { "intentSentenceGeneration": { "type": "object", "properties": { "enabled": { "type": "boolean", "description": "Enable/Disable the usecase." }, "largeLanguageModelId": { "type": "string", "description": "reference Id to the LargeLanguageModel object" }, "temperature": { "type": "integer", "minimum": 0, "maximum": 1, "description": "Defines the creativity of the model" } } }, "aiEnhancedOutputs": { "type": "object", "properties": { "enabled": { "type": "boolean", "description": "Enable/Disable the usecase." }, "largeLanguageModelId": { "type": "string", "description": "reference Id to the LargeLanguageModel object" }, "temperature": { "type": "integer", "minimum": 0, "maximum": 1, "description": "Defines the creativity of the model" } } }, "lexiconGeneration": { "type": "object", "properties": { "enabled": { "type": "boolean", "description": "Enable/Disable the usecase." }, "largeLanguageModelId": { "type": "string", "description": "reference Id to the LargeLanguageModel object" }, "temperature": { "type": "integer", "minimum": 0, "maximum": 1, "description": "Defines the creativity of the model" } } }, "flowGeneration": { "type": "object", "properties": { "enabled": { "type": "boolean", "description": "Enable/Disable the usecase." }, "largeLanguageModelId": { "type": "string", "description": "reference Id to the LargeLanguageModel object" }, "temperature": { "type": "integer", "minimum": 0, "maximum": 1, "description": "Defines the creativity of the model" } } }, "gptConversation": { "type": "object", "properties": { "enabled": { "type": "boolean", "description": "Enable/Disable the usecase." }, "largeLanguageModelId": { "type": "string", "description": "reference Id to the LargeLanguageModel object" }, "temperature": { "type": "integer", "minimum": 0, "maximum": 1, "description": "Defines the creativity of the model" } } }, "gptPromptNode": { "type": "object", "properties": { "enabled": { "type": "boolean", "description": "Enable/Disable the usecase." }, "largeLanguageModelId": { "type": "string", "description": "reference Id to the LargeLanguageModel object" }, "temperature": { "type": "integer", "minimum": 0, "maximum": 1, "description": "Defines the creativity of the model" } } }, "generateNodeOutput": { "type": "object", "properties": { "enabled": { "type": "boolean", "description": "Enable/Disable the usecase." }, "largeLanguageModelId": { "type": "string", "description": "reference Id to the LargeLanguageModel object" }, "temperature": { "type": "integer", "minimum": 0, "maximum": 1, "description": "Defines the creativity of the model" } } }, "knowledgeSearch": { "type": "object", "properties": { "enabled": { "type": "boolean", "description": "Enable/Disable the usecase." }, "largeLanguageModelId": { "type": "string", "description": "reference Id to the LargeLanguageModel object" }, "temperature": { "type": "integer", "minimum": 0, "maximum": 1, "description": "Defines the creativity of the model" } } } } } } }, "currencySettings": { "type": "object", "properties": { "currency": { "type": "string", "example": "USD" } } }, "knowledgeAISettings": { "type": "object", "properties": { "fileExtractor": { "type": "string", "description": "Options for the Knowledge AI File Extractor", "enum": [ "default", "legacy", "azure" ] }, "azureDIConnectionId": { "type": "string", "description": "ReferenceId of the Azure AI Document Intelligence Connection", "example": "f66e99eb-db8f-433c-977f-69160d9a6bdb" } } } } }, "IAgentSettings_2_0": { "type": "object", "properties": { "timezone": { "type": "string", "description": "Timezone according to IANA Timezone Database (2020a)", "example": "Europe/Berlin", "enum": [ "Africa/Abidjan", "Africa/Accra", "Africa/Addis_Ababa", "Africa/Algiers", "Africa/Asmara", "Africa/Asmera", "Africa/Bamako", "Africa/Bangui", "Africa/Banjul", "Africa/Bissau", "Africa/Blantyre", "Africa/Brazzaville", "Africa/Bujumbura", "Africa/Cairo", "Africa/Casablanca", "Africa/Ceuta", "Africa/Conakry", "Africa/Dakar", "Africa/Dar_es_Salaam", "Africa/Djibouti", "Africa/Douala", "Africa/El_Aaiun", "Africa/Freetown", "Africa/Gaborone", "Africa/Harare", "Africa/Johannesburg", "Africa/Juba", "Africa/Kampala", "Africa/Khartoum", "Africa/Kigali", "Africa/Kinshasa", "Africa/Lagos", "Africa/Libreville", "Africa/Lome", "Africa/Luanda", "Africa/Lubumbashi", "Africa/Lusaka", "Africa/Malabo", "Africa/Maputo", "Africa/Maseru", "Africa/Mbabane", "Africa/Mogadishu", "Africa/Monrovia", "Africa/Nairobi", "Africa/Ndjamena", "Africa/Niamey", "Africa/Nouakchott", "Africa/Ouagadougou", "Africa/Porto-Novo", "Africa/Sao_Tome", "Africa/Timbuktu", "Africa/Tripoli", "Africa/Tunis", "Africa/Windhoek", "America/Adak", "America/Anchorage", "America/Anguilla", "America/Antigua", "America/Araguaina", "America/Argentina/Buenos_Aires", "America/Argentina/Catamarca", "America/Argentina/ComodRivadavia", "America/Argentina/Cordoba", "America/Argentina/Jujuy", "America/Argentina/La_Rioja", "America/Argentina/Mendoza", "America/Argentina/Rio_Gallegos", "America/Argentina/Salta", "America/Argentina/San_Juan", "America/Argentina/San_Luis", "America/Argentina/Tucuman", "America/Argentina/Ushuaia", "America/Aruba", "America/Asuncion", "America/Atikokan", "America/Atka", "America/Bahia", "America/Bahia_Banderas", "America/Barbados", "America/Belem", "America/Belize", "America/Blanc-Sablon", "America/Boa_Vista", "America/Bogota", "America/Boise", "America/Buenos_Aires", "America/Cambridge_Bay", "America/Campo_Grande", "America/Cancun", "America/Caracas", "America/Catamarca", "America/Cayenne", "America/Cayman", "America/Chicago", "America/Chihuahua", "America/Coral_Harbour", "America/Cordoba", "America/Costa_Rica", "America/Creston", "America/Cuiaba", "America/Curacao", "America/Danmarkshavn", "America/Dawson", "America/Dawson_Creek", "America/Denver", "America/Detroit", "America/Dominica", "America/Edmonton", "America/Eirunepe", "America/El_Salvador", "America/Ensenada", "America/Fort_Nelson", "America/Fort_Wayne", "America/Fortaleza", "America/Glace_Bay", "America/Godthab", "America/Goose_Bay", "America/Grand_Turk", "America/Grenada", "America/Guadeloupe", "America/Guatemala", "America/Guayaquil", "America/Guyana", "America/Halifax", "America/Havana", "America/Hermosillo", "America/Indiana/Indianapolis", "America/Indiana/Knox", "America/Indiana/Marengo", "America/Indiana/Petersburg", "America/Indiana/Tell_City", "America/Indiana/Vevay", "America/Indiana/Vincennes", "America/Indiana/Winamac", "America/Indianapolis", "America/Inuvik", "America/Iqaluit", "America/Jamaica", "America/Jujuy", "America/Juneau", "America/Kentucky/Louisville", "America/Kentucky/Monticello", "America/Knox_IN", "America/Kralendijk", "America/La_Paz", "America/Lima", "America/Los_Angeles", "America/Louisville", "America/Lower_Princes", "America/Maceio", "America/Managua", "America/Manaus", "America/Marigot", "America/Martinique", "America/Matamoros", "America/Mazatlan", "America/Mendoza", "America/Menominee", "America/Merida", "America/Metlakatla", "America/Mexico_City", "America/Miquelon", "America/Moncton", "America/Monterrey", "America/Montevideo", "America/Montreal", "America/Montserrat", "America/Nassau", "America/New_York", "America/Nipigon", "America/Nome", "America/Noronha", "America/North_Dakota/Beulah", "America/North_Dakota/Center", "America/North_Dakota/New_Salem", "America/Ojinaga", "America/Panama", "America/Pangnirtung", "America/Paramaribo", "America/Phoenix", "America/Port-au-Prince", "America/Port_of_Spain", "America/Porto_Acre", "America/Porto_Velho", "America/Puerto_Rico", "America/Punta_Arenas", "America/Rainy_River", "America/Rankin_Inlet", "America/Recife", "America/Regina", "America/Resolute", "America/Rio_Branco", "America/Rosario", "America/Santa_Isabel", "America/Santarem", "America/Santiago", "America/Santo_Domingo", "America/Sao_Paulo", "America/Scoresbysund", "America/Shiprock", "America/Sitka", "America/St_Barthelemy", "America/St_Johns", "America/St_Kitts", "America/St_Lucia", "America/St_Thomas", "America/St_Vincent", "America/Swift_Current", "America/Tegucigalpa", "America/Thule", "America/Thunder_Bay", "America/Tijuana", "America/Toronto", "America/Tortola", "America/Vancouver", "America/Virgin", "America/Whitehorse", "America/Winnipeg", "America/Yakutat", "America/Yellowknife", "Antarctica/Casey", "Antarctica/Davis", "Antarctica/DumontDUrville", "Antarctica/Macquarie", "Antarctica/Mawson", "Antarctica/McMurdo", "Antarctica/Palmer", "Antarctica/Rothera", "Antarctica/South_Pole", "Antarctica/Syowa", "Antarctica/Troll", "Antarctica/Vostok", "Arctic/Longyearbyen", "Asia/Aden", "Asia/Almaty", "Asia/Amman", "Asia/Anadyr", "Asia/Aqtau", "Asia/Aqtobe", "Asia/Ashgabat", "Asia/Ashkhabad", "Asia/Atyrau", "Asia/Baghdad", "Asia/Bahrain", "Asia/Baku", "Asia/Bangkok", "Asia/Barnaul", "Asia/Beirut", "Asia/Bishkek", "Asia/Brunei", "Asia/Calcutta", "Asia/Chita", "Asia/Choibalsan", "Asia/Chongqing", "Asia/Chungking", "Asia/Colombo", "Asia/Dacca", "Asia/Damascus", "Asia/Dhaka", "Asia/Dili", "Asia/Dubai", "Asia/Dushanbe", "Asia/Famagusta", "Asia/Gaza", "Asia/Harbin", "Asia/Hebron", "Asia/Ho_Chi_Minh", "Asia/Hong_Kong", "Asia/Hovd", "Asia/Irkutsk", "Asia/Istanbul", "Asia/Jakarta", "Asia/Jayapura", "Asia/Jerusalem", "Asia/Kabul", "Asia/Kamchatka", "Asia/Karachi", "Asia/Kashgar", "Asia/Kathmandu", "Asia/Katmandu", "Asia/Khandyga", "Asia/Kolkata", "Asia/Krasnoyarsk", "Asia/Kuala_Lumpur", "Asia/Kuching", "Asia/Kuwait", "Asia/Macao", "Asia/Macau", "Asia/Magadan", "Asia/Makassar", "Asia/Manila", "Asia/Muscat", "Asia/Nicosia", "Asia/Novokuznetsk", "Asia/Novosibirsk", "Asia/Omsk", "Asia/Oral", "Asia/Phnom_Penh", "Asia/Pontianak", "Asia/Pyongyang", "Asia/Qatar", "Asia/Qyzylorda", "Asia/Rangoon", "Asia/Riyadh", "Asia/Saigon", "Asia/Sakhalin", "Asia/Samarkand", "Asia/Seoul", "Asia/Shanghai", "Asia/Singapore", "Asia/Srednekolymsk", "Asia/Taipei", "Asia/Tashkent", "Asia/Tbilisi", "Asia/Tehran", "Asia/Tel_Aviv", "Asia/Thimbu", "Asia/Thimphu", "Asia/Tokyo", "Asia/Tomsk", "Asia/Ujung_Pandang", "Asia/Ulaanbaatar", "Asia/Ulan_Bator", "Asia/Urumqi", "Asia/Ust-Nera", "Asia/Vientiane", "Asia/Vladivostok", "Asia/Yakutsk", "Asia/Yangon", "Asia/Yekaterinburg", "Asia/Yerevan", "Atlantic/Azores", "Atlantic/Bermuda", "Atlantic/Canary", "Atlantic/Cape_Verde", "Atlantic/Faeroe", "Atlantic/Faroe", "Atlantic/Jan_Mayen", "Atlantic/Madeira", "Atlantic/Reykjavik", "Atlantic/South_Georgia", "Atlantic/St_Helena", "Atlantic/Stanley", "Australia/ACT", "Australia/Adelaide", "Australia/Brisbane", "Australia/Broken_Hill", "Australia/Canberra", "Australia/Currie", "Australia/Darwin", "Australia/Eucla", "Australia/Hobart", "Australia/LHI", "Australia/Lindeman", "Australia/Lord_Howe", "Australia/Melbourne", "Australia/NSW", "Australia/North", "Australia/Perth", "Australia/Queensland", "Australia/South", "Australia/Sydney", "Australia/Tasmania", "Australia/Victoria", "Australia/West", "Australia/Yancowinna", "Brazil/Acre", "Brazil/DeNoronha", "Brazil/East", "Brazil/West", "CET", "CST6CDT", "Canada/Atlantic", "Canada/Central", "Canada/Eastern", "Canada/Mountain", "Canada/Newfoundland", "Canada/Pacific", "Canada/Saskatchewan", "Canada/Yukon", "Chile/Continental", "Chile/EasterIsland", "Cuba", "EET", "EST", "EST5EDT", "Egypt", "Eire", "Etc/GMT", "Etc/GMT+0", "Etc/GMT+1", "Etc/GMT+10", "Etc/GMT+11", "Etc/GMT+12", "Etc/GMT+2", "Etc/GMT+3", "Etc/GMT+4", "Etc/GMT+5", "Etc/GMT+6", "Etc/GMT+7", "Etc/GMT+8", "Etc/GMT+9", "Etc/GMT-0", "Etc/GMT-1", "Etc/GMT-10", "Etc/GMT-11", "Etc/GMT-12", "Etc/GMT-13", "Etc/GMT-14", "Etc/GMT-2", "Etc/GMT-3", "Etc/GMT-4", "Etc/GMT-5", "Etc/GMT-6", "Etc/GMT-7", "Etc/GMT-8", "Etc/GMT-9", "Etc/GMT0", "Etc/Greenwich", "Etc/UCT", "Etc/UTC", "Etc/Universal", "Etc/Zulu", "Europe/Amsterdam", "Europe/Andorra", "Europe/Astrakhan", "Europe/Athens", "Europe/Belfast", "Europe/Belgrade", "Europe/Berlin", "Europe/Bratislava", "Europe/Brussels", "Europe/Bucharest", "Europe/Budapest", "Europe/Busingen", "Europe/Chisinau", "Europe/Copenhagen", "Europe/Dublin", "Europe/Gibraltar", "Europe/Guernsey", "Europe/Helsinki", "Europe/Isle_of_Man", "Europe/Istanbul", "Europe/Jersey", "Europe/Kaliningrad", "Europe/Kiev", "Europe/Kirov", "Europe/Lisbon", "Europe/Ljubljana", "Europe/London", "Europe/Luxembourg", "Europe/Madrid", "Europe/Malta", "Europe/Mariehamn", "Europe/Minsk", "Europe/Monaco", "Europe/Moscow", "Europe/Nicosia", "Europe/Oslo", "Europe/Paris", "Europe/Podgorica", "Europe/Prague", "Europe/Riga", "Europe/Rome", "Europe/Samara", "Europe/San_Marino", "Europe/Sarajevo", "Europe/Saratov", "Europe/Simferopol", "Europe/Skopje", "Europe/Sofia", "Europe/Stockholm", "Europe/Tallinn", "Europe/Tirane", "Europe/Tiraspol", "Europe/Ulyanovsk", "Europe/Uzhgorod", "Europe/Vaduz", "Europe/Vatican", "Europe/Vienna", "Europe/Vilnius", "Europe/Volgograd", "Europe/Warsaw", "Europe/Zagreb", "Europe/Zaporozhye", "Europe/Zurich", "GB", "GB-Eire", "GMT", "GMT+0", "GMT-0", "GMT0", "Greenwich", "HST", "Hongkong", "Iceland", "Indian/Antananarivo", "Indian/Chagos", "Indian/Christmas", "Indian/Cocos", "Indian/Comoro", "Indian/Kerguelen", "Indian/Mahe", "Indian/Maldives", "Indian/Mauritius", "Indian/Mayotte", "Indian/Reunion", "Iran", "Israel", "Jamaica", "Japan", "Kwajalein", "Libya", "MET", "MST", "MST7MDT", "Mexico/BajaNorte", "Mexico/BajaSur", "Mexico/General", "NZ", "NZ-CHAT", "Navajo", "PRC", "PST8PDT", "Pacific/Apia", "Pacific/Auckland", "Pacific/Bougainville", "Pacific/Chatham", "Pacific/Chuuk", "Pacific/Easter", "Pacific/Efate", "Pacific/Enderbury", "Pacific/Fakaofo", "Pacific/Fiji", "Pacific/Funafuti", "Pacific/Galapagos", "Pacific/Gambier", "Pacific/Guadalcanal", "Pacific/Guam", "Pacific/Honolulu", "Pacific/Johnston", "Pacific/Kiritimati", "Pacific/Kosrae", "Pacific/Kwajalein", "Pacific/Majuro", "Pacific/Marquesas", "Pacific/Midway", "Pacific/Nauru", "Pacific/Niue", "Pacific/Norfolk", "Pacific/Noumea", "Pacific/Pago_Pago", "Pacific/Palau", "Pacific/Pitcairn", "Pacific/Pohnpei", "Pacific/Ponape", "Pacific/Port_Moresby", "Pacific/Rarotonga", "Pacific/Saipan", "Pacific/Samoa", "Pacific/Tahiti", "Pacific/Tarawa", "Pacific/Tongatapu", "Pacific/Truk", "Pacific/Wake", "Pacific/Wallis", "Pacific/Yap", "Poland", "Portugal", "ROC", "ROK", "Singapore", "Turkey", "UCT", "US/Alaska", "US/Aleutian", "US/Arizona", "US/Central", "US/East-Indiana", "US/Eastern", "US/Hawaii", "US/Indiana-Starke", "US/Michigan", "US/Mountain", "US/Pacific", "US/Pacific-New", "US/Samoa", "UTC", "Universal", "W-SU", "WET", "Zulu" ] }, "useCaseSensitiveIntentMapping": { "type": "boolean" }, "collectAnalytics": { "type": "boolean" }, "trackDataOnlyInputs": { "type": "boolean" }, "translationSettings": { "type": "object", "properties": { "provider": { "type": "string", "description": "Supported Translation Providers", "enum": [ "none", "microsoft", "google", "deepl" ] }, "connections": { "type": "object", "properties": { "microsoft": { "type": "object", "properties": { "connecionId": { "type": "string", "description": "ReferenceId to the connection provider" }, "retries": { "type": "string", "description": "Number of retries", "default": 1 }, "timeout": { "type": "string", "description": "Timeout in milliseconds", "default": 3000 }, "cacheExpiry": { "type": "string", "description": "Cache expiry in milliseconds", "default": 0 }, "customBaseUrl": { "type": "string", "description": "Custom base url", "default": "" } } }, "deepl": { "type": "object", "properties": { "connecionId": { "type": "string", "description": "ReferenceId to the connection provider" }, "retries": { "type": "string", "description": "Number of retries", "default": 1 }, "timeout": { "type": "string", "description": "Timeout in milliseconds", "default": 3000 }, "cacheExpiry": { "type": "string", "description": "Cache expiry in milliseconds", "default": 0 }, "customBaseUrl": { "type": "string", "description": "Custom base url", "default": "" } } }, "google": { "type": "object", "properties": { "connecionId": { "type": "string", "description": "ReferenceId to the connection provider" }, "retries": { "type": "string", "description": "Number of retries", "default": 1 }, "timeout": { "type": "string", "description": "Timeout in milliseconds", "default": 3000 }, "cacheExpiry": { "type": "string", "description": "Cache expiry in milliseconds", "default": 0 }, "customBaseUrl": { "type": "string", "description": "Custom base url", "default": "" } } } } } } }, "audioPreviewSettings": { "type": "object", "properties": { "provider": { "type": "string", "description": "Supported AudioPreview Providers", "enum": [ null, "microsoft", "google", "aws" ] }, "connections": { "type": "object", "properties": { "microsoft": { "type": "object", "properties": { "connecionId": { "type": "string", "description": "ReferenceId to the connection provider" } } }, "aws": { "type": "object", "properties": { "connecionId": { "type": "string", "description": "ReferenceId to the connection provider" } } }, "google": { "type": "object", "properties": { "connecionId": { "type": "string", "description": "ReferenceId to the connection provider" } } } } } } }, "generativeAISettings": { "type": "object", "properties": { "enabled": { "type": "boolean" }, "useCasesSettings": { "type": "object", "properties": { "intentSentenceGeneration": { "type": "object", "properties": { "enabled": { "type": "boolean", "description": "Enable/Disable the usecase." }, "largeLanguageModelId": { "type": "string", "description": "reference Id to the LargeLanguageModel object" }, "temperature": { "type": "integer", "minimum": 0, "maximum": 1, "description": "Defines the creativity of the model" } } }, "aiEnhancedOutputs": { "type": "object", "properties": { "enabled": { "type": "boolean", "description": "Enable/Disable the usecase." }, "largeLanguageModelId": { "type": "string", "description": "reference Id to the LargeLanguageModel object" }, "temperature": { "type": "integer", "minimum": 0, "maximum": 1, "description": "Defines the creativity of the model" } } }, "lexiconGeneration": { "type": "object", "properties": { "enabled": { "type": "boolean", "description": "Enable/Disable the usecase." }, "largeLanguageModelId": { "type": "string", "description": "reference Id to the LargeLanguageModel object" }, "temperature": { "type": "integer", "minimum": 0, "maximum": 1, "description": "Defines the creativity of the model" } } }, "flowGeneration": { "type": "object", "properties": { "enabled": { "type": "boolean", "description": "Enable/Disable the usecase." }, "largeLanguageModelId": { "type": "string", "description": "reference Id to the LargeLanguageModel object" }, "temperature": { "type": "integer", "minimum": 0, "maximum": 1, "description": "Defines the creativity of the model" } } }, "gptConversation": { "type": "object", "properties": { "enabled": { "type": "boolean", "description": "Enable/Disable the usecase." }, "largeLanguageModelId": { "type": "string", "description": "reference Id to the LargeLanguageModel object" }, "temperature": { "type": "integer", "minimum": 0, "maximum": 1, "description": "Defines the creativity of the model" } } }, "gptPromptNode": { "type": "object", "properties": { "enabled": { "type": "boolean", "description": "Enable/Disable the usecase." }, "largeLanguageModelId": { "type": "string", "description": "reference Id to the LargeLanguageModel object" }, "temperature": { "type": "integer", "minimum": 0, "maximum": 1, "description": "Defines the creativity of the model" } } }, "generateNodeOutput": { "type": "object", "properties": { "enabled": { "type": "boolean", "description": "Enable/Disable the usecase." }, "largeLanguageModelId": { "type": "string", "description": "reference Id to the LargeLanguageModel object" }, "temperature": { "type": "integer", "minimum": 0, "maximum": 1, "description": "Defines the creativity of the model" } } }, "knowledgeSearch": { "type": "object", "properties": { "enabled": { "type": "boolean", "description": "Enable/Disable the usecase." }, "largeLanguageModelId": { "type": "string", "description": "reference Id to the LargeLanguageModel object" }, "temperature": { "type": "integer", "minimum": 0, "maximum": 1, "description": "Defines the creativity of the model" } } } } } } }, "currencySettings": { "type": "object", "properties": { "currency": { "type": "string", "example": "USD" } } }, "knowledgeAISettings": { "type": "object", "properties": { "fileExtractor": { "type": "string", "description": "Options for the Knowledge AI File Extractor", "enum": [ "default", "legacy", "azure" ] }, "azureDIConnectionId": { "type": "string", "description": "ReferenceId of the Azure AI Document Intelligence Connection", "example": "f66e99eb-db8f-433c-977f-69160d9a6bdb" } } }, "intentThreshold": { "type": "object", "properties": { "lower": { "type": "number", "example": 0.4 }, "upper": { "type": "number", "example": 0.5 } } }, "learnNewExampleSentences": { "type": "boolean" }, "learnNewExampleSentencesThreshold": { "type": "integer" }, "negativeConfirmationWords": { "type": "array", "items": { "type": "string" } }, "positiveConfirmationWords": { "type": "array", "items": { "type": "string" } }, "systemSlots": { "type": "object", "properties": { "useAgeSlots": { "type": "boolean" }, "useDateSlots": { "type": "boolean" }, "useDistanceSlots": { "type": "boolean" }, "useDurationSlots": { "type": "boolean" }, "useEmailSlots": { "type": "boolean" }, "useMoneySlots": { "type": "boolean" }, "useNumberSlots": { "type": "boolean" }, "usePercentageSlots": { "type": "boolean" }, "useTemperatureSlots": { "type": "boolean" }, "useURLSlots": { "type": "boolean" } } }, "yesNoLogic": { "type": "string", "enum": [ "yesNoIntents", "yesNoIntentsWithRules", "confirmationWords" ] }, "yesNoIntentThreshold": { "type": "integer" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" }, "TTranslationProvider_2_0": { "type": "string", "description": "Supported Translation Providers", "enum": [ "none", "microsoft", "google", "deepl" ] }, "TranslationConnection": { "type": "object", "properties": { "connecionId": { "type": "string", "description": "ReferenceId to the connection provider" }, "retries": { "type": "string", "description": "Number of retries", "default": 1 }, "timeout": { "type": "string", "description": "Timeout in milliseconds", "default": 3000 }, "cacheExpiry": { "type": "string", "description": "Cache expiry in milliseconds", "default": 0 }, "customBaseUrl": { "type": "string", "description": "Custom base url", "default": "" } } }, "IAgentTranslationSettings_2_0": { "type": "object", "properties": { "provider": { "type": "string", "description": "Supported Translation Providers", "enum": [ "none", "microsoft", "google", "deepl" ] }, "connections": { "type": "object", "properties": { "microsoft": { "type": "object", "properties": { "connecionId": { "type": "string", "description": "ReferenceId to the connection provider" }, "retries": { "type": "string", "description": "Number of retries", "default": 1 }, "timeout": { "type": "string", "description": "Timeout in milliseconds", "default": 3000 }, "cacheExpiry": { "type": "string", "description": "Cache expiry in milliseconds", "default": 0 }, "customBaseUrl": { "type": "string", "description": "Custom base url", "default": "" } } }, "deepl": { "type": "object", "properties": { "connecionId": { "type": "string", "description": "ReferenceId to the connection provider" }, "retries": { "type": "string", "description": "Number of retries", "default": 1 }, "timeout": { "type": "string", "description": "Timeout in milliseconds", "default": 3000 }, "cacheExpiry": { "type": "string", "description": "Cache expiry in milliseconds", "default": 0 }, "customBaseUrl": { "type": "string", "description": "Custom base url", "default": "" } } }, "google": { "type": "object", "properties": { "connecionId": { "type": "string", "description": "ReferenceId to the connection provider" }, "retries": { "type": "string", "description": "Number of retries", "default": 1 }, "timeout": { "type": "string", "description": "Timeout in milliseconds", "default": 3000 }, "cacheExpiry": { "type": "string", "description": "Cache expiry in milliseconds", "default": 0 }, "customBaseUrl": { "type": "string", "description": "Custom base url", "default": "" } } } } } } }, "TAudioPreviewProvider_2_0": { "type": "string", "description": "Supported AudioPreview Providers", "enum": [ null, "microsoft", "google", "aws" ] }, "IAudioPreviewMicrosoftSettings_2_0": { "type": "object", "properties": { "apiKey": { "type": "string", "maxLength": 30, "description": "MS API Key" }, "region": { "type": "string", "maxLength": 30, "description": "MS region" } } }, "IAudioPreviewAWSSettings_2_0": { "type": "object", "properties": { "accessKeyId": { "type": "string", "maxLength": 100, "description": "AWS API Id" }, "secretAccessKey": { "type": "string", "maxLength": 150, "description": "AWS API accesss Key" }, "sessionToken": { "type": "string", "maxLength": 300, "description": "AWS API session token" }, "region": { "type": "string", "maxLength": 30, "description": "AWS region" } } }, "IAudioPreviewGoogleSettings_2_0": { "type": "object", "properties": { "googleCredentialsFileName": { "type": "string", "maxLength": 100, "description": "Google Cloud credentials .json file" }, "fileToken": { "type": "string", "maxLength": 500, "description": "Credentials file token" }, "credentialsStringified": { "type": "string", "maxLength": 300, "description": "Credentials file stringified" }, "clientEmail": { "type": "string", "maxLength": 300, "description": "Client Email from the Google Cloud credentials .json file" }, "privateKey": { "type": "string", "maxLength": 150, "description": "Client private key from Google credentials file name" } } }, "AudioPreviewConnection": { "type": "object", "properties": { "connecionId": { "type": "string", "description": "ReferenceId to the connection provider" } } }, "IAudioPreviewSettings_2_0": { "type": "object", "properties": { "provider": { "type": "string", "description": "Supported AudioPreview Providers", "enum": [ null, "microsoft", "google", "aws" ] }, "connections": { "type": "object", "properties": { "microsoft": { "type": "object", "properties": { "connecionId": { "type": "string", "description": "ReferenceId to the connection provider" } } }, "aws": { "type": "object", "properties": { "connecionId": { "type": "string", "description": "ReferenceId to the connection provider" } } }, "google": { "type": "object", "properties": { "connecionId": { "type": "string", "description": "ReferenceId to the connection provider" } } } } } } }, "TGenerativeAIProviders_2_0": { "type": "string", "description": "Supported Generative AI Providers", "enum": [ "openAI", "azureOpenAI", "anthropic", "googleVertexAI", "googleGemini", "alephAlpha" ] }, "TGenerativeAIModels_2_0": { "type": "string", "description": "Supported Generative AI Models", "enum": [ "text-davinci-003", "gpt-3.5-turbo", "gpt-3.5-turbo-instruct", "gpt-4", "text-embedding-ada-002", "luminous-extended-control", "claude-v1-100k", "claude-instant-v1", "claude-3-opus-20240229", "text-bison@001" ] }, "IGenerativeAIMeta_2_0": { "type": "object", "properties": { "enabled": { "type": "boolean", "description": "Enable/Disable the usecase." }, "largeLanguageModelId": { "type": "string", "description": "reference Id to the LargeLanguageModel object" }, "temperature": { "type": "integer", "minimum": 0, "maximum": 1, "description": "Defines the creativity of the model" } } }, "IGenerativeAIModelSettings_2_0": { "type": "object", "properties": { "enabled": { "type": "boolean" }, "useCasesSettings": { "type": "object", "properties": { "intentSentenceGeneration": { "type": "object", "properties": { "enabled": { "type": "boolean", "description": "Enable/Disable the usecase." }, "largeLanguageModelId": { "type": "string", "description": "reference Id to the LargeLanguageModel object" }, "temperature": { "type": "integer", "minimum": 0, "maximum": 1, "description": "Defines the creativity of the model" } } }, "aiEnhancedOutputs": { "type": "object", "properties": { "enabled": { "type": "boolean", "description": "Enable/Disable the usecase." }, "largeLanguageModelId": { "type": "string", "description": "reference Id to the LargeLanguageModel object" }, "temperature": { "type": "integer", "minimum": 0, "maximum": 1, "description": "Defines the creativity of the model" } } }, "lexiconGeneration": { "type": "object", "properties": { "enabled": { "type": "boolean", "description": "Enable/Disable the usecase." }, "largeLanguageModelId": { "type": "string", "description": "reference Id to the LargeLanguageModel object" }, "temperature": { "type": "integer", "minimum": 0, "maximum": 1, "description": "Defines the creativity of the model" } } }, "flowGeneration": { "type": "object", "properties": { "enabled": { "type": "boolean", "description": "Enable/Disable the usecase." }, "largeLanguageModelId": { "type": "string", "description": "reference Id to the LargeLanguageModel object" }, "temperature": { "type": "integer", "minimum": 0, "maximum": 1, "description": "Defines the creativity of the model" } } }, "gptConversation": { "type": "object", "properties": { "enabled": { "type": "boolean", "description": "Enable/Disable the usecase." }, "largeLanguageModelId": { "type": "string", "description": "reference Id to the LargeLanguageModel object" }, "temperature": { "type": "integer", "minimum": 0, "maximum": 1, "description": "Defines the creativity of the model" } } }, "gptPromptNode": { "type": "object", "properties": { "enabled": { "type": "boolean", "description": "Enable/Disable the usecase." }, "largeLanguageModelId": { "type": "string", "description": "reference Id to the LargeLanguageModel object" }, "temperature": { "type": "integer", "minimum": 0, "maximum": 1, "description": "Defines the creativity of the model" } } }, "generateNodeOutput": { "type": "object", "properties": { "enabled": { "type": "boolean", "description": "Enable/Disable the usecase." }, "largeLanguageModelId": { "type": "string", "description": "reference Id to the LargeLanguageModel object" }, "temperature": { "type": "integer", "minimum": 0, "maximum": 1, "description": "Defines the creativity of the model" } } }, "knowledgeSearch": { "type": "object", "properties": { "enabled": { "type": "boolean", "description": "Enable/Disable the usecase." }, "largeLanguageModelId": { "type": "string", "description": "reference Id to the LargeLanguageModel object" }, "temperature": { "type": "integer", "minimum": 0, "maximum": 1, "description": "Defines the creativity of the model" } } } } } } }, "TFileExtractorOptions_2_0": { "type": "string", "description": "Options for the Knowledge AI File Extractor", "enum": [ "default", "legacy", "azure" ] }, "IKnowledgeAISettings_2_0": { "type": "object", "properties": { "fileExtractor": { "type": "string", "description": "Options for the Knowledge AI File Extractor", "enum": [ "default", "legacy", "azure" ] }, "azureDIConnectionId": { "type": "string", "description": "ReferenceId of the Azure AI Document Intelligence Connection", "example": "f66e99eb-db8f-433c-977f-69160d9a6bdb" } } }, "ISharedSettings_2_0": { "type": "object", "properties": { "intentThreshold": { "type": "object", "properties": { "lower": { "type": "number", "example": 0.4 }, "upper": { "type": "number", "example": 0.5 } } }, "learnNewExampleSentences": { "type": "boolean" }, "learnNewExampleSentencesThreshold": { "type": "integer" }, "negativeConfirmationWords": { "type": "array", "items": { "type": "string" } }, "positiveConfirmationWords": { "type": "array", "items": { "type": "string" } }, "systemSlots": { "type": "object", "properties": { "useAgeSlots": { "type": "boolean" }, "useDateSlots": { "type": "boolean" }, "useDistanceSlots": { "type": "boolean" }, "useDurationSlots": { "type": "boolean" }, "useEmailSlots": { "type": "boolean" }, "useMoneySlots": { "type": "boolean" }, "useNumberSlots": { "type": "boolean" }, "usePercentageSlots": { "type": "boolean" }, "useTemperatureSlots": { "type": "boolean" }, "useURLSlots": { "type": "boolean" } } }, "yesNoLogic": { "type": "string", "enum": [ "yesNoIntents", "yesNoIntentsWithRules", "confirmationWords" ] }, "yesNoIntentThreshold": { "type": "integer" } } }, "ITestTranslationSettings_2_0": { "type": "object", "properties": { "language": { "type": "string" }, "error": { "type": "object" }, "msg": { "type": "string" } } }, "ISnippet_2_0": { "type": "object", "properties": { "label": { "type": "string", "description": "The snippet Name", "example": "New snippet" } } }, "ISearchResultIndexItem_2_0": { "type": "object", "properties": { "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "name": { "type": "string", "description": "The name of the Resource", "example": "pizza-endpoint" }, "type": { "type": "string", "description": "The type of a resource", "example": "endpoint", "enum": [ "endpoint", "extension", "flow", "function", "lexicon", "milestone", "nluconnector", "playbook", "project", "snapshot" ] }, "subType": { "oneOf": [ { "type": "string", "description": "The NLUConnector type", "example": "cognigy", "enum": [ "alexa", "dialogflow", "dialogflowBuiltIn", "amazonLexBuiltIn", "luis", "watson", "noNlu", "cognigy", "code", "generativeAI", "lex" ] }, { "type": "string", "example": "webchat2", "enum": [ "facebook", "alexa", "slack", "generic", "inject", "rest", "realtime", "socket", "adminconsole", "webchat2", "dialogflow", "twilio", "twilio-sms", "line", "intercom", "microsoftBotFramework", "microsoftTeams", "sunshineConversations", "admin-webchat", "avaya", "nonConversational", "voiceGateway2", "amazonLex", "workplace", "webhook", "abstractRest", "userlike", "ringCentralEngage", "audioCodes", "bandwidth", "whatsapp", "eightByEight", "genesysBotConnector", "niceCXOne", "agentAssistVoice", "webchat3" ] }, { "type": "string", "description": "Supported Generative AI Providers", "enum": [ "openAI", "azureOpenAI", "anthropic", "googleVertexAI", "googleGemini", "alephAlpha" ] } ] }, "projectId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 } } }, "IResourceInSnapshotItem_2_0": { "type": "object", "properties": { "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "name": { "type": "string", "description": "The name of the Resource", "example": "New Resource" }, "referenceId": { "type": "string", "description": "The reference ID of the resource" }, "resourceType": { "type": "string", "description": "The type of resource", "example": "flow" }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "minimum": 0, "maximum": 2147483647, "example": 1527621049 } } }, "ISnapshotData_2_0": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the Snapshot", "example": "New Snapshot" }, "description": { "type": "string", "description": "The description of the Snapshot", "example": "Version 1" } } }, "ISnapshotGeneratedData_2_0": { "type": "object", "properties": { "isPackaged": { "type": "boolean", "description": "Whether the Snapshot has already been packaged and is ready for download" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "hash": { "type": "string", "description": "The hash identifying the contents of the Snapshot", "example": "Version 1" }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 } } }, "ISnapshot_2_0": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the Snapshot", "example": "New Snapshot" }, "description": { "type": "string", "description": "The description of the Snapshot", "example": "Version 1" }, "isPackaged": { "type": "boolean", "description": "Whether the Snapshot has already been packaged and is ready for download" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "hash": { "type": "string", "description": "The hash identifying the contents of the Snapshot", "example": "Version 1" }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 } } }, "ISnapshotIndexItem_2_0": { "type": "object", "properties": { "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "name": { "type": "string", "description": "The name of the Snapshot", "example": "New Snapshot" }, "description": { "type": "string", "description": "The description of the Snapshot", "example": "Version 1" }, "isPackaged": { "type": "boolean", "description": "Whether the Snapshot has already been packaged and is ready for download" }, "packageExpiresAt": { "type": "number", "description": "The timestamp where the downloadable package expires" }, "hash": { "type": "string", "description": "The hash of the Snapshot identifying the contents of the Snapshot" }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "minimum": 0, "maximum": 2147483647, "example": 1527621049 } } }, "TUploadResumableTypes": { "type": "string", "enum": [ "snapshots", "packages" ] }, "ICrudPermissions": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "IOrganisationWideAcl": { "type": "object", "properties": { "rights": { "type": "object", "properties": { "analyticsOdata": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "apiKeys": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "liveAgentAccount": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "projects": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "userDetails": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "users": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "connections": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "contactProfiles": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "conversationHistory": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "endpoints": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "extensions": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "flowNodeComments": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "flowNodeDescription": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "flowNodes": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "flows": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "intents": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "knowledgeStores": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "lexicons": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "liveAgentInbox": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "locales": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "logs": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "memberDetails": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "members": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "milestones": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "nluConnectors": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "playbooks": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "project": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "projectSettings": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "snapshots": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "states": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "tasks": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "tokens": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "voiceGatewayAccount": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } } } }, "roles": { "type": "array", "items": { "type": "string", "enum": [ "admin", "apiKeys", "base_role", "basicSupportUser", "fullSupportUser", "liveAgentAdmin", "liveAgentAgent", "liveAgentSupervisor", "odata", "projectAssigner", "projectManager", "userManager", "userDetailsViewer", "voiceGatewayUser" ] } } } }, "IProjectWideAcl": { "type": "object", "properties": { "rights": { "type": "object", "properties": { "agentAssistConfigs": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "analytics": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "connections": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "contactProfiles": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "conversationHistory": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "endpoints": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "extensions": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "extensionsTrust": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "flowNodeComments": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "flowNodeDescription": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "flowNodes": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "flows": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "intents": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "largeLanguageModels": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "knowledgeStores": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "lexicons": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "liveAgentInbox": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "locales": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "logs": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "memberDetails": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "members": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "milestones": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "nluConnectors": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "playbooks": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "project": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "projectSettings": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "snapshots": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "states": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "tasks": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "tokens": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "analyticsOdata": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "apiKeys": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "projects": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "userDetails": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "users": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } } }, "additionalProperties": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } } }, "roles": { "type": "array", "items": { "type": "string", "enum": [ "agentAssistConfigAdmin", "agentAssistConfigViewer", "analytics", "basic", "connection_admin", "contact_profile_admin", "contact_profile_editor", "contact_profile_viewer", "conversationHistory", "developer", "endpoint_admin", "extension_admin", "extension_editor", "flowEditor", "flowNodeComments", "flowNodeDescriptions", "followUser", "intents", "data_privacy_admin", "data_privacy_editor", "data_privacy_viewer", "knowledgeAdmin", "large_language_model_admin,", "lexicon_admin", "lexicon_editor", "localesAdmin", "logs", "memberManager", "nlu_connector_admin", "packages_admin", "playbook_admin", "playbook_editor", "projectAdmin", "snapshot_admin", "tokenAdmin", "tokenEditor", "function_admin", "function_editor" ] } }, "allowedLocales": { "type": "array", "items": { "type": "object", "properties": { "localeId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "primary": { "type": "boolean" } } } } } }, "IUserAcl": { "type": "object", "properties": { "organisationWide": { "type": "object", "properties": { "rights": { "type": "object", "properties": { "analyticsOdata": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "apiKeys": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "liveAgentAccount": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "projects": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "userDetails": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "users": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "connections": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "contactProfiles": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "conversationHistory": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "endpoints": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "extensions": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "flowNodeComments": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "flowNodeDescription": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "flowNodes": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "flows": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "intents": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "knowledgeStores": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "lexicons": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "liveAgentInbox": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "locales": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "logs": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "memberDetails": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "members": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "milestones": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "nluConnectors": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "playbooks": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "project": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "projectSettings": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "snapshots": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "states": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "tasks": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "tokens": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "voiceGatewayAccount": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } } } }, "roles": { "type": "array", "items": { "type": "string", "enum": [ "admin", "apiKeys", "base_role", "basicSupportUser", "fullSupportUser", "liveAgentAdmin", "liveAgentAgent", "liveAgentSupervisor", "odata", "projectAssigner", "projectManager", "userManager", "userDetailsViewer", "voiceGatewayUser" ] } } } }, "projectWide": { "type": "object", "additionalProperties": { "type": "object", "properties": { "rights": { "type": "object", "properties": { "agentAssistConfigs": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "analytics": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "connections": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "contactProfiles": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "conversationHistory": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "endpoints": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "extensions": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "extensionsTrust": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "flowNodeComments": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "flowNodeDescription": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "flowNodes": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "flows": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "intents": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "largeLanguageModels": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "knowledgeStores": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "lexicons": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "liveAgentInbox": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "locales": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "logs": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "memberDetails": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "members": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "milestones": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "nluConnectors": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "playbooks": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "project": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "projectSettings": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "snapshots": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "states": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "tasks": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "tokens": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "analyticsOdata": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "apiKeys": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "projects": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "userDetails": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "users": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } } }, "additionalProperties": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } } }, "roles": { "type": "array", "items": { "type": "string", "enum": [ "agentAssistConfigAdmin", "agentAssistConfigViewer", "analytics", "basic", "connection_admin", "contact_profile_admin", "contact_profile_editor", "contact_profile_viewer", "conversationHistory", "developer", "endpoint_admin", "extension_admin", "extension_editor", "flowEditor", "flowNodeComments", "flowNodeDescriptions", "followUser", "intents", "data_privacy_admin", "data_privacy_editor", "data_privacy_viewer", "knowledgeAdmin", "large_language_model_admin,", "lexicon_admin", "lexicon_editor", "localesAdmin", "logs", "memberManager", "nlu_connector_admin", "packages_admin", "playbook_admin", "playbook_editor", "projectAdmin", "snapshot_admin", "tokenAdmin", "tokenEditor", "function_admin", "function_editor" ] } }, "allowedLocales": { "type": "array", "items": { "type": "object", "properties": { "localeId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "primary": { "type": "boolean" } } } } } } } } }, "IAllowedLocale": { "type": "object", "properties": { "localeId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "primary": { "type": "boolean" } } }, "TIdentityProviderType": { "type": "string", "description": "The Type of Identity Provider. Currently saml and oidc are supported.\n", "enum": [ "saml", "oidc" ] }, "ISamlIdentityProviderData": { "type": "object", "properties": { "idpType": { "type": "string", "enum": [ "saml" ] }, "idpIssuer": { "type": "string", "description": "The value that will be in the issuer field in the SAML request.", "format": "url" }, "idpLoginEndpoint": { "type": "string", "description": "The URL to use to login in the IDP. Used in the SP initiated Flow.", "format": "url" }, "idpLogoutEndpoint": { "type": "string", "description": "The URL to send SLO requests against. Not all identity providers support this.", "format": "url" }, "idpCertificate": { "type": "string", "description": "The certificate from the ID used to sign the SAML requests. It is base64 encoded." }, "decryptionPrivateKey": { "type": "string", "description": "An optional decryption key. This is necessary if the SAML request is encoded." }, "idpDisableRequestedAuthnContext": { "type": "boolean", "description": "For some providers, e.g. Azure on-prem, it might be necessary to disable the authn context field in the SAML request.", "default": false } } }, "TIdpTokenEndpointAuthMethod": { "type": "string", "description": "Requested Client Authentication method for the Token Endpoint.\n\nhttps://openid.net/specs/openid-connect-core-1_0.html#ClientAuthentication\n", "enum": [ "client_secret_basic", "client_secret_post", "client_secret_jwt", "private_key_jwt", "tls_client_auth", "self_signed_tls_client_auth", "none" ], "default": "client_secret_basic", "example": "client_secret_basic" }, "TIdpIdTokenSignedResponseAlg": { "type": "string", "description": "The Algorithm used to sign the ID Token issued to this Client.\n", "enum": [ "RS256", "RS384", "RS512", "HS256", "HS384", "HS512" ], "default": "RS256", "example": "RS256" }, "IOidcIdentityProviderData": { "type": "object", "properties": { "idpType": { "type": "string", "enum": [ "oidc" ] }, "idpIssuer": { "type": "string", "description": "The openId-Connect baseUrl", "format": "url" }, "idpClientId": { "type": "string", "description": "The client identifier issued to the client during\nthe registration process.\n\nThe authorization server issues the registered client a client\nidentifier -- a unique string representing the registration\ninformation provided by the client. The client identifier is not\na secret; it is exposed to the resource owner and MUST NOT be\nused alone for client authentication.\n\nThe client identifier is unique to the authorization server.\n\nhttps://tools.ietf.org/html/rfc6749#section-2.3.1\n" }, "idpClientSecret": { "type": "string", "description": "This value is used by Confidential Clients to authenticate to the\nToken Endpoint, as described in Section 2.3.1 of OAuth 2.0, and\nfor the derivation of symmetric encryption key values, as\ndescribed in Section 10.2 of OpenID Connect Core 1.0\n[OpenID.Core].\n\nhttps://tools.ietf.org/html/rfc6749#section-2.3.1\nhttps://openid.net/specs/openid-connect-core-1_0.html#Encryption\n" }, "idpAdditionalScope": { "type": "string", "default": "openid profile email offline_access", "description": "The scopes associated with Access Tokens determine what resources\nwill be available when they are used to access OAuth 2.0\nprotected endpoints.\nFor OpenID Connect, scopes can be used to request that specific\nsets of information be made available as Claim Values.\nThe scopes openid, profile, email and offline_access are always\nrequested.\n" }, "idpFrontChannelUrl": { "type": "string", "format": "url" }, "idpIdTokenSignedResponseAlg": { "type": "string", "description": "The Algorithm used to sign the ID Token issued to this Client.\n", "enum": [ "RS256", "RS384", "RS512", "HS256", "HS384", "HS512" ], "default": "RS256", "example": "RS256" }, "idpTokenEndpointAuthMethod": { "type": "string", "description": "Requested Client Authentication method for the Token Endpoint.\n\nhttps://openid.net/specs/openid-connect-core-1_0.html#ClientAuthentication\n", "enum": [ "client_secret_basic", "client_secret_post", "client_secret_jwt", "private_key_jwt", "tls_client_auth", "self_signed_tls_client_auth", "none" ], "default": "client_secret_basic", "example": "client_secret_basic" } } }, "IIdentityProviderData": { "type": "object", "oneOf": [ { "type": "object", "properties": { "idpType": { "type": "string", "enum": [ "saml" ] }, "idpIssuer": { "type": "string", "description": "The value that will be in the issuer field in the SAML request.", "format": "url" }, "idpLoginEndpoint": { "type": "string", "description": "The URL to use to login in the IDP. Used in the SP initiated Flow.", "format": "url" }, "idpLogoutEndpoint": { "type": "string", "description": "The URL to send SLO requests against. Not all identity providers support this.", "format": "url" }, "idpCertificate": { "type": "string", "description": "The certificate from the ID used to sign the SAML requests. It is base64 encoded." }, "decryptionPrivateKey": { "type": "string", "description": "An optional decryption key. This is necessary if the SAML request is encoded." }, "idpDisableRequestedAuthnContext": { "type": "boolean", "description": "For some providers, e.g. Azure on-prem, it might be necessary to disable the authn context field in the SAML request.", "default": false } } }, { "type": "object", "properties": { "idpType": { "type": "string", "enum": [ "oidc" ] }, "idpIssuer": { "type": "string", "description": "The openId-Connect baseUrl", "format": "url" }, "idpClientId": { "type": "string", "description": "The client identifier issued to the client during\nthe registration process.\n\nThe authorization server issues the registered client a client\nidentifier -- a unique string representing the registration\ninformation provided by the client. The client identifier is not\na secret; it is exposed to the resource owner and MUST NOT be\nused alone for client authentication.\n\nThe client identifier is unique to the authorization server.\n\nhttps://tools.ietf.org/html/rfc6749#section-2.3.1\n" }, "idpClientSecret": { "type": "string", "description": "This value is used by Confidential Clients to authenticate to the\nToken Endpoint, as described in Section 2.3.1 of OAuth 2.0, and\nfor the derivation of symmetric encryption key values, as\ndescribed in Section 10.2 of OpenID Connect Core 1.0\n[OpenID.Core].\n\nhttps://tools.ietf.org/html/rfc6749#section-2.3.1\nhttps://openid.net/specs/openid-connect-core-1_0.html#Encryption\n" }, "idpAdditionalScope": { "type": "string", "default": "openid profile email offline_access", "description": "The scopes associated with Access Tokens determine what resources\nwill be available when they are used to access OAuth 2.0\nprotected endpoints.\nFor OpenID Connect, scopes can be used to request that specific\nsets of information be made available as Claim Values.\nThe scopes openid, profile, email and offline_access are always\nrequested.\n" }, "idpFrontChannelUrl": { "type": "string", "format": "url" }, "idpIdTokenSignedResponseAlg": { "type": "string", "description": "The Algorithm used to sign the ID Token issued to this Client.\n", "enum": [ "RS256", "RS384", "RS512", "HS256", "HS384", "HS512" ], "default": "RS256", "example": "RS256" }, "idpTokenEndpointAuthMethod": { "type": "string", "description": "Requested Client Authentication method for the Token Endpoint.\n\nhttps://openid.net/specs/openid-connect-core-1_0.html#ClientAuthentication\n", "enum": [ "client_secret_basic", "client_secret_post", "client_secret_jwt", "private_key_jwt", "tls_client_auth", "self_signed_tls_client_auth", "none" ], "default": "client_secret_basic", "example": "client_secret_basic" } } } ] }, "TOrganisationWidePermissions": { "type": "string", "enum": [ "analyticsOdata", "apiKeys", "liveAgentAccount", "projects", "userDetails", "users", "voiceGatewayAccount" ] }, "TProjectWidePermissions": { "type": "string", "enum": [ "agentAssistConfigs", "analytics", "connections", "contactProfiles", "conversationHistory", "endpoints", "extensions", "extensionsTrust", "flowNodeComments", "flowNodeDescription", "flowNodes", "flows", "followUser", "intents", "largeLanguageModels", "knowledgeStores", "lexicons", "liveAgentInbox", "locales", "logs", "memberDetails", "members", "milestones", "nluConnectors", "packages", "playbooks", "project", "projectSettings", "snapshots", "states", "tasks", "tokens", "functions", "yesNoIntents", "dataPrivacySettings" ] }, "TPermissionState": { "type": "number", "enum": [ -1, 0, 1 ], "description": "Sort order:\n * `-1` - explicitly denied\n * `0` - unset(inherit)\n * `1` - explicitly granted\n" }, "IProjectScope": { "type": "object", "properties": { "projectId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } }, "TOrganisationWideRole": { "type": "string", "enum": [ "admin", "apiKeys", "base_role", "basicSupportUser", "fullSupportUser", "liveAgentAdmin", "liveAgentAgent", "liveAgentSupervisor", "odata", "projectAssigner", "projectManager", "userManager", "userDetailsViewer", "voiceGatewayUser" ] }, "TProjectWideRole": { "type": "string", "enum": [ "agentAssistConfigAdmin", "agentAssistConfigViewer", "analytics", "basic", "connection_admin", "contact_profile_admin", "contact_profile_editor", "contact_profile_viewer", "conversationHistory", "developer", "endpoint_admin", "extension_admin", "extension_editor", "flowEditor", "flowNodeComments", "flowNodeDescriptions", "followUser", "intents", "data_privacy_admin", "data_privacy_editor", "data_privacy_viewer", "knowledgeAdmin", "large_language_model_admin,", "lexicon_admin", "lexicon_editor", "localesAdmin", "logs", "memberManager", "nlu_connector_admin", "packages_admin", "playbook_admin", "playbook_editor", "projectAdmin", "snapshot_admin", "tokenAdmin", "tokenEditor", "function_admin", "function_editor" ] }, "TTaskProgress": { "type": "integer", "minimum": 0, "maximum": 100 }, "TCognigyColorName": { "type": "string", "example": "cognigyGrey", "enum": [ "amber", "blueGrey", "cognigyBlue", "cognigyGrey", "deepOrange", "deepPurple", "lightBlue", "lightGreen" ] }, "TCSSColorHex": { "type": "string", "pattern": "^#(?:[0-9a-fA-F]{3}){1,2}$", "example": "#ff8a80" }, "TCSSColor": { "oneOf": [ { "type": "string", "pattern": "^#(?:[0-9a-fA-F]{3}){1,2}$", "example": "#ff8a80" }, { "type": "string", "example": "none", "enum": [ "aliceBlue", "antiqueWhite", "aqua", "aquamarine", "azure", "beige", "bisque", "black", "blanchedAlmond", "blue", "blueViolet", "brown", "burlyWood", "cadetBlue", "chartreuse", "chocolate", "coral", "cornflowerBlue", "cornsilk", "crimson", "cyan", "darkBlue", "darkCyan", "darkGoldenRod", "darkGray", "darkGrey", "darkGreen", "darkKhaki", "darkMagenta", "darkOliveGreen", "darkOrange", "darkOrchid", "darkRed", "darkSalmon", "darkSeaGreen", "darkSlateBlue", "darkSlateGray", "darkSlateGrey", "darkTurquoise", "darkViolet", "deepPink", "deepSkyBlue", "dimGray", "dimGrey", "dodgerBlue", "fireBrick", "floralWhite", "forestGreen", "fuchsia", "gainsboro", "ghostWhite", "gold", "goldenRod", "gray", "grey", "green", "greenYellow", "honeyDew", "hotPink", "indianRed", "indigo", "ivory", "khaki", "lavender", "lavenderBlush", "lawnGreen", "lemonChiffon", "lightBlue", "lightCoral", "lightCyan", "lightGoldenRodYellow", "lightGray", "lightGrey", "lightGreen", "lightPink", "lightSalmon", "lightSeaGreen", "lightSkyBlue", "lightSlateGray", "lightSlateGrey", "lightSteelBlue", "lightYellow", "lime", "limeGreen", "linen", "magenta", "maroon", "mediumAquaMarine", "mediumBlue", "mediumOrchid", "mediumPurple", "mediumSeaGreen", "mediumSlateBlue", "mediumSpringGreen", "mediumTurquoise", "mediumVioletRed", "midnightBlue", "mintCream", "mistyRose", "moccasin", "navajoWhite", "navy", "oldLace", "olive", "oliveDrab", "orange", "orangeRed", "orchid", "paleGoldenRod", "paleGreen", "paleTurquoise", "paleVioletRed", "papayaWhip", "peachPuff", "peru", "pink", "plum", "powderBlue", "purple", "rebeccaPurple", "red", "rosyBrown", "royalBlue", "saddleBrown", "salmon", "sandyBrown", "seaGreen", "seaShell", "sienna", "silver", "skyBlue", "slateBlue", "slateGray", "slateGrey", "snow", "springGreen", "steelBlue", "tan", "teal", "thistle", "tomato", "turquoise", "violet", "wheat", "white", "whiteSmoke", "yellow", "yellowGreen", "none", "transparent" ] } ] }, "TCSSColorName": { "type": "string", "example": "none", "enum": [ "aliceBlue", "antiqueWhite", "aqua", "aquamarine", "azure", "beige", "bisque", "black", "blanchedAlmond", "blue", "blueViolet", "brown", "burlyWood", "cadetBlue", "chartreuse", "chocolate", "coral", "cornflowerBlue", "cornsilk", "crimson", "cyan", "darkBlue", "darkCyan", "darkGoldenRod", "darkGray", "darkGrey", "darkGreen", "darkKhaki", "darkMagenta", "darkOliveGreen", "darkOrange", "darkOrchid", "darkRed", "darkSalmon", "darkSeaGreen", "darkSlateBlue", "darkSlateGray", "darkSlateGrey", "darkTurquoise", "darkViolet", "deepPink", "deepSkyBlue", "dimGray", "dimGrey", "dodgerBlue", "fireBrick", "floralWhite", "forestGreen", "fuchsia", "gainsboro", "ghostWhite", "gold", "goldenRod", "gray", "grey", "green", "greenYellow", "honeyDew", "hotPink", "indianRed", "indigo", "ivory", "khaki", "lavender", "lavenderBlush", "lawnGreen", "lemonChiffon", "lightBlue", "lightCoral", "lightCyan", "lightGoldenRodYellow", "lightGray", "lightGrey", "lightGreen", "lightPink", "lightSalmon", "lightSeaGreen", "lightSkyBlue", "lightSlateGray", "lightSlateGrey", "lightSteelBlue", "lightYellow", "lime", "limeGreen", "linen", "magenta", "maroon", "mediumAquaMarine", "mediumBlue", "mediumOrchid", "mediumPurple", "mediumSeaGreen", "mediumSlateBlue", "mediumSpringGreen", "mediumTurquoise", "mediumVioletRed", "midnightBlue", "mintCream", "mistyRose", "moccasin", "navajoWhite", "navy", "oldLace", "olive", "oliveDrab", "orange", "orangeRed", "orchid", "paleGoldenRod", "paleGreen", "paleTurquoise", "paleVioletRed", "papayaWhip", "peachPuff", "peru", "pink", "plum", "powderBlue", "purple", "rebeccaPurple", "red", "rosyBrown", "royalBlue", "saddleBrown", "salmon", "sandyBrown", "seaGreen", "seaShell", "sienna", "silver", "skyBlue", "slateBlue", "slateGray", "slateGrey", "snow", "springGreen", "steelBlue", "tan", "teal", "thistle", "tomato", "turquoise", "violet", "wheat", "white", "whiteSmoke", "yellow", "yellowGreen", "none", "transparent" ] }, "TMongoId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "TExampleMongotId": { "type": "string", "example": "63c6c16a7e1ef09c81f6075d" }, "TTimestamp": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "TTimezone": { "type": "string", "description": "Timezone according to IANA Timezone Database (2020a)", "example": "Europe/Berlin", "enum": [ "Africa/Abidjan", "Africa/Accra", "Africa/Addis_Ababa", "Africa/Algiers", "Africa/Asmara", "Africa/Asmera", "Africa/Bamako", "Africa/Bangui", "Africa/Banjul", "Africa/Bissau", "Africa/Blantyre", "Africa/Brazzaville", "Africa/Bujumbura", "Africa/Cairo", "Africa/Casablanca", "Africa/Ceuta", "Africa/Conakry", "Africa/Dakar", "Africa/Dar_es_Salaam", "Africa/Djibouti", "Africa/Douala", "Africa/El_Aaiun", "Africa/Freetown", "Africa/Gaborone", "Africa/Harare", "Africa/Johannesburg", "Africa/Juba", "Africa/Kampala", "Africa/Khartoum", "Africa/Kigali", "Africa/Kinshasa", "Africa/Lagos", "Africa/Libreville", "Africa/Lome", "Africa/Luanda", "Africa/Lubumbashi", "Africa/Lusaka", "Africa/Malabo", "Africa/Maputo", "Africa/Maseru", "Africa/Mbabane", "Africa/Mogadishu", "Africa/Monrovia", "Africa/Nairobi", "Africa/Ndjamena", "Africa/Niamey", "Africa/Nouakchott", "Africa/Ouagadougou", "Africa/Porto-Novo", "Africa/Sao_Tome", "Africa/Timbuktu", "Africa/Tripoli", "Africa/Tunis", "Africa/Windhoek", "America/Adak", "America/Anchorage", "America/Anguilla", "America/Antigua", "America/Araguaina", "America/Argentina/Buenos_Aires", "America/Argentina/Catamarca", "America/Argentina/ComodRivadavia", "America/Argentina/Cordoba", "America/Argentina/Jujuy", "America/Argentina/La_Rioja", "America/Argentina/Mendoza", "America/Argentina/Rio_Gallegos", "America/Argentina/Salta", "America/Argentina/San_Juan", "America/Argentina/San_Luis", "America/Argentina/Tucuman", "America/Argentina/Ushuaia", "America/Aruba", "America/Asuncion", "America/Atikokan", "America/Atka", "America/Bahia", "America/Bahia_Banderas", "America/Barbados", "America/Belem", "America/Belize", "America/Blanc-Sablon", "America/Boa_Vista", "America/Bogota", "America/Boise", "America/Buenos_Aires", "America/Cambridge_Bay", "America/Campo_Grande", "America/Cancun", "America/Caracas", "America/Catamarca", "America/Cayenne", "America/Cayman", "America/Chicago", "America/Chihuahua", "America/Coral_Harbour", "America/Cordoba", "America/Costa_Rica", "America/Creston", "America/Cuiaba", "America/Curacao", "America/Danmarkshavn", "America/Dawson", "America/Dawson_Creek", "America/Denver", "America/Detroit", "America/Dominica", "America/Edmonton", "America/Eirunepe", "America/El_Salvador", "America/Ensenada", "America/Fort_Nelson", "America/Fort_Wayne", "America/Fortaleza", "America/Glace_Bay", "America/Godthab", "America/Goose_Bay", "America/Grand_Turk", "America/Grenada", "America/Guadeloupe", "America/Guatemala", "America/Guayaquil", "America/Guyana", "America/Halifax", "America/Havana", "America/Hermosillo", "America/Indiana/Indianapolis", "America/Indiana/Knox", "America/Indiana/Marengo", "America/Indiana/Petersburg", "America/Indiana/Tell_City", "America/Indiana/Vevay", "America/Indiana/Vincennes", "America/Indiana/Winamac", "America/Indianapolis", "America/Inuvik", "America/Iqaluit", "America/Jamaica", "America/Jujuy", "America/Juneau", "America/Kentucky/Louisville", "America/Kentucky/Monticello", "America/Knox_IN", "America/Kralendijk", "America/La_Paz", "America/Lima", "America/Los_Angeles", "America/Louisville", "America/Lower_Princes", "America/Maceio", "America/Managua", "America/Manaus", "America/Marigot", "America/Martinique", "America/Matamoros", "America/Mazatlan", "America/Mendoza", "America/Menominee", "America/Merida", "America/Metlakatla", "America/Mexico_City", "America/Miquelon", "America/Moncton", "America/Monterrey", "America/Montevideo", "America/Montreal", "America/Montserrat", "America/Nassau", "America/New_York", "America/Nipigon", "America/Nome", "America/Noronha", "America/North_Dakota/Beulah", "America/North_Dakota/Center", "America/North_Dakota/New_Salem", "America/Ojinaga", "America/Panama", "America/Pangnirtung", "America/Paramaribo", "America/Phoenix", "America/Port-au-Prince", "America/Port_of_Spain", "America/Porto_Acre", "America/Porto_Velho", "America/Puerto_Rico", "America/Punta_Arenas", "America/Rainy_River", "America/Rankin_Inlet", "America/Recife", "America/Regina", "America/Resolute", "America/Rio_Branco", "America/Rosario", "America/Santa_Isabel", "America/Santarem", "America/Santiago", "America/Santo_Domingo", "America/Sao_Paulo", "America/Scoresbysund", "America/Shiprock", "America/Sitka", "America/St_Barthelemy", "America/St_Johns", "America/St_Kitts", "America/St_Lucia", "America/St_Thomas", "America/St_Vincent", "America/Swift_Current", "America/Tegucigalpa", "America/Thule", "America/Thunder_Bay", "America/Tijuana", "America/Toronto", "America/Tortola", "America/Vancouver", "America/Virgin", "America/Whitehorse", "America/Winnipeg", "America/Yakutat", "America/Yellowknife", "Antarctica/Casey", "Antarctica/Davis", "Antarctica/DumontDUrville", "Antarctica/Macquarie", "Antarctica/Mawson", "Antarctica/McMurdo", "Antarctica/Palmer", "Antarctica/Rothera", "Antarctica/South_Pole", "Antarctica/Syowa", "Antarctica/Troll", "Antarctica/Vostok", "Arctic/Longyearbyen", "Asia/Aden", "Asia/Almaty", "Asia/Amman", "Asia/Anadyr", "Asia/Aqtau", "Asia/Aqtobe", "Asia/Ashgabat", "Asia/Ashkhabad", "Asia/Atyrau", "Asia/Baghdad", "Asia/Bahrain", "Asia/Baku", "Asia/Bangkok", "Asia/Barnaul", "Asia/Beirut", "Asia/Bishkek", "Asia/Brunei", "Asia/Calcutta", "Asia/Chita", "Asia/Choibalsan", "Asia/Chongqing", "Asia/Chungking", "Asia/Colombo", "Asia/Dacca", "Asia/Damascus", "Asia/Dhaka", "Asia/Dili", "Asia/Dubai", "Asia/Dushanbe", "Asia/Famagusta", "Asia/Gaza", "Asia/Harbin", "Asia/Hebron", "Asia/Ho_Chi_Minh", "Asia/Hong_Kong", "Asia/Hovd", "Asia/Irkutsk", "Asia/Istanbul", "Asia/Jakarta", "Asia/Jayapura", "Asia/Jerusalem", "Asia/Kabul", "Asia/Kamchatka", "Asia/Karachi", "Asia/Kashgar", "Asia/Kathmandu", "Asia/Katmandu", "Asia/Khandyga", "Asia/Kolkata", "Asia/Krasnoyarsk", "Asia/Kuala_Lumpur", "Asia/Kuching", "Asia/Kuwait", "Asia/Macao", "Asia/Macau", "Asia/Magadan", "Asia/Makassar", "Asia/Manila", "Asia/Muscat", "Asia/Nicosia", "Asia/Novokuznetsk", "Asia/Novosibirsk", "Asia/Omsk", "Asia/Oral", "Asia/Phnom_Penh", "Asia/Pontianak", "Asia/Pyongyang", "Asia/Qatar", "Asia/Qyzylorda", "Asia/Rangoon", "Asia/Riyadh", "Asia/Saigon", "Asia/Sakhalin", "Asia/Samarkand", "Asia/Seoul", "Asia/Shanghai", "Asia/Singapore", "Asia/Srednekolymsk", "Asia/Taipei", "Asia/Tashkent", "Asia/Tbilisi", "Asia/Tehran", "Asia/Tel_Aviv", "Asia/Thimbu", "Asia/Thimphu", "Asia/Tokyo", "Asia/Tomsk", "Asia/Ujung_Pandang", "Asia/Ulaanbaatar", "Asia/Ulan_Bator", "Asia/Urumqi", "Asia/Ust-Nera", "Asia/Vientiane", "Asia/Vladivostok", "Asia/Yakutsk", "Asia/Yangon", "Asia/Yekaterinburg", "Asia/Yerevan", "Atlantic/Azores", "Atlantic/Bermuda", "Atlantic/Canary", "Atlantic/Cape_Verde", "Atlantic/Faeroe", "Atlantic/Faroe", "Atlantic/Jan_Mayen", "Atlantic/Madeira", "Atlantic/Reykjavik", "Atlantic/South_Georgia", "Atlantic/St_Helena", "Atlantic/Stanley", "Australia/ACT", "Australia/Adelaide", "Australia/Brisbane", "Australia/Broken_Hill", "Australia/Canberra", "Australia/Currie", "Australia/Darwin", "Australia/Eucla", "Australia/Hobart", "Australia/LHI", "Australia/Lindeman", "Australia/Lord_Howe", "Australia/Melbourne", "Australia/NSW", "Australia/North", "Australia/Perth", "Australia/Queensland", "Australia/South", "Australia/Sydney", "Australia/Tasmania", "Australia/Victoria", "Australia/West", "Australia/Yancowinna", "Brazil/Acre", "Brazil/DeNoronha", "Brazil/East", "Brazil/West", "CET", "CST6CDT", "Canada/Atlantic", "Canada/Central", "Canada/Eastern", "Canada/Mountain", "Canada/Newfoundland", "Canada/Pacific", "Canada/Saskatchewan", "Canada/Yukon", "Chile/Continental", "Chile/EasterIsland", "Cuba", "EET", "EST", "EST5EDT", "Egypt", "Eire", "Etc/GMT", "Etc/GMT+0", "Etc/GMT+1", "Etc/GMT+10", "Etc/GMT+11", "Etc/GMT+12", "Etc/GMT+2", "Etc/GMT+3", "Etc/GMT+4", "Etc/GMT+5", "Etc/GMT+6", "Etc/GMT+7", "Etc/GMT+8", "Etc/GMT+9", "Etc/GMT-0", "Etc/GMT-1", "Etc/GMT-10", "Etc/GMT-11", "Etc/GMT-12", "Etc/GMT-13", "Etc/GMT-14", "Etc/GMT-2", "Etc/GMT-3", "Etc/GMT-4", "Etc/GMT-5", "Etc/GMT-6", "Etc/GMT-7", "Etc/GMT-8", "Etc/GMT-9", "Etc/GMT0", "Etc/Greenwich", "Etc/UCT", "Etc/UTC", "Etc/Universal", "Etc/Zulu", "Europe/Amsterdam", "Europe/Andorra", "Europe/Astrakhan", "Europe/Athens", "Europe/Belfast", "Europe/Belgrade", "Europe/Berlin", "Europe/Bratislava", "Europe/Brussels", "Europe/Bucharest", "Europe/Budapest", "Europe/Busingen", "Europe/Chisinau", "Europe/Copenhagen", "Europe/Dublin", "Europe/Gibraltar", "Europe/Guernsey", "Europe/Helsinki", "Europe/Isle_of_Man", "Europe/Istanbul", "Europe/Jersey", "Europe/Kaliningrad", "Europe/Kiev", "Europe/Kirov", "Europe/Lisbon", "Europe/Ljubljana", "Europe/London", "Europe/Luxembourg", "Europe/Madrid", "Europe/Malta", "Europe/Mariehamn", "Europe/Minsk", "Europe/Monaco", "Europe/Moscow", "Europe/Nicosia", "Europe/Oslo", "Europe/Paris", "Europe/Podgorica", "Europe/Prague", "Europe/Riga", "Europe/Rome", "Europe/Samara", "Europe/San_Marino", "Europe/Sarajevo", "Europe/Saratov", "Europe/Simferopol", "Europe/Skopje", "Europe/Sofia", "Europe/Stockholm", "Europe/Tallinn", "Europe/Tirane", "Europe/Tiraspol", "Europe/Ulyanovsk", "Europe/Uzhgorod", "Europe/Vaduz", "Europe/Vatican", "Europe/Vienna", "Europe/Vilnius", "Europe/Volgograd", "Europe/Warsaw", "Europe/Zagreb", "Europe/Zaporozhye", "Europe/Zurich", "GB", "GB-Eire", "GMT", "GMT+0", "GMT-0", "GMT0", "Greenwich", "HST", "Hongkong", "Iceland", "Indian/Antananarivo", "Indian/Chagos", "Indian/Christmas", "Indian/Cocos", "Indian/Comoro", "Indian/Kerguelen", "Indian/Mahe", "Indian/Maldives", "Indian/Mauritius", "Indian/Mayotte", "Indian/Reunion", "Iran", "Israel", "Jamaica", "Japan", "Kwajalein", "Libya", "MET", "MST", "MST7MDT", "Mexico/BajaNorte", "Mexico/BajaSur", "Mexico/General", "NZ", "NZ-CHAT", "Navajo", "PRC", "PST8PDT", "Pacific/Apia", "Pacific/Auckland", "Pacific/Bougainville", "Pacific/Chatham", "Pacific/Chuuk", "Pacific/Easter", "Pacific/Efate", "Pacific/Enderbury", "Pacific/Fakaofo", "Pacific/Fiji", "Pacific/Funafuti", "Pacific/Galapagos", "Pacific/Gambier", "Pacific/Guadalcanal", "Pacific/Guam", "Pacific/Honolulu", "Pacific/Johnston", "Pacific/Kiritimati", "Pacific/Kosrae", "Pacific/Kwajalein", "Pacific/Majuro", "Pacific/Marquesas", "Pacific/Midway", "Pacific/Nauru", "Pacific/Niue", "Pacific/Norfolk", "Pacific/Noumea", "Pacific/Pago_Pago", "Pacific/Palau", "Pacific/Pitcairn", "Pacific/Pohnpei", "Pacific/Ponape", "Pacific/Port_Moresby", "Pacific/Rarotonga", "Pacific/Saipan", "Pacific/Samoa", "Pacific/Tahiti", "Pacific/Tarawa", "Pacific/Tongatapu", "Pacific/Truk", "Pacific/Wake", "Pacific/Wallis", "Pacific/Yap", "Poland", "Portugal", "ROC", "ROK", "Singapore", "Turkey", "UCT", "US/Alaska", "US/Aleutian", "US/Arizona", "US/Central", "US/East-Indiana", "US/Eastern", "US/Hawaii", "US/Indiana-Starke", "US/Michigan", "US/Mountain", "US/Pacific", "US/Pacific-New", "US/Samoa", "UTC", "Universal", "W-SU", "WET", "Zulu" ] }, "ICursorBasedPaginationReturnValue": { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object" } }, "total": { "type": "integer", "example": 1 }, "next": { "oneOf": [ { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, { "nullable": true } ], "example": "5ce7c2d833ea1e04d7e6c432" }, "previous": { "oneOf": [ { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, { "nullable": true } ], "example": null } } } }, "responses": { "BadGatewayError": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "BadRequestError": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "ConflictError": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "ForbiddenError": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "GatewayTimeoutError": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "InternalServerError": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "MethodNotAllowedError": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "NotImplementedError": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "PayloadTooLargeError": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "PaymentRequiredError": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "NotFoundError": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "ServiceUnavailableError": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "TooManyRequestsError": { "description": "The server got too many requests than it is required to handle.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "TooManyRequestsError" }, "title": { "type": "string", "example": "Too Many Requests Error" }, "status": { "type": "number", "example": 429 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "UnauthorizedError": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } } }, "security": [ { "APIKeyHeader": [] }, { "APIKeyQueryParam": [] }, { "OAuth2": [] }, { "BasicAuth": [] } ], "externalDocs": { "description": "Cognigy.AI Documentation", "url": "https://docs.cognigy.com/docs/" }, "tags": [ { "name": "Cognigy.AI REST-ful API", "description": "The Cognigy.AI REST-ful API" } ], "openapi": "3.0.0", "paths": { "/.well-known/webfinger": { "get": { "operationId": "webfinger", "description": "Webfinger-Endpoint", "tags": [ "Webfinger" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "query", "name": "resource", "required": true, "schema": { "type": "string", "format": "uri" } }, { "in": "query", "name": "rel", "schema": { "type": "array", "items": { "type": "array", "items": { "type": "string", "enum": [ "idp" ] } } } } ], "responses": { "200": { "description": "Returns the Webfinger result.", "content": { "application/json": { "schema": { "type": "object", "properties": { "subject": { "type": "string", "example": "org:5ce7c2d833ea1e04d7e6c432" }, "links": { "type": "array", "items": { "type": "object", "properties": { "rel": { "type": "string", "enum": [ "idp" ] }, "properties": { "type": "object", "oneOf": [ { "type": "object", "properties": { "idp:type": { "type": "string", "enum": [ "none" ] } } }, { "type": "object", "properties": { "idp:type": { "type": "string", "enum": [ "oidc" ] }, "idp:callback": { "type": "string", "format": "url" }, "idp:login": { "type": "string", "format": "url" }, "idp:logout": { "type": "string", "format": "url" }, "idp:logout:fc": { "type": "string", "format": "url" } } }, { "type": "object", "properties": { "idp:type": { "type": "string", "enum": [ "oidc" ] }, "idp:login": { "type": "string", "format": "url" }, "idp:logout": { "type": "string", "format": "url" } } } ] } } } } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/auditevents": { "get": { "operationId": "indexAuditEvents_2_0", "summary": "Get audit events", "description": "Get 25 [Audit Event](https://docs.cognigy.com/ai/tools/user-menu/audit-events/) by default. To change the default value, use the `limit` query parameter. Additionally, you can filter, sort, and paginate the results.", "tags": [ "AuditEvents v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "query", "name": "filter", "required": false, "schema": { "type": "string" }, "description": "The user or type to filter the records" }, { "in": "query", "name": "user", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "type", "required": false, "schema": { "type": "string", "enum": [ "action", "create", "replace", "patch", "delete", "unauthorized" ] } }, { "in": "query", "name": "limit", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100 }, "description": "The maximum number of items to return. The default is 25." }, { "in": "query", "name": "skip", "required": false, "schema": { "type": "integer", "minimum": 0 }, "description": "The number of items to skip. The default is 0. Used along with a limit of a pagination." }, { "in": "query", "name": "sort", "required": false, "schema": { "type": "string", "minLength": 1 }, "description": "The order of the sorting items-`Desc` (descending) or `Asc` (ascending). For example, to sort the records by name in ascending order, specify `name:Asc`." }, { "in": "query", "name": "next", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the nextCursor value from the response to get the next set of records. Used along with limit for pagination." }, { "in": "query", "name": "previous", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the previousCursor value from the response to get the previous set of records. Used along with limit for pagination." } ], "responses": { "200": { "description": "Returns array of audit event metadata objects", "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "timestamp": { "type": "string", "format": "date-time", "description": "The timestamp when the action happened", "example": "2020-04-27T14:22:11.000Z" }, "type": { "type": "string", "description": "The type of operation that was performed", "example": "create", "enum": [ "action", "create", "replace", "patch", "delete", "unauthorized" ] }, "user": { "type": "string", "description": "The email of the user who performed the operation", "example": "hans.mustermann@xyz.com" }, "modifiedResources": { "type": "array", "description": "A list of resources in the chain of the modification", "items": { "type": "object", "properties": { "elementId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "elementType": { "type": "string", "description": "Additional resource types for audit purposes", "example": "node", "enum": [ "agentassistconfig", "agentSettings", "chart", "connection", "connectionSchema", "endpoint", "extension", "file", "flow", "flowSettings", "flowState", "function", "intent", "intentDefaultReply", "intentLearningSentence", "intentRelation", "intentSentence", "intentTrainGroup", "knowledgeStore", "largeLanguageModel", "lexicon", "lexiconEntry", "lexiconKeyphrase", "lexiconSlot", "locale", "milestone", "nluconnector", "nodeData", "nodeDescriptorSet", "package", "playbook", "slotFiller", "snapshot", "snippet", "aicopilotconfig", "apiKey", "analytics", "connectionField", "conversation", "examplesentence", "functionInstance", "keyphrase", "learningsentence", "node", "playbookStep", "playbookStepAssert", "profile", "profileSchema", "project", "projectsettings", "synonym", "tag", "task", "trainerRecord", "user", "yesNoIntent" ] } } } } } } }, "total": { "type": "integer", "example": 1 }, "next": { "oneOf": [ { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, { "nullable": true } ], "example": "5ce7c2d833ea1e04d7e6c432" }, "previous": { "oneOf": [ { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, { "nullable": true } ], "example": null } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/auditevents/{auditEventId}": { "get": { "operationId": "readAuditEvent_2_0", "summary": "Get an audit event", "description": "Get a single [Audit events](https://docs.cognigy.com/ai/tools/user-menu/audit-events/) in the system.", "tags": [ "AuditEvents v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "auditEventId", "schema": { "type": "string" }, "required": true, "description": "Audit event ID" } ], "responses": { "200": { "description": "Returns audit event object", "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "timestamp": { "type": "string", "description": "The timestamp when the action happened", "example": "2020-04-27T14:22:11.000Z" }, "type": { "type": "string", "description": "The type of operation that was performed", "example": "create", "enum": [ "action", "create", "replace", "patch", "delete", "unauthorized" ] }, "user": { "type": "string", "description": "The email of the user who performed the operation", "example": "hans.mustermann@xyz.com" }, "modifiedResources": { "type": "array", "description": "An list of resources in the chain of the modification", "items": { "type": "object", "properties": { "resourceId": { "type": "string", "description": "The id of the resource in the modification chain", "example": "5e997f0cdcfc57730cf32941" }, "resourceType": { "type": "string", "description": "Additional resource types for audit purposes", "example": "node", "enum": [ "agentassistconfig", "agentSettings", "chart", "connection", "connectionSchema", "endpoint", "extension", "file", "flow", "flowSettings", "flowState", "function", "intent", "intentDefaultReply", "intentLearningSentence", "intentRelation", "intentSentence", "intentTrainGroup", "knowledgeStore", "largeLanguageModel", "lexicon", "lexiconEntry", "lexiconKeyphrase", "lexiconSlot", "locale", "milestone", "nluconnector", "nodeData", "nodeDescriptorSet", "package", "playbook", "slotFiller", "snapshot", "snippet", "aicopilotconfig", "apiKey", "analytics", "connectionField", "conversation", "examplesentence", "functionInstance", "keyphrase", "learningsentence", "node", "playbookStep", "playbookStepAssert", "profile", "profileSchema", "project", "projectsettings", "synonym", "tag", "task", "trainerRecord", "user", "yesNoIntent" ] } } } }, "payload": { "type": "object", "description": "The raw payload of the operation in case it was tracked", "example": { "name": "new resource name" } } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/identityprovider/configure": { "post": { "operationId": "configureIdentityProvider_2_0", "summary": "Configure an identity provider for your organisation.", "description": "Configure an identity provider for your organisation.", "tags": [ "IdentityProviders v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "oneOf": [ { "type": "object", "properties": { "idpType": { "type": "string", "enum": [ "saml" ] }, "idpIssuer": { "type": "string", "description": "The value that will be in the issuer field in the SAML request.", "format": "url" }, "idpLoginEndpoint": { "type": "string", "description": "The URL to use to login in the IDP. Used in the SP initiated Flow.", "format": "url" }, "idpLogoutEndpoint": { "type": "string", "description": "The URL to send SLO requests against. Not all identity providers support this.", "format": "url" }, "idpCertificate": { "type": "string", "description": "The certificate from the ID used to sign the SAML requests. It is base64 encoded." }, "decryptionPrivateKey": { "type": "string", "description": "An optional decryption key. This is necessary if the SAML request is encoded." }, "idpDisableRequestedAuthnContext": { "type": "boolean", "description": "For some providers, e.g. Azure on-prem, it might be necessary to disable the authn context field in the SAML request.", "default": false } } }, { "type": "object", "properties": { "idpType": { "type": "string", "enum": [ "oidc" ] }, "idpIssuer": { "type": "string", "description": "The openId-Connect baseUrl", "format": "url" }, "idpClientId": { "type": "string", "description": "The client identifier issued to the client during\nthe registration process.\n\nThe authorization server issues the registered client a client\nidentifier -- a unique string representing the registration\ninformation provided by the client. The client identifier is not\na secret; it is exposed to the resource owner and MUST NOT be\nused alone for client authentication.\n\nThe client identifier is unique to the authorization server.\n\nhttps://tools.ietf.org/html/rfc6749#section-2.3.1\n" }, "idpClientSecret": { "type": "string", "description": "This value is used by Confidential Clients to authenticate to the\nToken Endpoint, as described in Section 2.3.1 of OAuth 2.0, and\nfor the derivation of symmetric encryption key values, as\ndescribed in Section 10.2 of OpenID Connect Core 1.0\n[OpenID.Core].\n\nhttps://tools.ietf.org/html/rfc6749#section-2.3.1\nhttps://openid.net/specs/openid-connect-core-1_0.html#Encryption\n" }, "idpAdditionalScope": { "type": "string", "default": "openid profile email offline_access", "description": "The scopes associated with Access Tokens determine what resources\nwill be available when they are used to access OAuth 2.0\nprotected endpoints.\nFor OpenID Connect, scopes can be used to request that specific\nsets of information be made available as Claim Values.\nThe scopes openid, profile, email and offline_access are always\nrequested.\n" }, "idpFrontChannelUrl": { "type": "string", "format": "url" }, "idpIdTokenSignedResponseAlg": { "type": "string", "description": "The Algorithm used to sign the ID Token issued to this Client.\n", "enum": [ "RS256", "RS384", "RS512", "HS256", "HS384", "HS512" ], "default": "RS256", "example": "RS256" }, "idpTokenEndpointAuthMethod": { "type": "string", "description": "Requested Client Authentication method for the Token Endpoint.\n\nhttps://openid.net/specs/openid-connect-core-1_0.html#ClientAuthentication\n", "enum": [ "client_secret_basic", "client_secret_post", "client_secret_jwt", "private_key_jwt", "tls_client_auth", "self_signed_tls_client_auth", "none" ], "default": "client_secret_basic", "example": "client_secret_basic" } } } ] } } } }, "responses": { "204": { "description": "The identity provider was configured for your organisation." }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/identityprovider/reset": { "post": { "operationId": "resetIdentityProvider_2_0", "summary": "Resets the identity configruation.", "description": "Resets the identity configuration for the current organisation by removing it.", "tags": [ "IdentityProviders v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" } ], "responses": { "204": { "description": "The identity provider configuration was successfully reset." }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/organisations/liveagentaccount": { "get": { "operationId": "readLiveAgentAccount_2_0", "summary": "Gets the Live Agent Account for the organisation.", "description": "Gets the Live Agent Account for the organisation.", "tags": [ "LiveAgent v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" } ], "responses": { "200": { "description": "Returns the Live Agent Account for the organisation." }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/projects/{projectId}/inbox": { "get": { "operationId": "readProjectInbox_2_0", "summary": "Gets the default Live Agent Inbox of the project.", "description": "Gets the default Live Agent Inbox of the project.", "tags": [ "LiveAgent v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "projectId", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "200": { "description": "Returns the default Live Agent Inbox Id of the project or an error message." }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/organisations/setupliveagent": { "post": { "operationId": "setupCognigyLiveAgent_2_0", "summary": "Sets up a Cognigy Live Agent.", "description": "Sets up a Cognigy Live Agent for an organisation.", "tags": [ "LiveAgent v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" } ], "responses": { "200": { "description": "Cognigy Live Agent was successfully setup for the organisation and returns the LiveAgent account Id or an error message." }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/projects/{projectId}/setupinbox": { "post": { "operationId": "setupCognigyLiveAgentInbox_2_0", "summary": "Sets up a Cognigy Live Agent Inbox.", "description": "Sets up a Cognigy Live Agent Inbox for a project.", "tags": [ "LiveAgent v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "projectId", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "200": { "description": "Cognigy Live agent Inbox was successfully setup for the project and returns the inbox id or an error message." }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "patch": { "operationId": "updateCognigyLiveAgentInbox_2_0", "summary": "Updates a Cognigy Live Agent Inbox.", "description": "Updates a Cognigy Live Agent Inbox for a project.", "tags": [ "LiveAgent v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "projectId", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "inboxId": { "type": "number" } } } } } }, "responses": { "200": { "description": "Cognigy Live agent Inbox was successfully updated for the project and returns the inbox id or an error message." }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/organisations/chunkcount": { "get": { "operationId": "readOrganisationKnowledgeChunksCount_2_0", "summary": "Returns knowledge chunk count for the organisation.", "description": "Returns the number of knowledge chunks in the organisation.", "tags": [ "Administration v2.0" ], "responses": { "200": { "description": "Returns the number of knowledge chunks in the organisation", "content": { "application/json": { "schema": { "type": "object", "properties": { "chunkCount": { "type": "number" } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/organisations/policy": { "get": { "operationId": "readOrganisationPolicies_2_0", "summary": "Returns the policies defined for the user's organisation.", "description": "Returns the policies defined for the user's organisation.", "tags": [ "Administration v2.0" ], "responses": { "200": { "description": "Returns the policies defined for the user's organisation.", "content": { "application/json": { "schema": { "type": "object", "properties": { "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "name": { "type": "string", "description": "The name of this organisation" }, "disabled": { "type": "boolean", "description": "Flag whether this organisation is currently disabled" }, "quotaMaxProjects": { "type": "number" }, "quotaMaxUsers": { "type": "number" }, "quotaMaxChannelsPerProject": { "type": "number" }, "quotaMaxMessagesPerDay": { "type": "number" }, "quotaMaxKnowledgeChunks": { "type": "number" }, "passwordPolicy": { "type": "object", "properties": { "minLength": { "type": "integer" }, "maxLength": { "type": "integer" }, "minAmountLowerCase": { "type": "integer" }, "minAmountUpperCase": { "type": "integer" }, "minAmountSpecialCharacters": { "type": "integer" }, "minAmountNumbers": { "type": "integer" }, "maxAmountIdenticalCharacters": { "type": "integer" }, "minAmountFailedAttemptsAutoDisable": { "type": "integer" } } }, "sessionStateTTLInMinutes": { "type": "number" }, "contactProfileTTLInMinutes": { "type": "number" }, "conversationTTLInMinutes": { "type": "number" }, "liveAgentAccount": { "type": "number" }, "billingTimezone": { "type": "string", "description": "Timezone according to IANA Timezone Database (2020a)", "example": "Europe/Berlin", "enum": [ "Africa/Abidjan", "Africa/Accra", "Africa/Addis_Ababa", "Africa/Algiers", "Africa/Asmara", "Africa/Asmera", "Africa/Bamako", "Africa/Bangui", "Africa/Banjul", "Africa/Bissau", "Africa/Blantyre", "Africa/Brazzaville", "Africa/Bujumbura", "Africa/Cairo", "Africa/Casablanca", "Africa/Ceuta", "Africa/Conakry", "Africa/Dakar", "Africa/Dar_es_Salaam", "Africa/Djibouti", "Africa/Douala", "Africa/El_Aaiun", "Africa/Freetown", "Africa/Gaborone", "Africa/Harare", "Africa/Johannesburg", "Africa/Juba", "Africa/Kampala", "Africa/Khartoum", "Africa/Kigali", "Africa/Kinshasa", "Africa/Lagos", "Africa/Libreville", "Africa/Lome", "Africa/Luanda", "Africa/Lubumbashi", "Africa/Lusaka", "Africa/Malabo", "Africa/Maputo", "Africa/Maseru", "Africa/Mbabane", "Africa/Mogadishu", "Africa/Monrovia", "Africa/Nairobi", "Africa/Ndjamena", "Africa/Niamey", "Africa/Nouakchott", "Africa/Ouagadougou", "Africa/Porto-Novo", "Africa/Sao_Tome", "Africa/Timbuktu", "Africa/Tripoli", "Africa/Tunis", "Africa/Windhoek", "America/Adak", "America/Anchorage", "America/Anguilla", "America/Antigua", "America/Araguaina", "America/Argentina/Buenos_Aires", "America/Argentina/Catamarca", "America/Argentina/ComodRivadavia", "America/Argentina/Cordoba", "America/Argentina/Jujuy", "America/Argentina/La_Rioja", "America/Argentina/Mendoza", "America/Argentina/Rio_Gallegos", "America/Argentina/Salta", "America/Argentina/San_Juan", "America/Argentina/San_Luis", "America/Argentina/Tucuman", "America/Argentina/Ushuaia", "America/Aruba", "America/Asuncion", "America/Atikokan", "America/Atka", "America/Bahia", "America/Bahia_Banderas", "America/Barbados", "America/Belem", "America/Belize", "America/Blanc-Sablon", "America/Boa_Vista", "America/Bogota", "America/Boise", "America/Buenos_Aires", "America/Cambridge_Bay", "America/Campo_Grande", "America/Cancun", "America/Caracas", "America/Catamarca", "America/Cayenne", "America/Cayman", "America/Chicago", "America/Chihuahua", "America/Coral_Harbour", "America/Cordoba", "America/Costa_Rica", "America/Creston", "America/Cuiaba", "America/Curacao", "America/Danmarkshavn", "America/Dawson", "America/Dawson_Creek", "America/Denver", "America/Detroit", "America/Dominica", "America/Edmonton", "America/Eirunepe", "America/El_Salvador", "America/Ensenada", "America/Fort_Nelson", "America/Fort_Wayne", "America/Fortaleza", "America/Glace_Bay", "America/Godthab", "America/Goose_Bay", "America/Grand_Turk", "America/Grenada", "America/Guadeloupe", "America/Guatemala", "America/Guayaquil", "America/Guyana", "America/Halifax", "America/Havana", "America/Hermosillo", "America/Indiana/Indianapolis", "America/Indiana/Knox", "America/Indiana/Marengo", "America/Indiana/Petersburg", "America/Indiana/Tell_City", "America/Indiana/Vevay", "America/Indiana/Vincennes", "America/Indiana/Winamac", "America/Indianapolis", "America/Inuvik", "America/Iqaluit", "America/Jamaica", "America/Jujuy", "America/Juneau", "America/Kentucky/Louisville", "America/Kentucky/Monticello", "America/Knox_IN", "America/Kralendijk", "America/La_Paz", "America/Lima", "America/Los_Angeles", "America/Louisville", "America/Lower_Princes", "America/Maceio", "America/Managua", "America/Manaus", "America/Marigot", "America/Martinique", "America/Matamoros", "America/Mazatlan", "America/Mendoza", "America/Menominee", "America/Merida", "America/Metlakatla", "America/Mexico_City", "America/Miquelon", "America/Moncton", "America/Monterrey", "America/Montevideo", "America/Montreal", "America/Montserrat", "America/Nassau", "America/New_York", "America/Nipigon", "America/Nome", "America/Noronha", "America/North_Dakota/Beulah", "America/North_Dakota/Center", "America/North_Dakota/New_Salem", "America/Ojinaga", "America/Panama", "America/Pangnirtung", "America/Paramaribo", "America/Phoenix", "America/Port-au-Prince", "America/Port_of_Spain", "America/Porto_Acre", "America/Porto_Velho", "America/Puerto_Rico", "America/Punta_Arenas", "America/Rainy_River", "America/Rankin_Inlet", "America/Recife", "America/Regina", "America/Resolute", "America/Rio_Branco", "America/Rosario", "America/Santa_Isabel", "America/Santarem", "America/Santiago", "America/Santo_Domingo", "America/Sao_Paulo", "America/Scoresbysund", "America/Shiprock", "America/Sitka", "America/St_Barthelemy", "America/St_Johns", "America/St_Kitts", "America/St_Lucia", "America/St_Thomas", "America/St_Vincent", "America/Swift_Current", "America/Tegucigalpa", "America/Thule", "America/Thunder_Bay", "America/Tijuana", "America/Toronto", "America/Tortola", "America/Vancouver", "America/Virgin", "America/Whitehorse", "America/Winnipeg", "America/Yakutat", "America/Yellowknife", "Antarctica/Casey", "Antarctica/Davis", "Antarctica/DumontDUrville", "Antarctica/Macquarie", "Antarctica/Mawson", "Antarctica/McMurdo", "Antarctica/Palmer", "Antarctica/Rothera", "Antarctica/South_Pole", "Antarctica/Syowa", "Antarctica/Troll", "Antarctica/Vostok", "Arctic/Longyearbyen", "Asia/Aden", "Asia/Almaty", "Asia/Amman", "Asia/Anadyr", "Asia/Aqtau", "Asia/Aqtobe", "Asia/Ashgabat", "Asia/Ashkhabad", "Asia/Atyrau", "Asia/Baghdad", "Asia/Bahrain", "Asia/Baku", "Asia/Bangkok", "Asia/Barnaul", "Asia/Beirut", "Asia/Bishkek", "Asia/Brunei", "Asia/Calcutta", "Asia/Chita", "Asia/Choibalsan", "Asia/Chongqing", "Asia/Chungking", "Asia/Colombo", "Asia/Dacca", "Asia/Damascus", "Asia/Dhaka", "Asia/Dili", "Asia/Dubai", "Asia/Dushanbe", "Asia/Famagusta", "Asia/Gaza", "Asia/Harbin", "Asia/Hebron", "Asia/Ho_Chi_Minh", "Asia/Hong_Kong", "Asia/Hovd", "Asia/Irkutsk", "Asia/Istanbul", "Asia/Jakarta", "Asia/Jayapura", "Asia/Jerusalem", "Asia/Kabul", "Asia/Kamchatka", "Asia/Karachi", "Asia/Kashgar", "Asia/Kathmandu", "Asia/Katmandu", "Asia/Khandyga", "Asia/Kolkata", "Asia/Krasnoyarsk", "Asia/Kuala_Lumpur", "Asia/Kuching", "Asia/Kuwait", "Asia/Macao", "Asia/Macau", "Asia/Magadan", "Asia/Makassar", "Asia/Manila", "Asia/Muscat", "Asia/Nicosia", "Asia/Novokuznetsk", "Asia/Novosibirsk", "Asia/Omsk", "Asia/Oral", "Asia/Phnom_Penh", "Asia/Pontianak", "Asia/Pyongyang", "Asia/Qatar", "Asia/Qyzylorda", "Asia/Rangoon", "Asia/Riyadh", "Asia/Saigon", "Asia/Sakhalin", "Asia/Samarkand", "Asia/Seoul", "Asia/Shanghai", "Asia/Singapore", "Asia/Srednekolymsk", "Asia/Taipei", "Asia/Tashkent", "Asia/Tbilisi", "Asia/Tehran", "Asia/Tel_Aviv", "Asia/Thimbu", "Asia/Thimphu", "Asia/Tokyo", "Asia/Tomsk", "Asia/Ujung_Pandang", "Asia/Ulaanbaatar", "Asia/Ulan_Bator", "Asia/Urumqi", "Asia/Ust-Nera", "Asia/Vientiane", "Asia/Vladivostok", "Asia/Yakutsk", "Asia/Yangon", "Asia/Yekaterinburg", "Asia/Yerevan", "Atlantic/Azores", "Atlantic/Bermuda", "Atlantic/Canary", "Atlantic/Cape_Verde", "Atlantic/Faeroe", "Atlantic/Faroe", "Atlantic/Jan_Mayen", "Atlantic/Madeira", "Atlantic/Reykjavik", "Atlantic/South_Georgia", "Atlantic/St_Helena", "Atlantic/Stanley", "Australia/ACT", "Australia/Adelaide", "Australia/Brisbane", "Australia/Broken_Hill", "Australia/Canberra", "Australia/Currie", "Australia/Darwin", "Australia/Eucla", "Australia/Hobart", "Australia/LHI", "Australia/Lindeman", "Australia/Lord_Howe", "Australia/Melbourne", "Australia/NSW", "Australia/North", "Australia/Perth", "Australia/Queensland", "Australia/South", "Australia/Sydney", "Australia/Tasmania", "Australia/Victoria", "Australia/West", "Australia/Yancowinna", "Brazil/Acre", "Brazil/DeNoronha", "Brazil/East", "Brazil/West", "CET", "CST6CDT", "Canada/Atlantic", "Canada/Central", "Canada/Eastern", "Canada/Mountain", "Canada/Newfoundland", "Canada/Pacific", "Canada/Saskatchewan", "Canada/Yukon", "Chile/Continental", "Chile/EasterIsland", "Cuba", "EET", "EST", "EST5EDT", "Egypt", "Eire", "Etc/GMT", "Etc/GMT+0", "Etc/GMT+1", "Etc/GMT+10", "Etc/GMT+11", "Etc/GMT+12", "Etc/GMT+2", "Etc/GMT+3", "Etc/GMT+4", "Etc/GMT+5", "Etc/GMT+6", "Etc/GMT+7", "Etc/GMT+8", "Etc/GMT+9", "Etc/GMT-0", "Etc/GMT-1", "Etc/GMT-10", "Etc/GMT-11", "Etc/GMT-12", "Etc/GMT-13", "Etc/GMT-14", "Etc/GMT-2", "Etc/GMT-3", "Etc/GMT-4", "Etc/GMT-5", "Etc/GMT-6", "Etc/GMT-7", "Etc/GMT-8", "Etc/GMT-9", "Etc/GMT0", "Etc/Greenwich", "Etc/UCT", "Etc/UTC", "Etc/Universal", "Etc/Zulu", "Europe/Amsterdam", "Europe/Andorra", "Europe/Astrakhan", "Europe/Athens", "Europe/Belfast", "Europe/Belgrade", "Europe/Berlin", "Europe/Bratislava", "Europe/Brussels", "Europe/Bucharest", "Europe/Budapest", "Europe/Busingen", "Europe/Chisinau", "Europe/Copenhagen", "Europe/Dublin", "Europe/Gibraltar", "Europe/Guernsey", "Europe/Helsinki", "Europe/Isle_of_Man", "Europe/Istanbul", "Europe/Jersey", "Europe/Kaliningrad", "Europe/Kiev", "Europe/Kirov", "Europe/Lisbon", "Europe/Ljubljana", "Europe/London", "Europe/Luxembourg", "Europe/Madrid", "Europe/Malta", "Europe/Mariehamn", "Europe/Minsk", "Europe/Monaco", "Europe/Moscow", "Europe/Nicosia", "Europe/Oslo", "Europe/Paris", "Europe/Podgorica", "Europe/Prague", "Europe/Riga", "Europe/Rome", "Europe/Samara", "Europe/San_Marino", "Europe/Sarajevo", "Europe/Saratov", "Europe/Simferopol", "Europe/Skopje", "Europe/Sofia", "Europe/Stockholm", "Europe/Tallinn", "Europe/Tirane", "Europe/Tiraspol", "Europe/Ulyanovsk", "Europe/Uzhgorod", "Europe/Vaduz", "Europe/Vatican", "Europe/Vienna", "Europe/Vilnius", "Europe/Volgograd", "Europe/Warsaw", "Europe/Zagreb", "Europe/Zaporozhye", "Europe/Zurich", "GB", "GB-Eire", "GMT", "GMT+0", "GMT-0", "GMT0", "Greenwich", "HST", "Hongkong", "Iceland", "Indian/Antananarivo", "Indian/Chagos", "Indian/Christmas", "Indian/Cocos", "Indian/Comoro", "Indian/Kerguelen", "Indian/Mahe", "Indian/Maldives", "Indian/Mauritius", "Indian/Mayotte", "Indian/Reunion", "Iran", "Israel", "Jamaica", "Japan", "Kwajalein", "Libya", "MET", "MST", "MST7MDT", "Mexico/BajaNorte", "Mexico/BajaSur", "Mexico/General", "NZ", "NZ-CHAT", "Navajo", "PRC", "PST8PDT", "Pacific/Apia", "Pacific/Auckland", "Pacific/Bougainville", "Pacific/Chatham", "Pacific/Chuuk", "Pacific/Easter", "Pacific/Efate", "Pacific/Enderbury", "Pacific/Fakaofo", "Pacific/Fiji", "Pacific/Funafuti", "Pacific/Galapagos", "Pacific/Gambier", "Pacific/Guadalcanal", "Pacific/Guam", "Pacific/Honolulu", "Pacific/Johnston", "Pacific/Kiritimati", "Pacific/Kosrae", "Pacific/Kwajalein", "Pacific/Majuro", "Pacific/Marquesas", "Pacific/Midway", "Pacific/Nauru", "Pacific/Niue", "Pacific/Norfolk", "Pacific/Noumea", "Pacific/Pago_Pago", "Pacific/Palau", "Pacific/Pitcairn", "Pacific/Pohnpei", "Pacific/Ponape", "Pacific/Port_Moresby", "Pacific/Rarotonga", "Pacific/Saipan", "Pacific/Samoa", "Pacific/Tahiti", "Pacific/Tarawa", "Pacific/Tongatapu", "Pacific/Truk", "Pacific/Wake", "Pacific/Wallis", "Pacific/Yap", "Poland", "Portugal", "ROC", "ROK", "Singapore", "Turkey", "UCT", "US/Alaska", "US/Aleutian", "US/Arizona", "US/Central", "US/East-Indiana", "US/Eastern", "US/Hawaii", "US/Indiana-Starke", "US/Michigan", "US/Mountain", "US/Pacific", "US/Pacific-New", "US/Samoa", "UTC", "Universal", "W-SU", "WET", "Zulu" ] }, "dataPrivacySettings": { "type": "object", "properties": { "enabled": { "type": "boolean" }, "useAnalytics": { "type": "boolean" }, "useContactProfiles": { "type": "boolean" }, "useConversations": { "type": "boolean" }, "maskAnalytics": { "type": "boolean" }, "maskLogging": { "type": "boolean" }, "ignoreList": { "type": "array", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/organisations/requestdeletion": { "post": { "operationId": "requestOrganisationDeletion_2_0", "summary": "Requests the deletion of the organisation.", "description": "Requests token to start the process of the organisation's deletion, the token will be sent via email to the system administrator.", "tags": [ "Administration v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" } ], "responses": { "200": { "description": "deleteOrganisation data model with all the data collection that will be removed." }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/system/license": { "get": { "operationId": "getSystemLicenseState_2_0", "summary": "Get the license state", "description": "Retrieves the current system license state. Used within e.g. the UI to display certain license warnings.", "tags": [ "Administration v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" } ], "responses": { "200": { "description": "The state of the license", "content": { "application/json": { "schema": { "type": "object", "properties": { "state": { "type": "string", "description": "The state of the license", "example": "valid", "enum": [ "invalid", "valid", "valid3MonthsLeft", "willExpireSoon", "expiredRenewRequired", "expired" ] } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "post": { "operationId": "setSystemLicense_2_0", "summary": "Set the license", "description": "Set the system license of your platform installation.", "tags": [ "Administration v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "query", "name": "organisationId", "required": false, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "email": { "type": "string", "format": "email" }, "password": { "type": "string" }, "licensekey": { "type": "string" } } } } } }, "responses": { "202": { "description": "Successfully updated the System License", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "description": "The success message.", "example": "The new license was installed within the system." } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/system/message": { "get": { "operationId": "getSystemMessage_2_0", "summary": "Get potential system wide maintenance messages", "tags": [ "Administration v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" } ], "responses": { "200": { "description": "The maintenance message", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Next great Update will be released next Monday." }, "until": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "showOnLogin": { "type": "boolean" } } } } } }, "204": { "description": "Currently no maintenance message" }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/users/me/accepttermsofservice": { "post": { "operationId": "acceptTermsOfService_2_0", "summary": "Accept the Terms of Service", "description": "The User accepts the Terms of Service.", "tags": [ "Users v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" } ], "responses": { "204": { "description": "Successfully accepted the Terms of Services" }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/projects/{projectId}/addprojectmember": { "post": { "operationId": "addProjectMember_2_0", "summary": "Adds a new project member.", "description": "Adds a new already existing user to this project as a member.", "tags": [ "Users v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "projectId", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "userId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } } } }, "responses": { "204": { "description": "Project member was added." }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/users/{userId}/addproject": { "post": { "operationId": "addProjectToUser_2_0", "summary": "Makes a project available to a user.", "description": "Gives an user access to a project.", "tags": [ "Users v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "userId", "description": "The Id of the User", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "projectId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } } } }, "responses": { "204": { "description": "The project is now accessible for the user." }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/projects/{projectId}/members/{userId}/addroletomember": { "post": { "operationId": "addRoleToMember_2_0", "summary": "Adds a new project-wide role to a user.", "description": "Adds a new project-wide role to an already existing user.", "tags": [ "Users v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "userId", "description": "The Id of the User", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "path", "name": "projectId", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "role": { "type": "string", "enum": [ "agentAssistConfigAdmin", "agentAssistConfigViewer", "analytics", "basic", "connection_admin", "contact_profile_admin", "contact_profile_editor", "contact_profile_viewer", "conversationHistory", "developer", "endpoint_admin", "extension_admin", "extension_editor", "flowEditor", "flowNodeComments", "flowNodeDescriptions", "followUser", "intents", "data_privacy_admin", "data_privacy_editor", "data_privacy_viewer", "knowledgeAdmin", "large_language_model_admin,", "lexicon_admin", "lexicon_editor", "localesAdmin", "logs", "memberManager", "nlu_connector_admin", "packages_admin", "playbook_admin", "playbook_editor", "projectAdmin", "snapshot_admin", "tokenAdmin", "tokenEditor", "function_admin", "function_editor" ] } } } } } }, "responses": { "204": { "description": "User-role was added to the project member." }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/users/{userId}/addroletouser": { "post": { "operationId": "addRoleToUser_2_0", "summary": "Adds a new org-wide role to an user.", "description": "Adds a new organisation wide user-role to an user.", "tags": [ "Users v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "userId", "description": "The Id of the User", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "role": { "type": "string", "enum": [ "admin", "apiKeys", "base_role", "basicSupportUser", "fullSupportUser", "liveAgentAdmin", "liveAgentAgent", "liveAgentSupervisor", "odata", "projectAssigner", "projectManager", "userManager", "userDetailsViewer", "voiceGatewayUser" ] } } } } } }, "responses": { "204": { "description": "User-role was added to the user." }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/users/me/apikeys": { "post": { "operationId": "createApiKeyMe_2_0", "summary": "Creates a new api-key for the own user.", "description": "Creates a new [ApiKey](doc:apikeys) for the own user.", "tags": [ "Users v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the ApiKey", "example": "Office" } } } } } }, "responses": { "201": { "description": "Returns the created api-key.", "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "minimum": 0, "maximum": 2147483647, "example": 1527621049 }, "apiKey": { "type": "string" } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "get": { "operationId": "indexApiKeysMe_2_0", "summary": "Get api-keys of the current user.", "description": "Get 25 api-keys of the current user by default. To change the default value, use the `limit` query parameter. Additionally, you can filter, sort, and paginate the results.", "tags": [ "Users v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "query", "name": "filter", "required": false, "schema": { "type": "string" }, "description": "The name of the api-key to filter the records" }, { "in": "query", "name": "limit", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100 }, "description": "The maximum number of items to return. The default is 25." }, { "in": "query", "name": "skip", "required": false, "schema": { "type": "integer", "minimum": 0 }, "description": "The number of items to skip. The default is 0. Used along with a limit of a pagination." }, { "in": "query", "name": "sort", "required": false, "schema": { "type": "string", "minLength": 1 }, "description": "The order of the sorting items-`Desc` (descending) or `Asc` (ascending). For example, to sort the records by name in ascending order, specify `name:Asc`." }, { "in": "query", "name": "next", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the nextCursor value from the response to get the next set of records. Used along with limit for pagination." }, { "in": "query", "name": "previous", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the previousCursor value from the response to get the previous set of records. Used along with limit for pagination." } ], "responses": { "200": { "description": "Returns api-keys of the current user.", "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "name": { "type": "string" }, "apiKey": { "type": "string" }, "createdAt": { "type": "number" } } } }, "total": { "type": "integer", "example": 1 }, "next": { "oneOf": [ { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, { "nullable": true } ], "example": "5ce7c2d833ea1e04d7e6c432" }, "previous": { "oneOf": [ { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, { "nullable": true } ], "example": null } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/users": { "post": { "operationId": "createUser_2_0", "summary": "Creates a new user", "description": "Creates a new [User](doc:users) in the system.", "tags": [ "Users v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "id", "name", "password" ], "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "roles": { "type": "array", "items": { "type": "string", "enum": [ "admin", "apiKeys", "base_role", "basicSupportUser", "fullSupportUser", "liveAgentAdmin", "liveAgentAgent", "liveAgentSupervisor", "odata", "projectAssigner", "projectManager", "userManager", "userDetailsViewer", "voiceGatewayUser" ] } }, "password": { "type": "string", "description": "Enter password in case of non-sso user" } } } } } }, "responses": { "201": { "description": "Returns the created user.", "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "organisation": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "roles": { "type": "array", "items": { "type": "string", "enum": [ "admin", "apiKeys", "base_role", "basicSupportUser", "fullSupportUser", "liveAgentAdmin", "liveAgentAgent", "liveAgentSupervisor", "odata", "projectAssigner", "projectManager", "userManager", "userDetailsViewer", "voiceGatewayUser" ] } }, "projects": { "type": "array", "items": { "type": "string" } }, "acceptedTOS": { "type": "boolean" }, "disabled": { "type": "boolean" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "get": { "operationId": "indexUsers_2_0", "summary": "Get users", "description": "Get 25 [Users](https://docs.cognigy.com/voicegateway/webapp/users) of the organisation by default. To change the default value, use the `limit` query parameter. Additionally, you can filter, sort, and paginate the results.", "tags": [ "Users v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "query", "name": "filter", "required": false, "schema": { "type": "string" }, "description": "The name or id of the user to filter the records" }, { "in": "query", "name": "limit", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100 }, "description": "The maximum number of items to return. The default is 25." }, { "in": "query", "name": "skip", "required": false, "schema": { "type": "integer", "minimum": 0 }, "description": "The number of items to skip. The default is 0. Used along with a limit of a pagination." }, { "in": "query", "name": "sort", "required": false, "schema": { "type": "string", "minLength": 1 }, "description": "The order of the sorting items-`Desc` (descending) or `Asc` (ascending). For example, to sort the records by name in ascending order, specify `name:Asc`." }, { "in": "query", "name": "next", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the nextCursor value from the response to get the next set of records. Used along with limit for pagination." }, { "in": "query", "name": "previous", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the previousCursor value from the response to get the previous set of records. Used along with limit for pagination." } ], "responses": { "200": { "description": "Returns metadata objects for each user in the system.", "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "lastActive": { "type": "number" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" } }, "total": { "type": "integer", "example": 1 }, "next": { "oneOf": [ { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, { "nullable": true } ], "example": "5ce7c2d833ea1e04d7e6c432" }, "previous": { "oneOf": [ { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, { "nullable": true } ], "example": null } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/users/me/apikeys/{apiKeyId}": { "delete": { "operationId": "deleteApiKeyMe_2_0", "summary": "Deletes an api-key for the own user.", "description": "Deletes an [ApiKey](doc:apikeys) for the own user.", "tags": [ "Users v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "apiKeyId", "description": "The Id of an Api Key", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "204": { "description": "The Api key was removed" }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/users/{userId}": { "delete": { "operationId": "deleteUser_2_0", "summary": "Deletes an user.", "description": "Deletes a [User](doc:users) from the system completely.", "tags": [ "Users v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "userId", "description": "The Id of the User", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "204": { "description": "The user was removed successfully." }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "get": { "operationId": "readUser_2_0", "summary": "Get a user", "description": "Get full data of a [User](doc:users) from the system.", "tags": [ "Users v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "userId", "description": "The Id of the User", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "200": { "description": "Returns User object", "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "organisation": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "roles": { "type": "array", "items": { "type": "string", "enum": [ "admin", "apiKeys", "base_role", "basicSupportUser", "fullSupportUser", "liveAgentAdmin", "liveAgentAgent", "liveAgentSupervisor", "odata", "projectAssigner", "projectManager", "userManager", "userDetailsViewer", "voiceGatewayUser" ] } }, "projects": { "type": "array", "items": { "type": "string" } }, "acceptedTOS": { "type": "boolean" }, "disabled": { "type": "boolean" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "patch": { "operationId": "updateUser_2_0", "summary": "Updates a user.", "description": "Updates the profile of a [User](doc:users).", "tags": [ "Users v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "userId", "description": "The Id of the User", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string" }, "newPassword": { "type": "string" } } } } } }, "responses": { "204": { "description": "The user is updated successfully." }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/users/me": { "delete": { "operationId": "deleteUserMe_2_0", "summary": "Deletes the own user.", "description": "Deletes the own [User](doc:users) from the system completely.", "tags": [ "Users v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" } ], "responses": { "204": { "description": "The own user was removed successfully." }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "get": { "operationId": "readUserMe_2_0", "summary": "Gets own user profile.", "description": "Gets the users own [User](doc:users) profile.", "tags": [ "Users v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" } ], "responses": { "200": { "description": "Returns own User object.", "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "organisation": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "roles": { "type": "array", "items": { "type": "string", "enum": [ "admin", "apiKeys", "base_role", "basicSupportUser", "fullSupportUser", "liveAgentAdmin", "liveAgentAgent", "liveAgentSupervisor", "odata", "projectAssigner", "projectManager", "userManager", "userDetailsViewer", "voiceGatewayUser" ] } }, "projects": { "type": "array", "items": { "type": "string" } }, "acceptedTOS": { "type": "boolean" }, "disabled": { "type": "boolean" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "patch": { "operationId": "updateUserMe_2_0", "summary": "Updates the own user object.", "description": "Updates the profile of the own [User](doc:users).", "tags": [ "Users v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string" }, "oldPassword": { "type": "string" }, "newPassword": { "type": "string" } } } } } }, "responses": { "204": { "description": "The user is updated successfully." }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/users/deprecatepassword": { "post": { "operationId": "deprecatePassword_2_0", "summary": "Deprecates a user-password / all passwords in the org.", "description": "Deprecates the password of a single user or all users of the organisation.", "tags": [ "Users v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "userId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } } } }, "responses": { "204": { "description": "The password(s) was/were deprecated." }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/users/me/loginattempts": { "get": { "operationId": "indexLoginAttemptsMe_2_0", "summary": "Get login attempts of the own user.", "description": "Get 25 login attempt objects for the current user by default. To change the default value, use the `limit` query parameter. Additionally, you can filter, sort, and paginate the results.", "tags": [ "Users v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "query", "name": "filter", "required": false, "schema": { "type": "string" }, "description": "The status or location to filter the login attempts" }, { "in": "query", "name": "limit", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100 }, "description": "The maximum number of items to return. The default is 25." }, { "in": "query", "name": "skip", "required": false, "schema": { "type": "integer", "minimum": 0 }, "description": "The number of items to skip. The default is 0. Used along with a limit of a pagination." }, { "in": "query", "name": "sort", "required": false, "schema": { "type": "string", "minLength": 1 }, "description": "The order of the sorting items-`Desc` (descending) or `Asc` (ascending). For example, to sort the records by name in ascending order, specify `name:Asc`." }, { "in": "query", "name": "next", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the nextCursor value from the response to get the next set of records. Used along with limit for pagination." }, { "in": "query", "name": "previous", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the previousCursor value from the response to get the previous set of records. Used along with limit for pagination." } ], "responses": { "200": { "description": "Returns login attempt objects for the curren tuser.", "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "status": { "type": "string", "enum": [ "success", "failed" ] }, "timestamp": { "type": "number" }, "location": { "type": "string" } } } }, "total": { "type": "integer", "example": 1 }, "next": { "oneOf": [ { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, { "nullable": true } ], "example": "5ce7c2d833ea1e04d7e6c432" }, "previous": { "oneOf": [ { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, { "nullable": true } ], "example": null } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/projects/{projectId}/members": { "get": { "operationId": "indexProjectMembers_2_0", "summary": "Get members of a project", "description": "Get 25 [Members](https://docs.cognigy.com/ai/resources/manage/members/) of a project by default. To change the default value, use the `limit` query parameter. Additionally, you can filter, sort, and paginate the results.", "tags": [ "Users v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "query", "name": "filter", "required": false, "schema": { "type": "string" }, "description": "The name or id of the member to filter the records" }, { "in": "query", "name": "limit", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100 }, "description": "The maximum number of items to return. The default is 25." }, { "in": "query", "name": "skip", "required": false, "schema": { "type": "integer", "minimum": 0 }, "description": "The number of items to skip. The default is 0. Used along with a limit of a pagination." }, { "in": "query", "name": "sort", "required": false, "schema": { "type": "string", "minLength": 1 }, "description": "The order of the sorting items-`Desc` (descending) or `Asc` (ascending). For example, to sort the records by name in ascending order, specify `name:Asc`." }, { "in": "query", "name": "next", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the nextCursor value from the response to get the next set of records. Used along with limit for pagination." }, { "in": "query", "name": "previous", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the previousCursor value from the response to get the previous set of records. Used along with limit for pagination." }, { "in": "path", "name": "projectId", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "200": { "description": "Returns metadata objects for each project member.", "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "roles": { "type": "array", "items": { "type": "string" } }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" } }, "total": { "type": "integer", "example": 1 }, "next": { "oneOf": [ { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, { "nullable": true } ], "example": "5ce7c2d833ea1e04d7e6c432" }, "previous": { "oneOf": [ { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, { "nullable": true } ], "example": null } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/users/{userId}/logout": { "post": { "operationId": "logoutUser_2_0", "summary": "Performs a logout for a specific user.", "description": "Performs a logout for a specific user and removes access-/refresh-token pair.", "tags": [ "Users v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "userId", "description": "The Id of the User", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "204": { "description": "The session was successfully destroyed." }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/users/me/lastloginattempt": { "post": { "operationId": "readLastLoginAttemptMe_2_0", "summary": "Retrieves the last login attempt.", "description": "Retrieves the last login attempt of the user.", "tags": [ "Users v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" } ], "responses": { "200": { "description": "The last login attempt object.", "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "type": "string", "enum": [ "success", "failed" ] }, "timestamp": { "type": "number" }, "location": { "type": "string" } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/projects/{projectId}/members/{userId}": { "get": { "operationId": "readProjectMember_2_0", "summary": "Reads a project member.", "description": "Retrieves all information about a project member in a project.", "tags": [ "Users v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "projectId", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "path", "name": "userId", "description": "The Id of the User", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "200": { "description": "Returns the project member with all information.", "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "roles": { "type": "array", "items": { "type": "string", "enum": [ "agentAssistConfigAdmin", "agentAssistConfigViewer", "analytics", "basic", "connection_admin", "contact_profile_admin", "contact_profile_editor", "contact_profile_viewer", "conversationHistory", "developer", "endpoint_admin", "extension_admin", "extension_editor", "flowEditor", "flowNodeComments", "flowNodeDescriptions", "followUser", "intents", "data_privacy_admin", "data_privacy_editor", "data_privacy_viewer", "knowledgeAdmin", "large_language_model_admin,", "lexicon_admin", "lexicon_editor", "localesAdmin", "logs", "memberManager", "nlu_connector_admin", "packages_admin", "playbook_admin", "playbook_editor", "projectAdmin", "snapshot_admin", "tokenAdmin", "tokenEditor", "function_admin", "function_editor", "admin" ] } }, "acceptedTOS": { "type": "boolean" }, "disabled": { "type": "boolean" }, "acl": { "type": "object" }, "allowedLocales": { "type": "array", "nullable": true, "items": { "type": "object", "properties": { "localeId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "patch": { "operationId": "updateProjectMember_2_0", "summary": "Updates a project member.", "description": "Updates a member of a project.", "tags": [ "Users v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "projectId", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "path", "name": "userId", "description": "The Id of the User", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "allowedLocales": { "type": "array", "nullable": true, "items": { "type": "object", "properties": { "localeId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } } } } } } }, "responses": { "204": { "description": "Project member was updated." }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/users/me/acl": { "get": { "operationId": "readUserAclMe_2_0", "summary": "Retrieves own ACL.", "description": "Retrieves the ACL information for the own [User](doc:users) profile.", "tags": [ "Users v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" } ], "responses": { "200": { "description": "Returns the acl object for the user.", "content": { "application/json": { "schema": { "type": "object", "properties": { "organisationWide": { "type": "object", "properties": { "rights": { "type": "object", "properties": { "analyticsOdata": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "apiKeys": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "liveAgentAccount": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "projects": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "userDetails": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "users": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "connections": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "contactProfiles": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "conversationHistory": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "endpoints": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "extensions": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "flowNodeComments": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "flowNodeDescription": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "flowNodes": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "flows": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "intents": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "knowledgeStores": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "lexicons": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "liveAgentInbox": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "locales": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "logs": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "memberDetails": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "members": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "milestones": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "nluConnectors": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "playbooks": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "project": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "projectSettings": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "snapshots": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "states": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "tasks": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "tokens": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "voiceGatewayAccount": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } } } }, "roles": { "type": "array", "items": { "type": "string", "enum": [ "admin", "apiKeys", "base_role", "basicSupportUser", "fullSupportUser", "liveAgentAdmin", "liveAgentAgent", "liveAgentSupervisor", "odata", "projectAssigner", "projectManager", "userManager", "userDetailsViewer", "voiceGatewayUser" ] } } } }, "projectWide": { "type": "object", "additionalProperties": { "type": "object", "properties": { "rights": { "type": "object", "properties": { "agentAssistConfigs": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "analytics": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "connections": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "contactProfiles": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "conversationHistory": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "endpoints": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "extensions": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "extensionsTrust": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "flowNodeComments": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "flowNodeDescription": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "flowNodes": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "flows": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "intents": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "largeLanguageModels": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "knowledgeStores": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "lexicons": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "liveAgentInbox": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "locales": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "logs": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "memberDetails": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "members": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "milestones": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "nluConnectors": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "playbooks": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "project": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "projectSettings": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "snapshots": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "states": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "tasks": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "tokens": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "analyticsOdata": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "apiKeys": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "projects": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "userDetails": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } }, "users": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } } }, "additionalProperties": { "type": "object", "properties": { "create": { "type": "boolean" }, "read": { "type": "boolean" }, "update": { "type": "boolean" }, "delete": { "type": "boolean" } } } }, "roles": { "type": "array", "items": { "type": "string", "enum": [ "agentAssistConfigAdmin", "agentAssistConfigViewer", "analytics", "basic", "connection_admin", "contact_profile_admin", "contact_profile_editor", "contact_profile_viewer", "conversationHistory", "developer", "endpoint_admin", "extension_admin", "extension_editor", "flowEditor", "flowNodeComments", "flowNodeDescriptions", "followUser", "intents", "data_privacy_admin", "data_privacy_editor", "data_privacy_viewer", "knowledgeAdmin", "large_language_model_admin,", "lexicon_admin", "lexicon_editor", "localesAdmin", "logs", "memberManager", "nlu_connector_admin", "packages_admin", "playbook_admin", "playbook_editor", "projectAdmin", "snapshot_admin", "tokenAdmin", "tokenEditor", "function_admin", "function_editor" ] } }, "allowedLocales": { "type": "array", "items": { "type": "object", "properties": { "localeId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "primary": { "type": "boolean" } } } } } } } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/users/{userId}/removeproject": { "post": { "operationId": "removeProjectFromUser_2_0", "summary": "Removes project from a user.", "description": "Removes access to a project for a specific user.", "tags": [ "Users v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "userId", "description": "The Id of the User", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "projectId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } } } }, "responses": { "204": { "description": "The user no longer has access to the project." }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0//projects/{projectId}/removeprojectmember": { "post": { "operationId": "removeProjectMember_2_0", "summary": "Removes a project member.", "description": "Removes a user from a project.", "tags": [ "Users v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "projectId", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "userId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } } } }, "responses": { "204": { "description": "Project member was removed." }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/projects/{projectId}/members/{userId}/removerolefrommember": { "post": { "operationId": "removeRoleFromMember_2_0", "summary": "Removes a role from a project-member.", "description": "Removes a role from a project-member.", "tags": [ "Users v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "userId", "description": "The Id of the User", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "path", "name": "projectId", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "role": { "type": "string", "enum": [ "agentAssistConfigAdmin", "agentAssistConfigViewer", "analytics", "basic", "connection_admin", "contact_profile_admin", "contact_profile_editor", "contact_profile_viewer", "conversationHistory", "developer", "endpoint_admin", "extension_admin", "extension_editor", "flowEditor", "flowNodeComments", "flowNodeDescriptions", "followUser", "intents", "data_privacy_admin", "data_privacy_editor", "data_privacy_viewer", "knowledgeAdmin", "large_language_model_admin,", "lexicon_admin", "lexicon_editor", "localesAdmin", "logs", "memberManager", "nlu_connector_admin", "packages_admin", "playbook_admin", "playbook_editor", "projectAdmin", "snapshot_admin", "tokenAdmin", "tokenEditor", "function_admin", "function_editor" ] } } } } } }, "responses": { "204": { "description": "The role was removed from the project member." }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/users/{userId}/removerolefromuser": { "post": { "operationId": "removeRoleFromUser_2_0", "summary": "Removes an organisation-wide role from an user.", "description": "Removes an organisation-wide user-role from an user.", "tags": [ "Users v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "userId", "description": "The Id of the User", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "role": { "type": "string", "enum": [ "admin", "apiKeys", "base_role", "basicSupportUser", "fullSupportUser", "liveAgentAdmin", "liveAgentAgent", "liveAgentSupervisor", "odata", "projectAssigner", "projectManager", "userManager", "userDetailsViewer", "voiceGatewayUser" ] } } } } } }, "responses": { "204": { "description": "User-role was removed from the user." }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/users/{userId}/resetfailedloginattempts": { "post": { "operationId": "resetFailedLoginAttempts_2_0", "summary": "Resets failed login attempts for user.", "description": "Resets the failed login attempts for a specific [User](doc:users). Requires 'admin' role.", "tags": [ "Users v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "userId", "description": "The Id of the User", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "204": { "description": "The failed logins attempts were reset." }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.1/users/me/apikeys": { "post": { "operationId": "createApiKeyMe_2_1", "summary": "Creates a new api-key for the own user.", "description": "Creates a new [ApiKey](https://docs.cognigy.com/ai/tools/user-menu/my-profile/#api-keys) for the own user.", "tags": [ "Users v2.1" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the ApiKey", "example": "Office" } } } } } }, "responses": { "201": { "description": "Returns the created api-key.", "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "minimum": 0, "maximum": 2147483647, "example": 1527621049 }, "apiKey": { "type": "string" } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "get": { "operationId": "indexApiKeysMe_2_1", "summary": "Get api-keys of the current user.", "description": "Get 25 api-keys of the current user by default. To change the default value, use the `limit` query parameter. Additionally, you can filter, sort, and paginate the results.", "tags": [ "Users v2.1" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "query", "name": "filter", "required": false, "schema": { "type": "string" }, "description": "The name of the api-key to filter the records" }, { "in": "query", "name": "limit", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100 }, "description": "The maximum number of items to return. The default is 25." }, { "in": "query", "name": "skip", "required": false, "schema": { "type": "integer", "minimum": 0 }, "description": "The number of items to skip. The default is 0. Used along with a limit of a pagination." }, { "in": "query", "name": "sort", "required": false, "schema": { "type": "string", "minLength": 1 }, "description": "The order of the sorting items-`Desc` (descending) or `Asc` (ascending). For example, to sort the records by name in ascending order, specify `name:Asc`." }, { "in": "query", "name": "next", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the nextCursor value from the response to get the next set of records. Used along with limit for pagination." }, { "in": "query", "name": "previous", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the previousCursor value from the response to get the previous set of records. Used along with limit for pagination." } ], "responses": { "200": { "description": "Returns api-keys of the current user.", "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "name": { "type": "string" }, "createdAt": { "type": "number" } } } }, "total": { "type": "integer", "example": 1 }, "next": { "oneOf": [ { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, { "nullable": true } ], "example": "5ce7c2d833ea1e04d7e6c432" }, "previous": { "oneOf": [ { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, { "nullable": true } ], "example": null } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/organisations/voicegateway/account": { "get": { "operationId": "readVoiceGatewayAccount_2_0", "summary": "Gets the Voice Gateway Account for the organisation.", "description": "Gets the Voice Gateway Account for the organisation.", "tags": [ "VoiceGateway v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" } ], "responses": { "200": { "description": "Returns the Voice Gateway Account for the organisation." }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "post": { "operationId": "setupCognigyVoiceGateway_2_0", "summary": "Sets up a Cognigy Voice Gateway.", "description": "Sets up a Cognigy Voice Gateway for an organisation.", "tags": [ "VoiceGateway v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "accountSid": { "type": "string", "description": "The Service Provider Identifier (SID) of the Voice Gateway account." } } } } } }, "responses": { "200": { "description": "Cognigy Voice Gateway account was successfully setup for the organisation." }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/analytics/{projectId}": { "delete": { "operationId": "deleteAnalyticsRecords_2_0", "summary": "Deletes analytics records.", "description": "Deletes analytics records for a project for given time.", "tags": [ "Analytics v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "projectId", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "contactIds": { "type": "array", "nullable": true, "items": { "type": "string" } }, "timestampStart": { "type": "string", "example": "2020-01-01T00:00:00Z" }, "timestampEnd": { "type": "string", "example": "2020-01-31T23:59:00Z" } } } } } }, "responses": { "202": { "description": "Accepts the Request to Delete Analytics Records." }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/analytics": { "patch": { "operationId": "updateAnalyticsRecords_2_0", "summary": "Update Analytics Record", "description": "Updates the Analytics Record", "tags": [ "Analytics v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "contactId": { "type": "string" }, "projectId": { "type": "string" }, "sessionId": { "type": "string" }, "inputId": { "type": "string" }, "properties": { "anyOf": [ { "type": "object", "properties": { "state": { "type": "string" }, "mode": { "type": "string" }, "userType": { "type": "string" }, "channel": { "type": "string" }, "flowLanguage": { "type": "string" }, "intent": { "type": "string" }, "intentScore": { "type": "number" }, "intentFlow": { "type": "string" }, "flowName": { "type": "string" }, "inHandoverRequest": { "type": "boolean" }, "inHandoverConversation": { "type": "boolean" }, "localeName": { "type": "string" }, "rating": { "type": "number" }, "ratingComment": { "type": "string" }, "entrypointType": { "type": "string" }, "trackedGoals": { "type": "array", "items": { "type": "string" } }, "endpointName": { "type": "string" }, "endpointUrlToken": { "type": "string" }, "handoverEscalations": { "type": "number" }, "snapshotName": { "type": "string" }, "slots": { "type": "object" }, "custom1": { "type": "string" }, "custom2": { "type": "string" }, "custom3": { "type": "string" }, "custom4": { "type": "string" }, "custom5": { "type": "string" }, "custom6": { "type": "string" }, "custom7": { "type": "string" }, "custom8": { "type": "string" }, "custom9": { "type": "string" }, "custom10": { "type": "string" } } } ] } } }, "example": { "contactId": "contactId", "projectId": "projectId", "sessionId": "sessionId", "inputId": "inputId", "properties": { "state": "state", "mode": "mode", "userType": "user userType", "channel": "channel", "flowLanguage": "new flowLanguage", "intent": "new intent", "intentFlow": "new intentFlow", "intentScore": 0, "flowName": "new flowName", "inHandoverRequest": false, "inHandoverConversation": false, "localeName": "new localeName", "rating": 9, "ratingComment": "new ratingComment", "entrypointType": "new entrypointType", "endpointName": "new endpointName", "endpointUrlToken": "new endpointUrlToken", "handoverEscalations": 2, "snapshotName": "new snapshotName", "slots": "new slots", "custom1": "new custom1", "custom2": "new custom2", "custom3": "new custom3", "custom4": "new custom4", "custom5": "new custom5", "custom6": "new custom6", "custom7": "new custom7", "custom8": "new custom8", "custom9": "new custom9", "custom10": "new custom10" } } } } }, "responses": { "204": { "description": "Successfully updated the Analytics Record" }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/audio/preview/languages": { "get": { "operationId": "indexAudioPreviewLanguages_2_0", "summary": "Get the available audio preview voices for speech synthezis", "description": "Get a list of available audio preview voices for the selected audio provider.", "tags": [ "VoicePreview v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "query", "name": "projectId", "schema": { "type": "string" }, "description": "Project id from which it will get the settings" } ], "responses": { "200": { "description": "Returns the available audio preview voices", "content": { "application/json": { "schema": { "type": "object", "properties": { "audioPreviewLanguages": { "type": "array", "items": { "type": "object", "properties": { "voiceId": { "type": "string", "maxLength": 50, "description": "Audio preview provided voice Id. This is the ID that you specify when calling the SynthesizeSpeech operation." }, "languageCode": { "type": "string", "maxLength": 10, "description": "Language code of the voice." } } } } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/audio/voiceprovider/test": { "post": { "operationId": "testVoiceProvider_2_0", "summary": "Validates the voice provider creedentials", "description": "Validates the creedentials making a connection to the VoiceProvider SDK", "tags": [ "VoicePreview v2.0" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "projectId" ], "properties": { "projectId": { "type": "string" } } } } } }, "responses": { "200": { "description": "Credentials have been validated and the connection was successful.", "content": { "application/json": { "schema": { "type": "object", "properties": { "voiceProvider": { "type": "string" }, "isCredentialsValid": { "type": "boolean" }, "msg": { "type": "string" }, "msgErr": { "type": "string" } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/external/alexa/users": { "post": { "operationId": "createAuthenticatedAmazonUser_2_0", "summary": "Create an authenticated AmazonUser", "description": "Create an authenticated AmazonUser", "tags": [ "Alexa v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "accessToken": { "type": "string" }, "refreshToken": { "type": "string" } } } } } }, "responses": { "204": { "description": "Successfully created AmazonUser" }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/external/alexa/users/me": { "delete": { "operationId": "deleteAmazonAccount_2_0", "summary": "Delete the used Amazon Account", "description": "Delete the used Amazon Account", "tags": [ "Alexa v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" } ], "responses": { "204": { "description": "Successfully deleted the used Amazon Account" }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "get": { "operationId": "getAmazonAccount_2_0", "summary": "Get information about the Amazon-Account", "description": "Get information about the Amazon-Account", "tags": [ "Alexa v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" } ], "responses": { "200": { "description": "Returns the data of the Amazon-Account", "content": { "application/json": { "schema": { "type": "object", "properties": { "userId": { "type": "string", "description": "The userId of the amazon user in the platform." }, "accessToken": { "type": "string", "description": "The user's access token that allows platform to make requests to Amazon." }, "refreshToken": { "type": "string", "description": "A refresh token that is used to generate a new access token refresh token pair." } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/external/alexa/skills/{skillId}/deploy": { "post": { "operationId": "deployAlexaEndpoint_2_0", "summary": "Deploy an Endpoint to an Alexa skill.", "description": "Deploy an Endpoint to an Alexa skill.", "tags": [ "Alexa v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "skillId", "description": "The Id of the Alexa-Skill", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "URLToken": { "type": "string" } } } } } }, "responses": { "204": { "description": "Successfully deployed the Endpoint" }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/external/alexa/skills": { "get": { "operationId": "getAlexaSkills_2_0", "summary": "Get all Alexa Skills", "description": "Get all [Alexa Skills](https://docs.cognigy.com/ai/endpoints/amazon-alexa/?h=alexa+skills#generic-endpoint-settings) of the current user.", "tags": [ "Alexa v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" } ], "responses": { "200": { "description": "Returns all the Alexa skills", "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "lastUpdated": { "type": "string", "description": "When the skill was last updated" }, "nameByLocale": { "type": "object", "description": "Gives the name of the skill for different locales", "properties": { "en-US": { "type": "string" }, "de-DE": { "type": "string" }, "ja-JP": { "type": "string" }, "en-GB": { "type": "string" }, "en-IN": { "type": "string" } } }, "skillId": { "type": "string", "description": "The unique id of the skill" }, "stage": { "type": "string", "description": "The current stage of the skills life cycle (e.g. is it in development, production..)" } } } } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/insights/beta/messages/report/generate": { "post": { "operationId": "generateMessages_2_0", "summary": "Generate messages report", "description": "Generate messages report [messages](doc:conversation).", "tags": [ "Insights Beta" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "query", "name": "search", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "limit", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100 }, "description": "The maximum number of items to return. The default is 25." }, { "in": "query", "name": "skip", "required": false, "schema": { "type": "integer", "minimum": 0 }, "description": "The number of items to skip. The default is 0. Used along with a limit of a pagination." }, { "in": "query", "name": "sort", "required": false, "schema": { "type": "string", "minLength": 1 }, "description": "The order of the sorting items-`Desc` (descending) or `Asc` (ascending). For example, to sort the records by name in ascending order, specify `name:Asc`." }, { "in": "query", "name": "next", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the nextCursor value from the response to get the next set of records. Used along with limit for pagination." }, { "in": "query", "name": "previous", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the previousCursor value from the response to get the previous set of records. Used along with limit for pagination." }, { "in": "query", "name": "messageType", "required": true, "schema": { "type": "string", "enum": [ "current", "next", "previous" ] } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "projectId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "timezoneOffset": { "type": "string" }, "filters": { "type": "array", "items": { "type": "object", "properties": { "field": { "type": "string" }, "operator": { "type": "string", "enum": [ "equals", "notEquals", "gt", "gte", "lt", "lte" ] }, "values": { "type": "array", "items": { "type": "string" } } } } } } } } } }, "responses": { "202": { "description": "Successfully started to generate the report", "content": { "application/json": { "schema": { "type": "object", "properties": { "queryHash": { "type": "string" } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/insights/beta/messages/report/{queryHash}": { "get": { "operationId": "loadMessagesReportByQueryHash_2_0", "summary": "Get Messages Report by queryHash", "description": "Get Messages Report in by queryHash a project or snapshot.", "tags": [ "Insights Beta" ], "parameters": [ { "name": "queryHash", "in": "path", "description": "Query Hash", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Returns the report that is referenced by the query hash", "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "type": "string", "enum": [ "pending", "done", "error" ] }, "data": { "type": "array", "items": { "type": "object", "properties": { "message": { "type": "string" }, "count": { "type": "number" }, "source": { "type": "string" } }, "example": { "message": "I want pizza", "count": 12345, "source": "bot" } } } }, "example": { "status": "done", "data": [ { "message": "I want pizza", "count": 12345, "source": "bot" } ] } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/insights/beta/reports/generate": { "post": { "operationId": "generateReport_2_0", "summary": "Load a Quantitative Report", "description": "Loads the Quantitative Report for an Agent with the given filters", "tags": [ "Insights Beta" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "query": { "type": "string" }, "projectId": { "type": "string" }, "grain": { "type": "string" }, "timezoneOffset": { "type": "string" }, "limit": { "type": "number" }, "filters": { "type": "array", "items": { "type": "object", "properties": { "field": { "type": "string" }, "operator": { "type": "string", "enum": [ "equals", "notEquals", "gt", "gte", "lt", "lte" ] }, "values": { "type": "array", "items": { "type": "string" } } } } } } } } } }, "responses": { "202": { "description": "Successfully started to generate the report", "content": { "application/json": { "schema": { "type": "object", "properties": { "queryHash": { "type": "string" } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/insights/beta/reports/{queryHash}": { "get": { "operationId": "loadReportByQueryHash_2_0", "summary": "Get Report by queryHash", "description": "Get Report in by queryHash a project or snapshot.", "tags": [ "Insights Beta" ], "parameters": [ { "name": "queryHash", "in": "path", "description": "Query Hash", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Returns the report that is referenced by the query hash", "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "type": "string", "enum": [ "pending", "done", "error" ] }, "data": { "type": "array", "items": { "type": "object", "properties": { "dimension": { "type": "string" }, "measure": { "type": "number" }, "value": { "type": "string" } } } } }, "example": { "status": "done", "data": [ { "dimension": "2021-01", "measure": 0 }, { "dimension": "2021-02", "measure": 1 }, { "dimension": "2021-03", "measure": 0 }, { "dimension": "2021-04", "measure": 1 } ] } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/insights/beta/steps/report/generate": { "post": { "operationId": "generateStepReport_2_0", "summary": "Generate a Step Report", "description": "Generates the Step Report for an Agent with the given filters", "tags": [ "Insights Beta" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "projectId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "timezoneOffset": { "type": "string" }, "direction": { "type": "string" }, "startingStepIdsForPagination": { "type": "array", "items": { "type": "string" } }, "limit": { "type": "number", "enum": [ "forward", "reverse" ] }, "startingStepId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "containingStepId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "filters": { "type": "array", "items": { "type": "object", "properties": { "field": { "type": "string" }, "operator": { "type": "string", "enum": [ "equals", "notEquals", "gt", "gte", "lt", "lte" ] }, "values": { "type": "array", "items": { "type": "string" } } } } } } } } } }, "responses": { "202": { "description": "Successfully started to generate the report", "content": { "application/json": { "schema": { "type": "object", "properties": { "queryHash": { "type": "string" } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/insights/beta/steps": { "get": { "operationId": "indexSteps_2_0", "summary": "Get Steps", "description": "Get 25 [Steps](https://docs.cognigy.com/ai/tools/analytics/analytics-concepts/#steps) in a project or snapshot by deafult. To change the default value, use the `limit` query parameter. Additionally, you can filter, sort, and paginate the results.", "tags": [ "Insights Beta" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "query", "name": "projectId", "description": "Filter by projectId", "required": false, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "query", "name": "limit", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100 }, "description": "The maximum number of items to return. The default is 25." }, { "in": "query", "name": "skip", "required": false, "schema": { "type": "integer", "minimum": 0 }, "description": "The number of items to skip. The default is 0. Used along with a limit of a pagination." }, { "in": "query", "name": "sort", "required": false, "schema": { "type": "string", "minLength": 1 }, "description": "The order of the sorting items-`Desc` (descending) or `Asc` (ascending). For example, to sort the records by name in ascending order, specify `name:Asc`." }, { "in": "query", "name": "next", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the nextCursor value from the response to get the next set of records. Used along with limit for pagination." }, { "in": "query", "name": "previous", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the previousCursor value from the response to get the previous set of records. Used along with limit for pagination." } ], "responses": { "200": { "description": "Returns array of a Step metadata objects", "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "label": { "type": "string" }, "type": { "type": "string", "enum": [ "intent", "node" ] }, "entityReferenceId": { "type": "string" }, "flowReferenceId": { "type": "string" }, "flowName": { "type": "string" }, "snapshotName": { "type": "string" }, "snapshotId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } }, "total": { "type": "integer", "example": 1 }, "next": { "oneOf": [ { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, { "nullable": true } ], "example": "5ce7c2d833ea1e04d7e6c432" }, "previous": { "oneOf": [ { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, { "nullable": true } ], "example": null } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/insights/beta/steps/report/{queryHash}": { "get": { "operationId": "loadStepReportByQueryHash_2_0", "summary": "Get Step Report by queryHash", "description": "Get Step Report in by queryHash a project or snapshot.", "tags": [ "Insights Beta" ], "parameters": [ { "name": "queryHash", "in": "path", "description": "Query Hash", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Returns the report that is referenced by the query hash", "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "type": "string", "enum": [ "pending", "done", "error" ] }, "data": { "type": "object", "properties": { "_id": { "type": "string" }, "step": { "type": "string" }, "type": { "type": "string", "enum": [ "intent", "node" ] }, "count": { "type": "number" }, "flowReferenceId": { "type": "string" }, "flowName": { "type": "string" }, "entityReferenceId": { "type": "string" }, "children": { "type": "array", "items": { "type": "object" } } }, "example": { "step": "Collect Email", "type": "node", "count": 10, "flowReferenceId": "5dcf4edd-e5da-4bdc-837f-f482f8b90f47", "flowName": "Main", "entityReferenceId": "9f5078b4-2c0e-4e62-a1a3-9f5c1db89ee9", "children": [ { "step": "Find Bookings", "type": "node", "count": 8, "flowReferenceId": "5dcf4edd-e5da-4bdc-837f-f482f8b90f47", "flowName": "Main", "entityReferenceId": "d623f450-ce35-4872-9842-3071ade1430f" }, { "step": "Help", "type": "intent", "count": 2, "flowReferenceId": "5dcf4edd-e5da-4bdc-837f-f482f8b90f47", "flowName": "Main", "entityReferenceId": "bfdb0179-32c2-4d5c-bf42-8882f14824a2" } ] } } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/insights/beta/transcripts/report/generate": { "post": { "operationId": "generateTranscripts_2_0", "summary": "Generate transcripts", "description": "Generates [transcripts](doc:conversation).", "tags": [ "Insights Beta" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "query", "name": "search", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "limit", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100 }, "description": "The maximum number of items to return. The default is 25." }, { "in": "query", "name": "skip", "required": false, "schema": { "type": "integer", "minimum": 0 }, "description": "The number of items to skip. The default is 0. Used along with a limit of a pagination." }, { "in": "query", "name": "sort", "required": false, "schema": { "type": "string", "minLength": 1 }, "description": "The order of the sorting items-`Desc` (descending) or `Asc` (ascending). For example, to sort the records by name in ascending order, specify `name:Asc`." }, { "in": "query", "name": "next", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the nextCursor value from the response to get the next set of records. Used along with limit for pagination." }, { "in": "query", "name": "previous", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the previousCursor value from the response to get the previous set of records. Used along with limit for pagination." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "projectId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "stepPath": { "type": "object", "properties": { "value": { "type": "string" }, "match": { "type": "string" } } }, "timezoneOffset": { "type": "string" }, "filters": { "type": "array", "items": { "type": "object", "properties": { "field": { "type": "string" }, "operator": { "type": "string", "enum": [ "equals", "notEquals", "gt", "gte", "lt", "lte" ] }, "values": { "type": "array", "items": { "type": "string" } } } } } } } } } }, "responses": { "202": { "description": "Successfully started to generate the report", "content": { "application/json": { "schema": { "type": "object", "properties": { "queryHash": { "type": "string" } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/insights/beta/transcripts/report/{queryHash}": { "get": { "operationId": "loadTranscriptsReportByQueryHash_2_0", "summary": "Get Transcripts Report by queryHash", "description": "Get Transcripts Report in by queryHash a project or snapshot.", "tags": [ "Insights Beta" ], "parameters": [ { "name": "queryHash", "in": "path", "description": "Query Hash", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Returns the report that is referenced by the query hash", "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "type": "string", "enum": [ "pending", "done", "error" ] }, "data": { "type": "array", "items": { "type": "object", "properties": { "_id": { "type": "string" }, "contactId": { "type": "string" }, "channel": { "type": "string", "example": "webchat2", "enum": [ "facebook", "alexa", "slack", "generic", "inject", "rest", "realtime", "socket", "adminconsole", "webchat2", "dialogflow", "twilio", "twilio-sms", "line", "intercom", "microsoftBotFramework", "microsoftTeams", "sunshineConversations", "admin-webchat", "avaya", "nonConversational", "voiceGateway2", "amazonLex", "workplace", "webhook", "abstractRest", "userlike", "ringCentralEngage", "audioCodes", "bandwidth", "whatsapp", "eightByEight", "genesysBotConnector", "niceCXOne", "agentAssistVoice", "webchat3" ] }, "projectId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "projectName": { "type": "string" }, "flowName": { "type": "string" }, "messages": { "type": "integer" }, "startTime": { "type": "string" }, "endTime": { "type": "string" }, "ratings": { "type": "array", "items": { "type": "number" } }, "ratingComments": { "type": "array", "items": { "type": "string" } }, "endpointName": { "type": "string" } } } } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/management/v2.0/organisations": { "post": { "operationId": "createOrganisation_2_0", "summary": "Creates a new organisation.", "description": "Creates a new organisation within the system.", "tags": [ "Management v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "properties": { "name": { "type": "string", "description": "The name of this organisation" }, "disabled": { "type": "boolean", "description": "Flag whether this organisation is currently disabled" }, "quotaMaxProjects": { "type": "number" }, "quotaMaxUsers": { "type": "number" }, "quotaMaxChannelsPerProject": { "type": "number" }, "quotaMaxMessagesPerDay": { "type": "number" }, "quotaMaxKnowledgeChunks": { "type": "number" }, "passwordPolicy": { "type": "object", "properties": { "minLength": { "type": "integer" }, "maxLength": { "type": "integer" }, "minAmountLowerCase": { "type": "integer" }, "minAmountUpperCase": { "type": "integer" }, "minAmountSpecialCharacters": { "type": "integer" }, "minAmountNumbers": { "type": "integer" }, "maxAmountIdenticalCharacters": { "type": "integer" }, "minAmountFailedAttemptsAutoDisable": { "type": "integer" } } }, "sessionStateTTLInMinutes": { "type": "number" }, "contactProfileTTLInMinutes": { "type": "number" }, "conversationTTLInMinutes": { "type": "number" }, "billingTimezone": { "type": "string", "description": "Timezone according to IANA Timezone Database (2020a)", "example": "Europe/Berlin", "enum": [ "Africa/Abidjan", "Africa/Accra", "Africa/Addis_Ababa", "Africa/Algiers", "Africa/Asmara", "Africa/Asmera", "Africa/Bamako", "Africa/Bangui", "Africa/Banjul", "Africa/Bissau", "Africa/Blantyre", "Africa/Brazzaville", "Africa/Bujumbura", "Africa/Cairo", "Africa/Casablanca", "Africa/Ceuta", "Africa/Conakry", "Africa/Dakar", "Africa/Dar_es_Salaam", "Africa/Djibouti", "Africa/Douala", "Africa/El_Aaiun", "Africa/Freetown", "Africa/Gaborone", "Africa/Harare", "Africa/Johannesburg", "Africa/Juba", "Africa/Kampala", "Africa/Khartoum", "Africa/Kigali", "Africa/Kinshasa", "Africa/Lagos", "Africa/Libreville", "Africa/Lome", "Africa/Luanda", "Africa/Lubumbashi", "Africa/Lusaka", "Africa/Malabo", "Africa/Maputo", "Africa/Maseru", "Africa/Mbabane", "Africa/Mogadishu", "Africa/Monrovia", "Africa/Nairobi", "Africa/Ndjamena", "Africa/Niamey", "Africa/Nouakchott", "Africa/Ouagadougou", "Africa/Porto-Novo", "Africa/Sao_Tome", "Africa/Timbuktu", "Africa/Tripoli", "Africa/Tunis", "Africa/Windhoek", "America/Adak", "America/Anchorage", "America/Anguilla", "America/Antigua", "America/Araguaina", "America/Argentina/Buenos_Aires", "America/Argentina/Catamarca", "America/Argentina/ComodRivadavia", "America/Argentina/Cordoba", "America/Argentina/Jujuy", "America/Argentina/La_Rioja", "America/Argentina/Mendoza", "America/Argentina/Rio_Gallegos", "America/Argentina/Salta", "America/Argentina/San_Juan", "America/Argentina/San_Luis", "America/Argentina/Tucuman", "America/Argentina/Ushuaia", "America/Aruba", "America/Asuncion", "America/Atikokan", "America/Atka", "America/Bahia", "America/Bahia_Banderas", "America/Barbados", "America/Belem", "America/Belize", "America/Blanc-Sablon", "America/Boa_Vista", "America/Bogota", "America/Boise", "America/Buenos_Aires", "America/Cambridge_Bay", "America/Campo_Grande", "America/Cancun", "America/Caracas", "America/Catamarca", "America/Cayenne", "America/Cayman", "America/Chicago", "America/Chihuahua", "America/Coral_Harbour", "America/Cordoba", "America/Costa_Rica", "America/Creston", "America/Cuiaba", "America/Curacao", "America/Danmarkshavn", "America/Dawson", "America/Dawson_Creek", "America/Denver", "America/Detroit", "America/Dominica", "America/Edmonton", "America/Eirunepe", "America/El_Salvador", "America/Ensenada", "America/Fort_Nelson", "America/Fort_Wayne", "America/Fortaleza", "America/Glace_Bay", "America/Godthab", "America/Goose_Bay", "America/Grand_Turk", "America/Grenada", "America/Guadeloupe", "America/Guatemala", "America/Guayaquil", "America/Guyana", "America/Halifax", "America/Havana", "America/Hermosillo", "America/Indiana/Indianapolis", "America/Indiana/Knox", "America/Indiana/Marengo", "America/Indiana/Petersburg", "America/Indiana/Tell_City", "America/Indiana/Vevay", "America/Indiana/Vincennes", "America/Indiana/Winamac", "America/Indianapolis", "America/Inuvik", "America/Iqaluit", "America/Jamaica", "America/Jujuy", "America/Juneau", "America/Kentucky/Louisville", "America/Kentucky/Monticello", "America/Knox_IN", "America/Kralendijk", "America/La_Paz", "America/Lima", "America/Los_Angeles", "America/Louisville", "America/Lower_Princes", "America/Maceio", "America/Managua", "America/Manaus", "America/Marigot", "America/Martinique", "America/Matamoros", "America/Mazatlan", "America/Mendoza", "America/Menominee", "America/Merida", "America/Metlakatla", "America/Mexico_City", "America/Miquelon", "America/Moncton", "America/Monterrey", "America/Montevideo", "America/Montreal", "America/Montserrat", "America/Nassau", "America/New_York", "America/Nipigon", "America/Nome", "America/Noronha", "America/North_Dakota/Beulah", "America/North_Dakota/Center", "America/North_Dakota/New_Salem", "America/Ojinaga", "America/Panama", "America/Pangnirtung", "America/Paramaribo", "America/Phoenix", "America/Port-au-Prince", "America/Port_of_Spain", "America/Porto_Acre", "America/Porto_Velho", "America/Puerto_Rico", "America/Punta_Arenas", "America/Rainy_River", "America/Rankin_Inlet", "America/Recife", "America/Regina", "America/Resolute", "America/Rio_Branco", "America/Rosario", "America/Santa_Isabel", "America/Santarem", "America/Santiago", "America/Santo_Domingo", "America/Sao_Paulo", "America/Scoresbysund", "America/Shiprock", "America/Sitka", "America/St_Barthelemy", "America/St_Johns", "America/St_Kitts", "America/St_Lucia", "America/St_Thomas", "America/St_Vincent", "America/Swift_Current", "America/Tegucigalpa", "America/Thule", "America/Thunder_Bay", "America/Tijuana", "America/Toronto", "America/Tortola", "America/Vancouver", "America/Virgin", "America/Whitehorse", "America/Winnipeg", "America/Yakutat", "America/Yellowknife", "Antarctica/Casey", "Antarctica/Davis", "Antarctica/DumontDUrville", "Antarctica/Macquarie", "Antarctica/Mawson", "Antarctica/McMurdo", "Antarctica/Palmer", "Antarctica/Rothera", "Antarctica/South_Pole", "Antarctica/Syowa", "Antarctica/Troll", "Antarctica/Vostok", "Arctic/Longyearbyen", "Asia/Aden", "Asia/Almaty", "Asia/Amman", "Asia/Anadyr", "Asia/Aqtau", "Asia/Aqtobe", "Asia/Ashgabat", "Asia/Ashkhabad", "Asia/Atyrau", "Asia/Baghdad", "Asia/Bahrain", "Asia/Baku", "Asia/Bangkok", "Asia/Barnaul", "Asia/Beirut", "Asia/Bishkek", "Asia/Brunei", "Asia/Calcutta", "Asia/Chita", "Asia/Choibalsan", "Asia/Chongqing", "Asia/Chungking", "Asia/Colombo", "Asia/Dacca", "Asia/Damascus", "Asia/Dhaka", "Asia/Dili", "Asia/Dubai", "Asia/Dushanbe", "Asia/Famagusta", "Asia/Gaza", "Asia/Harbin", "Asia/Hebron", "Asia/Ho_Chi_Minh", "Asia/Hong_Kong", "Asia/Hovd", "Asia/Irkutsk", "Asia/Istanbul", "Asia/Jakarta", "Asia/Jayapura", "Asia/Jerusalem", "Asia/Kabul", "Asia/Kamchatka", "Asia/Karachi", "Asia/Kashgar", "Asia/Kathmandu", "Asia/Katmandu", "Asia/Khandyga", "Asia/Kolkata", "Asia/Krasnoyarsk", "Asia/Kuala_Lumpur", "Asia/Kuching", "Asia/Kuwait", "Asia/Macao", "Asia/Macau", "Asia/Magadan", "Asia/Makassar", "Asia/Manila", "Asia/Muscat", "Asia/Nicosia", "Asia/Novokuznetsk", "Asia/Novosibirsk", "Asia/Omsk", "Asia/Oral", "Asia/Phnom_Penh", "Asia/Pontianak", "Asia/Pyongyang", "Asia/Qatar", "Asia/Qyzylorda", "Asia/Rangoon", "Asia/Riyadh", "Asia/Saigon", "Asia/Sakhalin", "Asia/Samarkand", "Asia/Seoul", "Asia/Shanghai", "Asia/Singapore", "Asia/Srednekolymsk", "Asia/Taipei", "Asia/Tashkent", "Asia/Tbilisi", "Asia/Tehran", "Asia/Tel_Aviv", "Asia/Thimbu", "Asia/Thimphu", "Asia/Tokyo", "Asia/Tomsk", "Asia/Ujung_Pandang", "Asia/Ulaanbaatar", "Asia/Ulan_Bator", "Asia/Urumqi", "Asia/Ust-Nera", "Asia/Vientiane", "Asia/Vladivostok", "Asia/Yakutsk", "Asia/Yangon", "Asia/Yekaterinburg", "Asia/Yerevan", "Atlantic/Azores", "Atlantic/Bermuda", "Atlantic/Canary", "Atlantic/Cape_Verde", "Atlantic/Faeroe", "Atlantic/Faroe", "Atlantic/Jan_Mayen", "Atlantic/Madeira", "Atlantic/Reykjavik", "Atlantic/South_Georgia", "Atlantic/St_Helena", "Atlantic/Stanley", "Australia/ACT", "Australia/Adelaide", "Australia/Brisbane", "Australia/Broken_Hill", "Australia/Canberra", "Australia/Currie", "Australia/Darwin", "Australia/Eucla", "Australia/Hobart", "Australia/LHI", "Australia/Lindeman", "Australia/Lord_Howe", "Australia/Melbourne", "Australia/NSW", "Australia/North", "Australia/Perth", "Australia/Queensland", "Australia/South", "Australia/Sydney", "Australia/Tasmania", "Australia/Victoria", "Australia/West", "Australia/Yancowinna", "Brazil/Acre", "Brazil/DeNoronha", "Brazil/East", "Brazil/West", "CET", "CST6CDT", "Canada/Atlantic", "Canada/Central", "Canada/Eastern", "Canada/Mountain", "Canada/Newfoundland", "Canada/Pacific", "Canada/Saskatchewan", "Canada/Yukon", "Chile/Continental", "Chile/EasterIsland", "Cuba", "EET", "EST", "EST5EDT", "Egypt", "Eire", "Etc/GMT", "Etc/GMT+0", "Etc/GMT+1", "Etc/GMT+10", "Etc/GMT+11", "Etc/GMT+12", "Etc/GMT+2", "Etc/GMT+3", "Etc/GMT+4", "Etc/GMT+5", "Etc/GMT+6", "Etc/GMT+7", "Etc/GMT+8", "Etc/GMT+9", "Etc/GMT-0", "Etc/GMT-1", "Etc/GMT-10", "Etc/GMT-11", "Etc/GMT-12", "Etc/GMT-13", "Etc/GMT-14", "Etc/GMT-2", "Etc/GMT-3", "Etc/GMT-4", "Etc/GMT-5", "Etc/GMT-6", "Etc/GMT-7", "Etc/GMT-8", "Etc/GMT-9", "Etc/GMT0", "Etc/Greenwich", "Etc/UCT", "Etc/UTC", "Etc/Universal", "Etc/Zulu", "Europe/Amsterdam", "Europe/Andorra", "Europe/Astrakhan", "Europe/Athens", "Europe/Belfast", "Europe/Belgrade", "Europe/Berlin", "Europe/Bratislava", "Europe/Brussels", "Europe/Bucharest", "Europe/Budapest", "Europe/Busingen", "Europe/Chisinau", "Europe/Copenhagen", "Europe/Dublin", "Europe/Gibraltar", "Europe/Guernsey", "Europe/Helsinki", "Europe/Isle_of_Man", "Europe/Istanbul", "Europe/Jersey", "Europe/Kaliningrad", "Europe/Kiev", "Europe/Kirov", "Europe/Lisbon", "Europe/Ljubljana", "Europe/London", "Europe/Luxembourg", "Europe/Madrid", "Europe/Malta", "Europe/Mariehamn", "Europe/Minsk", "Europe/Monaco", "Europe/Moscow", "Europe/Nicosia", "Europe/Oslo", "Europe/Paris", "Europe/Podgorica", "Europe/Prague", "Europe/Riga", "Europe/Rome", "Europe/Samara", "Europe/San_Marino", "Europe/Sarajevo", "Europe/Saratov", "Europe/Simferopol", "Europe/Skopje", "Europe/Sofia", "Europe/Stockholm", "Europe/Tallinn", "Europe/Tirane", "Europe/Tiraspol", "Europe/Ulyanovsk", "Europe/Uzhgorod", "Europe/Vaduz", "Europe/Vatican", "Europe/Vienna", "Europe/Vilnius", "Europe/Volgograd", "Europe/Warsaw", "Europe/Zagreb", "Europe/Zaporozhye", "Europe/Zurich", "GB", "GB-Eire", "GMT", "GMT+0", "GMT-0", "GMT0", "Greenwich", "HST", "Hongkong", "Iceland", "Indian/Antananarivo", "Indian/Chagos", "Indian/Christmas", "Indian/Cocos", "Indian/Comoro", "Indian/Kerguelen", "Indian/Mahe", "Indian/Maldives", "Indian/Mauritius", "Indian/Mayotte", "Indian/Reunion", "Iran", "Israel", "Jamaica", "Japan", "Kwajalein", "Libya", "MET", "MST", "MST7MDT", "Mexico/BajaNorte", "Mexico/BajaSur", "Mexico/General", "NZ", "NZ-CHAT", "Navajo", "PRC", "PST8PDT", "Pacific/Apia", "Pacific/Auckland", "Pacific/Bougainville", "Pacific/Chatham", "Pacific/Chuuk", "Pacific/Easter", "Pacific/Efate", "Pacific/Enderbury", "Pacific/Fakaofo", "Pacific/Fiji", "Pacific/Funafuti", "Pacific/Galapagos", "Pacific/Gambier", "Pacific/Guadalcanal", "Pacific/Guam", "Pacific/Honolulu", "Pacific/Johnston", "Pacific/Kiritimati", "Pacific/Kosrae", "Pacific/Kwajalein", "Pacific/Majuro", "Pacific/Marquesas", "Pacific/Midway", "Pacific/Nauru", "Pacific/Niue", "Pacific/Norfolk", "Pacific/Noumea", "Pacific/Pago_Pago", "Pacific/Palau", "Pacific/Pitcairn", "Pacific/Pohnpei", "Pacific/Ponape", "Pacific/Port_Moresby", "Pacific/Rarotonga", "Pacific/Saipan", "Pacific/Samoa", "Pacific/Tahiti", "Pacific/Tarawa", "Pacific/Tongatapu", "Pacific/Truk", "Pacific/Wake", "Pacific/Wallis", "Pacific/Yap", "Poland", "Portugal", "ROC", "ROK", "Singapore", "Turkey", "UCT", "US/Alaska", "US/Aleutian", "US/Arizona", "US/Central", "US/East-Indiana", "US/Eastern", "US/Hawaii", "US/Indiana-Starke", "US/Michigan", "US/Mountain", "US/Pacific", "US/Pacific-New", "US/Samoa", "UTC", "Universal", "W-SU", "WET", "Zulu" ] }, "dataPrivacySettings": { "type": "object", "properties": { "enabled": { "type": "boolean" }, "useAnalytics": { "type": "boolean" }, "useContactProfiles": { "type": "boolean" }, "useConversations": { "type": "boolean" }, "maskAnalytics": { "type": "boolean" }, "maskLogging": { "type": "boolean" }, "ignoreList": { "type": "array", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } } }, "required": [ "name" ], "type": "object" } } } }, "responses": { "201": { "description": "Returns the new organisation.", "content": { "application/json": { "schema": { "properties": { "name": { "type": "string", "description": "The name of this organisation" }, "disabled": { "type": "boolean", "description": "Flag whether this organisation is currently disabled" }, "quotaMaxProjects": { "type": "number" }, "quotaMaxUsers": { "type": "number" }, "quotaMaxChannelsPerProject": { "type": "number" }, "quotaMaxMessagesPerDay": { "type": "number" }, "quotaMaxKnowledgeChunks": { "type": "number" }, "passwordPolicy": { "type": "object", "properties": { "minLength": { "type": "integer" }, "maxLength": { "type": "integer" }, "minAmountLowerCase": { "type": "integer" }, "minAmountUpperCase": { "type": "integer" }, "minAmountSpecialCharacters": { "type": "integer" }, "minAmountNumbers": { "type": "integer" }, "maxAmountIdenticalCharacters": { "type": "integer" }, "minAmountFailedAttemptsAutoDisable": { "type": "integer" } } }, "sessionStateTTLInMinutes": { "type": "number" }, "contactProfileTTLInMinutes": { "type": "number" }, "conversationTTLInMinutes": { "type": "number" }, "billingTimezone": { "type": "string", "description": "Timezone according to IANA Timezone Database (2020a)", "example": "Europe/Berlin", "enum": [ "Africa/Abidjan", "Africa/Accra", "Africa/Addis_Ababa", "Africa/Algiers", "Africa/Asmara", "Africa/Asmera", "Africa/Bamako", "Africa/Bangui", "Africa/Banjul", "Africa/Bissau", "Africa/Blantyre", "Africa/Brazzaville", "Africa/Bujumbura", "Africa/Cairo", "Africa/Casablanca", "Africa/Ceuta", "Africa/Conakry", "Africa/Dakar", "Africa/Dar_es_Salaam", "Africa/Djibouti", "Africa/Douala", "Africa/El_Aaiun", "Africa/Freetown", "Africa/Gaborone", "Africa/Harare", "Africa/Johannesburg", "Africa/Juba", "Africa/Kampala", "Africa/Khartoum", "Africa/Kigali", "Africa/Kinshasa", "Africa/Lagos", "Africa/Libreville", "Africa/Lome", "Africa/Luanda", "Africa/Lubumbashi", "Africa/Lusaka", "Africa/Malabo", "Africa/Maputo", "Africa/Maseru", "Africa/Mbabane", "Africa/Mogadishu", "Africa/Monrovia", "Africa/Nairobi", "Africa/Ndjamena", "Africa/Niamey", "Africa/Nouakchott", "Africa/Ouagadougou", "Africa/Porto-Novo", "Africa/Sao_Tome", "Africa/Timbuktu", "Africa/Tripoli", "Africa/Tunis", "Africa/Windhoek", "America/Adak", "America/Anchorage", "America/Anguilla", "America/Antigua", "America/Araguaina", "America/Argentina/Buenos_Aires", "America/Argentina/Catamarca", "America/Argentina/ComodRivadavia", "America/Argentina/Cordoba", "America/Argentina/Jujuy", "America/Argentina/La_Rioja", "America/Argentina/Mendoza", "America/Argentina/Rio_Gallegos", "America/Argentina/Salta", "America/Argentina/San_Juan", "America/Argentina/San_Luis", "America/Argentina/Tucuman", "America/Argentina/Ushuaia", "America/Aruba", "America/Asuncion", "America/Atikokan", "America/Atka", "America/Bahia", "America/Bahia_Banderas", "America/Barbados", "America/Belem", "America/Belize", "America/Blanc-Sablon", "America/Boa_Vista", "America/Bogota", "America/Boise", "America/Buenos_Aires", "America/Cambridge_Bay", "America/Campo_Grande", "America/Cancun", "America/Caracas", "America/Catamarca", "America/Cayenne", "America/Cayman", "America/Chicago", "America/Chihuahua", "America/Coral_Harbour", "America/Cordoba", "America/Costa_Rica", "America/Creston", "America/Cuiaba", "America/Curacao", "America/Danmarkshavn", "America/Dawson", "America/Dawson_Creek", "America/Denver", "America/Detroit", "America/Dominica", "America/Edmonton", "America/Eirunepe", "America/El_Salvador", "America/Ensenada", "America/Fort_Nelson", "America/Fort_Wayne", "America/Fortaleza", "America/Glace_Bay", "America/Godthab", "America/Goose_Bay", "America/Grand_Turk", "America/Grenada", "America/Guadeloupe", "America/Guatemala", "America/Guayaquil", "America/Guyana", "America/Halifax", "America/Havana", "America/Hermosillo", "America/Indiana/Indianapolis", "America/Indiana/Knox", "America/Indiana/Marengo", "America/Indiana/Petersburg", "America/Indiana/Tell_City", "America/Indiana/Vevay", "America/Indiana/Vincennes", "America/Indiana/Winamac", "America/Indianapolis", "America/Inuvik", "America/Iqaluit", "America/Jamaica", "America/Jujuy", "America/Juneau", "America/Kentucky/Louisville", "America/Kentucky/Monticello", "America/Knox_IN", "America/Kralendijk", "America/La_Paz", "America/Lima", "America/Los_Angeles", "America/Louisville", "America/Lower_Princes", "America/Maceio", "America/Managua", "America/Manaus", "America/Marigot", "America/Martinique", "America/Matamoros", "America/Mazatlan", "America/Mendoza", "America/Menominee", "America/Merida", "America/Metlakatla", "America/Mexico_City", "America/Miquelon", "America/Moncton", "America/Monterrey", "America/Montevideo", "America/Montreal", "America/Montserrat", "America/Nassau", "America/New_York", "America/Nipigon", "America/Nome", "America/Noronha", "America/North_Dakota/Beulah", "America/North_Dakota/Center", "America/North_Dakota/New_Salem", "America/Ojinaga", "America/Panama", "America/Pangnirtung", "America/Paramaribo", "America/Phoenix", "America/Port-au-Prince", "America/Port_of_Spain", "America/Porto_Acre", "America/Porto_Velho", "America/Puerto_Rico", "America/Punta_Arenas", "America/Rainy_River", "America/Rankin_Inlet", "America/Recife", "America/Regina", "America/Resolute", "America/Rio_Branco", "America/Rosario", "America/Santa_Isabel", "America/Santarem", "America/Santiago", "America/Santo_Domingo", "America/Sao_Paulo", "America/Scoresbysund", "America/Shiprock", "America/Sitka", "America/St_Barthelemy", "America/St_Johns", "America/St_Kitts", "America/St_Lucia", "America/St_Thomas", "America/St_Vincent", "America/Swift_Current", "America/Tegucigalpa", "America/Thule", "America/Thunder_Bay", "America/Tijuana", "America/Toronto", "America/Tortola", "America/Vancouver", "America/Virgin", "America/Whitehorse", "America/Winnipeg", "America/Yakutat", "America/Yellowknife", "Antarctica/Casey", "Antarctica/Davis", "Antarctica/DumontDUrville", "Antarctica/Macquarie", "Antarctica/Mawson", "Antarctica/McMurdo", "Antarctica/Palmer", "Antarctica/Rothera", "Antarctica/South_Pole", "Antarctica/Syowa", "Antarctica/Troll", "Antarctica/Vostok", "Arctic/Longyearbyen", "Asia/Aden", "Asia/Almaty", "Asia/Amman", "Asia/Anadyr", "Asia/Aqtau", "Asia/Aqtobe", "Asia/Ashgabat", "Asia/Ashkhabad", "Asia/Atyrau", "Asia/Baghdad", "Asia/Bahrain", "Asia/Baku", "Asia/Bangkok", "Asia/Barnaul", "Asia/Beirut", "Asia/Bishkek", "Asia/Brunei", "Asia/Calcutta", "Asia/Chita", "Asia/Choibalsan", "Asia/Chongqing", "Asia/Chungking", "Asia/Colombo", "Asia/Dacca", "Asia/Damascus", "Asia/Dhaka", "Asia/Dili", "Asia/Dubai", "Asia/Dushanbe", "Asia/Famagusta", "Asia/Gaza", "Asia/Harbin", "Asia/Hebron", "Asia/Ho_Chi_Minh", "Asia/Hong_Kong", "Asia/Hovd", "Asia/Irkutsk", "Asia/Istanbul", "Asia/Jakarta", "Asia/Jayapura", "Asia/Jerusalem", "Asia/Kabul", "Asia/Kamchatka", "Asia/Karachi", "Asia/Kashgar", "Asia/Kathmandu", "Asia/Katmandu", "Asia/Khandyga", "Asia/Kolkata", "Asia/Krasnoyarsk", "Asia/Kuala_Lumpur", "Asia/Kuching", "Asia/Kuwait", "Asia/Macao", "Asia/Macau", "Asia/Magadan", "Asia/Makassar", "Asia/Manila", "Asia/Muscat", "Asia/Nicosia", "Asia/Novokuznetsk", "Asia/Novosibirsk", "Asia/Omsk", "Asia/Oral", "Asia/Phnom_Penh", "Asia/Pontianak", "Asia/Pyongyang", "Asia/Qatar", "Asia/Qyzylorda", "Asia/Rangoon", "Asia/Riyadh", "Asia/Saigon", "Asia/Sakhalin", "Asia/Samarkand", "Asia/Seoul", "Asia/Shanghai", "Asia/Singapore", "Asia/Srednekolymsk", "Asia/Taipei", "Asia/Tashkent", "Asia/Tbilisi", "Asia/Tehran", "Asia/Tel_Aviv", "Asia/Thimbu", "Asia/Thimphu", "Asia/Tokyo", "Asia/Tomsk", "Asia/Ujung_Pandang", "Asia/Ulaanbaatar", "Asia/Ulan_Bator", "Asia/Urumqi", "Asia/Ust-Nera", "Asia/Vientiane", "Asia/Vladivostok", "Asia/Yakutsk", "Asia/Yangon", "Asia/Yekaterinburg", "Asia/Yerevan", "Atlantic/Azores", "Atlantic/Bermuda", "Atlantic/Canary", "Atlantic/Cape_Verde", "Atlantic/Faeroe", "Atlantic/Faroe", "Atlantic/Jan_Mayen", "Atlantic/Madeira", "Atlantic/Reykjavik", "Atlantic/South_Georgia", "Atlantic/St_Helena", "Atlantic/Stanley", "Australia/ACT", "Australia/Adelaide", "Australia/Brisbane", "Australia/Broken_Hill", "Australia/Canberra", "Australia/Currie", "Australia/Darwin", "Australia/Eucla", "Australia/Hobart", "Australia/LHI", "Australia/Lindeman", "Australia/Lord_Howe", "Australia/Melbourne", "Australia/NSW", "Australia/North", "Australia/Perth", "Australia/Queensland", "Australia/South", "Australia/Sydney", "Australia/Tasmania", "Australia/Victoria", "Australia/West", "Australia/Yancowinna", "Brazil/Acre", "Brazil/DeNoronha", "Brazil/East", "Brazil/West", "CET", "CST6CDT", "Canada/Atlantic", "Canada/Central", "Canada/Eastern", "Canada/Mountain", "Canada/Newfoundland", "Canada/Pacific", "Canada/Saskatchewan", "Canada/Yukon", "Chile/Continental", "Chile/EasterIsland", "Cuba", "EET", "EST", "EST5EDT", "Egypt", "Eire", "Etc/GMT", "Etc/GMT+0", "Etc/GMT+1", "Etc/GMT+10", "Etc/GMT+11", "Etc/GMT+12", "Etc/GMT+2", "Etc/GMT+3", "Etc/GMT+4", "Etc/GMT+5", "Etc/GMT+6", "Etc/GMT+7", "Etc/GMT+8", "Etc/GMT+9", "Etc/GMT-0", "Etc/GMT-1", "Etc/GMT-10", "Etc/GMT-11", "Etc/GMT-12", "Etc/GMT-13", "Etc/GMT-14", "Etc/GMT-2", "Etc/GMT-3", "Etc/GMT-4", "Etc/GMT-5", "Etc/GMT-6", "Etc/GMT-7", "Etc/GMT-8", "Etc/GMT-9", "Etc/GMT0", "Etc/Greenwich", "Etc/UCT", "Etc/UTC", "Etc/Universal", "Etc/Zulu", "Europe/Amsterdam", "Europe/Andorra", "Europe/Astrakhan", "Europe/Athens", "Europe/Belfast", "Europe/Belgrade", "Europe/Berlin", "Europe/Bratislava", "Europe/Brussels", "Europe/Bucharest", "Europe/Budapest", "Europe/Busingen", "Europe/Chisinau", "Europe/Copenhagen", "Europe/Dublin", "Europe/Gibraltar", "Europe/Guernsey", "Europe/Helsinki", "Europe/Isle_of_Man", "Europe/Istanbul", "Europe/Jersey", "Europe/Kaliningrad", "Europe/Kiev", "Europe/Kirov", "Europe/Lisbon", "Europe/Ljubljana", "Europe/London", "Europe/Luxembourg", "Europe/Madrid", "Europe/Malta", "Europe/Mariehamn", "Europe/Minsk", "Europe/Monaco", "Europe/Moscow", "Europe/Nicosia", "Europe/Oslo", "Europe/Paris", "Europe/Podgorica", "Europe/Prague", "Europe/Riga", "Europe/Rome", "Europe/Samara", "Europe/San_Marino", "Europe/Sarajevo", "Europe/Saratov", "Europe/Simferopol", "Europe/Skopje", "Europe/Sofia", "Europe/Stockholm", "Europe/Tallinn", "Europe/Tirane", "Europe/Tiraspol", "Europe/Ulyanovsk", "Europe/Uzhgorod", "Europe/Vaduz", "Europe/Vatican", "Europe/Vienna", "Europe/Vilnius", "Europe/Volgograd", "Europe/Warsaw", "Europe/Zagreb", "Europe/Zaporozhye", "Europe/Zurich", "GB", "GB-Eire", "GMT", "GMT+0", "GMT-0", "GMT0", "Greenwich", "HST", "Hongkong", "Iceland", "Indian/Antananarivo", "Indian/Chagos", "Indian/Christmas", "Indian/Cocos", "Indian/Comoro", "Indian/Kerguelen", "Indian/Mahe", "Indian/Maldives", "Indian/Mauritius", "Indian/Mayotte", "Indian/Reunion", "Iran", "Israel", "Jamaica", "Japan", "Kwajalein", "Libya", "MET", "MST", "MST7MDT", "Mexico/BajaNorte", "Mexico/BajaSur", "Mexico/General", "NZ", "NZ-CHAT", "Navajo", "PRC", "PST8PDT", "Pacific/Apia", "Pacific/Auckland", "Pacific/Bougainville", "Pacific/Chatham", "Pacific/Chuuk", "Pacific/Easter", "Pacific/Efate", "Pacific/Enderbury", "Pacific/Fakaofo", "Pacific/Fiji", "Pacific/Funafuti", "Pacific/Galapagos", "Pacific/Gambier", "Pacific/Guadalcanal", "Pacific/Guam", "Pacific/Honolulu", "Pacific/Johnston", "Pacific/Kiritimati", "Pacific/Kosrae", "Pacific/Kwajalein", "Pacific/Majuro", "Pacific/Marquesas", "Pacific/Midway", "Pacific/Nauru", "Pacific/Niue", "Pacific/Norfolk", "Pacific/Noumea", "Pacific/Pago_Pago", "Pacific/Palau", "Pacific/Pitcairn", "Pacific/Pohnpei", "Pacific/Ponape", "Pacific/Port_Moresby", "Pacific/Rarotonga", "Pacific/Saipan", "Pacific/Samoa", "Pacific/Tahiti", "Pacific/Tarawa", "Pacific/Tongatapu", "Pacific/Truk", "Pacific/Wake", "Pacific/Wallis", "Pacific/Yap", "Poland", "Portugal", "ROC", "ROK", "Singapore", "Turkey", "UCT", "US/Alaska", "US/Aleutian", "US/Arizona", "US/Central", "US/East-Indiana", "US/Eastern", "US/Hawaii", "US/Indiana-Starke", "US/Michigan", "US/Mountain", "US/Pacific", "US/Pacific-New", "US/Samoa", "UTC", "Universal", "W-SU", "WET", "Zulu" ] }, "dataPrivacySettings": { "type": "object", "properties": { "enabled": { "type": "boolean" }, "useAnalytics": { "type": "boolean" }, "useContactProfiles": { "type": "boolean" }, "useConversations": { "type": "boolean" }, "maskAnalytics": { "type": "boolean" }, "maskLogging": { "type": "boolean" }, "ignoreList": { "type": "array", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } } }, "required": [ "name" ], "type": "object" } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "BasicAuth": [] } ] }, "get": { "operationId": "indexOrganisations_2_0", "summary": "Get organisations.", "description": "Get 25 organisations in the system by default. To change the default value, use the `limit` query parameter. Additionally, you can filter, sort, and paginate the results.", "tags": [ "Management v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "query", "name": "filter", "required": false, "schema": { "type": "string" }, "description": "The name of the organisation to filter the records" }, { "in": "query", "name": "limit", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100 }, "description": "The maximum number of items to return. The default is 25." }, { "in": "query", "name": "skip", "required": false, "schema": { "type": "integer", "minimum": 0 }, "description": "The number of items to skip. The default is 0. Used along with a limit of a pagination." }, { "in": "query", "name": "sort", "required": false, "schema": { "type": "string", "minLength": 1 }, "description": "The order of the sorting items-`Desc` (descending) or `Asc` (ascending). For example, to sort the records by name in ascending order, specify `name:Asc`." }, { "in": "query", "name": "next", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the nextCursor value from the response to get the next set of records. Used along with limit for pagination." }, { "in": "query", "name": "previous", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the previousCursor value from the response to get the previous set of records. Used along with limit for pagination." } ], "responses": { "200": { "description": "Returns metadata objects for each organisation in the system.", "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "name": { "type": "string", "description": "The name of this organisation" }, "disabled": { "type": "boolean", "description": "Flag whether this organisation is currently disabled" }, "quotaMaxProjects": { "type": "number" }, "quotaMaxUsers": { "type": "number" }, "quotaMaxChannelsPerProject": { "type": "number" }, "quotaMaxMessagesPerDay": { "type": "number" }, "quotaMaxKnowledgeChunks": { "type": "number" }, "passwordPolicy": { "type": "object", "properties": { "minLength": { "type": "integer" }, "maxLength": { "type": "integer" }, "minAmountLowerCase": { "type": "integer" }, "minAmountUpperCase": { "type": "integer" }, "minAmountSpecialCharacters": { "type": "integer" }, "minAmountNumbers": { "type": "integer" }, "maxAmountIdenticalCharacters": { "type": "integer" }, "minAmountFailedAttemptsAutoDisable": { "type": "integer" } } }, "sessionStateTTLInMinutes": { "type": "number" }, "contactProfileTTLInMinutes": { "type": "number" }, "conversationTTLInMinutes": { "type": "number" }, "liveAgentAccount": { "type": "number" }, "billingTimezone": { "type": "string", "description": "Timezone according to IANA Timezone Database (2020a)", "example": "Europe/Berlin", "enum": [ "Africa/Abidjan", "Africa/Accra", "Africa/Addis_Ababa", "Africa/Algiers", "Africa/Asmara", "Africa/Asmera", "Africa/Bamako", "Africa/Bangui", "Africa/Banjul", "Africa/Bissau", "Africa/Blantyre", "Africa/Brazzaville", "Africa/Bujumbura", "Africa/Cairo", "Africa/Casablanca", "Africa/Ceuta", "Africa/Conakry", "Africa/Dakar", "Africa/Dar_es_Salaam", "Africa/Djibouti", "Africa/Douala", "Africa/El_Aaiun", "Africa/Freetown", "Africa/Gaborone", "Africa/Harare", "Africa/Johannesburg", "Africa/Juba", "Africa/Kampala", "Africa/Khartoum", "Africa/Kigali", "Africa/Kinshasa", "Africa/Lagos", "Africa/Libreville", "Africa/Lome", "Africa/Luanda", "Africa/Lubumbashi", "Africa/Lusaka", "Africa/Malabo", "Africa/Maputo", "Africa/Maseru", "Africa/Mbabane", "Africa/Mogadishu", "Africa/Monrovia", "Africa/Nairobi", "Africa/Ndjamena", "Africa/Niamey", "Africa/Nouakchott", "Africa/Ouagadougou", "Africa/Porto-Novo", "Africa/Sao_Tome", "Africa/Timbuktu", "Africa/Tripoli", "Africa/Tunis", "Africa/Windhoek", "America/Adak", "America/Anchorage", "America/Anguilla", "America/Antigua", "America/Araguaina", "America/Argentina/Buenos_Aires", "America/Argentina/Catamarca", "America/Argentina/ComodRivadavia", "America/Argentina/Cordoba", "America/Argentina/Jujuy", "America/Argentina/La_Rioja", "America/Argentina/Mendoza", "America/Argentina/Rio_Gallegos", "America/Argentina/Salta", "America/Argentina/San_Juan", "America/Argentina/San_Luis", "America/Argentina/Tucuman", "America/Argentina/Ushuaia", "America/Aruba", "America/Asuncion", "America/Atikokan", "America/Atka", "America/Bahia", "America/Bahia_Banderas", "America/Barbados", "America/Belem", "America/Belize", "America/Blanc-Sablon", "America/Boa_Vista", "America/Bogota", "America/Boise", "America/Buenos_Aires", "America/Cambridge_Bay", "America/Campo_Grande", "America/Cancun", "America/Caracas", "America/Catamarca", "America/Cayenne", "America/Cayman", "America/Chicago", "America/Chihuahua", "America/Coral_Harbour", "America/Cordoba", "America/Costa_Rica", "America/Creston", "America/Cuiaba", "America/Curacao", "America/Danmarkshavn", "America/Dawson", "America/Dawson_Creek", "America/Denver", "America/Detroit", "America/Dominica", "America/Edmonton", "America/Eirunepe", "America/El_Salvador", "America/Ensenada", "America/Fort_Nelson", "America/Fort_Wayne", "America/Fortaleza", "America/Glace_Bay", "America/Godthab", "America/Goose_Bay", "America/Grand_Turk", "America/Grenada", "America/Guadeloupe", "America/Guatemala", "America/Guayaquil", "America/Guyana", "America/Halifax", "America/Havana", "America/Hermosillo", "America/Indiana/Indianapolis", "America/Indiana/Knox", "America/Indiana/Marengo", "America/Indiana/Petersburg", "America/Indiana/Tell_City", "America/Indiana/Vevay", "America/Indiana/Vincennes", "America/Indiana/Winamac", "America/Indianapolis", "America/Inuvik", "America/Iqaluit", "America/Jamaica", "America/Jujuy", "America/Juneau", "America/Kentucky/Louisville", "America/Kentucky/Monticello", "America/Knox_IN", "America/Kralendijk", "America/La_Paz", "America/Lima", "America/Los_Angeles", "America/Louisville", "America/Lower_Princes", "America/Maceio", "America/Managua", "America/Manaus", "America/Marigot", "America/Martinique", "America/Matamoros", "America/Mazatlan", "America/Mendoza", "America/Menominee", "America/Merida", "America/Metlakatla", "America/Mexico_City", "America/Miquelon", "America/Moncton", "America/Monterrey", "America/Montevideo", "America/Montreal", "America/Montserrat", "America/Nassau", "America/New_York", "America/Nipigon", "America/Nome", "America/Noronha", "America/North_Dakota/Beulah", "America/North_Dakota/Center", "America/North_Dakota/New_Salem", "America/Ojinaga", "America/Panama", "America/Pangnirtung", "America/Paramaribo", "America/Phoenix", "America/Port-au-Prince", "America/Port_of_Spain", "America/Porto_Acre", "America/Porto_Velho", "America/Puerto_Rico", "America/Punta_Arenas", "America/Rainy_River", "America/Rankin_Inlet", "America/Recife", "America/Regina", "America/Resolute", "America/Rio_Branco", "America/Rosario", "America/Santa_Isabel", "America/Santarem", "America/Santiago", "America/Santo_Domingo", "America/Sao_Paulo", "America/Scoresbysund", "America/Shiprock", "America/Sitka", "America/St_Barthelemy", "America/St_Johns", "America/St_Kitts", "America/St_Lucia", "America/St_Thomas", "America/St_Vincent", "America/Swift_Current", "America/Tegucigalpa", "America/Thule", "America/Thunder_Bay", "America/Tijuana", "America/Toronto", "America/Tortola", "America/Vancouver", "America/Virgin", "America/Whitehorse", "America/Winnipeg", "America/Yakutat", "America/Yellowknife", "Antarctica/Casey", "Antarctica/Davis", "Antarctica/DumontDUrville", "Antarctica/Macquarie", "Antarctica/Mawson", "Antarctica/McMurdo", "Antarctica/Palmer", "Antarctica/Rothera", "Antarctica/South_Pole", "Antarctica/Syowa", "Antarctica/Troll", "Antarctica/Vostok", "Arctic/Longyearbyen", "Asia/Aden", "Asia/Almaty", "Asia/Amman", "Asia/Anadyr", "Asia/Aqtau", "Asia/Aqtobe", "Asia/Ashgabat", "Asia/Ashkhabad", "Asia/Atyrau", "Asia/Baghdad", "Asia/Bahrain", "Asia/Baku", "Asia/Bangkok", "Asia/Barnaul", "Asia/Beirut", "Asia/Bishkek", "Asia/Brunei", "Asia/Calcutta", "Asia/Chita", "Asia/Choibalsan", "Asia/Chongqing", "Asia/Chungking", "Asia/Colombo", "Asia/Dacca", "Asia/Damascus", "Asia/Dhaka", "Asia/Dili", "Asia/Dubai", "Asia/Dushanbe", "Asia/Famagusta", "Asia/Gaza", "Asia/Harbin", "Asia/Hebron", "Asia/Ho_Chi_Minh", "Asia/Hong_Kong", "Asia/Hovd", "Asia/Irkutsk", "Asia/Istanbul", "Asia/Jakarta", "Asia/Jayapura", "Asia/Jerusalem", "Asia/Kabul", "Asia/Kamchatka", "Asia/Karachi", "Asia/Kashgar", "Asia/Kathmandu", "Asia/Katmandu", "Asia/Khandyga", "Asia/Kolkata", "Asia/Krasnoyarsk", "Asia/Kuala_Lumpur", "Asia/Kuching", "Asia/Kuwait", "Asia/Macao", "Asia/Macau", "Asia/Magadan", "Asia/Makassar", "Asia/Manila", "Asia/Muscat", "Asia/Nicosia", "Asia/Novokuznetsk", "Asia/Novosibirsk", "Asia/Omsk", "Asia/Oral", "Asia/Phnom_Penh", "Asia/Pontianak", "Asia/Pyongyang", "Asia/Qatar", "Asia/Qyzylorda", "Asia/Rangoon", "Asia/Riyadh", "Asia/Saigon", "Asia/Sakhalin", "Asia/Samarkand", "Asia/Seoul", "Asia/Shanghai", "Asia/Singapore", "Asia/Srednekolymsk", "Asia/Taipei", "Asia/Tashkent", "Asia/Tbilisi", "Asia/Tehran", "Asia/Tel_Aviv", "Asia/Thimbu", "Asia/Thimphu", "Asia/Tokyo", "Asia/Tomsk", "Asia/Ujung_Pandang", "Asia/Ulaanbaatar", "Asia/Ulan_Bator", "Asia/Urumqi", "Asia/Ust-Nera", "Asia/Vientiane", "Asia/Vladivostok", "Asia/Yakutsk", "Asia/Yangon", "Asia/Yekaterinburg", "Asia/Yerevan", "Atlantic/Azores", "Atlantic/Bermuda", "Atlantic/Canary", "Atlantic/Cape_Verde", "Atlantic/Faeroe", "Atlantic/Faroe", "Atlantic/Jan_Mayen", "Atlantic/Madeira", "Atlantic/Reykjavik", "Atlantic/South_Georgia", "Atlantic/St_Helena", "Atlantic/Stanley", "Australia/ACT", "Australia/Adelaide", "Australia/Brisbane", "Australia/Broken_Hill", "Australia/Canberra", "Australia/Currie", "Australia/Darwin", "Australia/Eucla", "Australia/Hobart", "Australia/LHI", "Australia/Lindeman", "Australia/Lord_Howe", "Australia/Melbourne", "Australia/NSW", "Australia/North", "Australia/Perth", "Australia/Queensland", "Australia/South", "Australia/Sydney", "Australia/Tasmania", "Australia/Victoria", "Australia/West", "Australia/Yancowinna", "Brazil/Acre", "Brazil/DeNoronha", "Brazil/East", "Brazil/West", "CET", "CST6CDT", "Canada/Atlantic", "Canada/Central", "Canada/Eastern", "Canada/Mountain", "Canada/Newfoundland", "Canada/Pacific", "Canada/Saskatchewan", "Canada/Yukon", "Chile/Continental", "Chile/EasterIsland", "Cuba", "EET", "EST", "EST5EDT", "Egypt", "Eire", "Etc/GMT", "Etc/GMT+0", "Etc/GMT+1", "Etc/GMT+10", "Etc/GMT+11", "Etc/GMT+12", "Etc/GMT+2", "Etc/GMT+3", "Etc/GMT+4", "Etc/GMT+5", "Etc/GMT+6", "Etc/GMT+7", "Etc/GMT+8", "Etc/GMT+9", "Etc/GMT-0", "Etc/GMT-1", "Etc/GMT-10", "Etc/GMT-11", "Etc/GMT-12", "Etc/GMT-13", "Etc/GMT-14", "Etc/GMT-2", "Etc/GMT-3", "Etc/GMT-4", "Etc/GMT-5", "Etc/GMT-6", "Etc/GMT-7", "Etc/GMT-8", "Etc/GMT-9", "Etc/GMT0", "Etc/Greenwich", "Etc/UCT", "Etc/UTC", "Etc/Universal", "Etc/Zulu", "Europe/Amsterdam", "Europe/Andorra", "Europe/Astrakhan", "Europe/Athens", "Europe/Belfast", "Europe/Belgrade", "Europe/Berlin", "Europe/Bratislava", "Europe/Brussels", "Europe/Bucharest", "Europe/Budapest", "Europe/Busingen", "Europe/Chisinau", "Europe/Copenhagen", "Europe/Dublin", "Europe/Gibraltar", "Europe/Guernsey", "Europe/Helsinki", "Europe/Isle_of_Man", "Europe/Istanbul", "Europe/Jersey", "Europe/Kaliningrad", "Europe/Kiev", "Europe/Kirov", "Europe/Lisbon", "Europe/Ljubljana", "Europe/London", "Europe/Luxembourg", "Europe/Madrid", "Europe/Malta", "Europe/Mariehamn", "Europe/Minsk", "Europe/Monaco", "Europe/Moscow", "Europe/Nicosia", "Europe/Oslo", "Europe/Paris", "Europe/Podgorica", "Europe/Prague", "Europe/Riga", "Europe/Rome", "Europe/Samara", "Europe/San_Marino", "Europe/Sarajevo", "Europe/Saratov", "Europe/Simferopol", "Europe/Skopje", "Europe/Sofia", "Europe/Stockholm", "Europe/Tallinn", "Europe/Tirane", "Europe/Tiraspol", "Europe/Ulyanovsk", "Europe/Uzhgorod", "Europe/Vaduz", "Europe/Vatican", "Europe/Vienna", "Europe/Vilnius", "Europe/Volgograd", "Europe/Warsaw", "Europe/Zagreb", "Europe/Zaporozhye", "Europe/Zurich", "GB", "GB-Eire", "GMT", "GMT+0", "GMT-0", "GMT0", "Greenwich", "HST", "Hongkong", "Iceland", "Indian/Antananarivo", "Indian/Chagos", "Indian/Christmas", "Indian/Cocos", "Indian/Comoro", "Indian/Kerguelen", "Indian/Mahe", "Indian/Maldives", "Indian/Mauritius", "Indian/Mayotte", "Indian/Reunion", "Iran", "Israel", "Jamaica", "Japan", "Kwajalein", "Libya", "MET", "MST", "MST7MDT", "Mexico/BajaNorte", "Mexico/BajaSur", "Mexico/General", "NZ", "NZ-CHAT", "Navajo", "PRC", "PST8PDT", "Pacific/Apia", "Pacific/Auckland", "Pacific/Bougainville", "Pacific/Chatham", "Pacific/Chuuk", "Pacific/Easter", "Pacific/Efate", "Pacific/Enderbury", "Pacific/Fakaofo", "Pacific/Fiji", "Pacific/Funafuti", "Pacific/Galapagos", "Pacific/Gambier", "Pacific/Guadalcanal", "Pacific/Guam", "Pacific/Honolulu", "Pacific/Johnston", "Pacific/Kiritimati", "Pacific/Kosrae", "Pacific/Kwajalein", "Pacific/Majuro", "Pacific/Marquesas", "Pacific/Midway", "Pacific/Nauru", "Pacific/Niue", "Pacific/Norfolk", "Pacific/Noumea", "Pacific/Pago_Pago", "Pacific/Palau", "Pacific/Pitcairn", "Pacific/Pohnpei", "Pacific/Ponape", "Pacific/Port_Moresby", "Pacific/Rarotonga", "Pacific/Saipan", "Pacific/Samoa", "Pacific/Tahiti", "Pacific/Tarawa", "Pacific/Tongatapu", "Pacific/Truk", "Pacific/Wake", "Pacific/Wallis", "Pacific/Yap", "Poland", "Portugal", "ROC", "ROK", "Singapore", "Turkey", "UCT", "US/Alaska", "US/Aleutian", "US/Arizona", "US/Central", "US/East-Indiana", "US/Eastern", "US/Hawaii", "US/Indiana-Starke", "US/Michigan", "US/Mountain", "US/Pacific", "US/Pacific-New", "US/Samoa", "UTC", "Universal", "W-SU", "WET", "Zulu" ] }, "dataPrivacySettings": { "type": "object", "properties": { "enabled": { "type": "boolean" }, "useAnalytics": { "type": "boolean" }, "useContactProfiles": { "type": "boolean" }, "useConversations": { "type": "boolean" }, "maskAnalytics": { "type": "boolean" }, "maskLogging": { "type": "boolean" }, "ignoreList": { "type": "array", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } } } } }, "total": { "type": "integer", "example": 1 }, "next": { "oneOf": [ { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, { "nullable": true } ], "example": "5ce7c2d833ea1e04d7e6c432" }, "previous": { "oneOf": [ { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, { "nullable": true } ], "example": null } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "BasicAuth": [] } ] } }, "/management/v2.0/organisations/{organisationId}": { "delete": { "operationId": "deleteOrganisation_2_0", "summary": "Deletes an organisation.", "description": "Deletes a specific organisation completely.", "tags": [ "Management v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "organisationId", "description": "The Id of the Organisation", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "query", "name": "verificationToken", "required": true, "schema": { "type": "string" } } ], "security": [ { "BasicAuth": [] } ], "responses": { "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } } }, "get": { "operationId": "readOrganisation_2_0", "summary": "Returns organisation.", "description": "Returns information about a specific organisation.", "tags": [ "Management v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "organisationId", "description": "The Id of the Organisation", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "200": { "description": "Returns the Organisation.", "content": { "application/json": { "schema": { "type": "object", "properties": { "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "name": { "type": "string", "description": "The name of this organisation" }, "disabled": { "type": "boolean", "description": "Flag whether this organisation is currently disabled" }, "quotaMaxProjects": { "type": "number" }, "quotaMaxUsers": { "type": "number" }, "quotaMaxChannelsPerProject": { "type": "number" }, "quotaMaxMessagesPerDay": { "type": "number" }, "quotaMaxKnowledgeChunks": { "type": "number" }, "passwordPolicy": { "type": "object", "properties": { "minLength": { "type": "integer" }, "maxLength": { "type": "integer" }, "minAmountLowerCase": { "type": "integer" }, "minAmountUpperCase": { "type": "integer" }, "minAmountSpecialCharacters": { "type": "integer" }, "minAmountNumbers": { "type": "integer" }, "maxAmountIdenticalCharacters": { "type": "integer" }, "minAmountFailedAttemptsAutoDisable": { "type": "integer" } } }, "sessionStateTTLInMinutes": { "type": "number" }, "contactProfileTTLInMinutes": { "type": "number" }, "conversationTTLInMinutes": { "type": "number" }, "liveAgentAccount": { "type": "number" }, "billingTimezone": { "type": "string", "description": "Timezone according to IANA Timezone Database (2020a)", "example": "Europe/Berlin", "enum": [ "Africa/Abidjan", "Africa/Accra", "Africa/Addis_Ababa", "Africa/Algiers", "Africa/Asmara", "Africa/Asmera", "Africa/Bamako", "Africa/Bangui", "Africa/Banjul", "Africa/Bissau", "Africa/Blantyre", "Africa/Brazzaville", "Africa/Bujumbura", "Africa/Cairo", "Africa/Casablanca", "Africa/Ceuta", "Africa/Conakry", "Africa/Dakar", "Africa/Dar_es_Salaam", "Africa/Djibouti", "Africa/Douala", "Africa/El_Aaiun", "Africa/Freetown", "Africa/Gaborone", "Africa/Harare", "Africa/Johannesburg", "Africa/Juba", "Africa/Kampala", "Africa/Khartoum", "Africa/Kigali", "Africa/Kinshasa", "Africa/Lagos", "Africa/Libreville", "Africa/Lome", "Africa/Luanda", "Africa/Lubumbashi", "Africa/Lusaka", "Africa/Malabo", "Africa/Maputo", "Africa/Maseru", "Africa/Mbabane", "Africa/Mogadishu", "Africa/Monrovia", "Africa/Nairobi", "Africa/Ndjamena", "Africa/Niamey", "Africa/Nouakchott", "Africa/Ouagadougou", "Africa/Porto-Novo", "Africa/Sao_Tome", "Africa/Timbuktu", "Africa/Tripoli", "Africa/Tunis", "Africa/Windhoek", "America/Adak", "America/Anchorage", "America/Anguilla", "America/Antigua", "America/Araguaina", "America/Argentina/Buenos_Aires", "America/Argentina/Catamarca", "America/Argentina/ComodRivadavia", "America/Argentina/Cordoba", "America/Argentina/Jujuy", "America/Argentina/La_Rioja", "America/Argentina/Mendoza", "America/Argentina/Rio_Gallegos", "America/Argentina/Salta", "America/Argentina/San_Juan", "America/Argentina/San_Luis", "America/Argentina/Tucuman", "America/Argentina/Ushuaia", "America/Aruba", "America/Asuncion", "America/Atikokan", "America/Atka", "America/Bahia", "America/Bahia_Banderas", "America/Barbados", "America/Belem", "America/Belize", "America/Blanc-Sablon", "America/Boa_Vista", "America/Bogota", "America/Boise", "America/Buenos_Aires", "America/Cambridge_Bay", "America/Campo_Grande", "America/Cancun", "America/Caracas", "America/Catamarca", "America/Cayenne", "America/Cayman", "America/Chicago", "America/Chihuahua", "America/Coral_Harbour", "America/Cordoba", "America/Costa_Rica", "America/Creston", "America/Cuiaba", "America/Curacao", "America/Danmarkshavn", "America/Dawson", "America/Dawson_Creek", "America/Denver", "America/Detroit", "America/Dominica", "America/Edmonton", "America/Eirunepe", "America/El_Salvador", "America/Ensenada", "America/Fort_Nelson", "America/Fort_Wayne", "America/Fortaleza", "America/Glace_Bay", "America/Godthab", "America/Goose_Bay", "America/Grand_Turk", "America/Grenada", "America/Guadeloupe", "America/Guatemala", "America/Guayaquil", "America/Guyana", "America/Halifax", "America/Havana", "America/Hermosillo", "America/Indiana/Indianapolis", "America/Indiana/Knox", "America/Indiana/Marengo", "America/Indiana/Petersburg", "America/Indiana/Tell_City", "America/Indiana/Vevay", "America/Indiana/Vincennes", "America/Indiana/Winamac", "America/Indianapolis", "America/Inuvik", "America/Iqaluit", "America/Jamaica", "America/Jujuy", "America/Juneau", "America/Kentucky/Louisville", "America/Kentucky/Monticello", "America/Knox_IN", "America/Kralendijk", "America/La_Paz", "America/Lima", "America/Los_Angeles", "America/Louisville", "America/Lower_Princes", "America/Maceio", "America/Managua", "America/Manaus", "America/Marigot", "America/Martinique", "America/Matamoros", "America/Mazatlan", "America/Mendoza", "America/Menominee", "America/Merida", "America/Metlakatla", "America/Mexico_City", "America/Miquelon", "America/Moncton", "America/Monterrey", "America/Montevideo", "America/Montreal", "America/Montserrat", "America/Nassau", "America/New_York", "America/Nipigon", "America/Nome", "America/Noronha", "America/North_Dakota/Beulah", "America/North_Dakota/Center", "America/North_Dakota/New_Salem", "America/Ojinaga", "America/Panama", "America/Pangnirtung", "America/Paramaribo", "America/Phoenix", "America/Port-au-Prince", "America/Port_of_Spain", "America/Porto_Acre", "America/Porto_Velho", "America/Puerto_Rico", "America/Punta_Arenas", "America/Rainy_River", "America/Rankin_Inlet", "America/Recife", "America/Regina", "America/Resolute", "America/Rio_Branco", "America/Rosario", "America/Santa_Isabel", "America/Santarem", "America/Santiago", "America/Santo_Domingo", "America/Sao_Paulo", "America/Scoresbysund", "America/Shiprock", "America/Sitka", "America/St_Barthelemy", "America/St_Johns", "America/St_Kitts", "America/St_Lucia", "America/St_Thomas", "America/St_Vincent", "America/Swift_Current", "America/Tegucigalpa", "America/Thule", "America/Thunder_Bay", "America/Tijuana", "America/Toronto", "America/Tortola", "America/Vancouver", "America/Virgin", "America/Whitehorse", "America/Winnipeg", "America/Yakutat", "America/Yellowknife", "Antarctica/Casey", "Antarctica/Davis", "Antarctica/DumontDUrville", "Antarctica/Macquarie", "Antarctica/Mawson", "Antarctica/McMurdo", "Antarctica/Palmer", "Antarctica/Rothera", "Antarctica/South_Pole", "Antarctica/Syowa", "Antarctica/Troll", "Antarctica/Vostok", "Arctic/Longyearbyen", "Asia/Aden", "Asia/Almaty", "Asia/Amman", "Asia/Anadyr", "Asia/Aqtau", "Asia/Aqtobe", "Asia/Ashgabat", "Asia/Ashkhabad", "Asia/Atyrau", "Asia/Baghdad", "Asia/Bahrain", "Asia/Baku", "Asia/Bangkok", "Asia/Barnaul", "Asia/Beirut", "Asia/Bishkek", "Asia/Brunei", "Asia/Calcutta", "Asia/Chita", "Asia/Choibalsan", "Asia/Chongqing", "Asia/Chungking", "Asia/Colombo", "Asia/Dacca", "Asia/Damascus", "Asia/Dhaka", "Asia/Dili", "Asia/Dubai", "Asia/Dushanbe", "Asia/Famagusta", "Asia/Gaza", "Asia/Harbin", "Asia/Hebron", "Asia/Ho_Chi_Minh", "Asia/Hong_Kong", "Asia/Hovd", "Asia/Irkutsk", "Asia/Istanbul", "Asia/Jakarta", "Asia/Jayapura", "Asia/Jerusalem", "Asia/Kabul", "Asia/Kamchatka", "Asia/Karachi", "Asia/Kashgar", "Asia/Kathmandu", "Asia/Katmandu", "Asia/Khandyga", "Asia/Kolkata", "Asia/Krasnoyarsk", "Asia/Kuala_Lumpur", "Asia/Kuching", "Asia/Kuwait", "Asia/Macao", "Asia/Macau", "Asia/Magadan", "Asia/Makassar", "Asia/Manila", "Asia/Muscat", "Asia/Nicosia", "Asia/Novokuznetsk", "Asia/Novosibirsk", "Asia/Omsk", "Asia/Oral", "Asia/Phnom_Penh", "Asia/Pontianak", "Asia/Pyongyang", "Asia/Qatar", "Asia/Qyzylorda", "Asia/Rangoon", "Asia/Riyadh", "Asia/Saigon", "Asia/Sakhalin", "Asia/Samarkand", "Asia/Seoul", "Asia/Shanghai", "Asia/Singapore", "Asia/Srednekolymsk", "Asia/Taipei", "Asia/Tashkent", "Asia/Tbilisi", "Asia/Tehran", "Asia/Tel_Aviv", "Asia/Thimbu", "Asia/Thimphu", "Asia/Tokyo", "Asia/Tomsk", "Asia/Ujung_Pandang", "Asia/Ulaanbaatar", "Asia/Ulan_Bator", "Asia/Urumqi", "Asia/Ust-Nera", "Asia/Vientiane", "Asia/Vladivostok", "Asia/Yakutsk", "Asia/Yangon", "Asia/Yekaterinburg", "Asia/Yerevan", "Atlantic/Azores", "Atlantic/Bermuda", "Atlantic/Canary", "Atlantic/Cape_Verde", "Atlantic/Faeroe", "Atlantic/Faroe", "Atlantic/Jan_Mayen", "Atlantic/Madeira", "Atlantic/Reykjavik", "Atlantic/South_Georgia", "Atlantic/St_Helena", "Atlantic/Stanley", "Australia/ACT", "Australia/Adelaide", "Australia/Brisbane", "Australia/Broken_Hill", "Australia/Canberra", "Australia/Currie", "Australia/Darwin", "Australia/Eucla", "Australia/Hobart", "Australia/LHI", "Australia/Lindeman", "Australia/Lord_Howe", "Australia/Melbourne", "Australia/NSW", "Australia/North", "Australia/Perth", "Australia/Queensland", "Australia/South", "Australia/Sydney", "Australia/Tasmania", "Australia/Victoria", "Australia/West", "Australia/Yancowinna", "Brazil/Acre", "Brazil/DeNoronha", "Brazil/East", "Brazil/West", "CET", "CST6CDT", "Canada/Atlantic", "Canada/Central", "Canada/Eastern", "Canada/Mountain", "Canada/Newfoundland", "Canada/Pacific", "Canada/Saskatchewan", "Canada/Yukon", "Chile/Continental", "Chile/EasterIsland", "Cuba", "EET", "EST", "EST5EDT", "Egypt", "Eire", "Etc/GMT", "Etc/GMT+0", "Etc/GMT+1", "Etc/GMT+10", "Etc/GMT+11", "Etc/GMT+12", "Etc/GMT+2", "Etc/GMT+3", "Etc/GMT+4", "Etc/GMT+5", "Etc/GMT+6", "Etc/GMT+7", "Etc/GMT+8", "Etc/GMT+9", "Etc/GMT-0", "Etc/GMT-1", "Etc/GMT-10", "Etc/GMT-11", "Etc/GMT-12", "Etc/GMT-13", "Etc/GMT-14", "Etc/GMT-2", "Etc/GMT-3", "Etc/GMT-4", "Etc/GMT-5", "Etc/GMT-6", "Etc/GMT-7", "Etc/GMT-8", "Etc/GMT-9", "Etc/GMT0", "Etc/Greenwich", "Etc/UCT", "Etc/UTC", "Etc/Universal", "Etc/Zulu", "Europe/Amsterdam", "Europe/Andorra", "Europe/Astrakhan", "Europe/Athens", "Europe/Belfast", "Europe/Belgrade", "Europe/Berlin", "Europe/Bratislava", "Europe/Brussels", "Europe/Bucharest", "Europe/Budapest", "Europe/Busingen", "Europe/Chisinau", "Europe/Copenhagen", "Europe/Dublin", "Europe/Gibraltar", "Europe/Guernsey", "Europe/Helsinki", "Europe/Isle_of_Man", "Europe/Istanbul", "Europe/Jersey", "Europe/Kaliningrad", "Europe/Kiev", "Europe/Kirov", "Europe/Lisbon", "Europe/Ljubljana", "Europe/London", "Europe/Luxembourg", "Europe/Madrid", "Europe/Malta", "Europe/Mariehamn", "Europe/Minsk", "Europe/Monaco", "Europe/Moscow", "Europe/Nicosia", "Europe/Oslo", "Europe/Paris", "Europe/Podgorica", "Europe/Prague", "Europe/Riga", "Europe/Rome", "Europe/Samara", "Europe/San_Marino", "Europe/Sarajevo", "Europe/Saratov", "Europe/Simferopol", "Europe/Skopje", "Europe/Sofia", "Europe/Stockholm", "Europe/Tallinn", "Europe/Tirane", "Europe/Tiraspol", "Europe/Ulyanovsk", "Europe/Uzhgorod", "Europe/Vaduz", "Europe/Vatican", "Europe/Vienna", "Europe/Vilnius", "Europe/Volgograd", "Europe/Warsaw", "Europe/Zagreb", "Europe/Zaporozhye", "Europe/Zurich", "GB", "GB-Eire", "GMT", "GMT+0", "GMT-0", "GMT0", "Greenwich", "HST", "Hongkong", "Iceland", "Indian/Antananarivo", "Indian/Chagos", "Indian/Christmas", "Indian/Cocos", "Indian/Comoro", "Indian/Kerguelen", "Indian/Mahe", "Indian/Maldives", "Indian/Mauritius", "Indian/Mayotte", "Indian/Reunion", "Iran", "Israel", "Jamaica", "Japan", "Kwajalein", "Libya", "MET", "MST", "MST7MDT", "Mexico/BajaNorte", "Mexico/BajaSur", "Mexico/General", "NZ", "NZ-CHAT", "Navajo", "PRC", "PST8PDT", "Pacific/Apia", "Pacific/Auckland", "Pacific/Bougainville", "Pacific/Chatham", "Pacific/Chuuk", "Pacific/Easter", "Pacific/Efate", "Pacific/Enderbury", "Pacific/Fakaofo", "Pacific/Fiji", "Pacific/Funafuti", "Pacific/Galapagos", "Pacific/Gambier", "Pacific/Guadalcanal", "Pacific/Guam", "Pacific/Honolulu", "Pacific/Johnston", "Pacific/Kiritimati", "Pacific/Kosrae", "Pacific/Kwajalein", "Pacific/Majuro", "Pacific/Marquesas", "Pacific/Midway", "Pacific/Nauru", "Pacific/Niue", "Pacific/Norfolk", "Pacific/Noumea", "Pacific/Pago_Pago", "Pacific/Palau", "Pacific/Pitcairn", "Pacific/Pohnpei", "Pacific/Ponape", "Pacific/Port_Moresby", "Pacific/Rarotonga", "Pacific/Saipan", "Pacific/Samoa", "Pacific/Tahiti", "Pacific/Tarawa", "Pacific/Tongatapu", "Pacific/Truk", "Pacific/Wake", "Pacific/Wallis", "Pacific/Yap", "Poland", "Portugal", "ROC", "ROK", "Singapore", "Turkey", "UCT", "US/Alaska", "US/Aleutian", "US/Arizona", "US/Central", "US/East-Indiana", "US/Eastern", "US/Hawaii", "US/Indiana-Starke", "US/Michigan", "US/Mountain", "US/Pacific", "US/Pacific-New", "US/Samoa", "UTC", "Universal", "W-SU", "WET", "Zulu" ] }, "dataPrivacySettings": { "type": "object", "properties": { "enabled": { "type": "boolean" }, "useAnalytics": { "type": "boolean" }, "useContactProfiles": { "type": "boolean" }, "useConversations": { "type": "boolean" }, "maskAnalytics": { "type": "boolean" }, "maskLogging": { "type": "boolean" }, "ignoreList": { "type": "array", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "BasicAuth": [] } ] }, "patch": { "operationId": "updateOrganisation_2_0", "summary": "Updates an organisation.", "description": "Updates a specific organisation partially.", "tags": [ "Management v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "organisationId", "description": "The Id of the Organisation", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "properties": { "name": { "type": "string", "description": "The name of this organisation" }, "disabled": { "type": "boolean", "description": "Flag whether this organisation is currently disabled" }, "quotaMaxProjects": { "type": "number" }, "quotaMaxUsers": { "type": "number" }, "quotaMaxChannelsPerProject": { "type": "number" }, "quotaMaxMessagesPerDay": { "type": "number" }, "quotaMaxKnowledgeChunks": { "type": "number" }, "passwordPolicy": { "type": "object", "properties": { "minLength": { "type": "integer" }, "maxLength": { "type": "integer" }, "minAmountLowerCase": { "type": "integer" }, "minAmountUpperCase": { "type": "integer" }, "minAmountSpecialCharacters": { "type": "integer" }, "minAmountNumbers": { "type": "integer" }, "maxAmountIdenticalCharacters": { "type": "integer" }, "minAmountFailedAttemptsAutoDisable": { "type": "integer" } } }, "sessionStateTTLInMinutes": { "type": "number" }, "contactProfileTTLInMinutes": { "type": "number" }, "conversationTTLInMinutes": { "type": "number" }, "billingTimezone": { "type": "string", "description": "Timezone according to IANA Timezone Database (2020a)", "example": "Europe/Berlin", "enum": [ "Africa/Abidjan", "Africa/Accra", "Africa/Addis_Ababa", "Africa/Algiers", "Africa/Asmara", "Africa/Asmera", "Africa/Bamako", "Africa/Bangui", "Africa/Banjul", "Africa/Bissau", "Africa/Blantyre", "Africa/Brazzaville", "Africa/Bujumbura", "Africa/Cairo", "Africa/Casablanca", "Africa/Ceuta", "Africa/Conakry", "Africa/Dakar", "Africa/Dar_es_Salaam", "Africa/Djibouti", "Africa/Douala", "Africa/El_Aaiun", "Africa/Freetown", "Africa/Gaborone", "Africa/Harare", "Africa/Johannesburg", "Africa/Juba", "Africa/Kampala", "Africa/Khartoum", "Africa/Kigali", "Africa/Kinshasa", "Africa/Lagos", "Africa/Libreville", "Africa/Lome", "Africa/Luanda", "Africa/Lubumbashi", "Africa/Lusaka", "Africa/Malabo", "Africa/Maputo", "Africa/Maseru", "Africa/Mbabane", "Africa/Mogadishu", "Africa/Monrovia", "Africa/Nairobi", "Africa/Ndjamena", "Africa/Niamey", "Africa/Nouakchott", "Africa/Ouagadougou", "Africa/Porto-Novo", "Africa/Sao_Tome", "Africa/Timbuktu", "Africa/Tripoli", "Africa/Tunis", "Africa/Windhoek", "America/Adak", "America/Anchorage", "America/Anguilla", "America/Antigua", "America/Araguaina", "America/Argentina/Buenos_Aires", "America/Argentina/Catamarca", "America/Argentina/ComodRivadavia", "America/Argentina/Cordoba", "America/Argentina/Jujuy", "America/Argentina/La_Rioja", "America/Argentina/Mendoza", "America/Argentina/Rio_Gallegos", "America/Argentina/Salta", "America/Argentina/San_Juan", "America/Argentina/San_Luis", "America/Argentina/Tucuman", "America/Argentina/Ushuaia", "America/Aruba", "America/Asuncion", "America/Atikokan", "America/Atka", "America/Bahia", "America/Bahia_Banderas", "America/Barbados", "America/Belem", "America/Belize", "America/Blanc-Sablon", "America/Boa_Vista", "America/Bogota", "America/Boise", "America/Buenos_Aires", "America/Cambridge_Bay", "America/Campo_Grande", "America/Cancun", "America/Caracas", "America/Catamarca", "America/Cayenne", "America/Cayman", "America/Chicago", "America/Chihuahua", "America/Coral_Harbour", "America/Cordoba", "America/Costa_Rica", "America/Creston", "America/Cuiaba", "America/Curacao", "America/Danmarkshavn", "America/Dawson", "America/Dawson_Creek", "America/Denver", "America/Detroit", "America/Dominica", "America/Edmonton", "America/Eirunepe", "America/El_Salvador", "America/Ensenada", "America/Fort_Nelson", "America/Fort_Wayne", "America/Fortaleza", "America/Glace_Bay", "America/Godthab", "America/Goose_Bay", "America/Grand_Turk", "America/Grenada", "America/Guadeloupe", "America/Guatemala", "America/Guayaquil", "America/Guyana", "America/Halifax", "America/Havana", "America/Hermosillo", "America/Indiana/Indianapolis", "America/Indiana/Knox", "America/Indiana/Marengo", "America/Indiana/Petersburg", "America/Indiana/Tell_City", "America/Indiana/Vevay", "America/Indiana/Vincennes", "America/Indiana/Winamac", "America/Indianapolis", "America/Inuvik", "America/Iqaluit", "America/Jamaica", "America/Jujuy", "America/Juneau", "America/Kentucky/Louisville", "America/Kentucky/Monticello", "America/Knox_IN", "America/Kralendijk", "America/La_Paz", "America/Lima", "America/Los_Angeles", "America/Louisville", "America/Lower_Princes", "America/Maceio", "America/Managua", "America/Manaus", "America/Marigot", "America/Martinique", "America/Matamoros", "America/Mazatlan", "America/Mendoza", "America/Menominee", "America/Merida", "America/Metlakatla", "America/Mexico_City", "America/Miquelon", "America/Moncton", "America/Monterrey", "America/Montevideo", "America/Montreal", "America/Montserrat", "America/Nassau", "America/New_York", "America/Nipigon", "America/Nome", "America/Noronha", "America/North_Dakota/Beulah", "America/North_Dakota/Center", "America/North_Dakota/New_Salem", "America/Ojinaga", "America/Panama", "America/Pangnirtung", "America/Paramaribo", "America/Phoenix", "America/Port-au-Prince", "America/Port_of_Spain", "America/Porto_Acre", "America/Porto_Velho", "America/Puerto_Rico", "America/Punta_Arenas", "America/Rainy_River", "America/Rankin_Inlet", "America/Recife", "America/Regina", "America/Resolute", "America/Rio_Branco", "America/Rosario", "America/Santa_Isabel", "America/Santarem", "America/Santiago", "America/Santo_Domingo", "America/Sao_Paulo", "America/Scoresbysund", "America/Shiprock", "America/Sitka", "America/St_Barthelemy", "America/St_Johns", "America/St_Kitts", "America/St_Lucia", "America/St_Thomas", "America/St_Vincent", "America/Swift_Current", "America/Tegucigalpa", "America/Thule", "America/Thunder_Bay", "America/Tijuana", "America/Toronto", "America/Tortola", "America/Vancouver", "America/Virgin", "America/Whitehorse", "America/Winnipeg", "America/Yakutat", "America/Yellowknife", "Antarctica/Casey", "Antarctica/Davis", "Antarctica/DumontDUrville", "Antarctica/Macquarie", "Antarctica/Mawson", "Antarctica/McMurdo", "Antarctica/Palmer", "Antarctica/Rothera", "Antarctica/South_Pole", "Antarctica/Syowa", "Antarctica/Troll", "Antarctica/Vostok", "Arctic/Longyearbyen", "Asia/Aden", "Asia/Almaty", "Asia/Amman", "Asia/Anadyr", "Asia/Aqtau", "Asia/Aqtobe", "Asia/Ashgabat", "Asia/Ashkhabad", "Asia/Atyrau", "Asia/Baghdad", "Asia/Bahrain", "Asia/Baku", "Asia/Bangkok", "Asia/Barnaul", "Asia/Beirut", "Asia/Bishkek", "Asia/Brunei", "Asia/Calcutta", "Asia/Chita", "Asia/Choibalsan", "Asia/Chongqing", "Asia/Chungking", "Asia/Colombo", "Asia/Dacca", "Asia/Damascus", "Asia/Dhaka", "Asia/Dili", "Asia/Dubai", "Asia/Dushanbe", "Asia/Famagusta", "Asia/Gaza", "Asia/Harbin", "Asia/Hebron", "Asia/Ho_Chi_Minh", "Asia/Hong_Kong", "Asia/Hovd", "Asia/Irkutsk", "Asia/Istanbul", "Asia/Jakarta", "Asia/Jayapura", "Asia/Jerusalem", "Asia/Kabul", "Asia/Kamchatka", "Asia/Karachi", "Asia/Kashgar", "Asia/Kathmandu", "Asia/Katmandu", "Asia/Khandyga", "Asia/Kolkata", "Asia/Krasnoyarsk", "Asia/Kuala_Lumpur", "Asia/Kuching", "Asia/Kuwait", "Asia/Macao", "Asia/Macau", "Asia/Magadan", "Asia/Makassar", "Asia/Manila", "Asia/Muscat", "Asia/Nicosia", "Asia/Novokuznetsk", "Asia/Novosibirsk", "Asia/Omsk", "Asia/Oral", "Asia/Phnom_Penh", "Asia/Pontianak", "Asia/Pyongyang", "Asia/Qatar", "Asia/Qyzylorda", "Asia/Rangoon", "Asia/Riyadh", "Asia/Saigon", "Asia/Sakhalin", "Asia/Samarkand", "Asia/Seoul", "Asia/Shanghai", "Asia/Singapore", "Asia/Srednekolymsk", "Asia/Taipei", "Asia/Tashkent", "Asia/Tbilisi", "Asia/Tehran", "Asia/Tel_Aviv", "Asia/Thimbu", "Asia/Thimphu", "Asia/Tokyo", "Asia/Tomsk", "Asia/Ujung_Pandang", "Asia/Ulaanbaatar", "Asia/Ulan_Bator", "Asia/Urumqi", "Asia/Ust-Nera", "Asia/Vientiane", "Asia/Vladivostok", "Asia/Yakutsk", "Asia/Yangon", "Asia/Yekaterinburg", "Asia/Yerevan", "Atlantic/Azores", "Atlantic/Bermuda", "Atlantic/Canary", "Atlantic/Cape_Verde", "Atlantic/Faeroe", "Atlantic/Faroe", "Atlantic/Jan_Mayen", "Atlantic/Madeira", "Atlantic/Reykjavik", "Atlantic/South_Georgia", "Atlantic/St_Helena", "Atlantic/Stanley", "Australia/ACT", "Australia/Adelaide", "Australia/Brisbane", "Australia/Broken_Hill", "Australia/Canberra", "Australia/Currie", "Australia/Darwin", "Australia/Eucla", "Australia/Hobart", "Australia/LHI", "Australia/Lindeman", "Australia/Lord_Howe", "Australia/Melbourne", "Australia/NSW", "Australia/North", "Australia/Perth", "Australia/Queensland", "Australia/South", "Australia/Sydney", "Australia/Tasmania", "Australia/Victoria", "Australia/West", "Australia/Yancowinna", "Brazil/Acre", "Brazil/DeNoronha", "Brazil/East", "Brazil/West", "CET", "CST6CDT", "Canada/Atlantic", "Canada/Central", "Canada/Eastern", "Canada/Mountain", "Canada/Newfoundland", "Canada/Pacific", "Canada/Saskatchewan", "Canada/Yukon", "Chile/Continental", "Chile/EasterIsland", "Cuba", "EET", "EST", "EST5EDT", "Egypt", "Eire", "Etc/GMT", "Etc/GMT+0", "Etc/GMT+1", "Etc/GMT+10", "Etc/GMT+11", "Etc/GMT+12", "Etc/GMT+2", "Etc/GMT+3", "Etc/GMT+4", "Etc/GMT+5", "Etc/GMT+6", "Etc/GMT+7", "Etc/GMT+8", "Etc/GMT+9", "Etc/GMT-0", "Etc/GMT-1", "Etc/GMT-10", "Etc/GMT-11", "Etc/GMT-12", "Etc/GMT-13", "Etc/GMT-14", "Etc/GMT-2", "Etc/GMT-3", "Etc/GMT-4", "Etc/GMT-5", "Etc/GMT-6", "Etc/GMT-7", "Etc/GMT-8", "Etc/GMT-9", "Etc/GMT0", "Etc/Greenwich", "Etc/UCT", "Etc/UTC", "Etc/Universal", "Etc/Zulu", "Europe/Amsterdam", "Europe/Andorra", "Europe/Astrakhan", "Europe/Athens", "Europe/Belfast", "Europe/Belgrade", "Europe/Berlin", "Europe/Bratislava", "Europe/Brussels", "Europe/Bucharest", "Europe/Budapest", "Europe/Busingen", "Europe/Chisinau", "Europe/Copenhagen", "Europe/Dublin", "Europe/Gibraltar", "Europe/Guernsey", "Europe/Helsinki", "Europe/Isle_of_Man", "Europe/Istanbul", "Europe/Jersey", "Europe/Kaliningrad", "Europe/Kiev", "Europe/Kirov", "Europe/Lisbon", "Europe/Ljubljana", "Europe/London", "Europe/Luxembourg", "Europe/Madrid", "Europe/Malta", "Europe/Mariehamn", "Europe/Minsk", "Europe/Monaco", "Europe/Moscow", "Europe/Nicosia", "Europe/Oslo", "Europe/Paris", "Europe/Podgorica", "Europe/Prague", "Europe/Riga", "Europe/Rome", "Europe/Samara", "Europe/San_Marino", "Europe/Sarajevo", "Europe/Saratov", "Europe/Simferopol", "Europe/Skopje", "Europe/Sofia", "Europe/Stockholm", "Europe/Tallinn", "Europe/Tirane", "Europe/Tiraspol", "Europe/Ulyanovsk", "Europe/Uzhgorod", "Europe/Vaduz", "Europe/Vatican", "Europe/Vienna", "Europe/Vilnius", "Europe/Volgograd", "Europe/Warsaw", "Europe/Zagreb", "Europe/Zaporozhye", "Europe/Zurich", "GB", "GB-Eire", "GMT", "GMT+0", "GMT-0", "GMT0", "Greenwich", "HST", "Hongkong", "Iceland", "Indian/Antananarivo", "Indian/Chagos", "Indian/Christmas", "Indian/Cocos", "Indian/Comoro", "Indian/Kerguelen", "Indian/Mahe", "Indian/Maldives", "Indian/Mauritius", "Indian/Mayotte", "Indian/Reunion", "Iran", "Israel", "Jamaica", "Japan", "Kwajalein", "Libya", "MET", "MST", "MST7MDT", "Mexico/BajaNorte", "Mexico/BajaSur", "Mexico/General", "NZ", "NZ-CHAT", "Navajo", "PRC", "PST8PDT", "Pacific/Apia", "Pacific/Auckland", "Pacific/Bougainville", "Pacific/Chatham", "Pacific/Chuuk", "Pacific/Easter", "Pacific/Efate", "Pacific/Enderbury", "Pacific/Fakaofo", "Pacific/Fiji", "Pacific/Funafuti", "Pacific/Galapagos", "Pacific/Gambier", "Pacific/Guadalcanal", "Pacific/Guam", "Pacific/Honolulu", "Pacific/Johnston", "Pacific/Kiritimati", "Pacific/Kosrae", "Pacific/Kwajalein", "Pacific/Majuro", "Pacific/Marquesas", "Pacific/Midway", "Pacific/Nauru", "Pacific/Niue", "Pacific/Norfolk", "Pacific/Noumea", "Pacific/Pago_Pago", "Pacific/Palau", "Pacific/Pitcairn", "Pacific/Pohnpei", "Pacific/Ponape", "Pacific/Port_Moresby", "Pacific/Rarotonga", "Pacific/Saipan", "Pacific/Samoa", "Pacific/Tahiti", "Pacific/Tarawa", "Pacific/Tongatapu", "Pacific/Truk", "Pacific/Wake", "Pacific/Wallis", "Pacific/Yap", "Poland", "Portugal", "ROC", "ROK", "Singapore", "Turkey", "UCT", "US/Alaska", "US/Aleutian", "US/Arizona", "US/Central", "US/East-Indiana", "US/Eastern", "US/Hawaii", "US/Indiana-Starke", "US/Michigan", "US/Mountain", "US/Pacific", "US/Pacific-New", "US/Samoa", "UTC", "Universal", "W-SU", "WET", "Zulu" ] }, "dataPrivacySettings": { "type": "object", "properties": { "enabled": { "type": "boolean" }, "useAnalytics": { "type": "boolean" }, "useContactProfiles": { "type": "boolean" }, "useConversations": { "type": "boolean" }, "maskAnalytics": { "type": "boolean" }, "maskLogging": { "type": "boolean" }, "ignoreList": { "type": "array", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } } }, "type": "object" } } } }, "security": [ { "BasicAuth": [] } ], "responses": { "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } } } }, "/management/v2.0/organisations/{organisationId}/enforcepasswordpolicy": { "post": { "operationId": "enforcePasswordPolicy_2_0", "summary": "Enforces a PasswordPolicy.", "description": "Enforces a PasswordPolicy by deprecating all Passwords.", "tags": [ "Management v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "organisationId", "description": "The Id of the Organisation", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "204": { "description": "Successfully enforced PasswordPolicy." }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "BasicAuth": [] } ] } }, "/management/v2.0/organisations/{organisationId}/apikeys": { "post": { "operationId": "createApiKeyManagement_2_0", "summary": "Creates a new api-key.", "description": "Creates a new [ApiKey](doc:apikeys) with admin permissions.\nThe ApiKey is valid for 15 minutes.\nThis feature needs to be enabled server-side by setting the\nFEATURE_USE_SUPERAPIKEY_API to \"true\".\n", "tags": [ "Management v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "organisationId", "description": "The Id of the Organisation", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "201": { "description": "Returns the created api-key.", "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "minimum": 0, "maximum": 2147483647, "example": 1527621049 }, "apiKey": { "type": "string" } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "BasicAuth": [] } ] } }, "/management/v2.0/system/createsystemmessage": { "post": { "operationId": "createSystemMessage_2_0", "summary": "Creates a system message.", "description": "Creates a system message and overwrites the current one (if exists).", "tags": [ "Management v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "message", "until" ], "properties": { "until": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "message": { "type": "string", "example": "Next great Update will be released next Monday." }, "showOnLogin": { "type": "boolean" } } } } } }, "responses": { "201": { "description": "The system message was created." }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "BasicAuth": [] } ] } }, "/management/v2.0/users": { "post": { "operationId": "management_createUser_2_0", "summary": "Creates a new user.", "description": "Creates a new [User](doc:users) in the system.", "tags": [ "Management v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "id", "name", "password", "organisation" ], "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "password": { "type": "string" }, "organisation": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "roles": { "type": "array", "items": { "type": "string", "enum": [ "admin", "apiKeys", "base_role", "basicSupportUser", "fullSupportUser", "liveAgentAdmin", "liveAgentAgent", "liveAgentSupervisor", "odata", "projectAssigner", "projectManager", "userManager", "userDetailsViewer", "voiceGatewayUser" ] } }, "acceptedTOS": { "type": "boolean" }, "disabled": { "type": "boolean" } } } } } }, "responses": { "201": { "description": "Returns the created user.", "content": { "application/json": { "schema": { "type": "object", "required": [ "id", "name", "password", "organisation" ], "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "password": { "type": "string" }, "organisation": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "roles": { "type": "array", "items": { "type": "string", "enum": [ "admin", "apiKeys", "base_role", "basicSupportUser", "fullSupportUser", "liveAgentAdmin", "liveAgentAgent", "liveAgentSupervisor", "odata", "projectAssigner", "projectManager", "userManager", "userDetailsViewer", "voiceGatewayUser" ] } }, "acceptedTOS": { "type": "boolean" }, "disabled": { "type": "boolean" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "BasicAuth": [] } ] }, "get": { "operationId": "management_indexUsers_2_0", "summary": "Get users.", "description": "Get 25 [Users](https://docs.cognigy.com/voicegateway/webapp/users) of the organisation by default. To change the default value, use the `limit` query parameter. Additionally, you can filter, sort, and paginate the results.", "tags": [ "Management v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "query", "name": "filter", "required": false, "schema": { "type": "string" }, "description": "The name or id of the user to filter the records" }, { "in": "query", "name": "limit", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100 }, "description": "The maximum number of items to return. The default is 25." }, { "in": "query", "name": "skip", "required": false, "schema": { "type": "integer", "minimum": 0 }, "description": "The number of items to skip. The default is 0. Used along with a limit of a pagination." }, { "in": "query", "name": "sort", "required": false, "schema": { "type": "string", "minLength": 1 }, "description": "The order of the sorting items-`Desc` (descending) or `Asc` (ascending). For example, to sort the records by name in ascending order, specify `name:Asc`." }, { "in": "query", "name": "next", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the nextCursor value from the response to get the next set of records. Used along with limit for pagination." }, { "in": "query", "name": "previous", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the previousCursor value from the response to get the previous set of records. Used along with limit for pagination." } ], "responses": { "200": { "description": "Returns metadata objects for each user in the system.", "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" } }, "total": { "type": "integer", "example": 1 }, "next": { "oneOf": [ { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, { "nullable": true } ], "example": "5ce7c2d833ea1e04d7e6c432" }, "previous": { "oneOf": [ { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, { "nullable": true } ], "example": null } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "BasicAuth": [] } ] } }, "/management/v2.0/users/{userId}": { "delete": { "operationId": "management_deleteUser_2_0", "summary": "Deletes an user.", "description": "Deletes a [User](doc:users) from the system completely.", "tags": [ "Management v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "userId", "description": "The Id of the User", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "204": { "description": "The user was removed successfully." }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "BasicAuth": [] } ] }, "get": { "operationId": "management_readUser_2_0", "summary": "Get a user", "description": "Get full data of a [User](doc:users) from the system.", "tags": [ "Management v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "userId", "description": "The Id of the User", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "200": { "description": "Returns User object", "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "organisation": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "roles": { "type": "array", "items": { "type": "string", "enum": [ "admin", "apiKeys", "base_role", "basicSupportUser", "fullSupportUser", "liveAgentAdmin", "liveAgentAgent", "liveAgentSupervisor", "odata", "projectAssigner", "projectManager", "userManager", "userDetailsViewer", "voiceGatewayUser" ] } }, "projects": { "type": "array", "items": { "type": "string" } }, "acceptedTOS": { "type": "boolean" }, "disabled": { "type": "boolean" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "BasicAuth": [] } ] }, "patch": { "operationId": "management_updateUser_2_0", "summary": "Updates an user.", "description": "Updates the profile of a [User](doc:users).", "tags": [ "Management v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "userId", "description": "The Id of the User", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "acceptedTOS": { "type": "boolean" }, "disabled": { "type": "boolean" }, "newPassword": { "type": "string" } } } } } }, "responses": { "204": { "description": "The user is updated successfully." }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "BasicAuth": [] } ] } }, "/management/v2.0/users/{userId}/impersonate": { "post": { "operationId": "management_impersonateUser_2_0", "summary": "Impersonate a user.", "description": "Creates an access-/refresh-token pair in order to login as a specific user.", "tags": [ "Management v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "userId", "description": "The Id of the User", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "200": { "description": "Token pair for the user.", "content": { "application/json": { "schema": { "type": "object", "properties": { "access_token": { "type": "string" }, "expires_in": { "type": "number" }, "refresh_token": { "type": "string" }, "token_type": { "type": "string" } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "BasicAuth": [] } ] } }, "/management/v2.0/billing": { "get": { "operationId": "getBillingInformation_2_0", "summary": "Returns billing relevant information.", "description": "Returns billing relevant information about 25 organisations in the system by default. To change the default value, use the `limit` query parameter. Additionally, you can filter, sort, and paginate the results.", "tags": [ "Management v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "query", "name": "filter", "required": false, "schema": { "type": "string" }, "description": "filter billing info by organisation name" }, { "in": "query", "name": "limit", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100 }, "description": "The maximum number of items to return. The default is 25." }, { "in": "query", "name": "skip", "required": false, "schema": { "type": "integer", "minimum": 0 }, "description": "The number of items to skip. The default is 0. Used along with a limit of a pagination." }, { "in": "query", "name": "sort", "required": false, "schema": { "type": "string", "minLength": 1 }, "description": "The order of the sorting items-`Desc` (descending) or `Asc` (ascending). For example, to sort the records by name in ascending order, specify `name:Asc`." }, { "in": "query", "name": "next", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the nextCursor value from the response to get the next set of records. Used along with limit for pagination." }, { "in": "query", "name": "previous", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the previousCursor value from the response to get the previous set of records. Used along with limit for pagination." } ], "responses": { "200": { "description": "Billing relevant information per organisation.", "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "organisationId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "name": { "type": "string" }, "isDisabled": { "type": "boolean" }, "conversations": { "type": "array", "items": { "type": "object", "properties": { "conversations": { "type": "number" }, "day": { "type": "number" }, "month": { "type": "number" }, "year": { "type": "number" }, "channel": { "type": "string" } } } } } } }, "total": { "type": "integer", "example": 1 }, "next": { "oneOf": [ { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, { "nullable": true } ], "example": "5ce7c2d833ea1e04d7e6c432" }, "previous": { "oneOf": [ { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, { "nullable": true } ], "example": null } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "BasicAuth": [] } ] } }, "/management/v2.0/vendor": { "get": { "operationId": "readVendor_2_0", "summary": "Returns info about the product.", "description": "Returns vendor information about the product.", "tags": [ "Management v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" } ], "responses": { "200": { "description": "Returns some product information like the version etc.", "content": { "application/json": { "schema": { "type": "object", "properties": { "version": { "type": "string", "description": "The product version we are running" }, "frontendBaseUrl": { "type": "string", "description": "Base URL to the frontend UI" }, "hasLicenseAgreement": { "type": "string", "description": "Flag whether users need to agree the license agreement within this env" }, "maxContactProfileTTL": { "type": "number" }, "maxConversationTTL": { "type": "number" }, "maxSessionStateTTL": { "type": "number" } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "BasicAuth": [] } ] } }, "/v2.0/projects/{projectId}/callcounter": { "get": { "operationId": "getCallCounter_2_0", "summary": "Returns call counter metrics.", "description": "Returns call counts for given input values.", "tags": [ "Analytics v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "projectId", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "query", "name": "year", "required": true, "schema": { "type": "number" } }, { "in": "query", "name": "month", "required": false, "schema": { "type": "number" } } ], "responses": { "200": { "description": "The call counter stats for the given time-frame.", "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "calls": { "type": "number" }, "duration": { "type": "number" }, "concurrentCalls": { "type": "number" }, "day": { "type": "number" }, "month": { "type": "number" }, "year": { "type": "number" } } } } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/callcounter": { "get": { "operationId": "getCallCounterOrganisation_2_0", "summary": "Returns call counter metrics org-wide.", "description": "Returns call counts for given input values.", "tags": [ "Analytics v2.0" ], "parameters": [ { "in": "query", "name": "year", "required": true, "schema": { "type": "number" } }, { "in": "query", "name": "month", "required": false, "schema": { "type": "number" } } ], "responses": { "200": { "description": "The call counter stats for the given time-frame.", "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "calls": { "type": "number" }, "duration": { "type": "number" }, "concurrentCalls": { "type": "number" }, "day": { "type": "number" }, "month": { "type": "number" }, "year": { "type": "number" } } } } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/projects/{projectId}/conversationcounter": { "get": { "operationId": "getConversationCounter_2_0", "summary": "Returns conversation counter metrics.", "description": "Returns conversation counts for given input values.", "tags": [ "Analytics v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "projectId", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "query", "name": "year", "required": true, "schema": { "type": "number" } }, { "in": "query", "name": "month", "required": false, "schema": { "type": "number" } }, { "in": "query", "name": "nonConversational", "required": false, "description": "Deprecated. Please no longer use this parameter. Use channel=nonConversational instead.", "schema": { "type": "boolean" } }, { "in": "query", "name": "channel", "required": false, "schema": { "type": "string", "enum": [ "facebook", "alexa", "slack", "generic", "inject", "rest", "realtime", "socket", "webchat", "webchat2", "dialogflow", "twilio", "twilio-sms", "line", "intercom", "microsoftBotFramework", "microsoftTeams", "sunshineConversations", "avaya", "nonConversational", "voiceGateway2" ] } } ], "responses": { "200": { "description": "The conversation counter stats for the given time-frame.", "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "conversations": { "type": "number" }, "day": { "type": "number" }, "month": { "type": "number" }, "year": { "type": "number" }, "channel": { "type": "string" } } } } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/conversationcounter": { "get": { "operationId": "getConversationCounterOrganisation_2_0", "summary": "Returns conversation counter metrics org-wide.", "description": "Returns conversation counts for given input values.", "tags": [ "Analytics v2.0" ], "parameters": [ { "in": "query", "name": "year", "required": true, "schema": { "type": "number" } }, { "in": "query", "name": "month", "required": false, "schema": { "type": "number" } }, { "in": "query", "name": "nonConversational", "required": false, "description": "Deprecated. Please no longer use this parameter. Use channel=nonConversational instead.", "schema": { "type": "boolean" } }, { "in": "query", "name": "channel", "required": false, "schema": { "type": "string", "enum": [ "facebook", "alexa", "slack", "generic", "inject", "rest", "realtime", "socket", "webchat", "webchat2", "dialogflow", "twilio", "twilio-sms", "line", "intercom", "microsoftBotFramework", "microsoftTeams", "sunshineConversations", "avaya", "nonConversational", "voiceGateway2" ] } } ], "responses": { "200": { "description": "The conversation counter stats for the given time-frame.", "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "conversations": { "type": "number" }, "day": { "type": "number" }, "month": { "type": "number" }, "year": { "type": "number" }, "channel": { "type": "string" } } } } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/conversations/{sessionId}": { "delete": { "operationId": "deleteConversation_2_0", "summary": "Deletes a conversation for a session.", "description": "Deletes a conversation in which a specific sessionid is referenced.", "tags": [ "Conversations v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "sessionId", "description": "The Id of the Session", "required": true, "schema": { "type": "string" } }, { "in": "query", "name": "projectId", "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "204": { "description": "Deletes a Conversation." }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "get": { "operationId": "readConversation_2_0", "summary": "Get a conversation", "description": "Get a conversation.", "tags": [ "Conversations v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "query", "name": "projectId", "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "path", "name": "sessionId", "description": "The Id of the Session", "required": true, "schema": { "type": "string" } }, { "in": "query", "name": "expertMode", "schema": { "type": "boolean" }, "description": "expertMode on or off e.g. expertMode=true" } ], "responses": { "200": { "description": "Returns a Conversation.", "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "object", "properties": { "projectId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "projectName": { "type": "string" }, "inputId": { "type": "string" }, "sessionId": { "type": "string" }, "contactId": { "type": "string" }, "organisation": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "inputText": { "type": "string" }, "inputData": { "type": "object" }, "type": { "type": "string", "example": "user", "enum": [ "input", "output" ] }, "source": { "type": "string", "example": "user", "enum": [ "user", "bot", "agent", "suggestion" ] }, "flowName": { "type": "string" }, "flowReferenceId": { "type": "string" }, "channel": { "type": "string", "example": "webchat2", "enum": [ "facebook", "alexa", "slack", "generic", "inject", "rest", "realtime", "socket", "adminconsole", "webchat2", "dialogflow", "twilio", "twilio-sms", "line", "intercom", "microsoftBotFramework", "microsoftTeams", "sunshineConversations", "admin-webchat", "avaya", "nonConversational", "voiceGateway2", "amazonLex", "workplace", "webhook", "abstractRest", "userlike", "ringCentralEngage", "audioCodes", "bandwidth", "whatsapp", "eightByEight", "genesysBotConnector", "niceCXOne", "agentAssistVoice", "webchat3" ] }, "timestamp": { "type": "object" }, "inHandoverRequest": { "type": "boolean" }, "inHandoverConversation": { "type": "boolean" }, "outputId": { "type": "string" }, "expiresAt": { "type": "object" }, "endpointUrlToken": { "type": "string" }, "endpointName": { "type": "string" }, "localeReferenceId": { "type": "string" }, "localeName": { "type": "string" }, "snapshotId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "snapshotName": { "type": "string" }, "rating": { "type": "number" }, "ratingComment": { "type": "string" } } }, "total": { "type": "integer" } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/conversations": { "get": { "operationId": "indexConversations_2_0", "summary": "Get all Conversations", "description": "Get all [Conversations].", "tags": [ "Conversations v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "query", "name": "projectId", "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "query", "name": "contactIds", "schema": { "type": "array", "items": { "type": "string" } } } ], "responses": { "200": { "description": "Returns array of Conversations", "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "_id": { "type": "string" }, "contactId": { "type": "string" }, "channel": { "type": "string", "example": "webchat2", "enum": [ "facebook", "alexa", "slack", "generic", "inject", "rest", "realtime", "socket", "adminconsole", "webchat2", "dialogflow", "twilio", "twilio-sms", "line", "intercom", "microsoftBotFramework", "microsoftTeams", "sunshineConversations", "admin-webchat", "avaya", "nonConversational", "voiceGateway2", "amazonLex", "workplace", "webhook", "abstractRest", "userlike", "ringCentralEngage", "audioCodes", "bandwidth", "whatsapp", "eightByEight", "genesysBotConnector", "niceCXOne", "agentAssistVoice", "webchat3" ] }, "projectId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "projectName": { "type": "string" }, "flowName": { "type": "string" }, "messages": { "type": "integer" }, "startTime": { "type": "string" }, "endTime": { "type": "string" }, "ratings": { "type": "array", "items": { "type": "number" } }, "ratingComments": { "type": "array", "items": { "type": "string" } }, "endpointName": { "type": "string" } } } } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/projects/{projectId}/knowledgequerycounter": { "get": { "operationId": "getKnowledgeQueryCounter_2_0", "summary": "Returns knowledge query counter metrics.", "description": "Returns knowledge query counts for given input values.", "tags": [ "Analytics v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "projectId", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "query", "name": "year", "required": true, "schema": { "type": "number" } }, { "in": "query", "name": "month", "required": false, "schema": { "type": "number" } } ], "responses": { "200": { "description": "The knowlege query counter stats for the given time-frame.", "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "queries": { "type": "number" }, "day": { "type": "number" }, "month": { "type": "number" }, "year": { "type": "number" } } } } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/knowledgequerycounter": { "get": { "operationId": "getKnowledgeQueryCounterOrganisation_2_0", "summary": "Returns knowledge query counter metrics org-wide.", "description": "Returns knowledge query counts for given input values.", "tags": [ "Analytics v2.0" ], "parameters": [ { "in": "query", "name": "year", "required": true, "schema": { "type": "number" } }, { "in": "query", "name": "month", "required": false, "schema": { "type": "number" } } ], "responses": { "200": { "description": "The knowledge query counter stats for the given time-frame.", "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "queries": { "type": "number" }, "day": { "type": "number" }, "month": { "type": "number" }, "year": { "type": "number" } } } } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/projects/{projectId}/logs": { "get": { "operationId": "indexLogEntries_2_0", "summary": "Get LogEntries", "description": "Get 25 [Log Entries](https://docs.cognigy.com/ai/resources/test/logs/) in a project by default. To change the default value, use the `limit` query parameter. Additionally, you can filter, sort, and paginate the results.", "tags": [ "Logs v2.0" ], "parameters": [ { "in": "path", "name": "projectId", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "query", "name": "filter", "required": false, "schema": { "type": "string" }, "description": "The type, msg or traceId of the log entry to filter the records" }, { "in": "query", "name": "limit", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100 }, "description": "The maximum number of items to return. The default is 25." }, { "in": "query", "name": "skip", "required": false, "schema": { "type": "integer", "minimum": 0 }, "description": "The number of items to skip. The default is 0. Used along with a limit of a pagination." }, { "in": "query", "name": "sort", "required": false, "schema": { "type": "string", "minLength": 1 }, "description": "The order of the sorting items-`Desc` (descending) or `Asc` (ascending). For example, to sort the records by name in ascending order, specify `name:Asc`." }, { "in": "query", "name": "next", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the nextCursor value from the response to get the next set of records. Used along with limit for pagination." }, { "in": "query", "name": "previous", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the previousCursor value from the response to get the previous set of records. Used along with limit for pagination." }, { "in": "query", "name": "type", "required": false, "schema": { "type": "array", "items": { "type": "string", "enum": [ "fatal", "error", "warn", "info", "debug", "trace" ] } } }, { "in": "query", "name": "userId", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "flowName", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Returns array of Log Entries", "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "timestamp": { "type": "string", "format": "date-time" }, "msg": { "type": "string" }, "meta": { "type": "object" }, "traceId": { "type": "string" } } } }, "total": { "type": "integer", "example": 1 }, "next": { "oneOf": [ { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, { "nullable": true } ], "example": "5ce7c2d833ea1e04d7e6c432" }, "previous": { "oneOf": [ { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, { "nullable": true } ], "example": null } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/projects/{projectId}/logs/{logEntryId}": { "get": { "operationId": "readLogEntry_2_0", "summary": "Get a LogEntry", "description": "Get a single [LogEntry](doc:logs) resource in a project.", "tags": [ "Logs v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "projectId", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "path", "name": "logEntryId", "description": "The Id of the Log Entry", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "200": { "description": "Returns LogEntry Object", "content": { "application/json": { "schema": { "type": "object", "properties": { "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "timestamp": { "type": "string", "format": "date-time" }, "msg": { "type": "string" }, "meta": { "type": "object" }, "traceId": { "type": "string" } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/profiles": { "post": { "operationId": "createProfile_2_0", "summary": "Create a new Profile", "description": "Create a new [Profile](doc:Profile).", "tags": [ "Profiles v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "profile": { "type": "object", "properties": { "prevent_data_collection": { "type": "boolean" }, "accepted_gdpr": { "type": "boolean" }, "privacy_policy": { "type": "object" }, "goals": { "type": "array", "items": { "type": "string", "example": "buyer" } }, "firstname": { "type": "string", "example": "Max" }, "lastname": { "type": "string", "example": "Mustermann" }, "email": { "type": "string", "format": "email" }, "profilepic": { "type": "string", "example": "" } } }, "active": { "type": "boolean" }, "contactIds": { "type": "array", "items": { "type": "string", "example": "mail@example.com" } }, "projectId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } } } }, "responses": { "201": { "description": "Returns Profile object.", "content": { "application/json": { "schema": { "type": "object", "properties": { "profile": { "type": "object", "properties": { "prevent_data_collection": { "type": "boolean" }, "accepted_gdpr": { "type": "boolean" }, "privacy_policy": { "type": "object" }, "goals": { "type": "array", "items": { "type": "string", "example": "buyer" } }, "firstname": { "type": "string", "example": "Max" }, "lastname": { "type": "string", "example": "Mustermann" }, "email": { "type": "string", "format": "email" }, "profilepic": { "type": "string", "example": "" } } }, "active": { "type": "boolean" }, "contactIds": { "type": "array", "items": { "type": "string", "example": "mail@example.com" } }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "get": { "operationId": "indexProfiles_2_0", "summary": "Get Profiles", "description": "Get 25 [Profiles](https://docs.cognigy.com/ai/resources/manage/contact-profiles/)in a project by default. To change the default value, use the `limit` query parameter. Additionally, you can filter, sort, and paginate the results.", "tags": [ "Profiles v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "query", "name": "projectId", "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "query", "name": "filter", "required": false, "schema": { "type": "string" }, "description": "The contactIds, firstname, lastName or email of the profile to filter the records" }, { "in": "query", "name": "limit", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100 }, "description": "The maximum number of items to return. The default is 25." }, { "in": "query", "name": "skip", "required": false, "schema": { "type": "integer", "minimum": 0 }, "description": "The number of items to skip. The default is 0. Used along with a limit of a pagination." }, { "in": "query", "name": "sort", "required": false, "schema": { "type": "string", "minLength": 1 }, "description": "The order of the sorting items-`Desc` (descending) or `Asc` (ascending). For example, to sort the records by name in ascending order, specify `name:Asc`." }, { "in": "query", "name": "next", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the nextCursor value from the response to get the next set of records. Used along with limit for pagination." }, { "in": "query", "name": "previous", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the previousCursor value from the response to get the previous set of records. Used along with limit for pagination." } ], "responses": { "200": { "description": "Returns array of a Profile metadata objects", "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "profile": { "type": "object", "properties": { "prevent_data_collection": { "type": "boolean" }, "accepted_gdpr": { "type": "boolean" }, "privacy_policy": { "type": "object" }, "goals": { "type": "array", "items": { "type": "string", "example": "buyer" } }, "firstname": { "type": "string", "example": "Max" }, "lastname": { "type": "string", "example": "Mustermann" }, "email": { "type": "string", "format": "email" }, "profilepic": { "type": "string", "example": "" } } }, "active": { "type": "boolean" }, "contactIds": { "type": "array", "items": { "type": "string" } }, "lastChanged": { "type": "number" }, "projectId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } }, "total": { "type": "integer", "example": 1 }, "next": { "oneOf": [ { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, { "nullable": true } ], "example": "5ce7c2d833ea1e04d7e6c432" }, "previous": { "oneOf": [ { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, { "nullable": true } ], "example": null } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/profiles/{profileId}": { "delete": { "operationId": "deleteProfile_2_0", "summary": "Delete a Profile", "description": "Delete a [Profile](doc:Profile).", "tags": [ "Profiles v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "profileId", "description": "The Id of the Profile", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "204": { "description": "Successfully deleted Profile" }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "get": { "operationId": "readProfile_2_0", "summary": "Get a Profile", "description": "Get a single [Profile](doc:Profile).", "tags": [ "Profiles v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "profileId", "description": "The Id of the Profile", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "200": { "description": "Returns Profile Object", "content": { "application/json": { "schema": { "type": "object", "properties": { "profile": { "type": "object", "properties": { "prevent_data_collection": { "type": "boolean" }, "accepted_gdpr": { "type": "boolean" }, "privacy_policy": { "type": "object" }, "goals": { "type": "array", "items": { "type": "string", "example": "buyer" } }, "firstname": { "type": "string", "example": "Max" }, "lastname": { "type": "string", "example": "Mustermann" }, "email": { "type": "string", "format": "email" }, "profilepic": { "type": "string", "example": "" } } }, "active": { "type": "boolean" }, "contactIds": { "type": "array", "items": { "type": "string", "example": "mail@example.com" } }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "patch": { "operationId": "updateProfile", "summary": "Update a Profile", "description": "Update a [Profile](doc:Profile).", "tags": [ "Profiles v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "profileId", "description": "The Id of the Profile", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "profile": { "type": "object", "properties": { "prevent_data_collection": { "type": "boolean" }, "accepted_gdpr": { "type": "boolean" }, "privacy_policy": { "type": "object" }, "goals": { "type": "array", "items": { "type": "string", "example": "buyer" } }, "firstname": { "type": "string", "example": "Max" }, "lastname": { "type": "string", "example": "Mustermann" }, "email": { "type": "string", "format": "email" }, "profilepic": { "type": "string", "example": "" } } }, "active": { "type": "boolean" }, "contactIds": { "type": "array", "items": { "type": "string", "example": "mail@example.com" } } } } } } }, "responses": { "204": { "description": "Successfully updated Profile" }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/profiles/{profileId}/data/export": { "post": { "operationId": "exportProfileData_2_0", "summary": "Export the Profile data", "description": "Export the Profile data", "tags": [ "Profiles v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "profileId", "description": "The Id of the Profile", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "200": { "description": "Returns all profile data", "content": { "application/json": { "schema": { "type": "object", "properties": { "profile": { "type": "object", "properties": { "prevent_data_collection": { "type": "boolean" }, "accepted_gdpr": { "type": "boolean" }, "privacy_policy": { "type": "object" }, "goals": { "type": "array", "items": { "type": "string", "example": "buyer" } }, "firstname": { "type": "string", "example": "Max" }, "lastname": { "type": "string", "example": "Mustermann" }, "email": { "type": "string", "format": "email" }, "profilepic": { "type": "string", "example": "" } } }, "active": { "type": "boolean" }, "contactIds": { "type": "array", "items": { "type": "string", "example": "mail@example.com" } }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "contactInput": { "type": "array", "items": { "type": "object", "properties": { "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "sessionId": { "type": "string", "example": "f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "inputText": { "type": "string", "example": "Hi, my name is Max." }, "timestamp": { "type": "string", "format": "date-time" }, "channel": { "type": "string", "example": "webchat2", "enum": [ "facebook", "alexa", "slack", "generic", "inject", "rest", "realtime", "socket", "adminconsole", "webchat2", "dialogflow", "twilio", "twilio-sms", "line", "intercom", "microsoftBotFramework", "microsoftTeams", "sunshineConversations", "admin-webchat", "avaya", "nonConversational", "voiceGateway2", "amazonLex", "workplace", "webhook", "abstractRest", "userlike", "ringCentralEngage", "audioCodes", "bandwidth", "whatsapp", "eightByEight", "genesysBotConnector", "niceCXOne", "agentAssistVoice", "webchat3" ] } } } } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/profiles/schema/{projectId}": { "get": { "operationId": "getProfileSchema_2_0", "summary": "Get the projects contact profile schema", "description": "Get the Profile schema definition.", "tags": [ "Profiles v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "projectId", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "200": { "description": "Returns Profile schema object.", "content": { "application/json": { "schema": { "type": "object", "properties": { "profile": { "type": "object", "properties": { "prevent_data_collection": { "type": "boolean" }, "accepted_gdpr": { "type": "boolean" }, "privacy_policy": { "type": "object" }, "goals": { "type": "array", "items": { "type": "string", "example": "buyer" } }, "firstname": { "type": "string", "example": "Max" }, "lastname": { "type": "string", "example": "Mustermann" }, "email": { "type": "string", "format": "email" }, "profilepic": { "type": "string", "example": "" } } }, "active": { "type": "boolean" }, "contactIds": { "type": "array", "items": { "type": "string", "example": "mail@example.com" } } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "put": { "operationId": "setProfileSchema_2_0", "summary": "Set the organisation wide Profile schema", "description": "Set the Profile schema definition.", "tags": [ "Profiles v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "projectId", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "details": { "type": "array", "items": { "type": "object", "properties": { "field": { "type": "string" }, "internal": { "type": "string" }, "type": { "type": "string", "enum": [ "string", "object", "number", "boolean" ] } } } } } } } } }, "responses": { "204": { "description": "Successfully updated the Schema." }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/profiles/{profileId}/merge": { "post": { "operationId": "mergeProfiles_2_0", "summary": "Merge two Profiles.", "description": "Merge two Profiles.", "tags": [ "Profiles v2.0" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "contactId": { "type": "string" }, "projectId": { "type": "string" } } } } } }, "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "profileId", "description": "The Id of the Profile", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "204": { "description": "Successfully merged Profiles" }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/profiles/{profileId}/contactids/remove": { "post": { "operationId": "removeContactIdFromProfile_2_0", "summary": "Remove a contactId from a profile", "tags": [ "Profiles v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "profileId", "description": "The Id of the Profile", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "contactId": { "type": "string" } } } } } }, "responses": { "204": { "description": "Successfully deleted Conversations" }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/profiles/{profileId}/data/remove": { "post": { "operationId": "removeProfileData_2_0", "summary": "Delete the data associated with the Profile", "description": "Delete the Data associated with the [Profile](doc:Profile).", "tags": [ "Profiles v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "profileId", "description": "The Id of the Profile", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "204": { "description": "Successfully deleted Data" }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/profiles/{profileId}/unmerge": { "post": { "operationId": "unmergeProfiles_2_0", "summary": "Unmerge two Profiles.", "description": "Unmerge two Profiles.", "tags": [ "Profiles v2.0" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "contactId": { "type": "string" } } } } } }, "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "profileId", "description": "The Id of the Profile", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "200": { "description": "Successfully unmerged Profiles" }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/tasks/{taskId}/cancel": { "post": { "operationId": "cancelTask_2_0", "summary": "Cancel a task", "description": "Cancel a [Task](doc:task) to a project.", "tags": [ "Tasks v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "taskId", "description": "The Id of the Task", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "202": { "description": "Successfully set task to cancelling-state" }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/tasks": { "get": { "operationId": "indexTasks_2_0", "summary": "Get Tasks", "description": "Get 25 [Tasks](https://docs.cognigy.com/ai/resources/agents/tasks/) of a project by default. To change the default value, use the `limit` query parameter. Additionally, you can filter, sort, and paginate the results.", "tags": [ "Tasks v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "query", "name": "projectId", "description": "Filter by projectId", "required": false, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "query", "name": "filter", "required": false, "schema": { "type": "string" }, "description": "The type of the task to filter the records" }, { "in": "query", "name": "limit", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100 }, "description": "The maximum number of items to return. The default is 25." }, { "in": "query", "name": "skip", "required": false, "schema": { "type": "integer", "minimum": 0 }, "description": "The number of items to skip. The default is 0. Used along with a limit of a pagination." }, { "in": "query", "name": "sort", "required": false, "schema": { "type": "string", "minLength": 1 }, "description": "The order of the sorting items-`Desc` (descending) or `Asc` (ascending). For example, to sort the records by name in ascending order, specify `name:Asc`." }, { "in": "query", "name": "next", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the nextCursor value from the response to get the next set of records. Used along with limit for pagination." }, { "in": "query", "name": "previous", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the previousCursor value from the response to get the previous set of records. Used along with limit for pagination." } ], "responses": { "200": { "description": "Returns array of a tasks metadata objects", "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the task" }, "data": { "type": "object", "description": "The parameters of the task" }, "status": { "type": "string", "description": "The status of the task", "example": "queued", "enum": [ "queued", "active", "done", "cancelling", "cancelled", "error" ] }, "currentStep": { "type": "integer" }, "totalStep": { "type": "integer" }, "failReason": { "type": "string" }, "lastRunAt": { "type": "string", "format": "date-time" }, "lastFinishedAt": { "type": "string", "format": "date-time" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" } }, "total": { "type": "integer", "example": 1 }, "next": { "oneOf": [ { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, { "nullable": true } ], "example": "5ce7c2d833ea1e04d7e6c432" }, "previous": { "oneOf": [ { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, { "nullable": true } ], "example": null } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/tasks/{taskId}": { "get": { "operationId": "readTask_2_0", "summary": "Get a Task", "description": "Get a single [Task](doc:task) resource in a project.", "tags": [ "Tasks v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "taskId", "description": "The Id of the Task", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "200": { "description": "Returns Task Object", "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the task" }, "data": { "type": "object", "description": "The parameters of the task" }, "status": { "type": "string", "description": "The status of the task", "example": "queued", "enum": [ "queued", "active", "done", "cancelling", "cancelled", "error" ] }, "currentStep": { "type": "integer" }, "totalStep": { "type": "integer" }, "failReason": { "type": "string" }, "lastRunAt": { "type": "string", "format": "date-time" }, "lastFinishedAt": { "type": "string", "format": "date-time" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/trainer/batch": { "post": { "operationId": "batchTrainerRecords_2_0", "summary": "Batch Operations on TrainerRecords", "description": "Batch Operations on TrainerRecords.", "tags": [ "Trainer v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "projectId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "operations": { "type": "array", "items": { "type": "object" } } } } } } }, "responses": { "204": { "description": "Successfully run the batch operations." }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/trainer/downloadlink": { "post": { "operationId": "composeTrainerRecordsDownloadLink_2_0", "summary": "Creates a download link to a TrainerRecords-Package", "description": "Creates a download link to a [TrainerRecords-Package](doc:trainer).", "tags": [ "Trainer v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "taskId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } } } }, "responses": { "200": { "description": "Returning a link to download the TrainerRecord-Package", "content": { "application/json": { "schema": { "type": "object", "properties": { "downloadLink": { "type": "string", "format": "uri" } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/trainer": { "get": { "operationId": "indexTrainerRecords_2_0", "summary": "Get TrainerRecords", "description": "Get 25 TrainerRecords(https://docs.cognigy.com/ai/resources/tweak/intent-trainer) of a Project by default. To change the default value, use the `limit` query parameter. Additionally, you can filter, sort, and paginate the results.", "tags": [ "Trainer v2.0" ], "parameters": [ { "in": "query", "name": "projectId", "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "query", "name": "filter", "required": false, "schema": { "type": "string" }, "description": "The text of the trainer record to filter the records" }, { "in": "query", "name": "limit", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100 }, "description": "The maximum number of items to return. The default is 25." }, { "in": "query", "name": "skip", "required": false, "schema": { "type": "integer", "minimum": 0 }, "description": "The number of items to skip. The default is 0. Used along with a limit of a pagination." }, { "in": "query", "name": "sort", "required": false, "schema": { "type": "string", "minLength": 1 }, "description": "The order of the sorting items-`Desc` (descending) or `Asc` (ascending). For example, to sort the records by name in ascending order, specify `name:Asc`." }, { "in": "query", "name": "next", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the nextCursor value from the response to get the next set of records. Used along with limit for pagination." }, { "in": "query", "name": "previous", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the previousCursor value from the response to get the previous set of records. Used along with limit for pagination." }, { "in": "query", "name": "understood", "required": false, "schema": { "type": "string", "enum": [ false, true ] } }, { "in": "query", "name": "intentFound", "required": false, "schema": { "type": "string", "enum": [ false, true ] } }, { "in": "query", "name": "slotFound", "required": false, "schema": { "type": "string", "enum": [ false, true ] } }, { "in": "query", "name": "userSlotsFound", "required": false, "schema": { "type": "string", "enum": [ false, true ] } }, { "in": "query", "name": "systemSlotsFound", "required": false, "schema": { "type": "string", "enum": [ false, true ] } }, { "in": "query", "name": "type", "required": false, "schema": { "type": "array", "items": { "type": "string", "enum": [ "Greeting", "pAnswer", "nAnswer", "BGreeting" ] } } }, { "in": "query", "name": "scoreRange", "required": false, "description": "A minimum and maximum range to filter with intent score. Example [0.3,0.6]", "schema": { "type": "array", "items": { "type": "number" }, "minItems": 2, "maxItems": 2 } } ], "responses": { "200": { "description": "Returns the Trainer Records with pagination", "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "text": { "type": "string", "description": "The text of the user", "example": "I want a Pizza" }, "count": { "type": "number", "description": "How often the text was used as an input", "example": 2 }, "flowReferenceId": { "type": "string", "format": "uuid" }, "handled": { "type": "boolean" }, "handleAction": { "type": "string", "enum": [ "addedToIntent", "skip", "ignored" ] }, "nlu": { "type": "object", "description": "The last NLU object that was created (from InputObject) based on the message" }, "meta": { "type": "object" }, "snapshotReference": { "type": "string", "description": "Reference to a snapshot in case this record was created because a user talked to a snapshot" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" } }, "total": { "type": "integer", "example": 1 }, "next": { "oneOf": [ { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, { "nullable": true } ], "example": "5ce7c2d833ea1e04d7e6c432" }, "previous": { "oneOf": [ { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, { "nullable": true } ], "example": null } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/trainer/package": { "post": { "operationId": "packageTrainerRecords_2_0", "summary": "Package TrainerRecords", "description": "Package [TrainerRecords](doc:trainer).", "tags": [ "Trainer v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "projectId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } } } }, "responses": { "202": { "description": "Successfully created a Task to package TrainerRecords.", "content": { "application/json": { "schema": { "type": "object", "properties": { "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "status": { "type": "string", "description": "The status of the task", "example": "queued", "enum": [ "queued", "active", "done", "cancelling", "cancelled", "error" ] }, "type": { "type": "string", "example": "trainIntents" }, "parameters": { "type": "object" }, "lastChangedAt": { "type": "number", "example": 1594243850 }, "lastCreatedAt": { "type": "number", "example": 1594243850 }, "currentStep": { "type": "integer", "example": 0 }, "totalStep": { "type": "integer", "example": 100 } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/trainer/{recordId}": { "get": { "operationId": "readTrainerRecord_2_0", "summary": "Get a TrainerRecord", "description": "Get a single [TrainerRecord](doc:logs) resource in a project.", "tags": [ "Trainer v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "recordId", "description": "The Id of the Record", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "200": { "description": "Returns TrainerRecord Object", "content": { "application/json": { "schema": { "type": "object", "properties": { "text": { "type": "string", "description": "The text of the user", "example": "I want a Pizza" }, "count": { "type": "number", "description": "How often the text was used as an input", "example": 2 }, "flowReferenceId": { "type": "string", "format": "uuid" }, "handled": { "type": "boolean" }, "handleAction": { "type": "string", "enum": [ "addedToIntent", "skip", "ignored" ] }, "nlu": { "type": "object", "description": "The last NLU object that was created (from InputObject) based on the message" }, "meta": { "type": "object" }, "snapshotReference": { "type": "string", "description": "Reference to a snapshot in case this record was created because a user talked to a snapshot" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/trainer/upload": { "post": { "operationId": "uploadTrainerRecordsPackage_2_0", "summary": "Uploads a TrainerRecords package", "description": "Uploads a [TrainerRecords](doc:trainerRecords) package.", "tags": [ "Trainer v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" } ], "requestBody": { "required": true, "content": { "multipart/form-data": { "schema": { "type": "object", "properties": { "projectId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "file": { "type": "string", "format": "binary" } } }, "encoding": { "file": { "contentType": "application/gzip" } } } } }, "responses": { "202": { "description": "Succesfully uploaded the TrainerRecords and queued a processing Task.", "content": { "application/json": { "schema": { "type": "object", "properties": { "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "status": { "type": "string", "description": "The status of the task", "example": "queued", "enum": [ "queued", "active", "done", "cancelling", "cancelled", "error" ] }, "type": { "type": "string", "example": "trainIntents" }, "parameters": { "type": "object" }, "lastChangedAt": { "type": "number", "example": 1594243850 }, "lastCreatedAt": { "type": "number", "example": 1594243850 }, "currentStep": { "type": "integer", "example": 0 }, "totalStep": { "type": "integer", "example": 100 } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/projects/{projectId}/nlu/scores": { "post": { "operationId": "generateNluScores", "summary": "Generate NLU Scores", "description": "Receives a JSON payload with flowReferenceId, localeReferenceId, and a sentence to analyze, and returns NLU scores for the sentence.", "tags": [ "Projects v2.0" ], "parameters": [ { "in": "path", "name": "projectId", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "flowReferenceId", "localeReferenceId", "sentence" ], "properties": { "flowReferenceId": { "type": "string", "format": "uuid", "description": "UUID of the flow reference." }, "localeReferenceId": { "type": "string", "format": "uuid", "description": "UUID of the locale reference." }, "sentence": { "type": "string", "description": "Sentence to analyze for NLU scoring." } } } } } }, "responses": { "200": { "description": "Returns a collection of matching NLU Intents and Scores for the given sentence.", "content": { "application/json": { "schema": { "type": "object", "properties": { "scores": { "type": "array", "description": "NLU scores based on the analysis.", "items": { "type": "object", "properties": { "id": { "type": "string", "description": "Unique identifier of the score." }, "name": { "type": "string", "description": "Name of the score type." }, "score": { "type": "number", "description": "Numerical value of the score." }, "negated": { "type": "boolean", "description": "Indicates if the score is negated." }, "confirmationSentence": { "type": "string", "description": "Sentence used to confirm the score." }, "confirmationSentences": { "type": "array", "items": { "type": "string" }, "description": "Multiple sentences for confirmation if applicable." }, "disambiguationSentence": { "type": "string", "description": "Sentence used for disambiguation." }, "flow": { "type": "string", "description": "UUID of the flow associated with the score." } } } } } }, "example": { "scores": [ { "id": "8870303c-2934-4145-a9c4-e2d89f05e3cf", "name": "food", "score": 0.6269008375746541, "negated": false, "confirmationSentence": null, "confirmationSentences": null, "disambiguationSentence": null, "flow": "43b8f152-f82c-4d0b-b7ae-04db34de8b68" } ] } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/files/{fileToken}": { "get": { "operationId": "readFileBlob_2_0", "summary": "Get binary data of a file.", "description": "Get binary data of a [File](doc:file) in a project.", "tags": [ "Files v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "fileToken", "description": "The token of the File", "required": true, "schema": { "type": "string", "pattern": "/[a-fA-F0-9]{64}/" } } ], "responses": { "200": { "description": "Binary data of the file object" }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/aicopilotconfigs": { "post": { "operationId": "createAiCopilotConfig_2_0", "summary": "Creates an AI Copilot configuration", "description": "The AI Copilot Config defines the grid layout, which serves as the structure for your AI Copilot Workspace. After creation, the configuration should be selected in the Cognigy.AI Endpoint under the AI Copilot Settings section.", "tags": [ "AICopilotConfigs v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "description": "The human readable name of the config." }, "description": { "type": "string", "description": "The description which can be used to understand what the agent assist config contains in terms of tiles." }, "config": { "type": "object", "description": "The actual grid-config.", "properties": { "grid": { "type": "object", "properties": { "columns": { "type": "number", "description": "Number of columns in the grid." }, "rows": { "type": "number", "description": "Number of rows in the grid." }, "gap": { "type": "number", "description": "Padding between tiles in pixels. The default value is 10. If you set it to 0, the default will be used." } } }, "tiles": { "type": "object", "properties": { "tile-id": { "type": "object", "description": "The Tile ID is used in the Flow Nodes to fill in this specific tile.", "properties": { "x": { "type": "number", "description": "The row number where the tile is located, starting from 1." }, "y": { "type": "number", "description": "The column number where the tile is located, starting from 1." }, "columns": { "type": "number", "description": "The number of columns the tile should occupy. The default value is 1." }, "rows": { "type": "number", "description": "The number of rows the tile should occupy. The default value is 1." } } } } } } }, "projectId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } } } }, "responses": { "201": { "description": "Returns agent assist config object.", "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "description": "The human readable name of the config." }, "description": { "type": "string", "description": "The description which can be used to understand what the agent assist config contains in terms of tiles." }, "config": { "type": "object", "description": "The actual grid-config.", "properties": { "grid": { "type": "object", "properties": { "columns": { "type": "number", "description": "Number of columns in the grid." }, "rows": { "type": "number", "description": "Number of rows in the grid." }, "gap": { "type": "number", "description": "Padding between tiles in pixels. The default value is 10. If you set it to 0, the default will be used." } } }, "tiles": { "type": "object", "properties": { "tile-id": { "type": "object", "description": "The Tile ID is used in the Flow Nodes to fill in this specific tile.", "properties": { "x": { "type": "number", "description": "The row number where the tile is located, starting from 1." }, "y": { "type": "number", "description": "The column number where the tile is located, starting from 1." }, "columns": { "type": "number", "description": "The number of columns the tile should occupy. The default value is 1." }, "rows": { "type": "number", "description": "The number of rows the tile should occupy. The default value is 1." } } } } } } }, "referenceId": { "type": "string", "format": "uuid" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "get": { "operationId": "indexAiCopilotConfigs_2_0", "summary": "Get AI Copilot configurations", "description": "Get 25 AI Copilot Configurations in a project by default. To change the default value, use the limit query parameter. Additionally, you can filter, sort, and paginate the results.", "tags": [ "AICopilotConfigs v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "query", "name": "projectId", "description": "Filter by projectId", "required": false, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "query", "name": "filter", "required": false, "schema": { "type": "string" }, "description": "Filter records by specific field eg:name." }, { "in": "query", "name": "limit", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100 }, "description": "The maximum number of items to return. The default is 25." }, { "in": "query", "name": "skip", "required": false, "schema": { "type": "integer", "minimum": 0 }, "description": "The number of items to skip. The default is 0. Used along with a limit of a pagination." }, { "in": "query", "name": "sort", "required": false, "schema": { "type": "string", "minLength": 1 }, "description": "The order of the sorting items-`Desc` (descending) or `Asc` (ascending). For example, to sort the records by name in ascending order, specify `name:Asc`." }, { "in": "query", "name": "next", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the nextCursor value from the response to get the next set of records. Used along with limit for pagination." }, { "in": "query", "name": "previous", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the previousCursor value from the response to get the previous set of records. Used along with limit for pagination." } ], "responses": { "200": { "description": "Returns an array of a AI Copilot config objects", "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string", "description": "The human readable name of the config." }, "description": { "type": "string", "description": "The description which can be used to understand what the agent assist config contains in terms of tiles." }, "config": { "type": "object", "description": "The actual grid-config.", "properties": { "grid": { "type": "object", "properties": { "columns": { "type": "number", "description": "Number of columns in the grid." }, "rows": { "type": "number", "description": "Number of rows in the grid." }, "gap": { "type": "number", "description": "Padding between tiles in pixels. The default value is 10. If you set it to 0, the default will be used." } } }, "tiles": { "type": "object", "properties": { "tile-id": { "type": "object", "description": "The Tile ID is used in the Flow Nodes to fill in this specific tile.", "properties": { "x": { "type": "number", "description": "The row number where the tile is located, starting from 1." }, "y": { "type": "number", "description": "The column number where the tile is located, starting from 1." }, "columns": { "type": "number", "description": "The number of columns the tile should occupy. The default value is 1." }, "rows": { "type": "number", "description": "The number of rows the tile should occupy. The default value is 1." } } } } } } }, "referenceId": { "type": "string", "format": "uuid" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" } }, "total": { "type": "integer", "example": 1 }, "next": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "previous": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/aicopilotconfigs/{configId}": { "delete": { "operationId": "deleteAiCopilotConfig_2_0", "summary": "Deletes an AI Copilot configuration", "description": "Deletes an AiCopilotConfig resource in a project and from the Endpoints referencing it. Note that if you are still using this config in the AI Copilot Config section, first replace it with another config and then proceed with the API Delete request.", "tags": [ "AICopilotConfigs v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "configId", "description": "The Id of the Ai Copilot config", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "204": { "description": "Successfully deleted AI Copilot config" }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "get": { "operationId": "readAiCopilotConfig_2_0", "summary": "Gets an AI Copilot configuration", "description": "Gets a single AiCopilotConfig resource in a project.", "tags": [ "AICopilotConfigs v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "configId", "description": "The Id of the Ai Copilot config", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "200": { "description": "Returns an AI Copilot config object", "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "description": "The human readable name of the config." }, "description": { "type": "string", "description": "The description which can be used to understand what the agent assist config contains in terms of tiles." }, "config": { "type": "object", "description": "The actual grid-config.", "properties": { "grid": { "type": "object", "properties": { "columns": { "type": "number", "description": "Number of columns in the grid." }, "rows": { "type": "number", "description": "Number of rows in the grid." }, "gap": { "type": "number", "description": "Padding between tiles in pixels. The default value is 10. If you set it to 0, the default will be used." } } }, "tiles": { "type": "object", "properties": { "tile-id": { "type": "object", "description": "The Tile ID is used in the Flow Nodes to fill in this specific tile.", "properties": { "x": { "type": "number", "description": "The row number where the tile is located, starting from 1." }, "y": { "type": "number", "description": "The column number where the tile is located, starting from 1." }, "columns": { "type": "number", "description": "The number of columns the tile should occupy. The default value is 1." }, "rows": { "type": "number", "description": "The number of rows the tile should occupy. The default value is 1." } } } } } } }, "referenceId": { "type": "string", "format": "uuid" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "patch": { "operationId": "updateAiCopilotConfig_2_0", "summary": "Updates an AI Copilot configuration", "description": "Updates an AiCopilotConfig resource in a project. Note that you need a relevant project id (agent id) to update the configuration.", "tags": [ "AICopilotConfigs v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "configId", "description": "The Id of the Ai Copilot config", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "description": "The human readable name of the config." }, "description": { "type": "string", "description": "The description which can be used to understand what the agent assist config contains in terms of tiles." }, "config": { "type": "object", "description": "The actual grid-config.", "properties": { "grid": { "type": "object", "properties": { "columns": { "type": "number", "description": "Number of columns in the grid." }, "rows": { "type": "number", "description": "Number of rows in the grid." }, "gap": { "type": "number", "description": "Padding between tiles in pixels. The default value is 10. If you set it to 0, the default will be used." } } }, "tiles": { "type": "object", "properties": { "tile-id": { "type": "object", "description": "The Tile ID is used in the Flow Nodes to fill in this specific tile.", "properties": { "x": { "type": "number", "description": "The row number where the tile is located, starting from 1." }, "y": { "type": "number", "description": "The column number where the tile is located, starting from 1." }, "columns": { "type": "number", "description": "The number of columns the tile should occupy. The default value is 1." }, "rows": { "type": "number", "description": "The number of rows the tile should occupy. The default value is 1." } } } } } } } } } } } }, "responses": { "204": { "description": "Successfully updated agent assist config" }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/connections": { "patch": { "operationId": "batchConnections_2_0", "summary": "Batch Operations on Connections", "description": "Batch Operations on Connections.", "tags": [ "Connections v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "query", "name": "projectId", "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "operations": { "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "op": { "type": "string", "enum": [ "delete" ] }, "id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } }, { "type": "object", "properties": { "op": { "type": "string", "enum": [ "create" ] }, "value": { "type": "object", "properties": { "name": { "type": "string", "example": "some name" }, "isDeprecated": { "type": "boolean", "description": "Marked 'true' if the connection type is deprecated" }, "type": { "type": "string", "example": "http_basic" }, "extension": { "type": "string", "example": "@cognigy/basic-nodes" }, "fields": { "type": "object", "description": "The fields of the Connection. Key-Value pairs. The key should match the connection schema of the specific connection type.", "minProperties": 1, "maxProperties": 10, "example": { "some-key-from-connection-schema": "x123sdfu12312" } } } } } }, { "type": "object", "properties": { "op": { "type": "string", "enum": [ "update" ] }, "id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "value": { "type": "object", "properties": { "fields": { "type": "object", "description": "The fields of the Connection. Key-Value pairs. The key should match the connection schema of the specific connection type.", "minProperties": 1, "maxProperties": 10, "example": { "some-key-from-connection-schema": "x123sdfu12312" } } } } } } ] } } } } } } }, "responses": { "200": { "description": "Successfully ran the batch operations.", "content": { "application/json": { "schema": { "type": "object", "properties": { "created": { "type": "array", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "updated": { "type": "array", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "deleted": { "type": "array", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "post": { "operationId": "createConnection_2_0", "summary": "Creates a new Connection", "description": "Creates a new [Connection](doc:connection) resource in a project.", "tags": [ "Connections v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "example": "some name" }, "isDeprecated": { "type": "boolean", "description": "Marked 'true' if the connection type is deprecated" }, "type": { "type": "string", "example": "http_basic" }, "extension": { "type": "string", "example": "@cognigy/basic-nodes" }, "fields": { "type": "object", "description": "The fields of the Connection. Key-Value pairs. The key should match the connection schema of the specific connection type.", "minProperties": 1, "maxProperties": 10, "example": { "some-key-from-connection-schema": "x123sdfu12312" } }, "projectId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } } } }, "responses": { "201": { "description": "Returns Connection metadata object.", "content": { "application/json": { "schema": { "type": "object", "properties": { "key": { "type": "string", "description": "The key of the connection field. The key should match the connection schema of the specific connection type.", "example": "some-key-from-connection-schema" }, "value": { "type": "string", "description": "The value of the connection field", "example": "x123w123" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "get": { "operationId": "indexConnections_2_0", "summary": "Get Connections", "description": "Get 25 [Connections](https://docs.cognigy.com/ai/resources/build/connections/) in a project by default. To change the default value, use the `limit` query parameter. Additionally, you can filter, sort, and paginate the results.", "tags": [ "Connections v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "query", "name": "projectId", "description": "Filter by projectId", "required": false, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "query", "name": "filter", "required": false, "schema": { "type": "string" }, "description": "The name of the connection to filter the records" }, { "in": "query", "name": "limit", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100 }, "description": "The maximum number of items to return. The default is 25." }, { "in": "query", "name": "skip", "required": false, "schema": { "type": "integer", "minimum": 0 }, "description": "The number of items to skip. The default is 0. Used along with a limit of a pagination." }, { "in": "query", "name": "sort", "required": false, "schema": { "type": "string", "minLength": 1 }, "description": "The order of the sorting items-`Desc` (descending) or `Asc` (ascending). For example, to sort the records by name in ascending order, specify `name:Asc`." }, { "in": "query", "name": "next", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the nextCursor value from the response to get the next set of records. Used along with limit for pagination." }, { "in": "query", "name": "previous", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the previousCursor value from the response to get the previous set of records. Used along with limit for pagination." } ], "responses": { "200": { "description": "Returns array of a Connection metadata objects", "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "referenceId": { "type": "string", "description": "The reference id of the Connection", "example": "0f7b5514-e7a5-4947-ae44-7519a23c7403" }, "name": { "type": "string", "description": "The name of the Connection", "example": "azure" }, "isDeprecated": { "type": "boolean", "description": "Marked 'true' if the connection type is deprecated" }, "connectionSchema": { "type": "object", "properties": { "extension": { "type": "string", "description": "The package-name of the extension." }, "type": { "type": "string", "description": "The type of connection." } } }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" } }, "total": { "type": "integer", "example": 1 }, "next": { "oneOf": [ { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, { "nullable": true } ], "example": "5ce7c2d833ea1e04d7e6c432" }, "previous": { "oneOf": [ { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, { "nullable": true } ], "example": null } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/connections/{connectionId}/fields": { "post": { "operationId": "createConnectionField_2_0", "summary": "Creates a field within a Connection", "description": "Creates a [Connection Field](doc:connectionField) in a connection.", "tags": [ "Connections v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "connectionId", "description": "The Id of the Connection", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "key": { "type": "string", "description": "The key of the connection field. The key should match the connection schema of the specific connection type.", "example": "some-key-from-connection-schema" }, "value": { "type": "string", "description": "The value of the connection field", "example": "x123w123" } } } } } }, "responses": { "201": { "description": "The connection field was created." }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/connections/{connectionId}": { "delete": { "operationId": "deleteConnection_2_0", "summary": "Delete a Connection", "description": "Delete a [Connection](doc:connection).", "tags": [ "Connections v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "connectionId", "description": "The Id of the Connection", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "204": { "description": "Successfully deleted Connection" }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "get": { "operationId": "readConnection_2_0", "summary": "Get a Connection", "description": "Get a single [Connection](doc:connection) resource in a project.", "tags": [ "Connections v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "connectionId", "description": "The Id of the Connection", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "200": { "description": "Returns Connection object", "content": { "application/json": { "schema": { "type": "object", "properties": { "key": { "type": "string", "description": "The key of the connection field. The key should match the connection schema of the specific connection type.", "example": "some-key-from-connection-schema" }, "value": { "type": "string", "description": "The value of the connection field", "example": "x123w123" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "patch": { "operationId": "updateConnection_2_0", "summary": "Updates a Connection", "description": "Updates a [Connection](doc:connection).", "tags": [ "Connections v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "connectionId", "description": "The Id of the Connection", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "fields": { "type": "object", "description": "The fields of the Connection. Key-Value pairs. The key should match the connection schema of the specific connection type.", "minProperties": 1, "maxProperties": 10, "example": { "some-key-from-connection-schema": "x123sdfu12312" } } } } } } }, "responses": { "204": { "description": "Successfully updated Flow" }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/connections/{connectionId}/fields/{fieldName}": { "delete": { "operationId": "deleteConnectionField_2_0", "summary": "Delete a field within a Connection", "description": "Delete a [Connection Field](doc:connectionField).", "tags": [ "Connections v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "connectionId", "description": "The Id of the Connection", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "path", "name": "fieldName", "description": "The name of the Connection field", "required": true, "schema": { "type": "string" } } ], "responses": { "204": { "description": "Successfully deleted field from Connection" }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/connections/schemas": { "get": { "operationId": "indexConnectionSchemas_2_0", "summary": "Get schemas for connections", "description": "Get 25 Connection Schemas in a project by default. To change the default value, use the `limit` query parameter. Additionally, you can filter, sort, and paginate the results.", "tags": [ "Connections v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "query", "name": "projectId", "description": "Filter by projectId", "required": false, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "query", "name": "filter", "required": false, "schema": { "type": "string" }, "description": "The type, label or extension of the Connection Schema to filter the records" }, { "in": "query", "name": "limit", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100 }, "description": "The maximum number of items to return. The default is 25." }, { "in": "query", "name": "skip", "required": false, "schema": { "type": "integer", "minimum": 0 }, "description": "The number of items to skip. The default is 0. Used along with a limit of a pagination." }, { "in": "query", "name": "sort", "required": false, "schema": { "type": "string", "minLength": 1 }, "description": "The order of the sorting items-`Desc` (descending) or `Asc` (ascending). For example, to sort the records by name in ascending order, specify `name:Asc`." }, { "in": "query", "name": "next", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the nextCursor value from the response to get the next set of records. Used along with limit for pagination." }, { "in": "query", "name": "previous", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the previousCursor value from the response to get the previous set of records. Used along with limit for pagination." } ], "responses": { "200": { "description": "Returns array of connection schemas", "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "extension": { "type": "string", "description": "The package name of the extension this schema was found", "example": "azure" }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" } }, "total": { "type": "integer", "example": 1 }, "next": { "oneOf": [ { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, { "nullable": true } ], "example": "5ce7c2d833ea1e04d7e6c432" }, "previous": { "oneOf": [ { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, { "nullable": true } ], "example": null } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/endpoints": { "patch": { "operationId": "batchEndpoints_2_0", "summary": "Batch Operations on Endpoints", "description": "Batch Operations on Endpoints.", "tags": [ "Endpoints v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "query", "name": "projectId", "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "operations": { "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "op": { "type": "string", "enum": [ "delete" ] }, "id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } }, { "type": "object", "properties": { "op": { "type": "string", "enum": [ "create" ] }, "value": { "type": "object", "properties": { "foreignId": { "type": "string" }, "channel": { "type": "string", "example": "webchat2", "enum": [ "facebook", "alexa", "slack", "generic", "inject", "rest", "realtime", "socket", "adminconsole", "webchat2", "dialogflow", "twilio", "twilio-sms", "line", "intercom", "microsoftBotFramework", "microsoftTeams", "sunshineConversations", "admin-webchat", "avaya", "nonConversational", "voiceGateway2", "amazonLex", "workplace", "webhook", "abstractRest", "userlike", "ringCentralEngage", "audioCodes", "bandwidth", "whatsapp", "eightByEight", "genesysBotConnector", "niceCXOne", "agentAssistVoice", "webchat3" ] }, "flowId": { "type": "string" }, "localeId": { "type": "string" }, "URLToken": { "type": "string", "description": "The URLToken of the endpoint", "example": "f65b289912c929c2a09523dd48eedb1249bb74384f6561f84b4ffc5e84d2f15f" }, "name": { "type": "string", "description": "The name of the endpoint", "example": "New Endpoint" }, "entrypoint": { "type": "string", "description": "The ID can be either a Snapshot ID or a Project ID. The Endpoint will refer to the chosen one.", "example": "667ed4ae16d66f47dc2a9400" }, "active": { "type": "boolean", "description": "Toggle whether the endpoint is active or not" }, "nluConnectorId": { "oneOf": [ { "type": "string", "description": "The NLUConnector type", "example": "cognigy", "enum": [ "alexa", "dialogflow", "dialogflowBuiltIn", "amazonLexBuiltIn", "luis", "watson", "noNlu", "cognigy", "code", "generativeAI", "lex" ] }, { "type": "string" } ] }, "useConversations": { "type": "boolean", "description": "Whether to collect conversations history for this endpoint" }, "maskIPAddress": { "type": "boolean", "description": "Whether to mask sensitive IP address in input object and analytics data for this endpoint" }, "maskAnalytics": { "type": "boolean", "description": "Whether to mask sensitive data in analytics for this endpoint" }, "maskLogging": { "type": "boolean", "description": "Whether to mask sensitive data in logs for this endpoint" }, "useContactProfiles": { "type": "boolean", "description": "Whether to use contact profiles for this endpoint" }, "useAnalytics": { "type": "boolean", "description": "Whether we should store analytics for this endpoint" }, "useChatbaseAnalytics": { "type": "boolean", "description": "Whether we should use Chatbase to collect analytics" }, "chatbaseApikey": { "type": "string", "description": "The apikey for the Chatbase bot" }, "useDashbotAnalytics": { "type": "boolean", "description": "Whether we should use Dashbot to collect analytics" }, "dashbotApikey": { "type": "string", "description": "The apikey for the dashbot bot" }, "dashbotPlatform": { "type": "string" }, "disableInputSanitization": { "type": "string", "description": "If true, disables input text sanitization after Input Transformer" }, "overrideSnapshotConnections": { "type": "boolean" }, "settings": { "type": "object", "properties": { "accessScope": { "type": "string" }, "accessToken": { "type": "string" }, "appId": { "type": "string" }, "appSecret": { "type": "string" }, "backgroundImageUrl": { "type": "string" }, "basicAuthPassword": { "type": "string" }, "basicAuthUser": { "type": "string" }, "botUserId": { "type": "string" }, "businessHours": { "type": "object", "properties": { "businessHours": { "type": "array", "items": { "type": "object", "properties": { "startTime": { "type": "string" }, "endTime": { "type": "string" }, "weekDay": { "type": "string" } } } }, "enabled": { "type": "boolean" }, "text": { "type": "string" }, "mode": { "type": "string" }, "timeZone": { "type": "string" }, "title": { "type": "string" } } }, "colorScheme": { "type": "string" }, "connectionName": { "type": "string" }, "customJSON": { "type": "string" }, "designTemplate": { "type": "integer" }, "disableHtmlContentSanitization": { "type": "boolean" }, "disableInputAutocomplete": { "type": "boolean" }, "disableInputAutogrow": { "type": "boolean" }, "disableUrlButtonSanitization": { "type": "boolean" }, "enableGenericHTMLStyling": { "type": "boolean" }, "enableAsyncCommunication": { "type": "boolean" }, "engagementMessageText": { "type": "string" }, "displayGetStartedButton": { "type": "boolean" }, "dynamicImageAspectRatio": { "type": "boolean" }, "enableCollectMetadata": { "type": "boolean" }, "enableConnectionStatusIndicator": { "type": "boolean" }, "enableDemoWebchat": { "type": "boolean" }, "enableFileUpload": { "type": "boolean" }, "enablePersistentMenu": { "type": "boolean" }, "enableRating": { "type": "string", "enum": [ "onRequest", "always", "once" ] }, "enableSTT": { "type": "boolean" }, "enableTTS": { "type": "boolean" }, "enableUnreadMessageBadge": { "type": "boolean" }, "enableUnreadMessagePreview": { "type": "boolean" }, "enableUnreadMessageSound": { "type": "boolean" }, "enableUnreadMessageTitleIndicator": { "type": "boolean" }, "enableTypingIndicator": { "type": "boolean" }, "facebookPageToken": { "type": "string" }, "focusInputAfterPostback": { "type": "boolean" }, "getStartedButtonText": { "type": "string" }, "getStartedPayload": { "type": "string" }, "getStartedText": { "type": "string" }, "getStartedData": { "type": "string" }, "headerLogoUrl": { "type": "string" }, "hubSecret": { "type": "string" }, "inputAutogrowMaxRows": { "type": "number" }, "inputPlaceholder": { "type": "string" }, "language": { "type": "string" }, "lineChannelAccessToken": { "type": "string" }, "lineChannelSecret": { "type": "string" }, "maintenance": { "type": "object", "properties": { "enabled": { "type": "boolean" }, "mode": { "type": "string" }, "text": { "type": "string" }, "title": { "type": "string" } } }, "mergeContactProfiles": { "type": "boolean" }, "messageDelay": { "type": "integer" }, "messageLogoUrl": { "type": "string" }, "overwriteWebchatBundleUrl": { "type": "string" }, "ratingTitleText": { "type": "string" }, "ratingCommentText": { "type": "string" }, "ratingMessageHistoryRatingText": { "type": "string" }, "ratingMessageHistoryCommentText": { "type": "string" }, "reparseAlexaSlots": { "type": "boolean" }, "requestFacebookProfileData": { "type": "boolean" }, "sessionExpiration": { "type": "integer" }, "shouldOverwriteWebchatBundleUrl": { "type": "boolean" }, "showEngagementMessagesInChat": { "type": "boolean" }, "slackOAuthAccessToken": { "type": "string" }, "slackVerifyToken": { "type": "string" }, "sunshineConversationsChannelKeyId": { "type": "string" }, "sunshineConversationsChannelSecret": { "type": "string" }, "sunshineConversationsChannelUri": { "type": "string", "format": "uri" }, "tenantId": { "type": "string" }, "updateContactProfileWithFacebookProfile": { "type": "boolean" }, "voice": { "type": "string" }, "webhookUrl": { "type": "string", "format": "uri" }, "skill": { "type": "object" }, "persistentMenu": { "type": "object" } } }, "transformerSettings": { "type": "object", "properties": { "abortOnError": { "type": "boolean", "description": "If true, then we will abort the message processing if the transformer throws an error. Otherwise, we will continue with normal message processing in the event of an error.\n" }, "transformer": { "type": "string", "description": "The transformer object as written by the user. This will be displayed in the UI since it includes typings.\n" }, "transpiledTransformer": { "type": "string", "description": "The transformer object written by the user, but without typings. This will be executed.\n" }, "inputTransformerEnabled": { "type": "boolean" }, "outputTransformerEnabled": { "type": "boolean" }, "finalPingTransformerEnabled": { "type": "boolean" }, "notifyTransformerEnabled": { "type": "boolean" }, "injectTransformerEnabled": { "type": "boolean" } } }, "handoverSettings": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "cognigy", "none", "rce" ] }, "providerSettings": { "type": "object", "properties": { "forwardOnlyHandoverConversations": { "type": "boolean", "description": "(rce) Whether to forward all conversations to the provider, or only the conversations that trigger a handover. If this setting is true, then we will only forward conversations were handover was triggered.\n" }, "getQueueUpdates": { "type": "boolean", "description": "(rce) Indicates if queue updates should be enabled to receive events about the estimated wait time\n" }, "apiVersion": { "type": "string", "description": "(salesforce) Salesforce LiveAgent API Version" }, "baseUrl": { "type": "string", "description": "Base URL of the LiveAgent API Deployment" }, "apiAccessToken": { "type": "string", "description": "(rce) The API access token you can create within RCE" }, "baseApiUrl": { "type": "string", "description": "(rce) The API URL to your RCE installation" }, "realtimeAccessToken": { "type": "string", "description": "(rce) The access token for your rce source sdk source" }, "realtimeEndpointUrl": { "type": "string", "description": "(rce) The endpoint URL of your rce source sdk source" }, "webhookSecret": { "type": "string", "description": "(rce) The secret used to secure webhooks in RCE" }, "botCategoryId": { "type": "string", "description": "(rce) The ID of the category you use as the 'bot category' within RCE" }, "agentCategoryId": { "type": "string", "description": "(rce) The ID of the category you use as the 'bot category' within RCE" }, "organizationId": { "type": "string", "description": "(salesforce) Salesforce Organization ID" }, "deploymentId": { "type": "string", "description": "(salesforce) Salesforce LiveAgent Deployment ID" }, "buttonId": { "type": "string", "description": "(salesforce) Salesforce LiveAgent Chat Button ID" } } }, "agentAssistSettings": { "type": "object", "properties": { "copilotType": { "type": "string", "enum": [ "none", "workspace", "whisper" ], "description": "Copilot Type" }, "agentAssistFlowId": { "type": "string", "description": "Copilot flow ID" }, "agentAssistConfigId": { "type": "string", "description": "Selected Copilot Config ReferenceId" }, "enableTranscriptTile": { "type": "boolean", "description": "Enable the transcript tile" }, "enableTranscriptTileChatInput": { "type": "boolean", "description": "Enable the chat input for transcript tile" }, "redactTranscriptTileMessages": { "type": "boolean", "description": "Enable redaction of messages in transcript tile" } } } } }, "orgDataPrivacySettings": { "description": "Organisation data privacy settings overwrite the ones defined on endpoint-level", "type": "object", "properties": { "enabled": { "type": "boolean", "description": "Whether or not organisation data privacy settings are enabled" }, "useAnalytics": { "type": "boolean" }, "storeDataPayload": { "type": "boolean" }, "useContactProfiles": { "type": "boolean" }, "useConversations": { "type": "boolean" }, "maskIPAddress": { "type": "boolean" }, "maskAnalytics": { "type": "boolean" }, "maskLogging": { "type": "boolean" } } } } } } }, { "type": "object", "properties": { "op": { "type": "string", "enum": [ "update" ] }, "id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "value": { "type": "object", "properties": { "foreignId": { "type": "string" }, "channel": { "type": "string", "example": "webchat2", "enum": [ "facebook", "alexa", "slack", "generic", "inject", "rest", "realtime", "socket", "adminconsole", "webchat2", "dialogflow", "twilio", "twilio-sms", "line", "intercom", "microsoftBotFramework", "microsoftTeams", "sunshineConversations", "admin-webchat", "avaya", "nonConversational", "voiceGateway2", "amazonLex", "workplace", "webhook", "abstractRest", "userlike", "ringCentralEngage", "audioCodes", "bandwidth", "whatsapp", "eightByEight", "genesysBotConnector", "niceCXOne", "agentAssistVoice", "webchat3" ] }, "flowId": { "type": "string" }, "localeId": { "type": "string" }, "URLToken": { "type": "string", "description": "The URLToken of the endpoint", "example": "f65b289912c929c2a09523dd48eedb1249bb74384f6561f84b4ffc5e84d2f15f" }, "name": { "type": "string", "description": "The name of the endpoint", "example": "New Endpoint" }, "entrypoint": { "type": "string", "description": "The ID can be either a Snapshot ID or a Project ID. The Endpoint will refer to the chosen one.", "example": "667ed4ae16d66f47dc2a9400" }, "active": { "type": "boolean", "description": "Toggle whether the endpoint is active or not" }, "nluConnectorId": { "oneOf": [ { "type": "string", "description": "The NLUConnector type", "example": "cognigy", "enum": [ "alexa", "dialogflow", "dialogflowBuiltIn", "amazonLexBuiltIn", "luis", "watson", "noNlu", "cognigy", "code", "generativeAI", "lex" ] }, { "type": "string" } ] }, "useConversations": { "type": "boolean", "description": "Whether to collect conversations history for this endpoint" }, "maskIPAddress": { "type": "boolean", "description": "Whether to mask sensitive IP address in input object and analytics data for this endpoint" }, "maskAnalytics": { "type": "boolean", "description": "Whether to mask sensitive data in analytics for this endpoint" }, "maskLogging": { "type": "boolean", "description": "Whether to mask sensitive data in logs for this endpoint" }, "useContactProfiles": { "type": "boolean", "description": "Whether to use contact profiles for this endpoint" }, "useAnalytics": { "type": "boolean", "description": "Whether we should store analytics for this endpoint" }, "useChatbaseAnalytics": { "type": "boolean", "description": "Whether we should use Chatbase to collect analytics" }, "chatbaseApikey": { "type": "string", "description": "The apikey for the Chatbase bot" }, "useDashbotAnalytics": { "type": "boolean", "description": "Whether we should use Dashbot to collect analytics" }, "dashbotApikey": { "type": "string", "description": "The apikey for the dashbot bot" }, "dashbotPlatform": { "type": "string" }, "disableInputSanitization": { "type": "string", "description": "If true, disables input text sanitization after Input Transformer" }, "overrideSnapshotConnections": { "type": "boolean" }, "settings": { "type": "object", "properties": { "accessScope": { "type": "string" }, "accessToken": { "type": "string" }, "appId": { "type": "string" }, "appSecret": { "type": "string" }, "backgroundImageUrl": { "type": "string" }, "basicAuthPassword": { "type": "string" }, "basicAuthUser": { "type": "string" }, "botUserId": { "type": "string" }, "businessHours": { "type": "object", "properties": { "businessHours": { "type": "array", "items": { "type": "object", "properties": { "startTime": { "type": "string" }, "endTime": { "type": "string" }, "weekDay": { "type": "string" } } } }, "enabled": { "type": "boolean" }, "text": { "type": "string" }, "mode": { "type": "string" }, "timeZone": { "type": "string" }, "title": { "type": "string" } } }, "colorScheme": { "type": "string" }, "connectionName": { "type": "string" }, "customJSON": { "type": "string" }, "designTemplate": { "type": "integer" }, "disableHtmlContentSanitization": { "type": "boolean" }, "disableInputAutocomplete": { "type": "boolean" }, "disableInputAutogrow": { "type": "boolean" }, "disableUrlButtonSanitization": { "type": "boolean" }, "enableGenericHTMLStyling": { "type": "boolean" }, "enableAsyncCommunication": { "type": "boolean" }, "engagementMessageText": { "type": "string" }, "displayGetStartedButton": { "type": "boolean" }, "dynamicImageAspectRatio": { "type": "boolean" }, "enableCollectMetadata": { "type": "boolean" }, "enableConnectionStatusIndicator": { "type": "boolean" }, "enableDemoWebchat": { "type": "boolean" }, "enableFileUpload": { "type": "boolean" }, "enablePersistentMenu": { "type": "boolean" }, "enableRating": { "type": "string", "enum": [ "onRequest", "always", "once" ] }, "enableSTT": { "type": "boolean" }, "enableTTS": { "type": "boolean" }, "enableUnreadMessageBadge": { "type": "boolean" }, "enableUnreadMessagePreview": { "type": "boolean" }, "enableUnreadMessageSound": { "type": "boolean" }, "enableUnreadMessageTitleIndicator": { "type": "boolean" }, "enableTypingIndicator": { "type": "boolean" }, "facebookPageToken": { "type": "string" }, "focusInputAfterPostback": { "type": "boolean" }, "getStartedButtonText": { "type": "string" }, "getStartedPayload": { "type": "string" }, "getStartedText": { "type": "string" }, "getStartedData": { "type": "string" }, "headerLogoUrl": { "type": "string" }, "hubSecret": { "type": "string" }, "inputAutogrowMaxRows": { "type": "number" }, "inputPlaceholder": { "type": "string" }, "language": { "type": "string" }, "lineChannelAccessToken": { "type": "string" }, "lineChannelSecret": { "type": "string" }, "maintenance": { "type": "object", "properties": { "enabled": { "type": "boolean" }, "mode": { "type": "string" }, "text": { "type": "string" }, "title": { "type": "string" } } }, "mergeContactProfiles": { "type": "boolean" }, "messageDelay": { "type": "integer" }, "messageLogoUrl": { "type": "string" }, "overwriteWebchatBundleUrl": { "type": "string" }, "ratingTitleText": { "type": "string" }, "ratingCommentText": { "type": "string" }, "ratingMessageHistoryRatingText": { "type": "string" }, "ratingMessageHistoryCommentText": { "type": "string" }, "reparseAlexaSlots": { "type": "boolean" }, "requestFacebookProfileData": { "type": "boolean" }, "sessionExpiration": { "type": "integer" }, "shouldOverwriteWebchatBundleUrl": { "type": "boolean" }, "showEngagementMessagesInChat": { "type": "boolean" }, "slackOAuthAccessToken": { "type": "string" }, "slackVerifyToken": { "type": "string" }, "sunshineConversationsChannelKeyId": { "type": "string" }, "sunshineConversationsChannelSecret": { "type": "string" }, "sunshineConversationsChannelUri": { "type": "string", "format": "uri" }, "tenantId": { "type": "string" }, "updateContactProfileWithFacebookProfile": { "type": "boolean" }, "voice": { "type": "string" }, "webhookUrl": { "type": "string", "format": "uri" }, "skill": { "type": "object" }, "persistentMenu": { "type": "object" } } }, "transformerSettings": { "type": "object", "properties": { "abortOnError": { "type": "boolean", "description": "If true, then we will abort the message processing if the transformer throws an error. Otherwise, we will continue with normal message processing in the event of an error.\n" }, "transformer": { "type": "string", "description": "The transformer object as written by the user. This will be displayed in the UI since it includes typings.\n" }, "transpiledTransformer": { "type": "string", "description": "The transformer object written by the user, but without typings. This will be executed.\n" }, "inputTransformerEnabled": { "type": "boolean" }, "outputTransformerEnabled": { "type": "boolean" }, "finalPingTransformerEnabled": { "type": "boolean" }, "notifyTransformerEnabled": { "type": "boolean" }, "injectTransformerEnabled": { "type": "boolean" } } }, "handoverSettings": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "cognigy", "none", "rce" ] }, "providerSettings": { "type": "object", "properties": { "forwardOnlyHandoverConversations": { "type": "boolean", "description": "(rce) Whether to forward all conversations to the provider, or only the conversations that trigger a handover. If this setting is true, then we will only forward conversations were handover was triggered.\n" }, "getQueueUpdates": { "type": "boolean", "description": "(rce) Indicates if queue updates should be enabled to receive events about the estimated wait time\n" }, "apiVersion": { "type": "string", "description": "(salesforce) Salesforce LiveAgent API Version" }, "baseUrl": { "type": "string", "description": "Base URL of the LiveAgent API Deployment" }, "apiAccessToken": { "type": "string", "description": "(rce) The API access token you can create within RCE" }, "baseApiUrl": { "type": "string", "description": "(rce) The API URL to your RCE installation" }, "realtimeAccessToken": { "type": "string", "description": "(rce) The access token for your rce source sdk source" }, "realtimeEndpointUrl": { "type": "string", "description": "(rce) The endpoint URL of your rce source sdk source" }, "webhookSecret": { "type": "string", "description": "(rce) The secret used to secure webhooks in RCE" }, "botCategoryId": { "type": "string", "description": "(rce) The ID of the category you use as the 'bot category' within RCE" }, "agentCategoryId": { "type": "string", "description": "(rce) The ID of the category you use as the 'bot category' within RCE" }, "organizationId": { "type": "string", "description": "(salesforce) Salesforce Organization ID" }, "deploymentId": { "type": "string", "description": "(salesforce) Salesforce LiveAgent Deployment ID" }, "buttonId": { "type": "string", "description": "(salesforce) Salesforce LiveAgent Chat Button ID" } } }, "agentAssistSettings": { "type": "object", "properties": { "copilotType": { "type": "string", "enum": [ "none", "workspace", "whisper" ], "description": "Copilot Type" }, "agentAssistFlowId": { "type": "string", "description": "Copilot flow ID" }, "agentAssistConfigId": { "type": "string", "description": "Selected Copilot Config ReferenceId" }, "enableTranscriptTile": { "type": "boolean", "description": "Enable the transcript tile" }, "enableTranscriptTileChatInput": { "type": "boolean", "description": "Enable the chat input for transcript tile" }, "redactTranscriptTileMessages": { "type": "boolean", "description": "Enable redaction of messages in transcript tile" } } } } }, "orgDataPrivacySettings": { "description": "Organisation data privacy settings overwrite the ones defined on endpoint-level", "type": "object", "properties": { "enabled": { "type": "boolean", "description": "Whether or not organisation data privacy settings are enabled" }, "useAnalytics": { "type": "boolean" }, "storeDataPayload": { "type": "boolean" }, "useContactProfiles": { "type": "boolean" }, "useConversations": { "type": "boolean" }, "maskIPAddress": { "type": "boolean" }, "maskAnalytics": { "type": "boolean" }, "maskLogging": { "type": "boolean" } } } } } } } ] } } } } } } }, "responses": { "200": { "description": "Successfully ran the batch operations.", "content": { "application/json": { "schema": { "type": "object", "properties": { "created": { "type": "array", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "updated": { "type": "array", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "deleted": { "type": "array", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "post": { "operationId": "createEndpoint_2_0", "summary": "Create a new Endpoint", "description": "Create a new [Endpoint](doc:endpoint) resource in a project.", "tags": [ "Endpoints v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "query", "name": "resourceId", "description": "An Id of a resource within the corresponding project to copy from", "required": false, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "foreignId": { "type": "string" }, "channel": { "type": "string", "example": "webchat2", "enum": [ "facebook", "alexa", "slack", "generic", "inject", "rest", "realtime", "socket", "adminconsole", "webchat2", "dialogflow", "twilio", "twilio-sms", "line", "intercom", "microsoftBotFramework", "microsoftTeams", "sunshineConversations", "admin-webchat", "avaya", "nonConversational", "voiceGateway2", "amazonLex", "workplace", "webhook", "abstractRest", "userlike", "ringCentralEngage", "audioCodes", "bandwidth", "whatsapp", "eightByEight", "genesysBotConnector", "niceCXOne", "agentAssistVoice", "webchat3" ] }, "flowId": { "type": "string" }, "localeId": { "type": "string" }, "URLToken": { "type": "string", "description": "The URLToken of the endpoint", "example": "f65b289912c929c2a09523dd48eedb1249bb74384f6561f84b4ffc5e84d2f15f" }, "name": { "type": "string", "description": "The name of the endpoint", "example": "New Endpoint" }, "entrypoint": { "type": "string", "description": "The ID can be either a Snapshot ID or a Project ID. The Endpoint will refer to the chosen one.", "example": "667ed4ae16d66f47dc2a9400" }, "active": { "type": "boolean", "description": "Toggle whether the endpoint is active or not" }, "nluConnectorId": { "oneOf": [ { "type": "string", "description": "The NLUConnector type", "example": "cognigy", "enum": [ "alexa", "dialogflow", "dialogflowBuiltIn", "amazonLexBuiltIn", "luis", "watson", "noNlu", "cognigy", "code", "generativeAI", "lex" ] }, { "type": "string" } ] }, "useConversations": { "type": "boolean", "description": "Whether to collect conversations history for this endpoint" }, "maskIPAddress": { "type": "boolean", "description": "Whether to mask sensitive IP address in input object and analytics data for this endpoint" }, "maskAnalytics": { "type": "boolean", "description": "Whether to mask sensitive data in analytics for this endpoint" }, "maskLogging": { "type": "boolean", "description": "Whether to mask sensitive data in logs for this endpoint" }, "useContactProfiles": { "type": "boolean", "description": "Whether to use contact profiles for this endpoint" }, "useAnalytics": { "type": "boolean", "description": "Whether we should store analytics for this endpoint" }, "useChatbaseAnalytics": { "type": "boolean", "description": "Whether we should use Chatbase to collect analytics" }, "chatbaseApikey": { "type": "string", "description": "The apikey for the Chatbase bot" }, "useDashbotAnalytics": { "type": "boolean", "description": "Whether we should use Dashbot to collect analytics" }, "dashbotApikey": { "type": "string", "description": "The apikey for the dashbot bot" }, "dashbotPlatform": { "type": "string" }, "disableInputSanitization": { "type": "string", "description": "If true, disables input text sanitization after Input Transformer" }, "overrideSnapshotConnections": { "type": "boolean" }, "settings": { "type": "object", "properties": { "accessScope": { "type": "string" }, "accessToken": { "type": "string" }, "appId": { "type": "string" }, "appSecret": { "type": "string" }, "backgroundImageUrl": { "type": "string" }, "basicAuthPassword": { "type": "string" }, "basicAuthUser": { "type": "string" }, "botUserId": { "type": "string" }, "businessHours": { "type": "object", "properties": { "businessHours": { "type": "array", "items": { "type": "object", "properties": { "startTime": { "type": "string" }, "endTime": { "type": "string" }, "weekDay": { "type": "string" } } } }, "enabled": { "type": "boolean" }, "text": { "type": "string" }, "mode": { "type": "string" }, "timeZone": { "type": "string" }, "title": { "type": "string" } } }, "colorScheme": { "type": "string" }, "connectionName": { "type": "string" }, "customJSON": { "type": "string" }, "designTemplate": { "type": "integer" }, "disableHtmlContentSanitization": { "type": "boolean" }, "disableInputAutocomplete": { "type": "boolean" }, "disableInputAutogrow": { "type": "boolean" }, "disableUrlButtonSanitization": { "type": "boolean" }, "enableGenericHTMLStyling": { "type": "boolean" }, "enableAsyncCommunication": { "type": "boolean" }, "engagementMessageText": { "type": "string" }, "displayGetStartedButton": { "type": "boolean" }, "dynamicImageAspectRatio": { "type": "boolean" }, "enableCollectMetadata": { "type": "boolean" }, "enableConnectionStatusIndicator": { "type": "boolean" }, "enableDemoWebchat": { "type": "boolean" }, "enableFileUpload": { "type": "boolean" }, "enablePersistentMenu": { "type": "boolean" }, "enableRating": { "type": "string", "enum": [ "onRequest", "always", "once" ] }, "enableSTT": { "type": "boolean" }, "enableTTS": { "type": "boolean" }, "enableUnreadMessageBadge": { "type": "boolean" }, "enableUnreadMessagePreview": { "type": "boolean" }, "enableUnreadMessageSound": { "type": "boolean" }, "enableUnreadMessageTitleIndicator": { "type": "boolean" }, "enableTypingIndicator": { "type": "boolean" }, "facebookPageToken": { "type": "string" }, "focusInputAfterPostback": { "type": "boolean" }, "getStartedButtonText": { "type": "string" }, "getStartedPayload": { "type": "string" }, "getStartedText": { "type": "string" }, "getStartedData": { "type": "string" }, "headerLogoUrl": { "type": "string" }, "hubSecret": { "type": "string" }, "inputAutogrowMaxRows": { "type": "number" }, "inputPlaceholder": { "type": "string" }, "language": { "type": "string" }, "lineChannelAccessToken": { "type": "string" }, "lineChannelSecret": { "type": "string" }, "maintenance": { "type": "object", "properties": { "enabled": { "type": "boolean" }, "mode": { "type": "string" }, "text": { "type": "string" }, "title": { "type": "string" } } }, "mergeContactProfiles": { "type": "boolean" }, "messageDelay": { "type": "integer" }, "messageLogoUrl": { "type": "string" }, "overwriteWebchatBundleUrl": { "type": "string" }, "ratingTitleText": { "type": "string" }, "ratingCommentText": { "type": "string" }, "ratingMessageHistoryRatingText": { "type": "string" }, "ratingMessageHistoryCommentText": { "type": "string" }, "reparseAlexaSlots": { "type": "boolean" }, "requestFacebookProfileData": { "type": "boolean" }, "sessionExpiration": { "type": "integer" }, "shouldOverwriteWebchatBundleUrl": { "type": "boolean" }, "showEngagementMessagesInChat": { "type": "boolean" }, "slackOAuthAccessToken": { "type": "string" }, "slackVerifyToken": { "type": "string" }, "sunshineConversationsChannelKeyId": { "type": "string" }, "sunshineConversationsChannelSecret": { "type": "string" }, "sunshineConversationsChannelUri": { "type": "string", "format": "uri" }, "tenantId": { "type": "string" }, "updateContactProfileWithFacebookProfile": { "type": "boolean" }, "voice": { "type": "string" }, "webhookUrl": { "type": "string", "format": "uri" }, "skill": { "type": "object" }, "persistentMenu": { "type": "object" } } }, "transformerSettings": { "type": "object", "properties": { "abortOnError": { "type": "boolean", "description": "If true, then we will abort the message processing if the transformer throws an error. Otherwise, we will continue with normal message processing in the event of an error.\n" }, "transformer": { "type": "string", "description": "The transformer object as written by the user. This will be displayed in the UI since it includes typings.\n" }, "transpiledTransformer": { "type": "string", "description": "The transformer object written by the user, but without typings. This will be executed.\n" }, "inputTransformerEnabled": { "type": "boolean" }, "outputTransformerEnabled": { "type": "boolean" }, "finalPingTransformerEnabled": { "type": "boolean" }, "notifyTransformerEnabled": { "type": "boolean" }, "injectTransformerEnabled": { "type": "boolean" } } }, "handoverSettings": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "cognigy", "none", "rce" ] }, "providerSettings": { "type": "object", "properties": { "forwardOnlyHandoverConversations": { "type": "boolean", "description": "(rce) Whether to forward all conversations to the provider, or only the conversations that trigger a handover. If this setting is true, then we will only forward conversations were handover was triggered.\n" }, "getQueueUpdates": { "type": "boolean", "description": "(rce) Indicates if queue updates should be enabled to receive events about the estimated wait time\n" }, "apiVersion": { "type": "string", "description": "(salesforce) Salesforce LiveAgent API Version" }, "baseUrl": { "type": "string", "description": "Base URL of the LiveAgent API Deployment" }, "apiAccessToken": { "type": "string", "description": "(rce) The API access token you can create within RCE" }, "baseApiUrl": { "type": "string", "description": "(rce) The API URL to your RCE installation" }, "realtimeAccessToken": { "type": "string", "description": "(rce) The access token for your rce source sdk source" }, "realtimeEndpointUrl": { "type": "string", "description": "(rce) The endpoint URL of your rce source sdk source" }, "webhookSecret": { "type": "string", "description": "(rce) The secret used to secure webhooks in RCE" }, "botCategoryId": { "type": "string", "description": "(rce) The ID of the category you use as the 'bot category' within RCE" }, "agentCategoryId": { "type": "string", "description": "(rce) The ID of the category you use as the 'bot category' within RCE" }, "organizationId": { "type": "string", "description": "(salesforce) Salesforce Organization ID" }, "deploymentId": { "type": "string", "description": "(salesforce) Salesforce LiveAgent Deployment ID" }, "buttonId": { "type": "string", "description": "(salesforce) Salesforce LiveAgent Chat Button ID" } } }, "agentAssistSettings": { "type": "object", "properties": { "copilotType": { "type": "string", "enum": [ "none", "workspace", "whisper" ], "description": "Copilot Type" }, "agentAssistFlowId": { "type": "string", "description": "Copilot flow ID" }, "agentAssistConfigId": { "type": "string", "description": "Selected Copilot Config ReferenceId" }, "enableTranscriptTile": { "type": "boolean", "description": "Enable the transcript tile" }, "enableTranscriptTileChatInput": { "type": "boolean", "description": "Enable the chat input for transcript tile" }, "redactTranscriptTileMessages": { "type": "boolean", "description": "Enable redaction of messages in transcript tile" } } } } }, "orgDataPrivacySettings": { "description": "Organisation data privacy settings overwrite the ones defined on endpoint-level", "type": "object", "properties": { "enabled": { "type": "boolean", "description": "Whether or not organisation data privacy settings are enabled" }, "useAnalytics": { "type": "boolean" }, "storeDataPayload": { "type": "boolean" }, "useContactProfiles": { "type": "boolean" }, "useConversations": { "type": "boolean" }, "maskIPAddress": { "type": "boolean" }, "maskAnalytics": { "type": "boolean" }, "maskLogging": { "type": "boolean" } } }, "projectId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } } } }, "responses": { "201": { "description": "Returns Endpoint metadata object.", "content": { "application/json": { "schema": { "type": "object", "properties": { "foreignId": { "type": "string" }, "channel": { "type": "string", "example": "webchat2", "enum": [ "facebook", "alexa", "slack", "generic", "inject", "rest", "realtime", "socket", "adminconsole", "webchat2", "dialogflow", "twilio", "twilio-sms", "line", "intercom", "microsoftBotFramework", "microsoftTeams", "sunshineConversations", "admin-webchat", "avaya", "nonConversational", "voiceGateway2", "amazonLex", "workplace", "webhook", "abstractRest", "userlike", "ringCentralEngage", "audioCodes", "bandwidth", "whatsapp", "eightByEight", "genesysBotConnector", "niceCXOne", "agentAssistVoice", "webchat3" ] }, "flowId": { "type": "string" }, "localeId": { "type": "string" }, "URLToken": { "type": "string", "description": "The URLToken of the endpoint", "example": "f65b289912c929c2a09523dd48eedb1249bb74384f6561f84b4ffc5e84d2f15f" }, "name": { "type": "string", "description": "The name of the endpoint", "example": "New Endpoint" }, "entrypoint": { "type": "string", "description": "The ID can be either a Snapshot ID or a Project ID. The Endpoint will refer to the chosen one.", "example": "667ed4ae16d66f47dc2a9400" }, "active": { "type": "boolean", "description": "Toggle whether the endpoint is active or not" }, "nluConnectorId": { "oneOf": [ { "type": "string", "description": "The NLUConnector type", "example": "cognigy", "enum": [ "alexa", "dialogflow", "dialogflowBuiltIn", "amazonLexBuiltIn", "luis", "watson", "noNlu", "cognigy", "code", "generativeAI", "lex" ] }, { "type": "string" } ] }, "useConversations": { "type": "boolean", "description": "Whether to collect conversations history for this endpoint" }, "maskIPAddress": { "type": "boolean", "description": "Whether to mask sensitive IP address in input object and analytics data for this endpoint" }, "maskAnalytics": { "type": "boolean", "description": "Whether to mask sensitive data in analytics for this endpoint" }, "maskLogging": { "type": "boolean", "description": "Whether to mask sensitive data in logs for this endpoint" }, "useContactProfiles": { "type": "boolean", "description": "Whether to use contact profiles for this endpoint" }, "useAnalytics": { "type": "boolean", "description": "Whether we should store analytics for this endpoint" }, "useChatbaseAnalytics": { "type": "boolean", "description": "Whether we should use Chatbase to collect analytics" }, "chatbaseApikey": { "type": "string", "description": "The apikey for the Chatbase bot" }, "useDashbotAnalytics": { "type": "boolean", "description": "Whether we should use Dashbot to collect analytics" }, "dashbotApikey": { "type": "string", "description": "The apikey for the dashbot bot" }, "dashbotPlatform": { "type": "string" }, "disableInputSanitization": { "type": "string", "description": "If true, disables input text sanitization after Input Transformer" }, "overrideSnapshotConnections": { "type": "boolean" }, "settings": { "type": "object", "properties": { "accessScope": { "type": "string" }, "accessToken": { "type": "string" }, "appId": { "type": "string" }, "appSecret": { "type": "string" }, "backgroundImageUrl": { "type": "string" }, "basicAuthPassword": { "type": "string" }, "basicAuthUser": { "type": "string" }, "botUserId": { "type": "string" }, "businessHours": { "type": "object", "properties": { "businessHours": { "type": "array", "items": { "type": "object", "properties": { "startTime": { "type": "string" }, "endTime": { "type": "string" }, "weekDay": { "type": "string" } } } }, "enabled": { "type": "boolean" }, "text": { "type": "string" }, "mode": { "type": "string" }, "timeZone": { "type": "string" }, "title": { "type": "string" } } }, "colorScheme": { "type": "string" }, "connectionName": { "type": "string" }, "customJSON": { "type": "string" }, "designTemplate": { "type": "integer" }, "disableHtmlContentSanitization": { "type": "boolean" }, "disableInputAutocomplete": { "type": "boolean" }, "disableInputAutogrow": { "type": "boolean" }, "disableUrlButtonSanitization": { "type": "boolean" }, "enableGenericHTMLStyling": { "type": "boolean" }, "enableAsyncCommunication": { "type": "boolean" }, "engagementMessageText": { "type": "string" }, "displayGetStartedButton": { "type": "boolean" }, "dynamicImageAspectRatio": { "type": "boolean" }, "enableCollectMetadata": { "type": "boolean" }, "enableConnectionStatusIndicator": { "type": "boolean" }, "enableDemoWebchat": { "type": "boolean" }, "enableFileUpload": { "type": "boolean" }, "enablePersistentMenu": { "type": "boolean" }, "enableRating": { "type": "string", "enum": [ "onRequest", "always", "once" ] }, "enableSTT": { "type": "boolean" }, "enableTTS": { "type": "boolean" }, "enableUnreadMessageBadge": { "type": "boolean" }, "enableUnreadMessagePreview": { "type": "boolean" }, "enableUnreadMessageSound": { "type": "boolean" }, "enableUnreadMessageTitleIndicator": { "type": "boolean" }, "enableTypingIndicator": { "type": "boolean" }, "facebookPageToken": { "type": "string" }, "focusInputAfterPostback": { "type": "boolean" }, "getStartedButtonText": { "type": "string" }, "getStartedPayload": { "type": "string" }, "getStartedText": { "type": "string" }, "getStartedData": { "type": "string" }, "headerLogoUrl": { "type": "string" }, "hubSecret": { "type": "string" }, "inputAutogrowMaxRows": { "type": "number" }, "inputPlaceholder": { "type": "string" }, "language": { "type": "string" }, "lineChannelAccessToken": { "type": "string" }, "lineChannelSecret": { "type": "string" }, "maintenance": { "type": "object", "properties": { "enabled": { "type": "boolean" }, "mode": { "type": "string" }, "text": { "type": "string" }, "title": { "type": "string" } } }, "mergeContactProfiles": { "type": "boolean" }, "messageDelay": { "type": "integer" }, "messageLogoUrl": { "type": "string" }, "overwriteWebchatBundleUrl": { "type": "string" }, "ratingTitleText": { "type": "string" }, "ratingCommentText": { "type": "string" }, "ratingMessageHistoryRatingText": { "type": "string" }, "ratingMessageHistoryCommentText": { "type": "string" }, "reparseAlexaSlots": { "type": "boolean" }, "requestFacebookProfileData": { "type": "boolean" }, "sessionExpiration": { "type": "integer" }, "shouldOverwriteWebchatBundleUrl": { "type": "boolean" }, "showEngagementMessagesInChat": { "type": "boolean" }, "slackOAuthAccessToken": { "type": "string" }, "slackVerifyToken": { "type": "string" }, "sunshineConversationsChannelKeyId": { "type": "string" }, "sunshineConversationsChannelSecret": { "type": "string" }, "sunshineConversationsChannelUri": { "type": "string", "format": "uri" }, "tenantId": { "type": "string" }, "updateContactProfileWithFacebookProfile": { "type": "boolean" }, "voice": { "type": "string" }, "webhookUrl": { "type": "string", "format": "uri" }, "skill": { "type": "object" }, "persistentMenu": { "type": "object" } } }, "transformerSettings": { "type": "object", "properties": { "abortOnError": { "type": "boolean", "description": "If true, then we will abort the message processing if the transformer throws an error. Otherwise, we will continue with normal message processing in the event of an error.\n" }, "transformer": { "type": "string", "description": "The transformer object as written by the user. This will be displayed in the UI since it includes typings.\n" }, "transpiledTransformer": { "type": "string", "description": "The transformer object written by the user, but without typings. This will be executed.\n" }, "inputTransformerEnabled": { "type": "boolean" }, "outputTransformerEnabled": { "type": "boolean" }, "finalPingTransformerEnabled": { "type": "boolean" }, "notifyTransformerEnabled": { "type": "boolean" }, "injectTransformerEnabled": { "type": "boolean" } } }, "handoverSettings": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "cognigy", "none", "rce" ] }, "providerSettings": { "type": "object", "properties": { "forwardOnlyHandoverConversations": { "type": "boolean", "description": "(rce) Whether to forward all conversations to the provider, or only the conversations that trigger a handover. If this setting is true, then we will only forward conversations were handover was triggered.\n" }, "getQueueUpdates": { "type": "boolean", "description": "(rce) Indicates if queue updates should be enabled to receive events about the estimated wait time\n" }, "apiVersion": { "type": "string", "description": "(salesforce) Salesforce LiveAgent API Version" }, "baseUrl": { "type": "string", "description": "Base URL of the LiveAgent API Deployment" }, "apiAccessToken": { "type": "string", "description": "(rce) The API access token you can create within RCE" }, "baseApiUrl": { "type": "string", "description": "(rce) The API URL to your RCE installation" }, "realtimeAccessToken": { "type": "string", "description": "(rce) The access token for your rce source sdk source" }, "realtimeEndpointUrl": { "type": "string", "description": "(rce) The endpoint URL of your rce source sdk source" }, "webhookSecret": { "type": "string", "description": "(rce) The secret used to secure webhooks in RCE" }, "botCategoryId": { "type": "string", "description": "(rce) The ID of the category you use as the 'bot category' within RCE" }, "agentCategoryId": { "type": "string", "description": "(rce) The ID of the category you use as the 'bot category' within RCE" }, "organizationId": { "type": "string", "description": "(salesforce) Salesforce Organization ID" }, "deploymentId": { "type": "string", "description": "(salesforce) Salesforce LiveAgent Deployment ID" }, "buttonId": { "type": "string", "description": "(salesforce) Salesforce LiveAgent Chat Button ID" } } }, "agentAssistSettings": { "type": "object", "properties": { "copilotType": { "type": "string", "enum": [ "none", "workspace", "whisper" ], "description": "Copilot Type" }, "agentAssistFlowId": { "type": "string", "description": "Copilot flow ID" }, "agentAssistConfigId": { "type": "string", "description": "Selected Copilot Config ReferenceId" }, "enableTranscriptTile": { "type": "boolean", "description": "Enable the transcript tile" }, "enableTranscriptTileChatInput": { "type": "boolean", "description": "Enable the chat input for transcript tile" }, "redactTranscriptTileMessages": { "type": "boolean", "description": "Enable redaction of messages in transcript tile" } } } } }, "orgDataPrivacySettings": { "description": "Organisation data privacy settings overwrite the ones defined on endpoint-level", "type": "object", "properties": { "enabled": { "type": "boolean", "description": "Whether or not organisation data privacy settings are enabled" }, "useAnalytics": { "type": "boolean" }, "storeDataPayload": { "type": "boolean" }, "useContactProfiles": { "type": "boolean" }, "useConversations": { "type": "boolean" }, "maskIPAddress": { "type": "boolean" }, "maskAnalytics": { "type": "boolean" }, "maskLogging": { "type": "boolean" } } }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "get": { "operationId": "indexEndpoints_2_0", "summary": "Get Endpoints", "description": "Get 25 [Endpoints](https://docs.cognigy.com/ai/resources/deploy/endpoints/) in a project by default. To change the default value, use the `limit` query parameter. Additionally, you can filter, sort, and paginate the results.", "tags": [ "Endpoints v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "query", "name": "projectId", "description": "Filter by projectId", "required": false, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "query", "name": "filter", "required": false, "schema": { "type": "string" }, "description": "The name of the endpoint to filter the records" }, { "in": "query", "name": "limit", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100 }, "description": "The maximum number of items to return. The default is 25." }, { "in": "query", "name": "skip", "required": false, "schema": { "type": "integer", "minimum": 0 }, "description": "The number of items to skip. The default is 0. Used along with a limit of a pagination." }, { "in": "query", "name": "sort", "required": false, "schema": { "type": "string", "minLength": 1 }, "description": "The order of the sorting items-`Desc` (descending) or `Asc` (ascending). For example, to sort the records by name in ascending order, specify `name:Asc`." }, { "in": "query", "name": "next", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the nextCursor value from the response to get the next set of records. Used along with limit for pagination." }, { "in": "query", "name": "previous", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the previousCursor value from the response to get the previous set of records. Used along with limit for pagination." } ], "responses": { "200": { "description": "Returns array of a Endpoint metadata objects", "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the endpoint", "example": "New Endpoint" }, "flowId": { "type": "string" }, "localeId": { "type": "string" }, "URLToken": { "type": "string", "description": "The URLToken of the endpoint", "example": "f65b289912c929c2a09523dd48eedb1249bb74384f6561f84b4ffc5e84d2f15f" }, "channel": { "type": "string", "example": "webchat2", "enum": [ "facebook", "alexa", "slack", "generic", "inject", "rest", "realtime", "socket", "adminconsole", "webchat2", "dialogflow", "twilio", "twilio-sms", "line", "intercom", "microsoftBotFramework", "microsoftTeams", "sunshineConversations", "admin-webchat", "avaya", "nonConversational", "voiceGateway2", "amazonLex", "workplace", "webhook", "abstractRest", "userlike", "ringCentralEngage", "audioCodes", "bandwidth", "whatsapp", "eightByEight", "genesysBotConnector", "niceCXOne", "agentAssistVoice", "webchat3" ] }, "overrideSnapshotConnections": { "type": "boolean" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" } }, "total": { "type": "integer", "example": 1 }, "next": { "oneOf": [ { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, { "nullable": true } ], "example": "5ce7c2d833ea1e04d7e6c432" }, "previous": { "oneOf": [ { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, { "nullable": true } ], "example": null } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/endpoints/{endpointId}": { "delete": { "operationId": "deleteEndpoint_2_0", "summary": "Delete an Endpoint", "description": "Delete an [Endpoint](doc:endpoint).", "tags": [ "Endpoints v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "endpointId", "description": "The Id of the Endpoint", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "204": { "description": "Successfully deleted endpoint" }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "get": { "operationId": "readEndpoint_2_0", "summary": "Get an Endpoint", "description": "Get a single [Endpoint](doc:endpoint) resource in a project.", "tags": [ "Endpoints v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "endpointId", "description": "The Id of the Endpoint", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "200": { "description": "Returns Endpoint Object", "content": { "application/json": { "schema": { "type": "object", "properties": { "foreignId": { "type": "string" }, "channel": { "type": "string", "example": "webchat2", "enum": [ "facebook", "alexa", "slack", "generic", "inject", "rest", "realtime", "socket", "adminconsole", "webchat2", "dialogflow", "twilio", "twilio-sms", "line", "intercom", "microsoftBotFramework", "microsoftTeams", "sunshineConversations", "admin-webchat", "avaya", "nonConversational", "voiceGateway2", "amazonLex", "workplace", "webhook", "abstractRest", "userlike", "ringCentralEngage", "audioCodes", "bandwidth", "whatsapp", "eightByEight", "genesysBotConnector", "niceCXOne", "agentAssistVoice", "webchat3" ] }, "flowId": { "type": "string" }, "localeId": { "type": "string" }, "URLToken": { "type": "string", "description": "The URLToken of the endpoint", "example": "f65b289912c929c2a09523dd48eedb1249bb74384f6561f84b4ffc5e84d2f15f" }, "name": { "type": "string", "description": "The name of the endpoint", "example": "New Endpoint" }, "entrypoint": { "type": "string", "description": "The ID can be either a Snapshot ID or a Project ID. The Endpoint will refer to the chosen one.", "example": "667ed4ae16d66f47dc2a9400" }, "active": { "type": "boolean", "description": "Toggle whether the endpoint is active or not" }, "nluConnectorId": { "oneOf": [ { "type": "string", "description": "The NLUConnector type", "example": "cognigy", "enum": [ "alexa", "dialogflow", "dialogflowBuiltIn", "amazonLexBuiltIn", "luis", "watson", "noNlu", "cognigy", "code", "generativeAI", "lex" ] }, { "type": "string" } ] }, "useConversations": { "type": "boolean", "description": "Whether to collect conversations history for this endpoint" }, "maskIPAddress": { "type": "boolean", "description": "Whether to mask sensitive IP address in input object and analytics data for this endpoint" }, "maskAnalytics": { "type": "boolean", "description": "Whether to mask sensitive data in analytics for this endpoint" }, "maskLogging": { "type": "boolean", "description": "Whether to mask sensitive data in logs for this endpoint" }, "useContactProfiles": { "type": "boolean", "description": "Whether to use contact profiles for this endpoint" }, "useAnalytics": { "type": "boolean", "description": "Whether we should store analytics for this endpoint" }, "useChatbaseAnalytics": { "type": "boolean", "description": "Whether we should use Chatbase to collect analytics" }, "chatbaseApikey": { "type": "string", "description": "The apikey for the Chatbase bot" }, "useDashbotAnalytics": { "type": "boolean", "description": "Whether we should use Dashbot to collect analytics" }, "dashbotApikey": { "type": "string", "description": "The apikey for the dashbot bot" }, "dashbotPlatform": { "type": "string" }, "disableInputSanitization": { "type": "string", "description": "If true, disables input text sanitization after Input Transformer" }, "overrideSnapshotConnections": { "type": "boolean" }, "settings": { "type": "object", "properties": { "accessScope": { "type": "string" }, "accessToken": { "type": "string" }, "appId": { "type": "string" }, "appSecret": { "type": "string" }, "backgroundImageUrl": { "type": "string" }, "basicAuthPassword": { "type": "string" }, "basicAuthUser": { "type": "string" }, "botUserId": { "type": "string" }, "businessHours": { "type": "object", "properties": { "businessHours": { "type": "array", "items": { "type": "object", "properties": { "startTime": { "type": "string" }, "endTime": { "type": "string" }, "weekDay": { "type": "string" } } } }, "enabled": { "type": "boolean" }, "text": { "type": "string" }, "mode": { "type": "string" }, "timeZone": { "type": "string" }, "title": { "type": "string" } } }, "colorScheme": { "type": "string" }, "connectionName": { "type": "string" }, "customJSON": { "type": "string" }, "designTemplate": { "type": "integer" }, "disableHtmlContentSanitization": { "type": "boolean" }, "disableInputAutocomplete": { "type": "boolean" }, "disableInputAutogrow": { "type": "boolean" }, "disableUrlButtonSanitization": { "type": "boolean" }, "enableGenericHTMLStyling": { "type": "boolean" }, "enableAsyncCommunication": { "type": "boolean" }, "engagementMessageText": { "type": "string" }, "displayGetStartedButton": { "type": "boolean" }, "dynamicImageAspectRatio": { "type": "boolean" }, "enableCollectMetadata": { "type": "boolean" }, "enableConnectionStatusIndicator": { "type": "boolean" }, "enableDemoWebchat": { "type": "boolean" }, "enableFileUpload": { "type": "boolean" }, "enablePersistentMenu": { "type": "boolean" }, "enableRating": { "type": "string", "enum": [ "onRequest", "always", "once" ] }, "enableSTT": { "type": "boolean" }, "enableTTS": { "type": "boolean" }, "enableUnreadMessageBadge": { "type": "boolean" }, "enableUnreadMessagePreview": { "type": "boolean" }, "enableUnreadMessageSound": { "type": "boolean" }, "enableUnreadMessageTitleIndicator": { "type": "boolean" }, "enableTypingIndicator": { "type": "boolean" }, "facebookPageToken": { "type": "string" }, "focusInputAfterPostback": { "type": "boolean" }, "getStartedButtonText": { "type": "string" }, "getStartedPayload": { "type": "string" }, "getStartedText": { "type": "string" }, "getStartedData": { "type": "string" }, "headerLogoUrl": { "type": "string" }, "hubSecret": { "type": "string" }, "inputAutogrowMaxRows": { "type": "number" }, "inputPlaceholder": { "type": "string" }, "language": { "type": "string" }, "lineChannelAccessToken": { "type": "string" }, "lineChannelSecret": { "type": "string" }, "maintenance": { "type": "object", "properties": { "enabled": { "type": "boolean" }, "mode": { "type": "string" }, "text": { "type": "string" }, "title": { "type": "string" } } }, "mergeContactProfiles": { "type": "boolean" }, "messageDelay": { "type": "integer" }, "messageLogoUrl": { "type": "string" }, "overwriteWebchatBundleUrl": { "type": "string" }, "ratingTitleText": { "type": "string" }, "ratingCommentText": { "type": "string" }, "ratingMessageHistoryRatingText": { "type": "string" }, "ratingMessageHistoryCommentText": { "type": "string" }, "reparseAlexaSlots": { "type": "boolean" }, "requestFacebookProfileData": { "type": "boolean" }, "sessionExpiration": { "type": "integer" }, "shouldOverwriteWebchatBundleUrl": { "type": "boolean" }, "showEngagementMessagesInChat": { "type": "boolean" }, "slackOAuthAccessToken": { "type": "string" }, "slackVerifyToken": { "type": "string" }, "sunshineConversationsChannelKeyId": { "type": "string" }, "sunshineConversationsChannelSecret": { "type": "string" }, "sunshineConversationsChannelUri": { "type": "string", "format": "uri" }, "tenantId": { "type": "string" }, "updateContactProfileWithFacebookProfile": { "type": "boolean" }, "voice": { "type": "string" }, "webhookUrl": { "type": "string", "format": "uri" }, "skill": { "type": "object" }, "persistentMenu": { "type": "object" } } }, "transformerSettings": { "type": "object", "properties": { "abortOnError": { "type": "boolean", "description": "If true, then we will abort the message processing if the transformer throws an error. Otherwise, we will continue with normal message processing in the event of an error.\n" }, "transformer": { "type": "string", "description": "The transformer object as written by the user. This will be displayed in the UI since it includes typings.\n" }, "transpiledTransformer": { "type": "string", "description": "The transformer object written by the user, but without typings. This will be executed.\n" }, "inputTransformerEnabled": { "type": "boolean" }, "outputTransformerEnabled": { "type": "boolean" }, "finalPingTransformerEnabled": { "type": "boolean" }, "notifyTransformerEnabled": { "type": "boolean" }, "injectTransformerEnabled": { "type": "boolean" } } }, "handoverSettings": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "cognigy", "none", "rce" ] }, "providerSettings": { "type": "object", "properties": { "forwardOnlyHandoverConversations": { "type": "boolean", "description": "(rce) Whether to forward all conversations to the provider, or only the conversations that trigger a handover. If this setting is true, then we will only forward conversations were handover was triggered.\n" }, "getQueueUpdates": { "type": "boolean", "description": "(rce) Indicates if queue updates should be enabled to receive events about the estimated wait time\n" }, "apiVersion": { "type": "string", "description": "(salesforce) Salesforce LiveAgent API Version" }, "baseUrl": { "type": "string", "description": "Base URL of the LiveAgent API Deployment" }, "apiAccessToken": { "type": "string", "description": "(rce) The API access token you can create within RCE" }, "baseApiUrl": { "type": "string", "description": "(rce) The API URL to your RCE installation" }, "realtimeAccessToken": { "type": "string", "description": "(rce) The access token for your rce source sdk source" }, "realtimeEndpointUrl": { "type": "string", "description": "(rce) The endpoint URL of your rce source sdk source" }, "webhookSecret": { "type": "string", "description": "(rce) The secret used to secure webhooks in RCE" }, "botCategoryId": { "type": "string", "description": "(rce) The ID of the category you use as the 'bot category' within RCE" }, "agentCategoryId": { "type": "string", "description": "(rce) The ID of the category you use as the 'bot category' within RCE" }, "organizationId": { "type": "string", "description": "(salesforce) Salesforce Organization ID" }, "deploymentId": { "type": "string", "description": "(salesforce) Salesforce LiveAgent Deployment ID" }, "buttonId": { "type": "string", "description": "(salesforce) Salesforce LiveAgent Chat Button ID" } } }, "agentAssistSettings": { "type": "object", "properties": { "copilotType": { "type": "string", "enum": [ "none", "workspace", "whisper" ], "description": "Copilot Type" }, "agentAssistFlowId": { "type": "string", "description": "Copilot flow ID" }, "agentAssistConfigId": { "type": "string", "description": "Selected Copilot Config ReferenceId" }, "enableTranscriptTile": { "type": "boolean", "description": "Enable the transcript tile" }, "enableTranscriptTileChatInput": { "type": "boolean", "description": "Enable the chat input for transcript tile" }, "redactTranscriptTileMessages": { "type": "boolean", "description": "Enable redaction of messages in transcript tile" } } } } }, "orgDataPrivacySettings": { "description": "Organisation data privacy settings overwrite the ones defined on endpoint-level", "type": "object", "properties": { "enabled": { "type": "boolean", "description": "Whether or not organisation data privacy settings are enabled" }, "useAnalytics": { "type": "boolean" }, "storeDataPayload": { "type": "boolean" }, "useContactProfiles": { "type": "boolean" }, "useConversations": { "type": "boolean" }, "maskIPAddress": { "type": "boolean" }, "maskAnalytics": { "type": "boolean" }, "maskLogging": { "type": "boolean" } } }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "patch": { "operationId": "updateEndpoint", "summary": "Update an Endpoint", "description": "Update an [Endpoint](doc:endpoint) resource in a project.", "tags": [ "Endpoints v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "endpointId", "description": "The Id of the Endpoint", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "foreignId": { "type": "string" }, "channel": { "type": "string", "example": "webchat2", "enum": [ "facebook", "alexa", "slack", "generic", "inject", "rest", "realtime", "socket", "adminconsole", "webchat2", "dialogflow", "twilio", "twilio-sms", "line", "intercom", "microsoftBotFramework", "microsoftTeams", "sunshineConversations", "admin-webchat", "avaya", "nonConversational", "voiceGateway2", "amazonLex", "workplace", "webhook", "abstractRest", "userlike", "ringCentralEngage", "audioCodes", "bandwidth", "whatsapp", "eightByEight", "genesysBotConnector", "niceCXOne", "agentAssistVoice", "webchat3" ] }, "flowId": { "type": "string" }, "localeId": { "type": "string" }, "URLToken": { "type": "string", "description": "The URLToken of the endpoint", "example": "f65b289912c929c2a09523dd48eedb1249bb74384f6561f84b4ffc5e84d2f15f" }, "name": { "type": "string", "description": "The name of the endpoint", "example": "New Endpoint" }, "entrypoint": { "type": "string", "description": "The ID can be either a Snapshot ID or a Project ID. The Endpoint will refer to the chosen one.", "example": "667ed4ae16d66f47dc2a9400" }, "active": { "type": "boolean", "description": "Toggle whether the endpoint is active or not" }, "nluConnectorId": { "oneOf": [ { "type": "string", "description": "The NLUConnector type", "example": "cognigy", "enum": [ "alexa", "dialogflow", "dialogflowBuiltIn", "amazonLexBuiltIn", "luis", "watson", "noNlu", "cognigy", "code", "generativeAI", "lex" ] }, { "type": "string" } ] }, "useConversations": { "type": "boolean", "description": "Whether to collect conversations history for this endpoint" }, "maskIPAddress": { "type": "boolean", "description": "Whether to mask sensitive IP address in input object and analytics data for this endpoint" }, "maskAnalytics": { "type": "boolean", "description": "Whether to mask sensitive data in analytics for this endpoint" }, "maskLogging": { "type": "boolean", "description": "Whether to mask sensitive data in logs for this endpoint" }, "useContactProfiles": { "type": "boolean", "description": "Whether to use contact profiles for this endpoint" }, "useAnalytics": { "type": "boolean", "description": "Whether we should store analytics for this endpoint" }, "useChatbaseAnalytics": { "type": "boolean", "description": "Whether we should use Chatbase to collect analytics" }, "chatbaseApikey": { "type": "string", "description": "The apikey for the Chatbase bot" }, "useDashbotAnalytics": { "type": "boolean", "description": "Whether we should use Dashbot to collect analytics" }, "dashbotApikey": { "type": "string", "description": "The apikey for the dashbot bot" }, "dashbotPlatform": { "type": "string" }, "disableInputSanitization": { "type": "string", "description": "If true, disables input text sanitization after Input Transformer" }, "overrideSnapshotConnections": { "type": "boolean" }, "settings": { "type": "object", "properties": { "accessScope": { "type": "string" }, "accessToken": { "type": "string" }, "appId": { "type": "string" }, "appSecret": { "type": "string" }, "backgroundImageUrl": { "type": "string" }, "basicAuthPassword": { "type": "string" }, "basicAuthUser": { "type": "string" }, "botUserId": { "type": "string" }, "businessHours": { "type": "object", "properties": { "businessHours": { "type": "array", "items": { "type": "object", "properties": { "startTime": { "type": "string" }, "endTime": { "type": "string" }, "weekDay": { "type": "string" } } } }, "enabled": { "type": "boolean" }, "text": { "type": "string" }, "mode": { "type": "string" }, "timeZone": { "type": "string" }, "title": { "type": "string" } } }, "colorScheme": { "type": "string" }, "connectionName": { "type": "string" }, "customJSON": { "type": "string" }, "designTemplate": { "type": "integer" }, "disableHtmlContentSanitization": { "type": "boolean" }, "disableInputAutocomplete": { "type": "boolean" }, "disableInputAutogrow": { "type": "boolean" }, "disableUrlButtonSanitization": { "type": "boolean" }, "enableGenericHTMLStyling": { "type": "boolean" }, "enableAsyncCommunication": { "type": "boolean" }, "engagementMessageText": { "type": "string" }, "displayGetStartedButton": { "type": "boolean" }, "dynamicImageAspectRatio": { "type": "boolean" }, "enableCollectMetadata": { "type": "boolean" }, "enableConnectionStatusIndicator": { "type": "boolean" }, "enableDemoWebchat": { "type": "boolean" }, "enableFileUpload": { "type": "boolean" }, "enablePersistentMenu": { "type": "boolean" }, "enableRating": { "type": "string", "enum": [ "onRequest", "always", "once" ] }, "enableSTT": { "type": "boolean" }, "enableTTS": { "type": "boolean" }, "enableUnreadMessageBadge": { "type": "boolean" }, "enableUnreadMessagePreview": { "type": "boolean" }, "enableUnreadMessageSound": { "type": "boolean" }, "enableUnreadMessageTitleIndicator": { "type": "boolean" }, "enableTypingIndicator": { "type": "boolean" }, "facebookPageToken": { "type": "string" }, "focusInputAfterPostback": { "type": "boolean" }, "getStartedButtonText": { "type": "string" }, "getStartedPayload": { "type": "string" }, "getStartedText": { "type": "string" }, "getStartedData": { "type": "string" }, "headerLogoUrl": { "type": "string" }, "hubSecret": { "type": "string" }, "inputAutogrowMaxRows": { "type": "number" }, "inputPlaceholder": { "type": "string" }, "language": { "type": "string" }, "lineChannelAccessToken": { "type": "string" }, "lineChannelSecret": { "type": "string" }, "maintenance": { "type": "object", "properties": { "enabled": { "type": "boolean" }, "mode": { "type": "string" }, "text": { "type": "string" }, "title": { "type": "string" } } }, "mergeContactProfiles": { "type": "boolean" }, "messageDelay": { "type": "integer" }, "messageLogoUrl": { "type": "string" }, "overwriteWebchatBundleUrl": { "type": "string" }, "ratingTitleText": { "type": "string" }, "ratingCommentText": { "type": "string" }, "ratingMessageHistoryRatingText": { "type": "string" }, "ratingMessageHistoryCommentText": { "type": "string" }, "reparseAlexaSlots": { "type": "boolean" }, "requestFacebookProfileData": { "type": "boolean" }, "sessionExpiration": { "type": "integer" }, "shouldOverwriteWebchatBundleUrl": { "type": "boolean" }, "showEngagementMessagesInChat": { "type": "boolean" }, "slackOAuthAccessToken": { "type": "string" }, "slackVerifyToken": { "type": "string" }, "sunshineConversationsChannelKeyId": { "type": "string" }, "sunshineConversationsChannelSecret": { "type": "string" }, "sunshineConversationsChannelUri": { "type": "string", "format": "uri" }, "tenantId": { "type": "string" }, "updateContactProfileWithFacebookProfile": { "type": "boolean" }, "voice": { "type": "string" }, "webhookUrl": { "type": "string", "format": "uri" }, "skill": { "type": "object" }, "persistentMenu": { "type": "object" } } }, "transformerSettings": { "type": "object", "properties": { "abortOnError": { "type": "boolean", "description": "If true, then we will abort the message processing if the transformer throws an error. Otherwise, we will continue with normal message processing in the event of an error.\n" }, "transformer": { "type": "string", "description": "The transformer object as written by the user. This will be displayed in the UI since it includes typings.\n" }, "transpiledTransformer": { "type": "string", "description": "The transformer object written by the user, but without typings. This will be executed.\n" }, "inputTransformerEnabled": { "type": "boolean" }, "outputTransformerEnabled": { "type": "boolean" }, "finalPingTransformerEnabled": { "type": "boolean" }, "notifyTransformerEnabled": { "type": "boolean" }, "injectTransformerEnabled": { "type": "boolean" } } }, "handoverSettings": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "cognigy", "none", "rce" ] }, "providerSettings": { "type": "object", "properties": { "forwardOnlyHandoverConversations": { "type": "boolean", "description": "(rce) Whether to forward all conversations to the provider, or only the conversations that trigger a handover. If this setting is true, then we will only forward conversations were handover was triggered.\n" }, "getQueueUpdates": { "type": "boolean", "description": "(rce) Indicates if queue updates should be enabled to receive events about the estimated wait time\n" }, "apiVersion": { "type": "string", "description": "(salesforce) Salesforce LiveAgent API Version" }, "baseUrl": { "type": "string", "description": "Base URL of the LiveAgent API Deployment" }, "apiAccessToken": { "type": "string", "description": "(rce) The API access token you can create within RCE" }, "baseApiUrl": { "type": "string", "description": "(rce) The API URL to your RCE installation" }, "realtimeAccessToken": { "type": "string", "description": "(rce) The access token for your rce source sdk source" }, "realtimeEndpointUrl": { "type": "string", "description": "(rce) The endpoint URL of your rce source sdk source" }, "webhookSecret": { "type": "string", "description": "(rce) The secret used to secure webhooks in RCE" }, "botCategoryId": { "type": "string", "description": "(rce) The ID of the category you use as the 'bot category' within RCE" }, "agentCategoryId": { "type": "string", "description": "(rce) The ID of the category you use as the 'bot category' within RCE" }, "organizationId": { "type": "string", "description": "(salesforce) Salesforce Organization ID" }, "deploymentId": { "type": "string", "description": "(salesforce) Salesforce LiveAgent Deployment ID" }, "buttonId": { "type": "string", "description": "(salesforce) Salesforce LiveAgent Chat Button ID" } } }, "agentAssistSettings": { "type": "object", "properties": { "copilotType": { "type": "string", "enum": [ "none", "workspace", "whisper" ], "description": "Copilot Type" }, "agentAssistFlowId": { "type": "string", "description": "Copilot flow ID" }, "agentAssistConfigId": { "type": "string", "description": "Selected Copilot Config ReferenceId" }, "enableTranscriptTile": { "type": "boolean", "description": "Enable the transcript tile" }, "enableTranscriptTileChatInput": { "type": "boolean", "description": "Enable the chat input for transcript tile" }, "redactTranscriptTileMessages": { "type": "boolean", "description": "Enable redaction of messages in transcript tile" } } } } }, "orgDataPrivacySettings": { "description": "Organisation data privacy settings overwrite the ones defined on endpoint-level", "type": "object", "properties": { "enabled": { "type": "boolean", "description": "Whether or not organisation data privacy settings are enabled" }, "useAnalytics": { "type": "boolean" }, "storeDataPayload": { "type": "boolean" }, "useContactProfiles": { "type": "boolean" }, "useConversations": { "type": "boolean" }, "maskIPAddress": { "type": "boolean" }, "maskAnalytics": { "type": "boolean" }, "maskLogging": { "type": "boolean" } } } } } } } }, "responses": { "200": { "description": "Successfully updated Endpoint" }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/extensions/{extensionId}": { "delete": { "operationId": "deleteExtension_2_0", "summary": "Delete an Extension", "description": "Delete an [Extension](doc:extension).", "tags": [ "Extensions v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "extensionId", "description": "The Id of the Extension", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "202": { "description": "Successfully deleted extension" }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "get": { "operationId": "readExtension_2_0", "summary": "Get a Extension", "description": "Get a single [Extension](doc:extension) resource in a project.", "tags": [ "Extensions v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "extensionId", "description": "The Id of the Extension", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "200": { "description": "Returns Extension Object", "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the Extension", "example": "New Extension" }, "label": { "type": "string", "description": "The label of the Extension", "example": "New Extension" }, "version": { "type": "string", "description": "The version of the Extension", "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)(?:-((?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\\.(?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\\+([0-9a-zA-Z-]+(?:\\.[0-9a-zA-Z-]+)*))?$", "example": "1.0.0" }, "imageUrlToken": { "type": "string", "format": "alphanum-64", "description": "A fully qualified URL to an image/icon for the extension." }, "description": { "type": "string", "description": "Optional description of the extension" }, "tags": { "type": "array", "description": "Optional list of tags to find the extension", "items": { "type": "string" } }, "author": { "type": "string", "description": "Author of the extension" }, "extensionType": { "type": "string", "description": "Type of this extension", "enum": [ "nodes" ] }, "trustedCode": { "type": "boolean", "description": "Whether the code of the extension is trusted and runs without isolation" }, "nodes": { "type": "object", "properties": { "type": { "type": "string" }, "parentType": { "type": "string", "description": "The type of the node parent, if there is one" }, "defaultLabel": { "oneOf": [ { "type": "string", "description": "The label that should be used when a new Node of this type is created" }, { "type": "object", "description": "A localized version of the label that should be used when a new Node of this type is created", "properties": { "default": { "type": "string" }, "enUS": { "type": "string" }, "deDE": { "type": "string" }, "esES": { "type": "string" }, "jaJP": { "type": "string" }, "koKR": { "type": "string" } } } ] }, "summary": { "oneOf": [ { "type": "string", "description": "A short line of text that describes what this Node is used for" }, { "type": "object", "description": "A localized version of a short line of text that describes what this Node is used for", "properties": { "default": { "type": "string" }, "enUS": { "type": "string" }, "deDE": { "type": "string" }, "esES": { "type": "string" }, "jaJP": { "type": "string" }, "koKR": { "type": "string" } } } ] }, "extension": { "type": "string" }, "extensionImg": { "type": "string" }, "appearance": { "type": "object", "properties": { "logo": { "type": "string" }, "textColor": { "type": "string", "example": "blue", "oneOf": [ { "type": "string", "example": "none", "enum": [ "aliceBlue", "antiqueWhite", "aqua", "aquamarine", "azure", "beige", "bisque", "black", "blanchedAlmond", "blue", "blueViolet", "brown", "burlyWood", "cadetBlue", "chartreuse", "chocolate", "coral", "cornflowerBlue", "cornsilk", "crimson", "cyan", "darkBlue", "darkCyan", "darkGoldenRod", "darkGray", "darkGrey", "darkGreen", "darkKhaki", "darkMagenta", "darkOliveGreen", "darkOrange", "darkOrchid", "darkRed", "darkSalmon", "darkSeaGreen", "darkSlateBlue", "darkSlateGray", "darkSlateGrey", "darkTurquoise", "darkViolet", "deepPink", "deepSkyBlue", "dimGray", "dimGrey", "dodgerBlue", "fireBrick", "floralWhite", "forestGreen", "fuchsia", "gainsboro", "ghostWhite", "gold", "goldenRod", "gray", "grey", "green", "greenYellow", "honeyDew", "hotPink", "indianRed", "indigo", "ivory", "khaki", "lavender", "lavenderBlush", "lawnGreen", "lemonChiffon", "lightBlue", "lightCoral", "lightCyan", "lightGoldenRodYellow", "lightGray", "lightGrey", "lightGreen", "lightPink", "lightSalmon", "lightSeaGreen", "lightSkyBlue", "lightSlateGray", "lightSlateGrey", "lightSteelBlue", "lightYellow", "lime", "limeGreen", "linen", "magenta", "maroon", "mediumAquaMarine", "mediumBlue", "mediumOrchid", "mediumPurple", "mediumSeaGreen", "mediumSlateBlue", "mediumSpringGreen", "mediumTurquoise", "mediumVioletRed", "midnightBlue", "mintCream", "mistyRose", "moccasin", "navajoWhite", "navy", "oldLace", "olive", "oliveDrab", "orange", "orangeRed", "orchid", "paleGoldenRod", "paleGreen", "paleTurquoise", "paleVioletRed", "papayaWhip", "peachPuff", "peru", "pink", "plum", "powderBlue", "purple", "rebeccaPurple", "red", "rosyBrown", "royalBlue", "saddleBrown", "salmon", "sandyBrown", "seaGreen", "seaShell", "sienna", "silver", "skyBlue", "slateBlue", "slateGray", "slateGrey", "snow", "springGreen", "steelBlue", "tan", "teal", "thistle", "tomato", "turquoise", "violet", "wheat", "white", "whiteSmoke", "yellow", "yellowGreen", "none", "transparent" ] }, { "type": "string", "example": "cognigyGrey", "enum": [ "amber", "blueGrey", "cognigyBlue", "cognigyGrey", "deepOrange", "deepPurple", "lightBlue", "lightGreen" ] } ] }, "contrastTextColor": { "type": "string", "example": "blue", "oneOf": [ { "type": "string", "example": "none", "enum": [ "aliceBlue", "antiqueWhite", "aqua", "aquamarine", "azure", "beige", "bisque", "black", "blanchedAlmond", "blue", "blueViolet", "brown", "burlyWood", "cadetBlue", "chartreuse", "chocolate", "coral", "cornflowerBlue", "cornsilk", "crimson", "cyan", "darkBlue", "darkCyan", "darkGoldenRod", "darkGray", "darkGrey", "darkGreen", "darkKhaki", "darkMagenta", "darkOliveGreen", "darkOrange", "darkOrchid", "darkRed", "darkSalmon", "darkSeaGreen", "darkSlateBlue", "darkSlateGray", "darkSlateGrey", "darkTurquoise", "darkViolet", "deepPink", "deepSkyBlue", "dimGray", "dimGrey", "dodgerBlue", "fireBrick", "floralWhite", "forestGreen", "fuchsia", "gainsboro", "ghostWhite", "gold", "goldenRod", "gray", "grey", "green", "greenYellow", "honeyDew", "hotPink", "indianRed", "indigo", "ivory", "khaki", "lavender", "lavenderBlush", "lawnGreen", "lemonChiffon", "lightBlue", "lightCoral", "lightCyan", "lightGoldenRodYellow", "lightGray", "lightGrey", "lightGreen", "lightPink", "lightSalmon", "lightSeaGreen", "lightSkyBlue", "lightSlateGray", "lightSlateGrey", "lightSteelBlue", "lightYellow", "lime", "limeGreen", "linen", "magenta", "maroon", "mediumAquaMarine", "mediumBlue", "mediumOrchid", "mediumPurple", "mediumSeaGreen", "mediumSlateBlue", "mediumSpringGreen", "mediumTurquoise", "mediumVioletRed", "midnightBlue", "mintCream", "mistyRose", "moccasin", "navajoWhite", "navy", "oldLace", "olive", "oliveDrab", "orange", "orangeRed", "orchid", "paleGoldenRod", "paleGreen", "paleTurquoise", "paleVioletRed", "papayaWhip", "peachPuff", "peru", "pink", "plum", "powderBlue", "purple", "rebeccaPurple", "red", "rosyBrown", "royalBlue", "saddleBrown", "salmon", "sandyBrown", "seaGreen", "seaShell", "sienna", "silver", "skyBlue", "slateBlue", "slateGray", "slateGrey", "snow", "springGreen", "steelBlue", "tan", "teal", "thistle", "tomato", "turquoise", "violet", "wheat", "white", "whiteSmoke", "yellow", "yellowGreen", "none", "transparent" ] }, { "type": "string", "example": "cognigyGrey", "enum": [ "amber", "blueGrey", "cognigyBlue", "cognigyGrey", "deepOrange", "deepPurple", "lightBlue", "lightGreen" ] } ] }, "color": { "type": "string", "example": "red", "oneOf": [ { "type": "string", "example": "none", "enum": [ "aliceBlue", "antiqueWhite", "aqua", "aquamarine", "azure", "beige", "bisque", "black", "blanchedAlmond", "blue", "blueViolet", "brown", "burlyWood", "cadetBlue", "chartreuse", "chocolate", "coral", "cornflowerBlue", "cornsilk", "crimson", "cyan", "darkBlue", "darkCyan", "darkGoldenRod", "darkGray", "darkGrey", "darkGreen", "darkKhaki", "darkMagenta", "darkOliveGreen", "darkOrange", "darkOrchid", "darkRed", "darkSalmon", "darkSeaGreen", "darkSlateBlue", "darkSlateGray", "darkSlateGrey", "darkTurquoise", "darkViolet", "deepPink", "deepSkyBlue", "dimGray", "dimGrey", "dodgerBlue", "fireBrick", "floralWhite", "forestGreen", "fuchsia", "gainsboro", "ghostWhite", "gold", "goldenRod", "gray", "grey", "green", "greenYellow", "honeyDew", "hotPink", "indianRed", "indigo", "ivory", "khaki", "lavender", "lavenderBlush", "lawnGreen", "lemonChiffon", "lightBlue", "lightCoral", "lightCyan", "lightGoldenRodYellow", "lightGray", "lightGrey", "lightGreen", "lightPink", "lightSalmon", "lightSeaGreen", "lightSkyBlue", "lightSlateGray", "lightSlateGrey", "lightSteelBlue", "lightYellow", "lime", "limeGreen", "linen", "magenta", "maroon", "mediumAquaMarine", "mediumBlue", "mediumOrchid", "mediumPurple", "mediumSeaGreen", "mediumSlateBlue", "mediumSpringGreen", "mediumTurquoise", "mediumVioletRed", "midnightBlue", "mintCream", "mistyRose", "moccasin", "navajoWhite", "navy", "oldLace", "olive", "oliveDrab", "orange", "orangeRed", "orchid", "paleGoldenRod", "paleGreen", "paleTurquoise", "paleVioletRed", "papayaWhip", "peachPuff", "peru", "pink", "plum", "powderBlue", "purple", "rebeccaPurple", "red", "rosyBrown", "royalBlue", "saddleBrown", "salmon", "sandyBrown", "seaGreen", "seaShell", "sienna", "silver", "skyBlue", "slateBlue", "slateGray", "slateGrey", "snow", "springGreen", "steelBlue", "tan", "teal", "thistle", "tomato", "turquoise", "violet", "wheat", "white", "whiteSmoke", "yellow", "yellowGreen", "none", "transparent" ] }, { "type": "string", "example": "cognigyGrey", "enum": [ "amber", "blueGrey", "cognigyBlue", "cognigyGrey", "deepOrange", "deepPurple", "lightBlue", "lightGreen" ] } ] }, "variant": { "type": "string", "enum": [ "regular", "mini", "hexagon" ] } } }, "behavior": { "type": "object", "properties": { "stopping": { "type": "boolean" }, "entrypoint": { "type": "boolean" } } }, "constraints": { "type": "object", "properties": { "editable": { "type": "boolean", "description": "Should this node be editable" }, "deletable": { "type": "boolean", "description": "Should this node be deletable" }, "creatable": { "type": "boolean", "description": "Should this node be manually creatable" }, "collapsable": { "type": "boolean", "description": "Should this node be collapsable" }, "childFlowCreatable": { "type": "boolean", "description": "Should it be possible to create child flow from this node" }, "movable": { "type": "boolean", "description": "Should this node be movable" }, "placement": { "type": "object", "description": "Additional placement information", "properties": { "predecessor": { "type": "object", "properties": { "whitelist": { "items": { "type": "string" } }, "blacklist": { "items": { "type": "string" } } } }, "successor": { "type": "object", "properties": { "whitelist": { "items": { "type": "string" } }, "blacklist": { "items": { "type": "string" } } } }, "children": { "type": "object", "properties": { "whitelist": { "items": { "type": "string" } }, "blacklist": { "items": { "type": "string" } } } } } } } }, "dependencies": { "type": "object", "properties": { "children": { "type": "array", "items": { "type": "string" } } } }, "fields": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "text", "rule" ] }, "key": { "type": "string" }, "label": { "oneOf": [ { "type": "string" }, { "type": "object", "properties": { "default": { "type": "string" }, "enUS": { "type": "string" }, "deDE": { "type": "string" }, "esES": { "type": "string" }, "jaJP": { "type": "string" }, "koKR": { "type": "string" } } } ] }, "defaultValue": { "description": "The default value for that field" } } } }, "previews": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "message", "image", "code" ] }, "key": { "type": "string" } } } }, "tokens": { "type": "array", "items": { "type": "object", "properties": { "label": { "type": "string", "maxLength": 30, "example": "word count" }, "script": { "type": "string", "maxLength": 500, "example": "ci.text.split(' ').length" }, "type": { "type": "string", "enum": [ "profile", "input", "context", "custom", "answer", "flow-output", "flow-input" ], "example": "input" } } } }, "tags": { "type": "string", "enum": [ "basic", "logic", "message", "profile", "service", "nlu", "data" ] }, "sections": { "type": "array", "items": { "type": "object", "properties": { "key": { "type": "string", "description": "The key of the Field whose value should be matched" }, "value": { "description": "The expected value(s) that make this condition match" }, "negate": { "type": "boolean", "description": "If this is true, the condition result will be inverted" } } } }, "form": { "type": "array", "items": { "type": "object", "properties": { "key": { "type": "string", "description": "A key either pointing to a 'field -> key' or 'section -> key'" }, "type": { "type": "string", "description": "The type of the pointer, either 'field' or 'section'", "enum": [ "field", "section" ] } } } } } }, "connections": { "type": "object", "properties": { "extension": { "type": "string", "description": "The package name of the extension", "example": "azure" }, "type": { "type": "string", "description": "The type of the connection within the extension", "example": "oauth-2" }, "label": { "type": "string", "description": "The label for the connection type", "example": "OAuth-2" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "fieldName": { "type": "string", "description": "The name of the field", "example": "client_secret" } } } }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "patch": { "operationId": "updateExtension_2_0", "summary": "Update an Extension", "description": "Updates properties of an Extension.", "tags": [ "Extensions v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "extensionId", "description": "The Id of the Extension", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "trustedCode": { "type": "boolean", "description": "Whether to trust the code within this extension. This will reduce isolation but increase performance.", "example": true } } } } } }, "responses": { "204": { "description": "Successfully updated Extension" }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/extensions": { "get": { "operationId": "indexExtensions_2_0", "summary": "Get Extensions", "description": "Get 25 [Extension](https://docs.cognigy.com/ai/resources/manage/extensions/) in a project by default. To change the default value, use the `limit` query parameter. Additionally, you can filter, sort, and paginate the results.", "tags": [ "Extensions v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "query", "name": "projectId", "description": "Filter by projectId", "required": false, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "query", "name": "filter", "required": false, "schema": { "type": "string" }, "description": "The name of the extension to filter the records" }, { "in": "query", "name": "limit", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100 }, "description": "The maximum number of items to return. The default is 25." }, { "in": "query", "name": "skip", "required": false, "schema": { "type": "integer", "minimum": 0 }, "description": "The number of items to skip. The default is 0. Used along with a limit of a pagination." }, { "in": "query", "name": "sort", "required": false, "schema": { "type": "string", "minLength": 1 }, "description": "The order of the sorting items-`Desc` (descending) or `Asc` (ascending). For example, to sort the records by name in ascending order, specify `name:Asc`." }, { "in": "query", "name": "next", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the nextCursor value from the response to get the next set of records. Used along with limit for pagination." }, { "in": "query", "name": "previous", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the previousCursor value from the response to get the previous set of records. Used along with limit for pagination." } ], "responses": { "200": { "description": "Returns array of a Extension metadata objects", "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "name": { "type": "string", "description": "The name of the Extension", "example": "new-extension" }, "label": { "type": "string", "description": "Optional human readable extension name", "example": "New Extension" }, "version": { "type": "string", "description": "The version of the Extension", "example": "1.0.0" }, "imageUrlToken": { "type": "string", "format": "alphanum-64", "description": "A fully qualified URL to an image/icon for the extension." }, "description": { "type": "string", "description": "Optional description of the extension", "example": "This is a fancy extension" }, "trustedCode": { "type": "boolean", "description": "NodeDescriptors trusted flag." }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" } }, "total": { "type": "integer", "example": 1 }, "next": { "oneOf": [ { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, { "nullable": true } ], "example": "5ce7c2d833ea1e04d7e6c432" }, "previous": { "oneOf": [ { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, { "nullable": true } ], "example": null } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/extensions/update": { "post": { "operationId": "updateExtensionPackage_2_0", "summary": "Update an Extension Package", "description": "Update an uploaded [Extension](doc:extension) in a project and create a task to process it.", "tags": [ "Extensions v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" } ], "requestBody": { "required": true, "content": { "multipart/form-data": { "schema": { "type": "object", "required": [ "projectId", "url", "extension" ], "properties": { "file": { "type": "string", "format": "binary" }, "projectId": { "type": "string", "description": "The Id of the project." }, "extension": { "type": "string", "description": "The Id or name of the extension to update." } } }, "encoding": { "file": { "contentType": "application/gzip" } } }, "application/json": { "schema": { "type": "object", "required": [ "projectId", "url", "extension" ], "properties": { "url": { "type": "string", "format": "url", "description": "The url to an extension. The Extension will then loaded by the system.", "example": "https://github.com/Cognigy/Extensions/releases/download/random-cat-image400/random-cat-image.tar.gz" }, "projectId": { "type": "string", "description": "The Id of the project." }, "extension": { "type": "string", "description": "The name of the extension to update." } } } } } }, "responses": { "202": { "description": "Create a Task to delete the Extension if already present and replace it with the uploaded Extension.", "content": { "application/json": { "schema": { "type": "object", "properties": { "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "status": { "type": "string", "description": "The status of the task", "example": "queued", "enum": [ "queued", "active", "done", "cancelling", "cancelled", "error" ] }, "type": { "type": "string", "example": "trainIntents" }, "parameters": { "type": "object" }, "lastChangedAt": { "type": "number", "example": 1594243850 }, "lastCreatedAt": { "type": "number", "example": 1594243850 }, "currentStep": { "type": "integer", "example": 0 }, "totalStep": { "type": "integer", "example": 100 } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/extensions/upload": { "post": { "operationId": "uploadExtension_2_0", "summary": "Upload an Extension", "description": "Upload an [Extension](doc:extension) to a project and create a task to process it.", "tags": [ "Extensions v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" } ], "requestBody": { "required": true, "content": { "multipart/form-data": { "schema": { "type": "object", "properties": { "projectId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "file": { "type": "string", "format": "binary" } } }, "encoding": { "file": { "contentType": "application/gzip" } } }, "application/json": { "schema": { "type": "object", "required": [ "projectId", "url" ], "properties": { "projectId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "url": { "type": "string", "format": "url", "description": "The url to an extension. The Extension will then loaded by the system.", "example": "https://github.com/Cognigy/Extensions/releases/download/random-cat-image400/random-cat-image.tar.gz" }, "name": { "type": "string", "description": "The name of the extension you are trying to upload. This is needed only to fill in the task meta data." } } } } } }, "responses": { "202": { "description": "Successfully uploaded the Extension and created a Task to process it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "status": { "type": "string", "description": "The status of the task", "example": "queued", "enum": [ "queued", "active", "done", "cancelling", "cancelled", "error" ] }, "type": { "type": "string", "example": "trainIntents" }, "parameters": { "type": "object" }, "lastChangedAt": { "type": "number", "example": 1594243850 }, "lastCreatedAt": { "type": "number", "example": 1594243850 }, "currentStep": { "type": "integer", "example": 0 }, "totalStep": { "type": "integer", "example": 100 } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/files/{fileId}": { "get": { "operationId": "readFile_2_0", "summary": "Get data of a file - binary data excluded", "description": "Get a single [File](doc:file) object in a project.", "tags": [ "Files v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "fileId", "description": "The Id of the File", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "200": { "description": "Returns File Object", "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/flows/{flowId}/addlocalization": { "post": { "operationId": "addFlowLocalization_2_0", "summary": "Adds a localiation for a node", "description": "Add a localization for a [Flow](doc:flow).", "tags": [ "Flows v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "flowId", "description": "The Id of the Flow", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "localeId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "inheritFromLocaleId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } } } }, "responses": { "204": { "description": "Successfully added localization for the Flow" }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/flows": { "patch": { "operationId": "batchFlows_2_0", "summary": "Batch Operations on Flows", "description": "Batch Operations on Flows.", "tags": [ "Flows v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "query", "name": "projectId", "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "operations": { "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "op": { "type": "string", "enum": [ "delete" ] }, "id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } }, { "type": "object", "properties": { "op": { "type": "string", "enum": [ "create" ] }, "value": { "type": "object", "properties": { "name": { "type": "string" }, "description": { "type": "string" }, "context": { "type": "object" }, "attachedFlows": { "type": "array", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "attachedLexicons": { "type": "array", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "img": { "type": "string" } } } } }, { "type": "object", "properties": { "op": { "type": "string", "enum": [ "update" ] }, "id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "value": { "type": "object", "properties": { "name": { "type": "string" }, "description": { "type": "string" }, "context": { "type": "object" }, "attachedFlows": { "type": "array", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "attachedLexicons": { "type": "array", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "img": { "type": "string" }, "localeId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } } } ] } } } } } } }, "responses": { "200": { "description": "Successfully ran the batch operations.", "content": { "application/json": { "schema": { "type": "object", "properties": { "created": { "type": "array", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "updated": { "type": "array", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "deleted": { "type": "array", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "post": { "operationId": "createFlow_2_0", "summary": "Create a new Flow", "description": "Create a new [Flow](doc:flow) resource in a project.", "tags": [ "Flows v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "query", "name": "resourceId", "description": "An Id of a resource within the corresponding project to copy from", "required": false, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string" }, "description": { "type": "string" }, "context": { "type": "object" }, "attachedFlows": { "type": "array", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "attachedLexicons": { "type": "array", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "img": { "type": "string" }, "projectId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } } } }, "responses": { "201": { "description": "Returns Flow object.", "content": { "application/json": { "schema": { "type": "object", "properties": { "referenceId": { "type": "string", "format": "uuid" }, "intentTrainGroupReference": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "feedbackReport": { "type": "object", "properties": { "findings": { "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "type": { "type": "string", "enum": [ "poorAccuracy", "fairAccuracy", "goodAccuracy", "lowDataIntents" ] } } }, { "type": "object", "properties": { "type": { "type": "string", "enum": [ "lowDataIntents" ] }, "intents": { "type": "array", "items": { "properties": { "intentReferenceId": { "type": "string" }, "intentName": { "type": "string" }, "intentId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "flowName": { "type": "string" }, "flowId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } } } } ] } }, "info": { "type": "object", "properties": { "fScore": { "type": "number" } } } } }, "isTrainingOutOfDate": { "type": "boolean" }, "name": { "type": "string" }, "description": { "type": "string" }, "context": { "type": "object" }, "attachedFlows": { "type": "array", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "attachedLexicons": { "type": "array", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "img": { "type": "string" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "get": { "operationId": "indexFlows_2_0", "summary": "Get Flows", "description": "Get 25 [Flows](https://docs.cognigy.com/ai/resources/build/flows/) in a project by default. To change the default value, use the `limit` query parameter. Additionally, you can filter, sort, and paginate the results.", "tags": [ "Flows v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "query", "name": "projectId", "description": "Filter by projectId", "required": false, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "query", "name": "filter", "required": false, "schema": { "type": "string" }, "description": "The name of the flow to filter the records" }, { "in": "query", "name": "limit", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100 }, "description": "The maximum number of items to return. The default is 25." }, { "in": "query", "name": "skip", "required": false, "schema": { "type": "integer", "minimum": 0 }, "description": "The number of items to skip. The default is 0. Used along with a limit of a pagination." }, { "in": "query", "name": "sort", "required": false, "schema": { "type": "string", "minLength": 1 }, "description": "The order of the sorting items-`Desc` (descending) or `Asc` (ascending). For example, to sort the records by name in ascending order, specify `name:Asc`." }, { "in": "query", "name": "next", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the nextCursor value from the response to get the next set of records. Used along with limit for pagination." }, { "in": "query", "name": "previous", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the previousCursor value from the response to get the previous set of records. Used along with limit for pagination." }, { "in": "query", "name": "preferredLocaleId", "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "200": { "description": "Returns array of a Flow metadata objects", "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "description": { "type": "string" }, "referenceId": { "type": "string", "format": "uuid" }, "isTrainingOutOfDate": { "type": "boolean" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" } }, "total": { "type": "integer", "example": 1 }, "next": { "oneOf": [ { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, { "nullable": true } ], "example": "5ce7c2d833ea1e04d7e6c432" }, "previous": { "oneOf": [ { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, { "nullable": true } ], "example": null } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/flows/{flowId}/chart/nodes/{nodeId}/addlocalization": { "post": { "operationId": "addFlowChartNodeLocalization_2_0", "summary": "Adds a localiation for a node", "description": "Add a localization for a [ChartNode](doc:chart).", "tags": [ "Charts v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "flowId", "description": "The Id of the Flow", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "path", "name": "nodeId", "description": "The Id of the Node", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "localeId": { "type": "string" }, "inhertFromLocaleId": { "type": "string" }, "nodeTranslationSettings": { "type": "object", "properties": { "from": { "type": "string" }, "to": { "type": "string" } } } } } } } }, "responses": { "200": { "description": "Successfully added localization for node" }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/flows/{flowId}/chart/nodes": { "post": { "operationId": "createFlowChartNode_2_0", "summary": "Create a new ChartNode", "description": "Create a new [ChartNode](doc:chart) resource in a project.", "tags": [ "Charts v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "flowId", "description": "The Id of the Flow", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "if", "description": "Type of the Node" }, "extension": { "type": "string", "example": "@cognigy/basic-nodes", "enum": [ "@cognigy/basic-nodes", "@cognigy/mongodb", "@cognigy/mssql", "@cognigy/smtp", "@cognigy/voicegateway", "@cognigy/microsoft", "@cognigy/voiceGateway2" ] }, "label": { "type": "string", "example": "A new Node", "description": "Replaces the default name of the Node displayed in the Flow Editor." }, "comment": { "type": "string", "example": "this is a very important node", "description": "Adds additional information about Nodes, for example, a specific of the Node." }, "commentColor": { "oneOf": [ { "oneOf": [ { "type": "string", "pattern": "^#(?:[0-9a-fA-F]{3}){1,2}$", "example": "#ff8a80" }, { "type": "string", "example": "none", "enum": [ "aliceBlue", "antiqueWhite", "aqua", "aquamarine", "azure", "beige", "bisque", "black", "blanchedAlmond", "blue", "blueViolet", "brown", "burlyWood", "cadetBlue", "chartreuse", "chocolate", "coral", "cornflowerBlue", "cornsilk", "crimson", "cyan", "darkBlue", "darkCyan", "darkGoldenRod", "darkGray", "darkGrey", "darkGreen", "darkKhaki", "darkMagenta", "darkOliveGreen", "darkOrange", "darkOrchid", "darkRed", "darkSalmon", "darkSeaGreen", "darkSlateBlue", "darkSlateGray", "darkSlateGrey", "darkTurquoise", "darkViolet", "deepPink", "deepSkyBlue", "dimGray", "dimGrey", "dodgerBlue", "fireBrick", "floralWhite", "forestGreen", "fuchsia", "gainsboro", "ghostWhite", "gold", "goldenRod", "gray", "grey", "green", "greenYellow", "honeyDew", "hotPink", "indianRed", "indigo", "ivory", "khaki", "lavender", "lavenderBlush", "lawnGreen", "lemonChiffon", "lightBlue", "lightCoral", "lightCyan", "lightGoldenRodYellow", "lightGray", "lightGrey", "lightGreen", "lightPink", "lightSalmon", "lightSeaGreen", "lightSkyBlue", "lightSlateGray", "lightSlateGrey", "lightSteelBlue", "lightYellow", "lime", "limeGreen", "linen", "magenta", "maroon", "mediumAquaMarine", "mediumBlue", "mediumOrchid", "mediumPurple", "mediumSeaGreen", "mediumSlateBlue", "mediumSpringGreen", "mediumTurquoise", "mediumVioletRed", "midnightBlue", "mintCream", "mistyRose", "moccasin", "navajoWhite", "navy", "oldLace", "olive", "oliveDrab", "orange", "orangeRed", "orchid", "paleGoldenRod", "paleGreen", "paleTurquoise", "paleVioletRed", "papayaWhip", "peachPuff", "peru", "pink", "plum", "powderBlue", "purple", "rebeccaPurple", "red", "rosyBrown", "royalBlue", "saddleBrown", "salmon", "sandyBrown", "seaGreen", "seaShell", "sienna", "silver", "skyBlue", "slateBlue", "slateGray", "slateGrey", "snow", "springGreen", "steelBlue", "tan", "teal", "thistle", "tomato", "turquoise", "violet", "wheat", "white", "whiteSmoke", "yellow", "yellowGreen", "none", "transparent" ] } ] }, { "type": "string", "nullable": false, "enum": [ "" ] } ] }, "isEntryPoint": { "type": "boolean", "example": false }, "isDisabled": { "type": "boolean", "example": false }, "config": { "type": "object", "example": { "condition": { "type": "rule", "condition": "", "rule": { "left": "1", "operand": "gt", "right": "2" } } } }, "localeReference": { "type": "string", "example": "63bd8ebb648e6e739f1bbd82" }, "analyticsLabel": { "type": "string", "example": "condition" }, "target": { "description": "The ID of the previous or parent node to which the current node should be attached.", "type": "string", "example": "63c6c16a7e1ef09c81f6075d" }, "mode": { "type": "string", "enum": [ "append", "prepend", "appendChild", "prependChild", "insertChildAt", "insertAfter", "insertBefore" ] }, "position": { "type": "number", "minimum": 0, "maximum": 2147483647, "example": 42, "description": "The desired position. Only used for insertChildAt." } }, "required": [ "target", "mode", "type" ] } } } }, "responses": { "201": { "description": "Returns ChartNode metadata object.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "if", "description": "Type of the Node" }, "extension": { "type": "string", "example": "@cognigy/basic-nodes", "enum": [ "@cognigy/basic-nodes", "@cognigy/mongodb", "@cognigy/mssql", "@cognigy/smtp", "@cognigy/voicegateway", "@cognigy/microsoft", "@cognigy/voiceGateway2" ] }, "label": { "type": "string", "example": "A new Node", "description": "Replaces the default name of the Node displayed in the Flow Editor." }, "comment": { "type": "string", "example": "this is a very important node", "description": "Adds additional information about Nodes, for example, a specific of the Node." }, "commentColor": { "oneOf": [ { "oneOf": [ { "type": "string", "pattern": "^#(?:[0-9a-fA-F]{3}){1,2}$", "example": "#ff8a80" }, { "type": "string", "example": "none", "enum": [ "aliceBlue", "antiqueWhite", "aqua", "aquamarine", "azure", "beige", "bisque", "black", "blanchedAlmond", "blue", "blueViolet", "brown", "burlyWood", "cadetBlue", "chartreuse", "chocolate", "coral", "cornflowerBlue", "cornsilk", "crimson", "cyan", "darkBlue", "darkCyan", "darkGoldenRod", "darkGray", "darkGrey", "darkGreen", "darkKhaki", "darkMagenta", "darkOliveGreen", "darkOrange", "darkOrchid", "darkRed", "darkSalmon", "darkSeaGreen", "darkSlateBlue", "darkSlateGray", "darkSlateGrey", "darkTurquoise", "darkViolet", "deepPink", "deepSkyBlue", "dimGray", "dimGrey", "dodgerBlue", "fireBrick", "floralWhite", "forestGreen", "fuchsia", "gainsboro", "ghostWhite", "gold", "goldenRod", "gray", "grey", "green", "greenYellow", "honeyDew", "hotPink", "indianRed", "indigo", "ivory", "khaki", "lavender", "lavenderBlush", "lawnGreen", "lemonChiffon", "lightBlue", "lightCoral", "lightCyan", "lightGoldenRodYellow", "lightGray", "lightGrey", "lightGreen", "lightPink", "lightSalmon", "lightSeaGreen", "lightSkyBlue", "lightSlateGray", "lightSlateGrey", "lightSteelBlue", "lightYellow", "lime", "limeGreen", "linen", "magenta", "maroon", "mediumAquaMarine", "mediumBlue", "mediumOrchid", "mediumPurple", "mediumSeaGreen", "mediumSlateBlue", "mediumSpringGreen", "mediumTurquoise", "mediumVioletRed", "midnightBlue", "mintCream", "mistyRose", "moccasin", "navajoWhite", "navy", "oldLace", "olive", "oliveDrab", "orange", "orangeRed", "orchid", "paleGoldenRod", "paleGreen", "paleTurquoise", "paleVioletRed", "papayaWhip", "peachPuff", "peru", "pink", "plum", "powderBlue", "purple", "rebeccaPurple", "red", "rosyBrown", "royalBlue", "saddleBrown", "salmon", "sandyBrown", "seaGreen", "seaShell", "sienna", "silver", "skyBlue", "slateBlue", "slateGray", "slateGrey", "snow", "springGreen", "steelBlue", "tan", "teal", "thistle", "tomato", "turquoise", "violet", "wheat", "white", "whiteSmoke", "yellow", "yellowGreen", "none", "transparent" ] } ] }, { "type": "string", "nullable": false, "enum": [ "" ] } ] }, "isEntryPoint": { "type": "boolean", "example": false }, "isDisabled": { "type": "boolean", "example": false }, "config": { "type": "object", "example": { "condition": { "type": "rule", "condition": "", "rule": { "left": "1", "operand": "gt", "right": "2" } } } }, "localeReference": { "type": "string", "example": "63bd8ebb648e6e739f1bbd82" }, "analyticsLabel": { "type": "string", "example": "condition" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "get": { "operationId": "indexFlowChartNodes_2_0", "summary": "Get nodes", "description": "Get 25 [Node Nodes](https://docs.cognigy.com/ai/resources/build/flows/) of a Chart by default. To change the default value, use the `limit` query parameter. Additionally, you can filter, sort, and paginate the results.", "tags": [ "Charts v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "flowId", "description": "The Id of the Flow", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "query", "name": "filter", "required": false, "schema": { "type": "string" }, "description": "The label or comment of the node to filter the records" }, { "in": "query", "name": "limit", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100 }, "description": "The maximum number of items to return. The default is 25." }, { "in": "query", "name": "skip", "required": false, "schema": { "type": "integer", "minimum": 0 }, "description": "The number of items to skip. The default is 0. Used along with a limit of a pagination." }, { "in": "query", "name": "sort", "required": false, "schema": { "type": "string", "minLength": 1 }, "description": "The order of the sorting items-`Desc` (descending) or `Asc` (ascending). For example, to sort the records by name in ascending order, specify `name:Asc`." }, { "in": "query", "name": "next", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the nextCursor value from the response to get the next set of records. Used along with limit for pagination." }, { "in": "query", "name": "previous", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the previousCursor value from the response to get the previous set of records. Used along with limit for pagination." }, { "in": "query", "name": "preferredLocaleId", "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "200": { "description": "Returns array of Node Nodes", "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "string", "example": "if", "description": "Type of the Node" }, "extension": { "type": "string", "example": "@cognigy/basic-nodes", "enum": [ "@cognigy/basic-nodes", "@cognigy/mongodb", "@cognigy/mssql", "@cognigy/smtp", "@cognigy/voicegateway", "@cognigy/microsoft", "@cognigy/voiceGateway2" ] }, "label": { "type": "string", "example": "A new Node", "description": "Replaces the default name of the Node displayed in the Flow Editor." }, "comment": { "type": "string", "example": "this is a very important node", "description": "Adds additional information about Nodes, for example, a specific of the Node." }, "commentColor": { "oneOf": [ { "oneOf": [ { "type": "string", "pattern": "^#(?:[0-9a-fA-F]{3}){1,2}$", "example": "#ff8a80" }, { "type": "string", "example": "none", "enum": [ "aliceBlue", "antiqueWhite", "aqua", "aquamarine", "azure", "beige", "bisque", "black", "blanchedAlmond", "blue", "blueViolet", "brown", "burlyWood", "cadetBlue", "chartreuse", "chocolate", "coral", "cornflowerBlue", "cornsilk", "crimson", "cyan", "darkBlue", "darkCyan", "darkGoldenRod", "darkGray", "darkGrey", "darkGreen", "darkKhaki", "darkMagenta", "darkOliveGreen", "darkOrange", "darkOrchid", "darkRed", "darkSalmon", "darkSeaGreen", "darkSlateBlue", "darkSlateGray", "darkSlateGrey", "darkTurquoise", "darkViolet", "deepPink", "deepSkyBlue", "dimGray", "dimGrey", "dodgerBlue", "fireBrick", "floralWhite", "forestGreen", "fuchsia", "gainsboro", "ghostWhite", "gold", "goldenRod", "gray", "grey", "green", "greenYellow", "honeyDew", "hotPink", "indianRed", "indigo", "ivory", "khaki", "lavender", "lavenderBlush", "lawnGreen", "lemonChiffon", "lightBlue", "lightCoral", "lightCyan", "lightGoldenRodYellow", "lightGray", "lightGrey", "lightGreen", "lightPink", "lightSalmon", "lightSeaGreen", "lightSkyBlue", "lightSlateGray", "lightSlateGrey", "lightSteelBlue", "lightYellow", "lime", "limeGreen", "linen", "magenta", "maroon", "mediumAquaMarine", "mediumBlue", "mediumOrchid", "mediumPurple", "mediumSeaGreen", "mediumSlateBlue", "mediumSpringGreen", "mediumTurquoise", "mediumVioletRed", "midnightBlue", "mintCream", "mistyRose", "moccasin", "navajoWhite", "navy", "oldLace", "olive", "oliveDrab", "orange", "orangeRed", "orchid", "paleGoldenRod", "paleGreen", "paleTurquoise", "paleVioletRed", "papayaWhip", "peachPuff", "peru", "pink", "plum", "powderBlue", "purple", "rebeccaPurple", "red", "rosyBrown", "royalBlue", "saddleBrown", "salmon", "sandyBrown", "seaGreen", "seaShell", "sienna", "silver", "skyBlue", "slateBlue", "slateGray", "slateGrey", "snow", "springGreen", "steelBlue", "tan", "teal", "thistle", "tomato", "turquoise", "violet", "wheat", "white", "whiteSmoke", "yellow", "yellowGreen", "none", "transparent" ] } ] }, { "type": "string", "nullable": false, "enum": [ "" ] } ] }, "isEntryPoint": { "type": "boolean", "example": false }, "isDisabled": { "type": "boolean", "example": false }, "config": { "type": "object", "example": { "condition": { "type": "rule", "condition": "", "rule": { "left": "1", "operand": "gt", "right": "2" } } } }, "localeReference": { "type": "string", "example": "63bd8ebb648e6e739f1bbd82" }, "analyticsLabel": { "type": "string", "example": "condition" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } }, "total": { "type": "integer", "example": 1 }, "next": { "oneOf": [ { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, { "nullable": true } ], "example": "5ce7c2d833ea1e04d7e6c432" }, "previous": { "oneOf": [ { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, { "nullable": true } ], "example": null } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/flows/{flowId}/chart/nodes/{nodeId}": { "delete": { "operationId": "deleteFlowChartNode_2_0", "summary": "Delete a ChartNode", "description": "Delete a [Chart](doc:chart).", "tags": [ "Charts v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "flowId", "description": "The Id of the Flow", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "path", "name": "nodeId", "description": "The Id of the Node", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "204": { "description": "Successfully deleted ChartNode" }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "get": { "operationId": "readFlowChartNode_2_0", "summary": "Get the data of the specified ChartNode", "description": "Get the [ChartNode](doc:chart) of the specified Flow.", "tags": [ "Charts v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "flowId", "description": "The Id of the Flow", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "path", "name": "nodeId", "description": "The Id of the Node", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "query", "name": "preferredLocaleId", "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "200": { "description": "Returns data of the ChartNode", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "if", "description": "Type of the Node" }, "extension": { "type": "string", "example": "@cognigy/basic-nodes", "enum": [ "@cognigy/basic-nodes", "@cognigy/mongodb", "@cognigy/mssql", "@cognigy/smtp", "@cognigy/voicegateway", "@cognigy/microsoft", "@cognigy/voiceGateway2" ] }, "label": { "type": "string", "example": "A new Node", "description": "Replaces the default name of the Node displayed in the Flow Editor." }, "comment": { "type": "string", "example": "this is a very important node", "description": "Adds additional information about Nodes, for example, a specific of the Node." }, "commentColor": { "oneOf": [ { "oneOf": [ { "type": "string", "pattern": "^#(?:[0-9a-fA-F]{3}){1,2}$", "example": "#ff8a80" }, { "type": "string", "example": "none", "enum": [ "aliceBlue", "antiqueWhite", "aqua", "aquamarine", "azure", "beige", "bisque", "black", "blanchedAlmond", "blue", "blueViolet", "brown", "burlyWood", "cadetBlue", "chartreuse", "chocolate", "coral", "cornflowerBlue", "cornsilk", "crimson", "cyan", "darkBlue", "darkCyan", "darkGoldenRod", "darkGray", "darkGrey", "darkGreen", "darkKhaki", "darkMagenta", "darkOliveGreen", "darkOrange", "darkOrchid", "darkRed", "darkSalmon", "darkSeaGreen", "darkSlateBlue", "darkSlateGray", "darkSlateGrey", "darkTurquoise", "darkViolet", "deepPink", "deepSkyBlue", "dimGray", "dimGrey", "dodgerBlue", "fireBrick", "floralWhite", "forestGreen", "fuchsia", "gainsboro", "ghostWhite", "gold", "goldenRod", "gray", "grey", "green", "greenYellow", "honeyDew", "hotPink", "indianRed", "indigo", "ivory", "khaki", "lavender", "lavenderBlush", "lawnGreen", "lemonChiffon", "lightBlue", "lightCoral", "lightCyan", "lightGoldenRodYellow", "lightGray", "lightGrey", "lightGreen", "lightPink", "lightSalmon", "lightSeaGreen", "lightSkyBlue", "lightSlateGray", "lightSlateGrey", "lightSteelBlue", "lightYellow", "lime", "limeGreen", "linen", "magenta", "maroon", "mediumAquaMarine", "mediumBlue", "mediumOrchid", "mediumPurple", "mediumSeaGreen", "mediumSlateBlue", "mediumSpringGreen", "mediumTurquoise", "mediumVioletRed", "midnightBlue", "mintCream", "mistyRose", "moccasin", "navajoWhite", "navy", "oldLace", "olive", "oliveDrab", "orange", "orangeRed", "orchid", "paleGoldenRod", "paleGreen", "paleTurquoise", "paleVioletRed", "papayaWhip", "peachPuff", "peru", "pink", "plum", "powderBlue", "purple", "rebeccaPurple", "red", "rosyBrown", "royalBlue", "saddleBrown", "salmon", "sandyBrown", "seaGreen", "seaShell", "sienna", "silver", "skyBlue", "slateBlue", "slateGray", "slateGrey", "snow", "springGreen", "steelBlue", "tan", "teal", "thistle", "tomato", "turquoise", "violet", "wheat", "white", "whiteSmoke", "yellow", "yellowGreen", "none", "transparent" ] } ] }, { "type": "string", "nullable": false, "enum": [ "" ] } ] }, "isEntryPoint": { "type": "boolean", "example": false }, "isDisabled": { "type": "boolean", "example": false }, "config": { "type": "object", "example": { "condition": { "type": "rule", "condition": "", "rule": { "left": "1", "operand": "gt", "right": "2" } } } }, "localeReference": { "type": "string", "example": "63bd8ebb648e6e739f1bbd82" }, "analyticsLabel": { "type": "string", "example": "condition" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "patch": { "operationId": "updateFlowChartNode_2_0", "summary": "Update a ChartNode", "description": "Update a [ChartNode](doc:chart).", "tags": [ "Charts v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "flowId", "description": "The Id of the Flow", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "path", "name": "nodeId", "description": "The Id of the Node", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "if", "description": "Type of the Node" }, "extension": { "type": "string", "example": "@cognigy/basic-nodes", "enum": [ "@cognigy/basic-nodes", "@cognigy/mongodb", "@cognigy/mssql", "@cognigy/smtp", "@cognigy/voicegateway", "@cognigy/microsoft", "@cognigy/voiceGateway2" ] }, "label": { "type": "string", "example": "A new Node", "description": "Replaces the default name of the Node displayed in the Flow Editor." }, "comment": { "type": "string", "example": "this is a very important node", "description": "Adds additional information about Nodes, for example, a specific of the Node." }, "commentColor": { "oneOf": [ { "oneOf": [ { "type": "string", "pattern": "^#(?:[0-9a-fA-F]{3}){1,2}$", "example": "#ff8a80" }, { "type": "string", "example": "none", "enum": [ "aliceBlue", "antiqueWhite", "aqua", "aquamarine", "azure", "beige", "bisque", "black", "blanchedAlmond", "blue", "blueViolet", "brown", "burlyWood", "cadetBlue", "chartreuse", "chocolate", "coral", "cornflowerBlue", "cornsilk", "crimson", "cyan", "darkBlue", "darkCyan", "darkGoldenRod", "darkGray", "darkGrey", "darkGreen", "darkKhaki", "darkMagenta", "darkOliveGreen", "darkOrange", "darkOrchid", "darkRed", "darkSalmon", "darkSeaGreen", "darkSlateBlue", "darkSlateGray", "darkSlateGrey", "darkTurquoise", "darkViolet", "deepPink", "deepSkyBlue", "dimGray", "dimGrey", "dodgerBlue", "fireBrick", "floralWhite", "forestGreen", "fuchsia", "gainsboro", "ghostWhite", "gold", "goldenRod", "gray", "grey", "green", "greenYellow", "honeyDew", "hotPink", "indianRed", "indigo", "ivory", "khaki", "lavender", "lavenderBlush", "lawnGreen", "lemonChiffon", "lightBlue", "lightCoral", "lightCyan", "lightGoldenRodYellow", "lightGray", "lightGrey", "lightGreen", "lightPink", "lightSalmon", "lightSeaGreen", "lightSkyBlue", "lightSlateGray", "lightSlateGrey", "lightSteelBlue", "lightYellow", "lime", "limeGreen", "linen", "magenta", "maroon", "mediumAquaMarine", "mediumBlue", "mediumOrchid", "mediumPurple", "mediumSeaGreen", "mediumSlateBlue", "mediumSpringGreen", "mediumTurquoise", "mediumVioletRed", "midnightBlue", "mintCream", "mistyRose", "moccasin", "navajoWhite", "navy", "oldLace", "olive", "oliveDrab", "orange", "orangeRed", "orchid", "paleGoldenRod", "paleGreen", "paleTurquoise", "paleVioletRed", "papayaWhip", "peachPuff", "peru", "pink", "plum", "powderBlue", "purple", "rebeccaPurple", "red", "rosyBrown", "royalBlue", "saddleBrown", "salmon", "sandyBrown", "seaGreen", "seaShell", "sienna", "silver", "skyBlue", "slateBlue", "slateGray", "slateGrey", "snow", "springGreen", "steelBlue", "tan", "teal", "thistle", "tomato", "turquoise", "violet", "wheat", "white", "whiteSmoke", "yellow", "yellowGreen", "none", "transparent" ] } ] }, { "type": "string", "nullable": false, "enum": [ "" ] } ] }, "isEntryPoint": { "type": "boolean", "example": false }, "isDisabled": { "type": "boolean", "example": false }, "config": { "type": "object", "example": { "condition": { "type": "rule", "condition": "", "rule": { "left": "1", "operand": "gt", "right": "2" } } } }, "localeReference": { "type": "string", "example": "63bd8ebb648e6e739f1bbd82" }, "analyticsLabel": { "type": "string", "example": "condition" }, "localeId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } } } }, "responses": { "204": { "description": "Successfully updated ChartNode" }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/flows/{flowId}/chart/nodes/output/generate": { "post": { "operationId": "generateNodeOutput_2_0", "summary": "Generate Output for a node using generative AI.", "description": "Generate Output (Adaptive Card or Text) for a node using generative AI.", "tags": [ "Charts v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "flowId", "description": "The Id of the Flow", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "localeId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "userText": { "type": "string", "example": "greetings" }, "outputType": { "type": "string", "example": "text", "enum": [ "text", "adaptiveCard" ] }, "lastOutput": { "type": "string", "description": "Last adaptive card output", "example": "{\"$schema\":\"http://adaptivecards.io/schemas/adaptive-card.json\", ...}" }, "generateContentLimit": { "type": "number", "description": "The number of sentences to be generated", "example": 3 } } } } } }, "responses": { "200": { "description": "Returns output", "content": { "application/json": { "schema": { "oneOf": [ { "type": "object", "properties": { "output": { "type": "object", "properties": { "type": { "type": "string", "example": "AdaptiveCard" }, "body": { "type": "array", "items": { "type": "object" } }, "actions": { "type": "array", "items": { "type": "object" } }, "version": { "type": "string", "example": 1 }, "speak": { "type": "string", "example": "create a poll for playing football on saturday at 3pm with the following options: yes, no, maybe" } } }, "outputType": { "type": "string", "example": "adaptiveCard" } } }, { "type": "object", "properties": { "output": { "type": "array", "items": { "type": "string", "example": "Greetings" } }, "outputType": { "type": "string", "example": "text" } } } ] } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/flows/{flowId}/chart/descriptors": { "get": { "operationId": "indexNodeDescriptors_2_0", "summary": "Get all node descriptors", "description": "Get all Node Descriptors of a Chart.", "tags": [ "Charts v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "flowId", "description": "The Id of the Flow", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "200": { "description": "Returns array of Node Descriptors", "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "string" }, "parentType": { "type": "string", "description": "The type of the node parent, if there is one" }, "defaultLabel": { "oneOf": [ { "type": "string", "description": "The label that should be used when a new Node of this type is created" }, { "type": "object", "description": "A localized version of the label that should be used when a new Node of this type is created", "properties": { "default": { "type": "string" }, "enUS": { "type": "string" }, "deDE": { "type": "string" }, "esES": { "type": "string" }, "jaJP": { "type": "string" }, "koKR": { "type": "string" } } } ] }, "summary": { "oneOf": [ { "type": "string", "description": "A short line of text that describes what this Node is used for" }, { "type": "object", "description": "A localized version of a short line of text that describes what this Node is used for", "properties": { "default": { "type": "string" }, "enUS": { "type": "string" }, "deDE": { "type": "string" }, "esES": { "type": "string" }, "jaJP": { "type": "string" }, "koKR": { "type": "string" } } } ] }, "extension": { "type": "string" }, "extensionImg": { "type": "string" }, "appearance": { "type": "object", "properties": { "logo": { "type": "string" }, "textColor": { "type": "string", "example": "blue", "oneOf": [ { "type": "string", "example": "none", "enum": [ "aliceBlue", "antiqueWhite", "aqua", "aquamarine", "azure", "beige", "bisque", "black", "blanchedAlmond", "blue", "blueViolet", "brown", "burlyWood", "cadetBlue", "chartreuse", "chocolate", "coral", "cornflowerBlue", "cornsilk", "crimson", "cyan", "darkBlue", "darkCyan", "darkGoldenRod", "darkGray", "darkGrey", "darkGreen", "darkKhaki", "darkMagenta", "darkOliveGreen", "darkOrange", "darkOrchid", "darkRed", "darkSalmon", "darkSeaGreen", "darkSlateBlue", "darkSlateGray", "darkSlateGrey", "darkTurquoise", "darkViolet", "deepPink", "deepSkyBlue", "dimGray", "dimGrey", "dodgerBlue", "fireBrick", "floralWhite", "forestGreen", "fuchsia", "gainsboro", "ghostWhite", "gold", "goldenRod", "gray", "grey", "green", "greenYellow", "honeyDew", "hotPink", "indianRed", "indigo", "ivory", "khaki", "lavender", "lavenderBlush", "lawnGreen", "lemonChiffon", "lightBlue", "lightCoral", "lightCyan", "lightGoldenRodYellow", "lightGray", "lightGrey", "lightGreen", "lightPink", "lightSalmon", "lightSeaGreen", "lightSkyBlue", "lightSlateGray", "lightSlateGrey", "lightSteelBlue", "lightYellow", "lime", "limeGreen", "linen", "magenta", "maroon", "mediumAquaMarine", "mediumBlue", "mediumOrchid", "mediumPurple", "mediumSeaGreen", "mediumSlateBlue", "mediumSpringGreen", "mediumTurquoise", "mediumVioletRed", "midnightBlue", "mintCream", "mistyRose", "moccasin", "navajoWhite", "navy", "oldLace", "olive", "oliveDrab", "orange", "orangeRed", "orchid", "paleGoldenRod", "paleGreen", "paleTurquoise", "paleVioletRed", "papayaWhip", "peachPuff", "peru", "pink", "plum", "powderBlue", "purple", "rebeccaPurple", "red", "rosyBrown", "royalBlue", "saddleBrown", "salmon", "sandyBrown", "seaGreen", "seaShell", "sienna", "silver", "skyBlue", "slateBlue", "slateGray", "slateGrey", "snow", "springGreen", "steelBlue", "tan", "teal", "thistle", "tomato", "turquoise", "violet", "wheat", "white", "whiteSmoke", "yellow", "yellowGreen", "none", "transparent" ] }, { "type": "string", "example": "cognigyGrey", "enum": [ "amber", "blueGrey", "cognigyBlue", "cognigyGrey", "deepOrange", "deepPurple", "lightBlue", "lightGreen" ] } ] }, "contrastTextColor": { "type": "string", "example": "blue", "oneOf": [ { "type": "string", "example": "none", "enum": [ "aliceBlue", "antiqueWhite", "aqua", "aquamarine", "azure", "beige", "bisque", "black", "blanchedAlmond", "blue", "blueViolet", "brown", "burlyWood", "cadetBlue", "chartreuse", "chocolate", "coral", "cornflowerBlue", "cornsilk", "crimson", "cyan", "darkBlue", "darkCyan", "darkGoldenRod", "darkGray", "darkGrey", "darkGreen", "darkKhaki", "darkMagenta", "darkOliveGreen", "darkOrange", "darkOrchid", "darkRed", "darkSalmon", "darkSeaGreen", "darkSlateBlue", "darkSlateGray", "darkSlateGrey", "darkTurquoise", "darkViolet", "deepPink", "deepSkyBlue", "dimGray", "dimGrey", "dodgerBlue", "fireBrick", "floralWhite", "forestGreen", "fuchsia", "gainsboro", "ghostWhite", "gold", "goldenRod", "gray", "grey", "green", "greenYellow", "honeyDew", "hotPink", "indianRed", "indigo", "ivory", "khaki", "lavender", "lavenderBlush", "lawnGreen", "lemonChiffon", "lightBlue", "lightCoral", "lightCyan", "lightGoldenRodYellow", "lightGray", "lightGrey", "lightGreen", "lightPink", "lightSalmon", "lightSeaGreen", "lightSkyBlue", "lightSlateGray", "lightSlateGrey", "lightSteelBlue", "lightYellow", "lime", "limeGreen", "linen", "magenta", "maroon", "mediumAquaMarine", "mediumBlue", "mediumOrchid", "mediumPurple", "mediumSeaGreen", "mediumSlateBlue", "mediumSpringGreen", "mediumTurquoise", "mediumVioletRed", "midnightBlue", "mintCream", "mistyRose", "moccasin", "navajoWhite", "navy", "oldLace", "olive", "oliveDrab", "orange", "orangeRed", "orchid", "paleGoldenRod", "paleGreen", "paleTurquoise", "paleVioletRed", "papayaWhip", "peachPuff", "peru", "pink", "plum", "powderBlue", "purple", "rebeccaPurple", "red", "rosyBrown", "royalBlue", "saddleBrown", "salmon", "sandyBrown", "seaGreen", "seaShell", "sienna", "silver", "skyBlue", "slateBlue", "slateGray", "slateGrey", "snow", "springGreen", "steelBlue", "tan", "teal", "thistle", "tomato", "turquoise", "violet", "wheat", "white", "whiteSmoke", "yellow", "yellowGreen", "none", "transparent" ] }, { "type": "string", "example": "cognigyGrey", "enum": [ "amber", "blueGrey", "cognigyBlue", "cognigyGrey", "deepOrange", "deepPurple", "lightBlue", "lightGreen" ] } ] }, "color": { "type": "string", "example": "red", "oneOf": [ { "type": "string", "example": "none", "enum": [ "aliceBlue", "antiqueWhite", "aqua", "aquamarine", "azure", "beige", "bisque", "black", "blanchedAlmond", "blue", "blueViolet", "brown", "burlyWood", "cadetBlue", "chartreuse", "chocolate", "coral", "cornflowerBlue", "cornsilk", "crimson", "cyan", "darkBlue", "darkCyan", "darkGoldenRod", "darkGray", "darkGrey", "darkGreen", "darkKhaki", "darkMagenta", "darkOliveGreen", "darkOrange", "darkOrchid", "darkRed", "darkSalmon", "darkSeaGreen", "darkSlateBlue", "darkSlateGray", "darkSlateGrey", "darkTurquoise", "darkViolet", "deepPink", "deepSkyBlue", "dimGray", "dimGrey", "dodgerBlue", "fireBrick", "floralWhite", "forestGreen", "fuchsia", "gainsboro", "ghostWhite", "gold", "goldenRod", "gray", "grey", "green", "greenYellow", "honeyDew", "hotPink", "indianRed", "indigo", "ivory", "khaki", "lavender", "lavenderBlush", "lawnGreen", "lemonChiffon", "lightBlue", "lightCoral", "lightCyan", "lightGoldenRodYellow", "lightGray", "lightGrey", "lightGreen", "lightPink", "lightSalmon", "lightSeaGreen", "lightSkyBlue", "lightSlateGray", "lightSlateGrey", "lightSteelBlue", "lightYellow", "lime", "limeGreen", "linen", "magenta", "maroon", "mediumAquaMarine", "mediumBlue", "mediumOrchid", "mediumPurple", "mediumSeaGreen", "mediumSlateBlue", "mediumSpringGreen", "mediumTurquoise", "mediumVioletRed", "midnightBlue", "mintCream", "mistyRose", "moccasin", "navajoWhite", "navy", "oldLace", "olive", "oliveDrab", "orange", "orangeRed", "orchid", "paleGoldenRod", "paleGreen", "paleTurquoise", "paleVioletRed", "papayaWhip", "peachPuff", "peru", "pink", "plum", "powderBlue", "purple", "rebeccaPurple", "red", "rosyBrown", "royalBlue", "saddleBrown", "salmon", "sandyBrown", "seaGreen", "seaShell", "sienna", "silver", "skyBlue", "slateBlue", "slateGray", "slateGrey", "snow", "springGreen", "steelBlue", "tan", "teal", "thistle", "tomato", "turquoise", "violet", "wheat", "white", "whiteSmoke", "yellow", "yellowGreen", "none", "transparent" ] }, { "type": "string", "example": "cognigyGrey", "enum": [ "amber", "blueGrey", "cognigyBlue", "cognigyGrey", "deepOrange", "deepPurple", "lightBlue", "lightGreen" ] } ] }, "variant": { "type": "string", "enum": [ "regular", "mini", "hexagon" ] } } }, "behavior": { "type": "object", "properties": { "stopping": { "type": "boolean" }, "entrypoint": { "type": "boolean" } } }, "constraints": { "type": "object", "properties": { "editable": { "type": "boolean", "description": "Should this node be editable" }, "deletable": { "type": "boolean", "description": "Should this node be deletable" }, "creatable": { "type": "boolean", "description": "Should this node be manually creatable" }, "collapsable": { "type": "boolean", "description": "Should this node be collapsable" }, "childFlowCreatable": { "type": "boolean", "description": "Should it be possible to create child flow from this node" }, "movable": { "type": "boolean", "description": "Should this node be movable" }, "placement": { "type": "object", "description": "Additional placement information", "properties": { "predecessor": { "type": "object", "properties": { "whitelist": { "items": { "type": "string" } }, "blacklist": { "items": { "type": "string" } } } }, "successor": { "type": "object", "properties": { "whitelist": { "items": { "type": "string" } }, "blacklist": { "items": { "type": "string" } } } }, "children": { "type": "object", "properties": { "whitelist": { "items": { "type": "string" } }, "blacklist": { "items": { "type": "string" } } } } } } } }, "dependencies": { "type": "object", "properties": { "children": { "type": "array", "items": { "type": "string" } } } }, "fields": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "text", "rule" ] }, "key": { "type": "string" }, "label": { "oneOf": [ { "type": "string" }, { "type": "object", "properties": { "default": { "type": "string" }, "enUS": { "type": "string" }, "deDE": { "type": "string" }, "esES": { "type": "string" }, "jaJP": { "type": "string" }, "koKR": { "type": "string" } } } ] }, "defaultValue": { "description": "The default value for that field" } } } }, "previews": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "message", "image", "code" ] }, "key": { "type": "string" } } } }, "tokens": { "type": "array", "items": { "type": "object", "properties": { "label": { "type": "string", "maxLength": 30, "example": "word count" }, "script": { "type": "string", "maxLength": 500, "example": "ci.text.split(' ').length" }, "type": { "type": "string", "enum": [ "profile", "input", "context", "custom", "answer", "flow-output", "flow-input" ], "example": "input" } } } }, "tags": { "type": "string", "enum": [ "basic", "logic", "message", "profile", "service", "nlu", "data" ] }, "sections": { "type": "array", "items": { "type": "object", "properties": { "key": { "type": "string", "description": "The key of the Field whose value should be matched" }, "value": { "description": "The expected value(s) that make this condition match" }, "negate": { "type": "boolean", "description": "If this is true, the condition result will be inverted" } } } }, "form": { "type": "array", "items": { "type": "object", "properties": { "key": { "type": "string", "description": "A key either pointing to a 'field -> key' or 'section -> key'" }, "type": { "type": "string", "description": "The type of the pointer, either 'field' or 'section'", "enum": [ "field", "section" ] } } } } } } } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/flows/{flowId}/chart/nodes/{nodeId}/move": { "post": { "operationId": "moveFlowChartNode_2_0", "summary": "Move a ChartNode", "description": "Move a [ChartNode](doc:chart).", "tags": [ "Charts v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "flowId", "description": "The Id of the Flow", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "path", "name": "nodeId", "description": "The Id of the Node", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "required": [ "target", "mode" ], "properties": { "target": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "mode": { "type": "string", "enum": [ "append", "prepend", "appendChild", "prependChild", "insertChildAt", "insertAfter", "insertBefore" ] }, "position": { "type": "number", "minimum": 0, "maximum": 2147483647, "example": 42, "description": "The desired position. The desired position. Only used for insertChildAt." } } } } } }, "responses": { "204": { "description": "Successfully moved ChartNode." }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/flows/{flowId}/chart/nodes/{nodeId}/removelocalization": { "post": { "operationId": "removeFlowChartNodeLocalization_2_0", "summary": "Removes a localization for a node", "description": "Remove a localization for a [ChartNode](doc:chart).", "tags": [ "Charts v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "flowId", "description": "The Id of the Flow", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "path", "name": "nodeId", "description": "The Id of the Node", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "localeId": { "type": "string" } } } } } }, "responses": { "204": { "description": "Successfully removed localization for node" }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/flows/{flowId}/chart/nodes/search": { "get": { "operationId": "searchFlowChartNodes_2_0", "summary": "Search chart nodes", "description": "Seach all [Node Nodes](doc:chart) of a Chart for a particular keyword", "tags": [ "Charts v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "flowId", "description": "The Id of the Flow", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "query", "name": "filter", "required": false, "schema": { "type": "string" }, "description": "Filter records by specific field eg:name." }, { "in": "query", "name": "preferredLocaleId", "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "200": { "description": "Returns array of Chart Nodes", "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "nodeId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "nodeReferenceId": { "type": "string", "format": "uuid" }, "matches": { "type": "array", "items": { "type": "object", "properties": { "fieldType": { "type": "string" }, "matchPath": { "type": "string" } } } } } } } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/flows/{flowId}/clone": { "post": { "operationId": "cloneFlow_2_0", "summary": "Clone an existing Flow", "description": "Clone a [Flow](doc:flow) in a project.", "tags": [ "Flows v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "flowId", "description": "The Id of the Flow", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "200": { "description": "Returns the cloned flow object.", "content": { "application/json": { "schema": { "type": "object", "properties": { "referenceId": { "type": "string", "format": "uuid" }, "intentTrainGroupReference": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "feedbackReport": { "type": "object", "properties": { "findings": { "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "type": { "type": "string", "enum": [ "poorAccuracy", "fairAccuracy", "goodAccuracy", "lowDataIntents" ] } } }, { "type": "object", "properties": { "type": { "type": "string", "enum": [ "lowDataIntents" ] }, "intents": { "type": "array", "items": { "properties": { "intentReferenceId": { "type": "string" }, "intentName": { "type": "string" }, "intentId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "flowName": { "type": "string" }, "flowId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } } } } ] } }, "info": { "type": "object", "properties": { "fScore": { "type": "number" } } } } }, "isTrainingOutOfDate": { "type": "boolean" }, "name": { "type": "string" }, "description": { "type": "string" }, "context": { "type": "object" }, "attachedFlows": { "type": "array", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "attachedLexicons": { "type": "array", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "img": { "type": "string" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/flows/{flowId}/chart/nodes/childflow": { "post": { "operationId": "createFlowFromChildren_2_0", "summary": "Create a new Flow from children nodes", "description": "Create a new [Flow](doc:flow) resource in a project from a child nodes.", "tags": [ "Flows v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "flowId", "description": "The Id of the Flow", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "nodeId", "newFlowName" ], "properties": { "nodeId": { "type": "string" }, "newFlowName": { "type": "string" } } } } } }, "responses": { "201": { "description": "Returns the created Child Flow metadata object.", "content": { "application/json": { "schema": { "type": "object", "properties": { "referenceId": { "type": "string", "format": "uuid" }, "intentTrainGroupReference": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "feedbackReport": { "type": "object", "properties": { "findings": { "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "type": { "type": "string", "enum": [ "poorAccuracy", "fairAccuracy", "goodAccuracy", "lowDataIntents" ] } } }, { "type": "object", "properties": { "type": { "type": "string", "enum": [ "lowDataIntents" ] }, "intents": { "type": "array", "items": { "properties": { "intentReferenceId": { "type": "string" }, "intentName": { "type": "string" }, "intentId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "flowName": { "type": "string" }, "flowId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } } } } ] } }, "info": { "type": "object", "properties": { "fScore": { "type": "number" } } } } }, "isTrainingOutOfDate": { "type": "boolean" }, "name": { "type": "string" }, "description": { "type": "string" }, "context": { "type": "object" }, "attachedFlows": { "type": "array", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "attachedLexicons": { "type": "array", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "img": { "type": "string" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/flows/{flowId}": { "delete": { "operationId": "deleteFlow_2_0", "summary": "Delete an Flow", "description": "Delete an [Flow](doc:flow).", "tags": [ "Flows v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "flowId", "description": "The Id of the Flow", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "204": { "description": "Successfully deleted Flow" }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "get": { "operationId": "readFlow_2_0", "summary": "Get a Flow", "description": "Get a single [Flow](doc:flow).", "tags": [ "Flows v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "flowId", "description": "The Id of the Flow", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "query", "name": "preferredLocaleId", "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "200": { "description": "Returns Flow Object", "content": { "application/json": { "schema": { "type": "object", "properties": { "referenceId": { "type": "string", "format": "uuid" }, "intentTrainGroupReference": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "feedbackReport": { "type": "object", "properties": { "findings": { "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "type": { "type": "string", "enum": [ "poorAccuracy", "fairAccuracy", "goodAccuracy", "lowDataIntents" ] } } }, { "type": "object", "properties": { "type": { "type": "string", "enum": [ "lowDataIntents" ] }, "intents": { "type": "array", "items": { "properties": { "intentReferenceId": { "type": "string" }, "intentName": { "type": "string" }, "intentId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "flowName": { "type": "string" }, "flowId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } } } } ] } }, "info": { "type": "object", "properties": { "fScore": { "type": "number" } } } } }, "isTrainingOutOfDate": { "type": "boolean" }, "name": { "type": "string" }, "description": { "type": "string" }, "context": { "type": "object" }, "attachedFlows": { "type": "array", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "attachedLexicons": { "type": "array", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "img": { "type": "string" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "patch": { "operationId": "updateFlow", "summary": "Update a Flow", "description": "Update a [Flow](doc:flow).", "tags": [ "Flows v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "flowId", "description": "The Id of the Flow", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string" }, "description": { "type": "string" }, "context": { "type": "object" }, "attachedFlows": { "type": "array", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "attachedLexicons": { "type": "array", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "img": { "type": "string" }, "localeId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } } } }, "responses": { "204": { "description": "Successfully updated Flow" }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/flows/{flowId}/intents/{intentId}/addlocalization": { "post": { "operationId": "addIntentLocalization_2_0", "summary": "Adds a localiation for an intent", "description": "Add a localization for an [Intent](doc:intent).", "tags": [ "Intents v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "flowId", "description": "The Id of the Flow", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "path", "name": "intentId", "description": "The Id of the Intent", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "localeId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "inheritFromLocaleId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "intentTranslationSettings": { "type": "object", "properties": { "from": { "type": "string" }, "to": { "type": "string" } } } } } } } }, "responses": { "200": { "description": "Successfully added localization for the intent" }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/flows/{flowId}/intents": { "patch": { "operationId": "batchIntents_2_0", "summary": "Batch Operations on Intents", "description": "Batch Operations on Intents.", "tags": [ "Intents v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "flowId", "description": "The Id of the Flow", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "operations": { "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "op": { "type": "string", "enum": [ "delete" ] }, "id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } }, { "type": "object", "properties": { "op": { "type": "string", "enum": [ "create" ] }, "value": { "type": "object", "properties": { "name": { "type": "string", "example": "OrderFood" }, "description": { "type": "string", "example": "Intent to order food" }, "condition": { "type": "string" }, "rules": { "type": "array", "items": { "type": "string" } }, "isRejectIntent": { "type": "boolean" }, "isDisabled": { "type": "boolean" }, "tags": { "type": "array", "items": { "type": "string" } }, "confirmationSentences": { "type": "array", "items": { "type": "string" } }, "disambiguationSentence": { "type": "string" }, "data": { "type": "object" }, "localeReference": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "childFeatures": { "oneOf": [ { "type": "boolean" }, { "type": "array", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "example": false }, "biasTowardsParentOrChildIntents": { "type": "string", "enum": [ "parents", "children" ] }, "parentIntentId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "analyticsLabel": { "type": "string" }, "overrideIntentDefaultRepliesAsExamples": { "type": "string", "description": "Toggle overriding the flow setting for using default replies as training examples", "enum": [ "on", "off", "useFlowSettings" ] } } } } }, { "type": "object", "properties": { "op": { "type": "string", "enum": [ "update" ] }, "id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "value": { "type": "object", "properties": { "name": { "type": "string", "example": "OrderFood" }, "description": { "type": "string", "example": "Intent to order food" }, "condition": { "type": "string" }, "rules": { "type": "array", "items": { "type": "string" } }, "isRejectIntent": { "type": "boolean" }, "isDisabled": { "type": "boolean" }, "tags": { "type": "array", "items": { "type": "string" } }, "confirmationSentences": { "type": "array", "items": { "type": "string" } }, "disambiguationSentence": { "type": "string" }, "data": { "type": "object" }, "localeReference": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "childFeatures": { "oneOf": [ { "type": "boolean" }, { "type": "array", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "example": false }, "biasTowardsParentOrChildIntents": { "type": "string", "enum": [ "parents", "children" ] }, "parentIntentId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "analyticsLabel": { "type": "string" }, "overrideIntentDefaultRepliesAsExamples": { "type": "string", "description": "Toggle overriding the flow setting for using default replies as training examples", "enum": [ "on", "off", "useFlowSettings" ] } } } } } ] } } } } } } }, "responses": { "200": { "description": "Successfully ran the batch operations.", "content": { "application/json": { "schema": { "type": "object", "properties": { "created": { "type": "array", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "updated": { "type": "array", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "deleted": { "type": "array", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "post": { "operationId": "createIntent_2_0", "summary": "Create a new Intent", "description": "Create a new [Intent](doc:endpoint) resource in a project.", "tags": [ "Intents v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "flowId", "description": "The Id of the Flow", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "query", "name": "shouldGenerateSentences", "required": false, "schema": { "type": "boolean" } }, { "in": "query", "name": "generateSentenceLimit", "required": false, "schema": { "type": "integer", "minimum": 5, "maximum": 20 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "example": "OrderFood" }, "description": { "type": "string", "example": "Intent to order food" }, "condition": { "type": "string" }, "rules": { "type": "array", "items": { "type": "string" } }, "isRejectIntent": { "type": "boolean" }, "isDisabled": { "type": "boolean" }, "tags": { "type": "array", "items": { "type": "string" } }, "confirmationSentences": { "type": "array", "items": { "type": "string" } }, "disambiguationSentence": { "type": "string" }, "data": { "type": "object" }, "localeReference": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "childFeatures": { "oneOf": [ { "type": "boolean" }, { "type": "array", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "example": false }, "biasTowardsParentOrChildIntents": { "type": "string", "enum": [ "parents", "children" ] }, "parentIntentId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "analyticsLabel": { "type": "string" }, "overrideIntentDefaultRepliesAsExamples": { "type": "string", "description": "Toggle overriding the flow setting for using default replies as training examples", "enum": [ "on", "off", "useFlowSettings" ] } } } } } }, "responses": { "201": { "description": "Returns Intent metadata object.", "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "example": "OrderFood" }, "description": { "type": "string", "example": "Intent to order food" }, "condition": { "type": "string" }, "rules": { "type": "array", "items": { "type": "string" } }, "isRejectIntent": { "type": "boolean" }, "isDisabled": { "type": "boolean" }, "tags": { "type": "array", "items": { "type": "string" } }, "confirmationSentences": { "type": "array", "items": { "type": "string" } }, "disambiguationSentence": { "type": "string" }, "data": { "type": "object" }, "localeReference": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "childFeatures": { "oneOf": [ { "type": "boolean" }, { "type": "array", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "example": false }, "biasTowardsParentOrChildIntents": { "type": "string", "enum": [ "parents", "children" ] }, "parentIntentId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "analyticsLabel": { "type": "string" }, "overrideIntentDefaultRepliesAsExamples": { "type": "string", "description": "Toggle overriding the flow setting for using default replies as training examples", "enum": [ "on", "off", "useFlowSettings" ] }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "get": { "operationId": "indexIntents_2_0", "summary": "Get Intents", "description": "Get 25 [Intents](https://docs.cognigy.com/ai/nlu/nlu-overview/overview/#intents) of a Flow by default. To change the default value, use the `limit` query parameter. Additionally, you can filter, sort, and paginate the results.", "tags": [ "Intents v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "flowId", "description": "The Id of the Flow", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "query", "name": "filter", "required": false, "schema": { "type": "string" }, "description": "The name of the intent to filter the records" }, { "in": "query", "name": "limit", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100 }, "description": "The maximum number of items to return. The default is 25." }, { "in": "query", "name": "skip", "required": false, "schema": { "type": "integer", "minimum": 0 }, "description": "The number of items to skip. The default is 0. Used along with a limit of a pagination." }, { "in": "query", "name": "sort", "required": false, "schema": { "type": "string", "minLength": 1 }, "description": "The order of the sorting items-`Desc` (descending) or `Asc` (ascending). For example, to sort the records by name in ascending order, specify `name:Asc`." }, { "in": "query", "name": "next", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the nextCursor value from the response to get the next set of records. Used along with limit for pagination." }, { "in": "query", "name": "previous", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the previousCursor value from the response to get the previous set of records. Used along with limit for pagination." }, { "in": "query", "name": "parent", "required": false, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "query", "name": "includeChildren", "required": false, "schema": { "type": "boolean" }, "example": true }, { "in": "query", "name": "includeFeedbackReport", "required": false, "schema": { "type": "boolean" }, "example": false }, { "in": "query", "name": "preferredLocaleId", "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "200": { "description": "Returns array of a Intents metadata objects", "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "referenceId": { "type": "string", "format": "uuid" }, "name": { "type": "string", "example": "OrderFood" }, "description": { "type": "string", "example": "Intent to order food" }, "tags": { "type": "array", "items": { "type": "string" } }, "isRejectIntent": { "type": "boolean" }, "isDisabled": { "type": "boolean" }, "localeReference": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "parentIntentId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "feedbackReport": { "type": "object", "properties": { "findings": { "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "type": { "type": "string", "enum": [ "poorFScore", "fairFScore", "goodFScore", "fewSentences", "unclearIntent", "noSiblings" ] } } }, { "type": "object", "properties": { "type": { "type": "string", "enum": [ "someOverlap", "strongOverlap" ] }, "overlappingIntentReferenceId": { "type": "string" }, "overlappingIntentName": { "type": "string" }, "overlappingIntentId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "overlappingFlowName": { "type": "string" }, "overlappingFlowId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } }, { "type": "object", "properties": { "type": { "type": "string", "enum": [ "lowDataIntents" ] }, "intents": { "type": "array", "items": { "properties": { "intentReferenceId": { "type": "string" }, "intentName": { "type": "string" }, "intentId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "flowName": { "type": "string" }, "flowId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } } } } ] } }, "info": { "type": "object", "properties": { "fScore": { "type": "number" } } } } } } } }, "total": { "type": "integer", "example": 1 }, "next": { "oneOf": [ { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, { "nullable": true } ], "example": "5ce7c2d833ea1e04d7e6c432" }, "previous": { "oneOf": [ { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, { "nullable": true } ], "example": null } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/flows/{flowId}/intents/{intentId}": { "delete": { "operationId": "deleteIntent_2_0", "summary": "Delete an Intent", "description": "Delete an [Intent](doc:endpoint).", "tags": [ "Intents v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "flowId", "description": "The Id of the Flow", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "path", "name": "intentId", "description": "The Id of the Intent", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "204": { "description": "Successfully deleted endpoint" }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "get": { "operationId": "readIntent_2_0", "summary": "Get an Intent", "description": "Get a single [Intent](doc:intent) of the specified Flow.", "tags": [ "Intents v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "flowId", "description": "The Id of the Flow", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "path", "name": "intentId", "description": "The Id of the Intent", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "query", "name": "preferredLocaleId", "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "200": { "description": "Returns Intent Object", "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "example": "OrderFood" }, "description": { "type": "string", "example": "Intent to order food" }, "condition": { "type": "string" }, "rules": { "type": "array", "items": { "type": "string" } }, "isRejectIntent": { "type": "boolean" }, "isDisabled": { "type": "boolean" }, "tags": { "type": "array", "items": { "type": "string" } }, "confirmationSentences": { "type": "array", "items": { "type": "string" } }, "disambiguationSentence": { "type": "string" }, "data": { "type": "object" }, "localeReference": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "childFeatures": { "oneOf": [ { "type": "boolean" }, { "type": "array", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "example": false }, "biasTowardsParentOrChildIntents": { "type": "string", "enum": [ "parents", "children" ] }, "parentIntentId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "analyticsLabel": { "type": "string" }, "overrideIntentDefaultRepliesAsExamples": { "type": "string", "description": "Toggle overriding the flow setting for using default replies as training examples", "enum": [ "on", "off", "useFlowSettings" ] }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "patch": { "operationId": "updateIntent_2_0", "summary": "Update an Intent", "description": "Update an [Intent](doc:intent) resource in a project.", "tags": [ "Intents v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "flowId", "description": "The Id of the Flow", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "path", "name": "intentId", "description": "The Id of the Intent", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "example": "OrderFood" }, "description": { "type": "string", "example": "Intent to order food" }, "condition": { "type": "string" }, "rules": { "type": "array", "items": { "type": "string" } }, "isRejectIntent": { "type": "boolean" }, "isDisabled": { "type": "boolean" }, "tags": { "type": "array", "items": { "type": "string" } }, "confirmationSentences": { "type": "array", "items": { "type": "string" } }, "disambiguationSentence": { "type": "string" }, "data": { "type": "object" }, "localeReference": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "childFeatures": { "oneOf": [ { "type": "boolean" }, { "type": "array", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "example": false }, "biasTowardsParentOrChildIntents": { "type": "string", "enum": [ "parents", "children" ] }, "parentIntentId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "analyticsLabel": { "type": "string" }, "overrideIntentDefaultRepliesAsExamples": { "type": "string", "description": "Toggle overriding the flow setting for using default replies as training examples", "enum": [ "on", "off", "useFlowSettings" ] } } } } } }, "responses": { "204": { "description": "Successfully updated Intent" }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/flows/{flowId}/intents/export": { "post": { "operationId": "exportIntents_2_0", "summary": "Export intents", "description": "Export Intents of a Flow.", "tags": [ "Intents v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "flowId", "description": "The Id of the Flow", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "localeId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "format": { "type": "string", "enum": [ "csv", "json" ] } } } } } }, "responses": { "200": { "description": "Returns exported lexicon data in specified type.", "content": { "text/csv": { "schema": { "type": "string", "description": "Stringified CSV or JSON.", "example": "" } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/flows/{flowId}/intents/import": { "post": { "operationId": "importIntents_2_0", "summary": "Upload Intents", "description": "Upload Intents and create a Task to import the Intents. Currently you can only import csv formatted data.", "tags": [ "Intents v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "flowId", "description": "The Id of the Flow", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "requestBody": { "required": true, "content": { "multipart/form-data": { "schema": { "type": "object", "properties": { "file": { "type": "string", "format": "binary" }, "localeId": { "type": "string" }, "mode": { "type": "string", "enum": [ "skip", "overwrite", "merge" ] } } } } } }, "responses": { "202": { "description": "Successfully uploaded the Intents and created a Task to import the Intents.", "content": { "application/json": { "schema": { "type": "object", "properties": { "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "status": { "type": "string", "description": "The status of the task", "example": "queued", "enum": [ "queued", "active", "done", "cancelling", "cancelled", "error" ] }, "type": { "type": "string", "example": "trainIntents" }, "parameters": { "type": "object" }, "lastChangedAt": { "type": "number", "example": 1594243850 }, "lastCreatedAt": { "type": "number", "example": 1594243850 }, "currentStep": { "type": "integer", "example": 0 }, "totalStep": { "type": "integer", "example": 100 } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/flows/{flowId}/intents/{intentId}/removelocalization": { "post": { "operationId": "removeIntentLocalization_2_0", "summary": "Removes a localiation for an intent", "description": "Remove a localization for an [Intent](doc:intent).", "tags": [ "Intents v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "flowId", "description": "The Id of the Flow", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "path", "name": "intentId", "description": "The Id of the Intent", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "localeId": { "type": "string" } } } } } }, "responses": { "204": { "description": "Successfully removed localization for the intent" }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/flows/{flowId}/intents/train": { "post": { "operationId": "trainIntents_2_0", "summary": "Create a Task to Train the Intents of Flow", "description": "Create a Task to Train the [Intents](doc:intent) of a Flow", "tags": [ "Intents v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "flowId", "description": "The Id of the Flow", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "query", "name": "filter", "required": false, "schema": { "type": "string" }, "description": "Filter records by specific field eg:name." }, { "in": "query", "name": "limit", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100 }, "description": "The maximum number of items to return. The default is 25." }, { "in": "query", "name": "skip", "required": false, "schema": { "type": "integer", "minimum": 0 }, "description": "The number of items to skip. The default is 0. Used along with a limit of a pagination." }, { "in": "query", "name": "sort", "required": false, "schema": { "type": "string", "minLength": 1 }, "description": "The order of the sorting items-`Desc` (descending) or `Asc` (ascending). For example, to sort the records by name in ascending order, specify `name:Asc`." }, { "in": "query", "name": "next", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the nextCursor value from the response to get the next set of records. Used along with limit for pagination." }, { "in": "query", "name": "previous", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the previousCursor value from the response to get the previous set of records. Used along with limit for pagination." } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "localeId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "mode": { "type": "string", "enum": [ "full", "quick" ] } } } } } }, "responses": { "202": { "description": "Successfully created Task to train Intents", "content": { "application/json": { "schema": { "type": "object", "properties": { "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "status": { "type": "string", "description": "The status of the task", "example": "queued", "enum": [ "queued", "active", "done", "cancelling", "cancelled", "error" ] }, "type": { "type": "string", "example": "trainIntents" }, "parameters": { "type": "object" }, "lastChangedAt": { "type": "number", "example": 1594243850 }, "lastCreatedAt": { "type": "number", "example": 1594243850 }, "currentStep": { "type": "integer", "example": 0 }, "totalStep": { "type": "integer", "example": 100 } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/flows/{flowId}/chart": { "get": { "operationId": "readFlowChart_2_0", "summary": "Get the Chart of specified Flow", "description": "Get the [Chart](doc:chart) of the specified Flow.", "tags": [ "Charts v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "flowId", "description": "The Id of the Flow", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "query", "name": "preferredLocaleId", "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "200": { "description": "Returns Chart of the Flow", "content": { "application/json": { "schema": { "type": "object", "properties": { "nodes": { "type": "array", "items": { "type": "object", "properties": { "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "type": { "type": "string", "example": "if" }, "referenceId": { "type": "string", "format": "uuid" }, "extension": { "type": "string", "example": "@cognigy/basic-nodes" }, "label": { "type": "string", "example": "A new Node" }, "analyticsLabel": { "type": "string", "example": "Step name" }, "comment": { "type": "string", "example": "this is a very important node" }, "commentColor": { "oneOf": [ { "oneOf": [ { "type": "string", "pattern": "^#(?:[0-9a-fA-F]{3}){1,2}$", "example": "#ff8a80" }, { "type": "string", "example": "none", "enum": [ "aliceBlue", "antiqueWhite", "aqua", "aquamarine", "azure", "beige", "bisque", "black", "blanchedAlmond", "blue", "blueViolet", "brown", "burlyWood", "cadetBlue", "chartreuse", "chocolate", "coral", "cornflowerBlue", "cornsilk", "crimson", "cyan", "darkBlue", "darkCyan", "darkGoldenRod", "darkGray", "darkGrey", "darkGreen", "darkKhaki", "darkMagenta", "darkOliveGreen", "darkOrange", "darkOrchid", "darkRed", "darkSalmon", "darkSeaGreen", "darkSlateBlue", "darkSlateGray", "darkSlateGrey", "darkTurquoise", "darkViolet", "deepPink", "deepSkyBlue", "dimGray", "dimGrey", "dodgerBlue", "fireBrick", "floralWhite", "forestGreen", "fuchsia", "gainsboro", "ghostWhite", "gold", "goldenRod", "gray", "grey", "green", "greenYellow", "honeyDew", "hotPink", "indianRed", "indigo", "ivory", "khaki", "lavender", "lavenderBlush", "lawnGreen", "lemonChiffon", "lightBlue", "lightCoral", "lightCyan", "lightGoldenRodYellow", "lightGray", "lightGrey", "lightGreen", "lightPink", "lightSalmon", "lightSeaGreen", "lightSkyBlue", "lightSlateGray", "lightSlateGrey", "lightSteelBlue", "lightYellow", "lime", "limeGreen", "linen", "magenta", "maroon", "mediumAquaMarine", "mediumBlue", "mediumOrchid", "mediumPurple", "mediumSeaGreen", "mediumSlateBlue", "mediumSpringGreen", "mediumTurquoise", "mediumVioletRed", "midnightBlue", "mintCream", "mistyRose", "moccasin", "navajoWhite", "navy", "oldLace", "olive", "oliveDrab", "orange", "orangeRed", "orchid", "paleGoldenRod", "paleGreen", "paleTurquoise", "paleVioletRed", "papayaWhip", "peachPuff", "peru", "pink", "plum", "powderBlue", "purple", "rebeccaPurple", "red", "rosyBrown", "royalBlue", "saddleBrown", "salmon", "sandyBrown", "seaGreen", "seaShell", "sienna", "silver", "skyBlue", "slateBlue", "slateGray", "slateGrey", "snow", "springGreen", "steelBlue", "tan", "teal", "thistle", "tomato", "turquoise", "violet", "wheat", "white", "whiteSmoke", "yellow", "yellowGreen", "none", "transparent" ] } ] }, { "type": "string", "nullable": false, "enum": [ "" ] } ] }, "isCollapsed": { "type": "boolean", "example": false }, "isEntryPoint": { "type": "boolean", "example": false }, "isDisabled": { "type": "boolean", "example": false } } } }, "relations": { "type": "array", "items": { "type": "object", "properties": { "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "node": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "children": { "type": "array", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "next": { "oneOf": [ { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, { "nullable": true } ] } } } } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/flows/{flowId}/removelocalization": { "post": { "operationId": "removeFlowLocalization_2_0", "summary": "Removes a localization for a flow", "description": "Remove a localization for a [Flow](doc:flow).", "tags": [ "Flows v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "flowId", "description": "The Id of the Flow", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "localeId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } } } }, "responses": { "204": { "description": "Successfully removed localization for flow" }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/flows/{flowId}/intents/{intentId}/sentences": { "patch": { "operationId": "batchSentences_2_0", "summary": "Batch Operations on Sentences", "description": "Batch Operations on Sentences.", "tags": [ "Sentences v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "flowId", "description": "The Id of the Flow", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "path", "name": "intentId", "description": "The Id of the Intent", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "operations": { "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "op": { "type": "string", "enum": [ "delete" ] }, "id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } }, { "type": "object", "properties": { "op": { "type": "string", "enum": [ "create" ] }, "value": { "type": "object", "properties": { "text": { "type": "string", "example": "I want to buy a pizza." }, "slots": { "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "type": { "type": "string", "enum": [ "anySlot" ] }, "name": { "type": "string" }, "start": { "type": "number" }, "end": { "type": "number" } } }, { "type": "object", "properties": { "type": { "type": "string", "enum": [ "systemSlot" ] }, "dimension": { "type": "string" }, "start": { "type": "number" }, "end": { "type": "number" } } }, { "type": "object", "properties": { "type": { "type": "string", "enum": [ "lexiconSlot" ] }, "lexiconReference": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "slotReference": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "name": { "type": "string" }, "start": { "type": "number" }, "end": { "type": "number" } } } ] } } } } } }, { "type": "object", "properties": { "op": { "type": "string", "enum": [ "update" ] }, "id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "value": { "type": "object", "properties": { "text": { "type": "string", "example": "I want to buy a pizza." }, "slots": { "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "type": { "type": "string", "enum": [ "anySlot" ] }, "name": { "type": "string" }, "start": { "type": "number" }, "end": { "type": "number" } } }, { "type": "object", "properties": { "type": { "type": "string", "enum": [ "systemSlot" ] }, "dimension": { "type": "string" }, "start": { "type": "number" }, "end": { "type": "number" } } }, { "type": "object", "properties": { "type": { "type": "string", "enum": [ "lexiconSlot" ] }, "lexiconReference": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "slotReference": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "name": { "type": "string" }, "start": { "type": "number" }, "end": { "type": "number" } } } ] } } } } } } ] } } } } } } }, "responses": { "200": { "description": "Successfully ran the batch operations.", "content": { "application/json": { "schema": { "type": "object", "properties": { "created": { "type": "array", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "updated": { "type": "array", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "deleted": { "type": "array", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "post": { "operationId": "createSentence_2_0", "summary": "Create a new Sentence", "description": "Create a new [Sentence](doc:sentence) resource in a project.", "tags": [ "Sentences v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "flowId", "description": "The Id of the Flow", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "path", "name": "intentId", "description": "The Id of the Intent", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "text": { "type": "string", "example": "I want to buy a pizza." }, "slots": { "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "type": { "type": "string", "enum": [ "anySlot" ] }, "name": { "type": "string" }, "start": { "type": "number" }, "end": { "type": "number" } } }, { "type": "object", "properties": { "type": { "type": "string", "enum": [ "systemSlot" ] }, "dimension": { "type": "string" }, "start": { "type": "number" }, "end": { "type": "number" } } }, { "type": "object", "properties": { "type": { "type": "string", "enum": [ "lexiconSlot" ] }, "lexiconReference": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "slotReference": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "name": { "type": "string" }, "start": { "type": "number" }, "end": { "type": "number" } } } ] } } } } } } }, "responses": { "201": { "description": "Returns Sentence metadata object.", "content": { "application/json": { "schema": { "type": "object", "properties": { "localeReference": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "feedbackReport": { "type": "object", "properties": { "findings": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "poorScore", "fairScore", "goodScore", "overlap", "wrongIntent" ] } } } }, "info": { "type": "object", "properties": { "trueIntent": { "type": "string" }, "topIntent": { "type": "string" }, "runnerUp": { "type": "string" }, "topScore": { "type": "number" }, "runnerUpScore": { "type": "number" }, "difference": { "type": "number" }, "trueIntentName": { "type": "string" }, "topIntentName": { "type": "string" }, "runnerUpIntentName": { "type": "string" } } } } }, "text": { "type": "string", "example": "I want to buy a pizza." }, "slots": { "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "type": { "type": "string", "enum": [ "anySlot" ] }, "name": { "type": "string" }, "start": { "type": "number" }, "end": { "type": "number" } } }, { "type": "object", "properties": { "type": { "type": "string", "enum": [ "systemSlot" ] }, "dimension": { "type": "string" }, "start": { "type": "number" }, "end": { "type": "number" } } }, { "type": "object", "properties": { "type": { "type": "string", "enum": [ "lexiconSlot" ] }, "lexiconReference": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "slotReference": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "name": { "type": "string" }, "start": { "type": "number" }, "end": { "type": "number" } } } ] } }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "get": { "operationId": "indexSentences_2_0", "summary": "Get Sentences", "description": "Get 25 [Sentences](https://docs.cognigy.com/ai/nlu/nlu-overview/ml-intents/#example-sentences) in a project by default. To change the default value, use the `limit` query parameter. Additionally, you can filter, sort, and paginate the results.", "tags": [ "Sentences v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "flowId", "description": "The Id of the Flow", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "path", "name": "intentId", "description": "The Id of the Intent", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "query", "name": "filter", "required": false, "schema": { "type": "string" }, "description": "The text of the sentence to filter the records" }, { "in": "query", "name": "limit", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100 }, "description": "The maximum number of items to return. The default is 25." }, { "in": "query", "name": "skip", "required": false, "schema": { "type": "integer", "minimum": 0 }, "description": "The number of items to skip. The default is 0. Used along with a limit of a pagination." }, { "in": "query", "name": "sort", "required": false, "schema": { "type": "string", "minLength": 1 }, "description": "The order of the sorting items-`Desc` (descending) or `Asc` (ascending). For example, to sort the records by name in ascending order, specify `name:Asc`." }, { "in": "query", "name": "next", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the nextCursor value from the response to get the next set of records. Used along with limit for pagination." }, { "in": "query", "name": "previous", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the previousCursor value from the response to get the previous set of records. Used along with limit for pagination." }, { "in": "query", "name": "preferredLocaleId", "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "200": { "description": "Returns array of a Sentence metadata objects", "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "text": { "type": "string", "example": "I want to buy a pizza." }, "localeReference": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "slots": { "type": "array", "items": { "type": "object", "additionalProperties": false, "properties": { "tagReference": { "type": "string" }, "lexiconReference": { "type": "string" } } } }, "feedbackReport": { "type": "object", "properties": { "findings": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "poorScore", "fairScore", "goodScore", "overlap", "wrongIntent" ] } } } }, "info": { "type": "object", "properties": { "trueIntent": { "type": "string" }, "topIntent": { "type": "string" }, "runnerUp": { "type": "string" }, "topScore": { "type": "number" }, "runnerUpScore": { "type": "number" }, "difference": { "type": "number" }, "trueIntentName": { "type": "string" }, "topIntentName": { "type": "string" }, "runnerUpIntentName": { "type": "string" } } } } }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" } }, "total": { "type": "integer", "example": 1 }, "next": { "oneOf": [ { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, { "nullable": true } ], "example": "5ce7c2d833ea1e04d7e6c432" }, "previous": { "oneOf": [ { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, { "nullable": true } ], "example": null } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/flows/{flowId}/intents/{intentId}/sentences/{sentenceId}": { "delete": { "operationId": "deleteSentence_2_0", "summary": "Delete an Sentence", "description": "Delete an [Sentence](doc:sentence).", "tags": [ "Sentences v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "flowId", "description": "The Id of the Flow", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "path", "name": "intentId", "description": "The Id of the Intent", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "path", "name": "sentenceId", "description": "The Id of the Sentence", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "204": { "description": "Successfully deleted sentence" }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "get": { "operationId": "readSentence_2_0", "summary": "Get a Sentence", "description": "Get a single [Sentence](doc:sentence) resource in a project.", "tags": [ "Sentences v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "flowId", "description": "The Id of the Flow", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "path", "name": "intentId", "description": "The Id of the Intent", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "path", "name": "sentenceId", "description": "The Id of the Sentence", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "200": { "description": "Returns Sentence Object", "content": { "application/json": { "schema": { "type": "object", "properties": { "localeReference": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "feedbackReport": { "type": "object", "properties": { "findings": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "poorScore", "fairScore", "goodScore", "overlap", "wrongIntent" ] } } } }, "info": { "type": "object", "properties": { "trueIntent": { "type": "string" }, "topIntent": { "type": "string" }, "runnerUp": { "type": "string" }, "topScore": { "type": "number" }, "runnerUpScore": { "type": "number" }, "difference": { "type": "number" }, "trueIntentName": { "type": "string" }, "topIntentName": { "type": "string" }, "runnerUpIntentName": { "type": "string" } } } } }, "text": { "type": "string", "example": "I want to buy a pizza." }, "slots": { "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "type": { "type": "string", "enum": [ "anySlot" ] }, "name": { "type": "string" }, "start": { "type": "number" }, "end": { "type": "number" } } }, { "type": "object", "properties": { "type": { "type": "string", "enum": [ "systemSlot" ] }, "dimension": { "type": "string" }, "start": { "type": "number" }, "end": { "type": "number" } } }, { "type": "object", "properties": { "type": { "type": "string", "enum": [ "lexiconSlot" ] }, "lexiconReference": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "slotReference": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "name": { "type": "string" }, "start": { "type": "number" }, "end": { "type": "number" } } } ] } }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "patch": { "operationId": "updateSentence", "summary": "Update a Sentence", "description": "Update a [Sentence](doc:sentence) resource in a project.", "tags": [ "Sentences v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "flowId", "description": "The Id of the Flow", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "path", "name": "intentId", "description": "The Id of the Intent", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "path", "name": "sentenceId", "description": "The Id of the Sentence", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "text": { "type": "string", "example": "I want to buy a pizza." }, "slots": { "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "type": { "type": "string", "enum": [ "anySlot" ] }, "name": { "type": "string" }, "start": { "type": "number" }, "end": { "type": "number" } } }, { "type": "object", "properties": { "type": { "type": "string", "enum": [ "systemSlot" ] }, "dimension": { "type": "string" }, "start": { "type": "number" }, "end": { "type": "number" } } }, { "type": "object", "properties": { "type": { "type": "string", "enum": [ "lexiconSlot" ] }, "lexiconReference": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "slotReference": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "name": { "type": "string" }, "start": { "type": "number" }, "end": { "type": "number" } } } ] } } } } } } }, "responses": { "204": { "description": "Successfully updated Sentence" }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/flows/{flowId}/intents/{intentId}/sentences/generate": { "post": { "operationId": "generateSentences_2_0", "summary": "Generate Sentences for an intent using generative AI.", "description": "Generate Sentences for an intent using generative AI.", "tags": [ "Sentences v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "flowId", "description": "The Id of the Flow", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "path", "name": "intentId", "description": "The Id of the Intent", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "query", "name": "localeId", "required": false, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "query", "name": "limit", "required": false, "schema": { "type": "integer", "minimum": 5, "maximum": 20 } } ], "responses": { "200": { "description": "Returns array of sentences", "content": { "application/json": { "schema": { "type": "array", "items": { "type": "string" } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/flows/{flowId}/settings": { "get": { "operationId": "readFlowSettings_2_0", "summary": "Get the Settings of a Flow", "description": "Get the Settings of a [Flow](doc:flow).", "tags": [ "Flows v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "flowId", "description": "The Id of the Flow", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "200": { "description": "Returns the Settings of the Flow", "content": { "application/json": { "schema": { "type": "object", "properties": { "continueExecutionAfterAttachedFlow": { "type": "boolean" }, "continueExecutionAterDefaultReply": { "type": "boolean" }, "continueExecutionAfterNegativeConfirmation": { "type": "boolean" }, "passDefaultRepliesIntoFlow": { "type": "boolean" }, "flowIntentMappingOrder": { "type": "string", "enum": [ "joint", "main", "attached" ] }, "useAttachedFlowThresholds": { "type": "boolean" }, "useAttachedFlowContinueAfterDefaultReply": { "type": "boolean" }, "useAttachedFlowPassDefaultRepliesIntoFlow": { "type": "boolean" }, "implicitSlotParsing": { "type": "string", "enum": [ "disabled", "full", "system", "lexicon" ] }, "useAttachedFlowImplicitSlotParsing": { "type": "boolean" }, "lexiconSlotsWithSubMatches": { "type": "boolean" }, "useIntentDefaultRepliesAsExamples": { "description": "Enable/Disable using default replies as training examples.", "type": "boolean" }, "localeSettings": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "object", "properties": { "localeReference": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "inheritFallbackLocaleModel": { "type": "boolean" } } } } } }, "intentThreshold": { "type": "object", "properties": { "lower": { "type": "number", "example": 0.4 }, "upper": { "type": "number", "example": 0.5 } } }, "learnNewExampleSentences": { "type": "boolean" }, "learnNewExampleSentencesThreshold": { "type": "integer" }, "negativeConfirmationWords": { "type": "array", "items": { "type": "string" } }, "positiveConfirmationWords": { "type": "array", "items": { "type": "string" } }, "systemSlots": { "type": "object", "properties": { "useAgeSlots": { "type": "boolean" }, "useDateSlots": { "type": "boolean" }, "useDistanceSlots": { "type": "boolean" }, "useDurationSlots": { "type": "boolean" }, "useEmailSlots": { "type": "boolean" }, "useMoneySlots": { "type": "boolean" }, "useNumberSlots": { "type": "boolean" }, "usePercentageSlots": { "type": "boolean" }, "useTemperatureSlots": { "type": "boolean" }, "useURLSlots": { "type": "boolean" } } }, "yesNoLogic": { "type": "string", "enum": [ "yesNoIntents", "yesNoIntentsWithRules", "confirmationWords" ] }, "yesNoIntentThreshold": { "type": "integer" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "patch": { "operationId": "updateFlowSettings_2_0", "summary": "Update the Settings of a Flow", "description": "Update the Settings of a [Flow](doc:flow).", "tags": [ "Flows v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "flowId", "description": "The Id of the Flow", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "continueExecutionAfterAttachedFlow": { "type": "boolean" }, "continueExecutionAterDefaultReply": { "type": "boolean" }, "continueExecutionAfterNegativeConfirmation": { "type": "boolean" }, "passDefaultRepliesIntoFlow": { "type": "boolean" }, "flowIntentMappingOrder": { "type": "string", "enum": [ "joint", "main", "attached" ] }, "useAttachedFlowThresholds": { "type": "boolean" }, "useAttachedFlowContinueAfterDefaultReply": { "type": "boolean" }, "useAttachedFlowPassDefaultRepliesIntoFlow": { "type": "boolean" }, "implicitSlotParsing": { "type": "string", "enum": [ "disabled", "full", "system", "lexicon" ] }, "useAttachedFlowImplicitSlotParsing": { "type": "boolean" }, "lexiconSlotsWithSubMatches": { "type": "boolean" }, "useIntentDefaultRepliesAsExamples": { "description": "Enable/Disable using default replies as training examples.", "type": "boolean" }, "localeSettings": { "type": "object", "properties": { "localeReference": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "inheritFallbackLocaleModel": { "type": "boolean" } } } } } } } }, "responses": { "204": { "description": "Successfully updated the FlowSettings" }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/flow/{flowId}/slotfillers": { "patch": { "operationId": "batchSlotFillers_2_0", "summary": "Batch Operations on SlotFillers", "description": "Batch Operations on SlotFillers.", "tags": [ "SlotFillers v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "flowId", "description": "The Id of the Flow", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "operations": { "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "op": { "type": "string", "enum": [ "delete" ] }, "id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } }, { "type": "object", "properties": { "op": { "type": "string", "enum": [ "create" ] }, "value": { "type": "object", "properties": { "name": { "type": "string" }, "type": { "type": "string", "example": "age", "enum": [ "age", "date", "duration", "email", "intent", "slot", "money", "number", "percentage", "regex", "temperature" ] }, "usePositiveOnly": { "type": "boolean" }, "removeNegated": { "type": "boolean" }, "storeResultInContext": { "type": "boolean" }, "contextKey": { "type": "string" }, "storeInContactProfile": { "type": "boolean" }, "profileKey": { "type": "string" }, "storeDetailedResults": { "type": "boolean" }, "skipIfResultInContext": { "type": "boolean" }, "additionalValidation": { "type": "string" }, "resultLocation": { "type": "string" }, "regex": { "type": "string" }, "slot": { "type": "string" } } } } }, { "type": "object", "properties": { "op": { "type": "string", "enum": [ "update" ] }, "id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "value": { "type": "object", "properties": { "name": { "type": "string" }, "type": { "type": "string", "example": "age", "enum": [ "age", "date", "duration", "email", "intent", "slot", "money", "number", "percentage", "regex", "temperature" ] }, "usePositiveOnly": { "type": "boolean" }, "removeNegated": { "type": "boolean" }, "storeResultInContext": { "type": "boolean" }, "contextKey": { "type": "string" }, "storeInContactProfile": { "type": "boolean" }, "profileKey": { "type": "string" }, "storeDetailedResults": { "type": "boolean" }, "skipIfResultInContext": { "type": "boolean" }, "additionalValidation": { "type": "string" }, "resultLocation": { "type": "string" }, "regex": { "type": "string" }, "slot": { "type": "string" } } } } } ] } } } } } } }, "responses": { "200": { "description": "Successfully ran the batch operations.", "content": { "application/json": { "schema": { "type": "object", "properties": { "created": { "type": "array", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "updated": { "type": "array", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "deleted": { "type": "array", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/flows/{flowId}/slotfillers": { "post": { "operationId": "createSlotFiller_2_0", "summary": "Create a new SlotFiller", "description": "Create a new [SlotFiller](doc:slotfiller) resource in a project.", "tags": [ "SlotFillers v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "flowId", "description": "The Id of the Flow", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string" }, "type": { "type": "string", "example": "age", "enum": [ "age", "date", "duration", "email", "intent", "slot", "money", "number", "percentage", "regex", "temperature" ] }, "usePositiveOnly": { "type": "boolean" }, "removeNegated": { "type": "boolean" }, "storeResultInContext": { "type": "boolean" }, "contextKey": { "type": "string" }, "storeInContactProfile": { "type": "boolean" }, "profileKey": { "type": "string" }, "storeDetailedResults": { "type": "boolean" }, "skipIfResultInContext": { "type": "boolean" }, "additionalValidation": { "type": "string" }, "resultLocation": { "type": "string" }, "regex": { "type": "string" }, "slot": { "type": "string" } } } } } }, "responses": { "201": { "description": "Returns SlotFiller metadata object.", "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string" }, "type": { "type": "string", "example": "age", "enum": [ "age", "date", "duration", "email", "intent", "slot", "money", "number", "percentage", "regex", "temperature" ] }, "usePositiveOnly": { "type": "boolean" }, "removeNegated": { "type": "boolean" }, "storeResultInContext": { "type": "boolean" }, "contextKey": { "type": "string" }, "storeInContactProfile": { "type": "boolean" }, "profileKey": { "type": "string" }, "storeDetailedResults": { "type": "boolean" }, "skipIfResultInContext": { "type": "boolean" }, "additionalValidation": { "type": "string" }, "resultLocation": { "type": "string" }, "regex": { "type": "string" }, "slot": { "type": "string" }, "referenceId": { "type": "string", "format": "uuid" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "get": { "operationId": "indexSlotFillers_2_0", "summary": "Get SlotFillers", "description": "Get 25 SlotFillers in a project by default. To change the default value, use the `limit` query parameter. Additionally, you can filter, sort, and paginate the results.", "tags": [ "SlotFillers v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "flowId", "description": "The Id of the Flow", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "query", "name": "filter", "required": false, "schema": { "type": "string" }, "description": "The name of the SlotFiller to filter the records" }, { "in": "query", "name": "limit", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100 }, "description": "The maximum number of items to return. The default is 25." }, { "in": "query", "name": "skip", "required": false, "schema": { "type": "integer", "minimum": 0 }, "description": "The number of items to skip. The default is 0. Used along with a limit of a pagination." }, { "in": "query", "name": "sort", "required": false, "schema": { "type": "string", "minLength": 1 }, "description": "The order of the sorting items-`Desc` (descending) or `Asc` (ascending). For example, to sort the records by name in ascending order, specify `name:Asc`." }, { "in": "query", "name": "next", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the nextCursor value from the response to get the next set of records. Used along with limit for pagination." }, { "in": "query", "name": "previous", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the previousCursor value from the response to get the previous set of records. Used along with limit for pagination." } ], "responses": { "200": { "description": "Returns array of a SlotFiller metadata objects", "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "name": { "type": "string", "example": "pizza" }, "type": { "type": "string", "example": "age", "enum": [ "age", "date", "duration", "email", "intent", "slot", "money", "number", "percentage", "regex", "temperature" ] }, "referenceId": { "type": "string" }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" } }, "total": { "type": "integer", "example": 1 }, "next": { "oneOf": [ { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, { "nullable": true } ], "example": "5ce7c2d833ea1e04d7e6c432" }, "previous": { "oneOf": [ { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, { "nullable": true } ], "example": null } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/flows/{flowId}/slotfillers/{slotFillerId}": { "delete": { "operationId": "deleteSlotFiller_2_0", "summary": "Delete a SlotFiller", "description": "Delete a [SlotFiller](doc:slotfiller).", "tags": [ "SlotFillers v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "flowId", "description": "The Id of the Flow", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "path", "name": "slotFillerId", "description": "The Id of the SlotFiller", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "204": { "description": "Successfully deleted SlotFiller" }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "get": { "operationId": "readSlotFiller_2_0", "summary": "Get a SlotFiller", "description": "Get a single [SlotFiller](doc:slotfiller) resource in a project.", "tags": [ "SlotFillers v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "flowId", "description": "The Id of the Flow", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "path", "name": "slotFillerId", "description": "The Id of the SlotFiller", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "200": { "description": "Returns SlotFiller Object", "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string" }, "type": { "type": "string", "example": "age", "enum": [ "age", "date", "duration", "email", "intent", "slot", "money", "number", "percentage", "regex", "temperature" ] }, "usePositiveOnly": { "type": "boolean" }, "removeNegated": { "type": "boolean" }, "storeResultInContext": { "type": "boolean" }, "contextKey": { "type": "string" }, "storeInContactProfile": { "type": "boolean" }, "profileKey": { "type": "string" }, "storeDetailedResults": { "type": "boolean" }, "skipIfResultInContext": { "type": "boolean" }, "additionalValidation": { "type": "string" }, "resultLocation": { "type": "string" }, "regex": { "type": "string" }, "slot": { "type": "string" }, "referenceId": { "type": "string", "format": "uuid" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "patch": { "operationId": "updateSlotFiller_2_0", "summary": "Update a Slot Filler", "description": "Update a [SlotFiller](doc:slotfiller).", "tags": [ "SlotFillers v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "flowId", "description": "The Id of the Flow", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "path", "name": "slotFillerId", "description": "The Id of the SlotFiller", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string" }, "type": { "type": "string", "example": "age", "enum": [ "age", "date", "duration", "email", "intent", "slot", "money", "number", "percentage", "regex", "temperature" ] }, "usePositiveOnly": { "type": "boolean" }, "removeNegated": { "type": "boolean" }, "storeResultInContext": { "type": "boolean" }, "contextKey": { "type": "string" }, "storeInContactProfile": { "type": "boolean" }, "profileKey": { "type": "string" }, "storeDetailedResults": { "type": "boolean" }, "skipIfResultInContext": { "type": "boolean" }, "additionalValidation": { "type": "string" }, "resultLocation": { "type": "string" }, "regex": { "type": "string" }, "slot": { "type": "string" } } } } } }, "responses": { "204": { "description": "Successfully updated SlotFiller" }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/flows/{flowId}/states/{stateId}/addintent": { "post": { "operationId": "addIntentToFlowState_2_0", "summary": "Adds an Intent to a State", "description": "Adds an Intent to a [State](doc:state).", "tags": [ "FlowStates v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "flowId", "description": "The Id of the Flow", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "path", "name": "stateId", "description": "The Id of the State", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "intentId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } } } }, "responses": { "204": { "description": "Successfully added Intent to the State" }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/flow/{flowId}/states": { "patch": { "operationId": "batchFlowStates_2_0", "summary": "Batch Operations on FlowStates", "description": "Batch Operations on FlowStates.", "tags": [ "FlowStates v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "flowId", "description": "The Id of the Flow", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "operations": { "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "op": { "type": "string", "enum": [ "delete" ] }, "id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } }, { "type": "object", "properties": { "op": { "type": "string", "enum": [ "create" ] }, "value": { "type": "object", "properties": { "name": { "type": "string", "example": "default" }, "isDefault": { "type": "boolean" }, "type": { "type": "string", "enum": [ "blacklist", "whitelist" ], "example": "blacklist" }, "intentIds": { "type": "array", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } } } }, { "type": "object", "properties": { "op": { "type": "string", "enum": [ "update" ] }, "id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "value": { "type": "object", "properties": { "name": { "type": "string", "example": "default" }, "isDefault": { "type": "boolean" }, "type": { "type": "string", "enum": [ "blacklist", "whitelist" ], "example": "blacklist" }, "intentIds": { "type": "array", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } } } } ] } } } } } } }, "responses": { "200": { "description": "Successfully ran the batch operations.", "content": { "application/json": { "schema": { "type": "object", "properties": { "created": { "type": "array", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "updated": { "type": "array", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "deleted": { "type": "array", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/flows/{flowId}/states": { "post": { "operationId": "createFlowState_2_0", "summary": "Create a new State", "description": "Create a new [State](doc:state) State in a Flow.", "tags": [ "FlowStates v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "flowId", "description": "The Id of the Flow", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "example": "default" }, "isDefault": { "type": "boolean" }, "type": { "type": "string", "enum": [ "blacklist", "whitelist" ], "example": "blacklist" }, "intentIds": { "type": "array", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } } } } }, "responses": { "201": { "description": "Returns State metadata object.", "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "example": "default" }, "isDefault": { "type": "boolean" }, "type": { "type": "string", "enum": [ "blacklist", "whitelist" ], "example": "blacklist" }, "intentIds": { "type": "array", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "referenceId": { "type": "string", "format": "uuid" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "get": { "operationId": "indexFlowStates_2_0", "summary": "Get States", "description": "Get 25 States of a Flow by default. To change the default value, use the `limit` query parameter. Additionally, you can filter, sort, and paginate the results.", "tags": [ "FlowStates v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "flowId", "description": "The Id of the Flow", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "query", "name": "filter", "required": false, "schema": { "type": "string" }, "description": "The name of the funtion to filter the records" }, { "in": "query", "name": "limit", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100 }, "description": "The maximum number of items to return. The default is 25." }, { "in": "query", "name": "skip", "required": false, "schema": { "type": "integer", "minimum": 0 }, "description": "The number of items to skip. The default is 0. Used along with a limit of a pagination." }, { "in": "query", "name": "sort", "required": false, "schema": { "type": "string", "minLength": 1 }, "description": "The order of the sorting items-`Desc` (descending) or `Asc` (ascending). For example, to sort the records by name in ascending order, specify `name:Asc`." }, { "in": "query", "name": "next", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the nextCursor value from the response to get the next set of records. Used along with limit for pagination." }, { "in": "query", "name": "previous", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the previousCursor value from the response to get the previous set of records. Used along with limit for pagination." } ], "responses": { "200": { "description": "Returns array of States", "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string", "example": "default" }, "referenceId": { "type": "string", "format": "uuid" }, "isDefault": { "type": "boolean" }, "type": { "type": "string", "enum": [ "blacklist", "whitelist" ], "example": "blacklist" }, "intentIds": { "type": "array", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" } }, "total": { "type": "integer", "example": 1 }, "next": { "oneOf": [ { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, { "nullable": true } ], "example": "5ce7c2d833ea1e04d7e6c432" }, "previous": { "oneOf": [ { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, { "nullable": true } ], "example": null } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/flows/{flowId}/states/{stateId}": { "delete": { "operationId": "deleteFlowState_2_0", "summary": "Delete a State", "description": "Delete a [State](doc:state).", "tags": [ "FlowStates v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "flowId", "description": "The Id of the Flow", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "path", "name": "stateId", "description": "The Id of the State", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "204": { "description": "Successfully deleted the State" }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "get": { "operationId": "readFlowState_2_0", "summary": "Get a State", "description": "Get a single [State](doc:state) of the specified Flow.", "tags": [ "FlowStates v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "flowId", "description": "The Id of the Flow", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "path", "name": "stateId", "description": "The Id of the State", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "200": { "description": "Returns State Object", "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "example": "default" }, "isDefault": { "type": "boolean" }, "type": { "type": "string", "enum": [ "blacklist", "whitelist" ], "example": "blacklist" }, "intentIds": { "type": "array", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "referenceId": { "type": "string", "format": "uuid" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "patch": { "operationId": "updateFlowState", "summary": "Update an State", "description": "Update an [State](doc:state) in a Flow.", "tags": [ "FlowStates v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "flowId", "description": "The Id of the Flow", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "path", "name": "stateId", "description": "The Id of the State", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "example": "default" }, "isDefault": { "type": "boolean" }, "type": { "type": "string", "enum": [ "blacklist", "whitelist" ], "example": "blacklist" }, "intentIds": { "type": "array", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } } } } }, "responses": { "204": { "description": "Successfully updated State" }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/flows/{flowId}/states/{stateId}/removeintent": { "post": { "operationId": "removeIntentFromFlowState_2_0", "summary": "Removes an Intent for a State", "description": "Removes an Intent for a [State](doc:intent).", "tags": [ "FlowStates v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "flowId", "description": "The Id of the Flow", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "path", "name": "stateId", "description": "The Id of the State", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "intentId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } } } }, "responses": { "204": { "description": "Successfully removed Intent from the State" }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/functions": { "post": { "operationId": "createFunction_2_0", "summary": "Create a new Function", "description": "Create a new [Function](doc:function) resource in a project.", "tags": [ "Functions v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string" }, "code": { "type": "string" }, "isDisabled": { "type": "boolean" }, "projectId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } } } }, "responses": { "201": { "description": "Returns Function metadata object.", "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string" }, "code": { "type": "string" }, "isDisabled": { "type": "boolean" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "get": { "operationId": "indexFunctions_2_0", "summary": "Get Functions", "description": "Get 25 [Functions](https://docs.cognigy.com/ai/resources/build/functions/) in a project by default. To change the default value, use the `limit` query parameter. Additionally, you can filter, sort, and paginate the results.", "tags": [ "Functions v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "query", "name": "projectId", "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "query", "name": "filter", "required": false, "schema": { "type": "string" }, "description": "The name of the funtion to filter the records" }, { "in": "query", "name": "limit", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100 }, "description": "The maximum number of items to return. The default is 25." }, { "in": "query", "name": "skip", "required": false, "schema": { "type": "integer", "minimum": 0 }, "description": "The number of items to skip. The default is 0. Used along with a limit of a pagination." }, { "in": "query", "name": "sort", "required": false, "schema": { "type": "string", "minLength": 1 }, "description": "The order of the sorting items-`Desc` (descending) or `Asc` (ascending). For example, to sort the records by name in ascending order, specify `name:Asc`." }, { "in": "query", "name": "next", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the nextCursor value from the response to get the next set of records. Used along with limit for pagination." }, { "in": "query", "name": "previous", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the previousCursor value from the response to get the previous set of records. Used along with limit for pagination." } ], "responses": { "200": { "description": "Returns array of a Function metadata objects", "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the function", "example": "New Function" }, "code": { "type": "string", "description": "The code of the function", "example": "console.log('Hello World');" }, "referenceId": { "type": "string", "format": "uuid" }, "isDisabled": { "type": "boolean" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" } }, "total": { "type": "integer", "example": 1 }, "next": { "oneOf": [ { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, { "nullable": true } ], "example": "5ce7c2d833ea1e04d7e6c432" }, "previous": { "oneOf": [ { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, { "nullable": true } ], "example": null } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/functions/{functionId}": { "delete": { "operationId": "deleteFunction_2_0", "summary": "Delete a Function", "description": "Delete a [Function](doc:function).", "tags": [ "Functions v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "functionId", "description": "The Id of the Function", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "202": { "description": "Successfully kicked-off the delete function operation" }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "get": { "operationId": "readFunction_2_0", "summary": "Get a Function", "description": "Get a single [Function](doc:function) resource in a project.", "tags": [ "Functions v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "functionId", "description": "The Id of the Function", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "200": { "description": "Returns Function Object", "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string" }, "code": { "type": "string" }, "isDisabled": { "type": "boolean" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "patch": { "operationId": "updateFunction", "summary": "Update a Function", "description": "Update a [Function](doc:function) resource in a project.", "tags": [ "Functions v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "functionId", "description": "The Id of the Function", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string" }, "code": { "type": "string" }, "isDisabled": { "type": "boolean" } } } } } }, "responses": { "200": { "description": "Successfully updated Function" }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/functions/{functionId}/instances": { "get": { "operationId": "indexFunctionInstances_2_0", "summary": "Get Function Instances.", "description": "Get 25 [Function Instances](https://docs.cognigy.com/ai/resources/build/functions/) in a project by default. To change the default value, use the `limit` query parameter. Additionally, you can filter, sort, and paginate the results.", "tags": [ "Functions v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "functionId", "description": "The Id of the Function", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "query", "name": "projectId", "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "query", "name": "limit", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100 }, "description": "The maximum number of items to return. The default is 25." }, { "in": "query", "name": "skip", "required": false, "schema": { "type": "integer", "minimum": 0 }, "description": "The number of items to skip. The default is 0. Used along with a limit of a pagination." }, { "in": "query", "name": "sort", "required": false, "schema": { "type": "string", "minLength": 1 }, "description": "The order of the sorting items-`Desc` (descending) or `Asc` (ascending). For example, to sort the records by name in ascending order, specify `name:Asc`." }, { "in": "query", "name": "next", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the nextCursor value from the response to get the next set of records. Used along with limit for pagination." }, { "in": "query", "name": "previous", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the previousCursor value from the response to get the previous set of records. Used along with limit for pagination." } ], "responses": { "200": { "description": "Returns an array of Function Instance metadata objects", "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "trigger": { "type": "string", "enum": [ "flow", "manual" ], "description": "How was this function instance triggered, e.g. was it spawned while executing a Flow?", "example": "flow" }, "status": { "type": "string", "enum": [ "queued", "active", "done", "error" ], "description": "The current state of the instance. New instances are in the 'queued' state, while running ones are in 'active' state.", "example": "active" }, "error": { "type": "string" }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "finishedAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 } } } }, "total": { "type": "integer", "example": 1 }, "next": { "oneOf": [ { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, { "nullable": true } ], "example": "5ce7c2d833ea1e04d7e6c432" }, "previous": { "oneOf": [ { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, { "nullable": true } ], "example": null } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/functions/{functionId}/instances/{functionInstanceId}": { "get": { "operationId": "readFunctionInstance_2_0", "summary": "Get a Function Instance", "description": "Get a single [Function Instance](doc:functionInstance) resource in a project.", "tags": [ "Functions v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "functionId", "description": "The Id of the Function", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "path", "name": "functionInstanceId", "description": "The Id of the Function Instance", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "200": { "description": "Returns a Function Instance object", "content": { "application/json": { "schema": { "type": "object", "properties": { "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "functionReference": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "trigger": { "type": "string", "enum": [ "flow", "manual" ], "description": "How was this function instance triggered, e.g. was it spawned while executing a Flow?", "example": "flow" }, "status": { "type": "string", "enum": [ "queued", "active", "done", "error" ], "description": "The current state of the instance. New instances are in the 'queued' state, while running ones are in 'active' state.", "example": "active" }, "error": { "type": "string" }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "finishedAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/functions/{functionId}/instances/{functionInstanceId}/stop": { "post": { "operationId": "stopFunctionInstance_2_0", "summary": "Stops a single function instance.", "description": "Dispatches a stop operation on a single function instance.", "tags": [ "Functions v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "functionId", "description": "The Id of the Function", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "path", "name": "functionInstanceId", "description": "The Id of the Function Instance", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "202": { "description": "The stop operation was accepted." }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/functions/{functionId}/trigger": { "post": { "operationId": "triggerFunction_2_0", "summary": "Starts a new instance for a function.", "description": "Contacts the function scheduler in order to schedule a new instance of a function.", "tags": [ "Functions v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "functionId", "description": "The Id of the Function", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "202": { "description": "Object with the function instances id.", "content": { "application/json": { "schema": { "type": "object", "properties": { "functionInstanceId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/knowledgestores": { "post": { "operationId": "createKnowledgeStore_2_0", "summary": "Creates a new KnowledgeStore", "description": "Creates a new [KnowledgeStore](doc:KnowledgeStore) resource in a project.", "tags": [ "KnowledgeStores" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "example": "mystore", "description": "The name of the KnowledgeStore" }, "description": { "type": "string", "example": "mystore description", "description": "The description about what the knowledge store contains" }, "projectId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } } } }, "responses": { "201": { "description": "Returns KnowledgeStore metadata object.", "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "example": "mystore", "description": "The name of the KnowledgeStore" }, "description": { "type": "string", "example": "mystore description", "description": "The description about what the knowledge store contains" }, "language": { "type": "string", "example": "en-US", "description": "The language code" }, "status": { "type": "string", "enum": [ "ready", "warning" ] }, "documents": { "type": "array", "items": { "type": "string", "example": "https://some-website.com/knowledgebase.txt", "description": "The document url or the file name ingested for the knowledge store" } }, "referenceId": { "type": "string", "format": "uuid" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "get": { "operationId": "indexKnowledgeStores_2_0", "summary": "Get KnowledgeStores", "description": "Get 25 [KnowledgeStores](https://docs.cognigy.com/ai/resources/build/KnowledgeStores/) in a project by default. To change the default value, use the `limit` query parameter. Additionally, you can filter, sort, and paginate the results.", "tags": [ "KnowledgeStores" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "query", "name": "projectId", "description": "Filter by projectId", "required": false, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "query", "name": "filter", "required": false, "schema": { "type": "string" }, "description": "The name of the knowledge store to filter the records" }, { "in": "query", "name": "limit", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100 }, "description": "The maximum number of items to return. The default is 25." }, { "in": "query", "name": "skip", "required": false, "schema": { "type": "integer", "minimum": 0 }, "description": "The number of items to skip. The default is 0. Used along with a limit of a pagination." }, { "in": "query", "name": "sort", "required": false, "schema": { "type": "string", "minLength": 1 }, "description": "The order of the sorting items-`Desc` (descending) or `Asc` (ascending). For example, to sort the records by name in ascending order, specify `name:Asc`." }, { "in": "query", "name": "next", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the nextCursor value from the response to get the next set of records. Used along with limit for pagination." }, { "in": "query", "name": "previous", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the previousCursor value from the response to get the previous set of records. Used along with limit for pagination." } ], "responses": { "200": { "description": "Returns array of a KnowledgeStore metadata objects", "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string", "example": "mystore", "description": "The name of the KnowledgeStore" }, "description": { "type": "string", "example": "mystore description", "description": "The description about what the knowledge store contains" }, "language": { "type": "string", "example": "en-US", "description": "The language code" }, "status": { "type": "string", "enum": [ "ready", "warning" ] }, "documents": { "type": "array", "items": { "type": "string", "example": "https://some-website.com/knowledgebase.txt", "description": "The document url or the file name ingested for the knowledge store" } }, "referenceId": { "type": "string", "format": "uuid" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" } }, "total": { "type": "integer", "example": 1 }, "next": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "previous": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/knowledgestores/{knowledgeStoreId}": { "delete": { "operationId": "deleteKnowledgeStore_2_0", "summary": "Delete a KnowledgeStore", "description": "Delete a [KnowledgeStore](doc:KnowledgeStore).", "tags": [ "KnowledgeStores" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "knowledgeStoreId", "description": "The Id of the KnowledgeStore", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "query", "name": "documentUrl", "required": false, "schema": { "type": "string" } } ], "responses": { "204": { "description": "Successfully deleted KnowledgeStore" }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "get": { "operationId": "readKnowledgeStore_2_0", "summary": "Get a KnowledgeStore", "description": "Get a single [KnowledgeStore](doc:KnowledgeStore) resource in a project.", "tags": [ "KnowledgeStores" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "knowledgeStoreId", "description": "The Id of the KnowledgeStore", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "200": { "description": "Returns KnowledgeStore object", "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "example": "mystore", "description": "The name of the KnowledgeStore" }, "description": { "type": "string", "example": "mystore description", "description": "The description about what the knowledge store contains" }, "language": { "type": "string", "example": "en-US", "description": "The language code" }, "status": { "type": "string", "enum": [ "ready", "warning" ] }, "documents": { "type": "array", "items": { "type": "string", "example": "https://some-website.com/knowledgebase.txt", "description": "The document url or the file name ingested for the knowledge store" } }, "referenceId": { "type": "string", "format": "uuid" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "patch": { "operationId": "updateKnowledgeStore_2_0", "summary": "Updates a KnowledgeStore", "description": "Updates a [KnowledgeStore](doc:KnowledgeStore) resource in a project.", "tags": [ "KnowledgeStores" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "knowledgeStoreId", "description": "The Id of the KnowledgeStore", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "example": "mystore", "description": "The name of the KnowledgeStore" }, "description": { "type": "string", "example": "mystore description", "description": "The description about what the knowledge store contains" } } } } } }, "responses": { "204": { "description": "Successfully updated knowledge store" }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/knowledgestores/{knowledgeStoreId}/sources/{sourceId}/chunks": { "post": { "operationId": "createKnowledgeChunk_2_0", "summary": "Creates a new KnowledgeChunk", "description": "Creates a new [KnowledgeChunk](doc:KnowledgeChunk) resource in a project.", "tags": [ "KnowledgeChunks" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "knowledgeStoreId", "description": "The Id of the KnowledgeStore", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "path", "name": "sourceId", "description": "The Id of the KnowledgeSource", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "order": { "type": "number", "example": 1, "description": "The name of the KnowledgeChunk" }, "text": { "type": "string", "example": "This is a paragraph from an article", "description": "The text that is the actual content of the chunk" }, "data": { "type": "object", "description": "The extended data of KnowledgeChunk" } } } } } }, "responses": { "201": { "description": "Returns KnowledgeChunk metadata object.", "content": { "application/json": { "schema": { "type": "object", "properties": { "order": { "type": "number", "example": 1, "description": "The name of the KnowledgeChunk" }, "text": { "type": "string", "example": "This is a paragraph from an article", "description": "The text that is the actual content of the chunk" }, "data": { "type": "object", "description": "The extended data of KnowledgeChunk" }, "disabled": { "type": "boolean", "enum": [ false, true ], "description": "The status to check if knowledge chunk is disabled" }, "referenceId": { "type": "string", "format": "uuid" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "get": { "operationId": "indexKnowledgeChunks_2_0", "summary": "Get KnowledgeChunks", "description": "Get 25 [KnowledgeChunks](https://docs.cognigy.com/ai/resources/build/KnowledgeStores/) in a project by default. To change the default value, use the `limit` query parameter. Additionally, you can filter, sort, and paginate the results.", "tags": [ "KnowledgeChunks" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "knowledgeStoreId", "description": "The Id of the KnowledgeStore", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "path", "name": "sourceId", "description": "The Id of the KnowledgeSource", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "query", "name": "filter", "required": false, "schema": { "type": "string" }, "description": "The text of the knowledge chunk to filter the records" }, { "in": "query", "name": "limit", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100 }, "description": "The maximum number of items to return. The default is 25." }, { "in": "query", "name": "skip", "required": false, "schema": { "type": "integer", "minimum": 0 }, "description": "The number of items to skip. The default is 0. Used along with a limit of a pagination." }, { "in": "query", "name": "sort", "required": false, "schema": { "type": "string", "minLength": 1 }, "description": "The order of the sorting items-`Desc` (descending) or `Asc` (ascending). For example, to sort the records by name in ascending order, specify `name:Asc`." }, { "in": "query", "name": "next", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the nextCursor value from the response to get the next set of records. Used along with limit for pagination." }, { "in": "query", "name": "previous", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the previousCursor value from the response to get the previous set of records. Used along with limit for pagination." } ], "responses": { "200": { "description": "Returns array of a KnowledgeChunk metadata objects", "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "order": { "type": "number", "example": 1, "description": "The name of the KnowledgeChunk" }, "text": { "type": "string", "example": "This is a paragraph from an article", "description": "The text that is the actual content of the chunk" }, "data": { "type": "object", "description": "The extended data of KnowledgeChunk" }, "disabled": { "type": "boolean", "enum": [ false, true ], "description": "The status to check if knowledge chunk is disabled" }, "referenceId": { "type": "string", "format": "uuid" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" } }, "total": { "type": "integer", "example": 1 }, "next": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "previous": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/knowledgestores/{knowledgeStoreId}/sources/{sourceId}/chunks/{chunkId}": { "delete": { "operationId": "deleteKnowledgeChunk_2_0", "summary": "Delete a KnowledgeChunk", "description": "Delete a [KnowledgeChunk](doc:KnowledgeChunk).", "tags": [ "KnowledgeChunks" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "knowledgeStoreId", "description": "The Id of the KnowledgeStore", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "path", "name": "sourceId", "description": "The Id of the KnowledgeSource", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "path", "name": "chunkId", "description": "The Id of the KnowledgeChunk", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "204": { "description": "Successfully deleted KnowledgeChunk" }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "get": { "operationId": "readKnowledgeChunk_2_0", "summary": "Get a KnowledgeChunk", "description": "Get a single [KnowledgeChunk](doc:KnowledgeChunk) resource in a project.", "tags": [ "KnowledgeChunks" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "knowledgeStoreId", "description": "The Id of the KnowledgeStore", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "path", "name": "sourceId", "description": "The Id of the KnowledgeSource", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "path", "name": "chunkId", "description": "The Id of the KnowledgeChunk", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "200": { "description": "Returns KnowledgeChunk object", "content": { "application/json": { "schema": { "type": "object", "properties": { "order": { "type": "number", "example": 1, "description": "The name of the KnowledgeChunk" }, "text": { "type": "string", "example": "This is a paragraph from an article", "description": "The text that is the actual content of the chunk" }, "data": { "type": "object", "description": "The extended data of KnowledgeChunk" }, "disabled": { "type": "boolean", "enum": [ false, true ], "description": "The status to check if knowledge chunk is disabled" }, "referenceId": { "type": "string", "format": "uuid" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "patch": { "operationId": "updateKnowledgeChunk_2_0", "summary": "Updates a KnowledgeChunk", "description": "Updates a [KnowledgeChunk](doc:KnowledgeChunk) resource in a project.", "tags": [ "KnowledgeChunks" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "knowledgeStoreId", "description": "The Id of the KnowledgeStore", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "path", "name": "sourceId", "description": "The Id of the KnowledgeSource", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "path", "name": "chunkId", "description": "The Id of the KnowledgeChunk", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "order": { "type": "number", "example": 1, "description": "The name of the KnowledgeChunk" }, "text": { "type": "string", "example": "This is a paragraph from an article", "description": "The text that is the actual content of the chunk" }, "data": { "type": "object", "description": "The extended data of KnowledgeChunk" }, "disabled": { "type": "boolean", "enum": [ false, true ], "description": "The status to check if knowledge chunk is disabled" } } } } } }, "responses": { "204": { "description": "Successfully updated knowledge source" }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/knowledgestores/{knowledgeStoreId}/sources": { "post": { "operationId": "createKnowledgeSource_2_0", "summary": "Creates a new KnowledgeSource", "description": "Creates a new [KnowledgeSource](doc:KnowledgeSource) resource in a project.", "tags": [ "KnowledgeSources" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "knowledgeStoreId", "description": "The Id of the KnowledgeStore", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "example": "mysource", "description": "The name of the KnowledgeSource" }, "description": { "type": "string", "example": "mysource description", "description": "The description about what the knowledge source contains" }, "type": { "type": "string", "enum": [ "url", "manual", "pdf", "txt", "ctxt" ], "description": "The type of source for the Knowledge store" }, "metaData": { "type": "object", "properties": { "tags": { "type": "array", "items": { "type": "string", "example": "tag1" } } } }, "url": { "type": "string", "example": "https://www.some-article.com", "description": "The url of the website to scrape the data from. This is only applicable for KnowledgeSources of type \"url\"" } } } } } }, "responses": { "201": { "description": "Returns KnowledgeSource metadata object.", "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "example": "mysource", "description": "The name of the KnowledgeSource" }, "description": { "type": "string", "example": "mysource description", "description": "The description about what the knowledge source contains" }, "type": { "type": "string", "enum": [ "url", "manual", "pdf", "txt", "ctxt" ], "description": "The type of source for the Knowledge store" }, "metaData": { "type": "object", "properties": { "tags": { "type": "array", "items": { "type": "string", "example": "tag1" } } } }, "chunkCount": { "type": "integer" }, "status": { "type": "string", "enum": [ "ready", "ingesting", "disabled" ] }, "referenceId": { "type": "string", "format": "uuid" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "get": { "operationId": "indexKnowledgeSources_2_0", "summary": "Get KnowledgeSources", "description": "Get 25 [KnowledgeSources](https://docs.cognigy.com/ai/resources/build/KnowledgeSources/) in a project by default. To change the default value, use the `limit` query parameter. Additionally, you can filter, sort, and paginate the results.", "tags": [ "KnowledgeSources" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "knowledgeStoreId", "description": "The Id of the KnowledgeStore", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "query", "name": "filter", "required": false, "schema": { "type": "string" }, "description": "The name of the knowledge source to filter the records" }, { "in": "query", "name": "limit", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100 }, "description": "The maximum number of items to return. The default is 25." }, { "in": "query", "name": "skip", "required": false, "schema": { "type": "integer", "minimum": 0 }, "description": "The number of items to skip. The default is 0. Used along with a limit of a pagination." }, { "in": "query", "name": "sort", "required": false, "schema": { "type": "string", "minLength": 1 }, "description": "The order of the sorting items-`Desc` (descending) or `Asc` (ascending). For example, to sort the records by name in ascending order, specify `name:Asc`." }, { "in": "query", "name": "next", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the nextCursor value from the response to get the next set of records. Used along with limit for pagination." }, { "in": "query", "name": "previous", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the previousCursor value from the response to get the previous set of records. Used along with limit for pagination." } ], "responses": { "200": { "description": "Returns array of a KnowledgeSource metadata objects", "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string", "example": "mysource", "description": "The name of the KnowledgeSource" }, "description": { "type": "string", "example": "mysource description", "description": "The description about what the knowledge source contains" }, "type": { "type": "string", "enum": [ "url", "manual", "pdf", "txt", "ctxt" ], "description": "The type of source for the Knowledge store" }, "metaData": { "type": "object", "properties": { "tags": { "type": "array", "items": { "type": "string", "example": "tag1" } } } }, "chunkCount": { "type": "integer" }, "status": { "type": "string", "enum": [ "ready", "ingesting", "disabled" ] }, "referenceId": { "type": "string", "format": "uuid" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" } }, "total": { "type": "integer", "example": 1 }, "next": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "previous": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/knowledgestores/{knowledgeStoreId}/sources/{sourceId}": { "delete": { "operationId": "deleteKnowledgeSource_2_0", "summary": "Delete a KnowledgeSource", "description": "Delete a [KnowledgeSource](doc:KnowledgeSource).", "tags": [ "KnowledgeSources" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "knowledgeStoreId", "description": "The Id of the KnowledgeStore", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "path", "name": "sourceId", "description": "The Id of the KnowledgeSource", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "204": { "description": "Successfully deleted KnowledgeSource" }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "get": { "operationId": "readKnowledgeSource_2_0", "summary": "Get a KnowledgeSource", "description": "Get a single [KnowledgeSource](doc:KnowledgeSource) resource in a project.", "tags": [ "KnowledgeSources" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "knowledgeStoreId", "description": "The Id of the KnowledgeStore", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "path", "name": "sourceId", "description": "The Id of the KnowledgeSource", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "200": { "description": "Returns KnowledgeSource object", "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "example": "mysource", "description": "The name of the KnowledgeSource" }, "description": { "type": "string", "example": "mysource description", "description": "The description about what the knowledge source contains" }, "type": { "type": "string", "enum": [ "url", "manual", "pdf", "txt", "ctxt" ], "description": "The type of source for the Knowledge store" }, "metaData": { "type": "object", "properties": { "tags": { "type": "array", "items": { "type": "string", "example": "tag1" } } } }, "chunkCount": { "type": "integer" }, "status": { "type": "string", "enum": [ "ready", "ingesting", "disabled" ] }, "referenceId": { "type": "string", "format": "uuid" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "patch": { "operationId": "updateKnowledgeSource_2_0", "summary": "Updates a KnowledgeSource", "description": "Updates a [KnowledgeSource](doc:KnowledgeSource) resource in a project.", "tags": [ "KnowledgeSources" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "knowledgeStoreId", "description": "The Id of the KnowledgeStore", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "path", "name": "sourceId", "description": "The Id of the KnowledgeSource", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "example": "mysource", "description": "The name of the KnowledgeSource" }, "description": { "type": "string", "example": "mysource description", "description": "The description about what the knowledge source contains" }, "status": { "type": "string", "enum": [ "ready", "ingesting", "disabled" ] } } } } } }, "responses": { "204": { "description": "Successfully updated knowledge source" }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/knowledgestores/{knowledgeStoreId}/sources/upload": { "post": { "operationId": "uploadKnowledgeSourceFile_2_0", "summary": "Upload a file to create a new KnowledgeSource", "description": "Upload a file to create [KnowledgeSource](doc:KnowledgeSource) resource in a project of type \"pdf | txt | ctxt\"", "tags": [ "KnowledgeSources" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "knowledgeStoreId", "description": "The Id of the KnowledgeStore", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "requestBody": { "required": true, "content": { "multipart/form-data": { "schema": { "type": "object", "properties": { "tags": { "type": "string", "description": "A comma separated list of tags for the KnowledgeSource" }, "file": { "type": "string", "format": "binary" } } } } } }, "responses": { "202": { "description": "Successfully uploaded the file and created a Task to process it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "status": { "type": "string", "description": "The status of the task", "example": "queued", "enum": [ "queued", "active", "done", "cancelling", "cancelled", "error" ] }, "type": { "type": "string", "example": "trainIntents" }, "parameters": { "type": "object" }, "lastChangedAt": { "type": "number", "example": 1594243850 }, "lastCreatedAt": { "type": "number", "example": 1594243850 }, "currentStep": { "type": "integer", "example": 0 }, "totalStep": { "type": "integer", "example": 100 } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/largelanguagemodels/{largeLanguageModelId}/clone": { "post": { "operationId": "cloneLargeLanguageModel_2_0", "summary": "Clone an existing LargeLanguageModel", "description": "Clone a [LargeLanguageModel](doc:largeLanguageModel) in a project.", "tags": [ "LargeLanguageModels v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "largeLanguageModelId", "description": "Id for the LargeLangugeModel", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "200": { "description": "Returns the cloned largeLanguageModel object.", "content": { "application/json": { "schema": { "type": "object", "required": [ "name", "modelType", "provider", "connectionId" ], "properties": { "name": { "type": "string", "example": "LLM Name" }, "description": { "type": "string", "example": "LLM meaningful description" }, "modelType": { "type": "string", "enum": [ "gpt-3.5-turbo", "gpt-3.5-turbo-instruct", "text-davinci-003", "gpt-4", "text-embedding-ada-002", "luminous-extended-control", "luminous-embedding-128", "claude-v1-100k", "claude-instant-v1", "claude-3-opus-20240229", "text-bison@001", "custom-model", "gemini-1.0-pro" ] }, "modelGroup": { "type": "string", "enum": [ "chat", "completion" ] }, "isCustomModel": { "type": "boolean", "example": true }, "provider": { "type": "string", "enum": [ "azureOpenAI", "openAI", "anthropic", "googleVertexAI", "googleGemini", "alephAlpha" ] }, "connectionId": { "type": "string", "description": "The reference id of the GenerativeAI Provider Connection", "format": "uuid" }, "isDefault": { "type": "boolean", "description": "Sets the LLM to default (fallback) if no other LLM is set", "example": false }, "openAI": { "type": "object", "description": "OpenAI specific meta data", "properties": { "customModel": { "type": "string", "example": "gpt-4-32k-0613", "description": "The custom model name. This does not work with embedding models" } } }, "anthropic": { "type": "object", "description": "Anthropic specific meta data", "properties": { "customModel": { "type": "string", "example": "claude-3-opus-20240229", "description": "The custom model name. This does not work with embedding models" } } }, "azureOpenAI": { "type": "object", "description": "Azure OpenAI specific meta data", "properties": { "resourceName": { "type": "string" }, "deploymentName": { "type": "string" }, "apiVersion": { "type": "string" }, "baseCustomUrl": { "type": "string", "example": [ "https://.openai.azure.com/openai/deployments//chat/completions?api-version=", "https://.openai.azure.com/openai/deployments//completions?api-version=", "https://.openai.azure.com/openai/deployments//embeddings?api-version=" ] } } }, "googleVertexAI": { "type": "object", "description": "Google VertexAI specific meta data", "properties": { "location": { "type": "string" }, "apiEndpoint": { "type": "string" }, "publisher": { "type": "string" } } }, "googleGemini": { "type": "object", "description": "Google Gemini specific meta data", "properties": { "location": { "type": "string" } } }, "alephAlpha": { "type": "object", "description": "Aleph Alpha specific meta data", "properties": { "customModel": { "type": "string", "example": "luminous-003", "description": "The custom model name. This does not work with embedding models" }, "baseCustomUrl": { "type": "string", "example": "https://api.aleph-alpha.com" } } }, "referenceId": { "type": "string", "description": "The reference id of the LargeLanguageModel", "format": "uuid" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/largelanguagemodels": { "post": { "operationId": "createLargeLanguageModel_2_0", "summary": "Creates a new LargeLanguageModel", "description": "Creates a new [LargeLanguageModel](doc:largeLanguageModel) resource in a project.", "tags": [ "LargeLanguageModels v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "name", "modelType", "provider", "connectionId" ], "properties": { "name": { "type": "string", "example": "LLM Name" }, "description": { "type": "string", "example": "LLM meaningful description" }, "modelType": { "type": "string", "enum": [ "gpt-3.5-turbo", "gpt-3.5-turbo-instruct", "text-davinci-003", "gpt-4", "text-embedding-ada-002", "luminous-extended-control", "luminous-embedding-128", "claude-v1-100k", "claude-instant-v1", "claude-3-opus-20240229", "text-bison@001", "custom-model", "gemini-1.0-pro" ] }, "modelGroup": { "type": "string", "enum": [ "chat", "completion" ] }, "isCustomModel": { "type": "boolean", "example": true }, "provider": { "type": "string", "enum": [ "azureOpenAI", "openAI", "anthropic", "googleVertexAI", "googleGemini", "alephAlpha" ] }, "connectionId": { "type": "string", "description": "The reference id of the GenerativeAI Provider Connection", "format": "uuid" }, "isDefault": { "type": "boolean", "description": "Sets the LLM to default (fallback) if no other LLM is set", "example": false }, "openAI": { "type": "object", "description": "OpenAI specific meta data", "properties": { "customModel": { "type": "string", "example": "gpt-4-32k-0613", "description": "The custom model name. This does not work with embedding models" } } }, "anthropic": { "type": "object", "description": "Anthropic specific meta data", "properties": { "customModel": { "type": "string", "example": "claude-3-opus-20240229", "description": "The custom model name. This does not work with embedding models" } } }, "azureOpenAI": { "type": "object", "description": "Azure OpenAI specific meta data", "properties": { "resourceName": { "type": "string" }, "deploymentName": { "type": "string" }, "apiVersion": { "type": "string" }, "baseCustomUrl": { "type": "string", "example": [ "https://.openai.azure.com/openai/deployments//chat/completions?api-version=", "https://.openai.azure.com/openai/deployments//completions?api-version=", "https://.openai.azure.com/openai/deployments//embeddings?api-version=" ] } } }, "googleVertexAI": { "type": "object", "description": "Google VertexAI specific meta data", "properties": { "location": { "type": "string" }, "apiEndpoint": { "type": "string" }, "publisher": { "type": "string" } } }, "googleGemini": { "type": "object", "description": "Google Gemini specific meta data", "properties": { "location": { "type": "string" } } }, "alephAlpha": { "type": "object", "description": "Aleph Alpha specific meta data", "properties": { "customModel": { "type": "string", "example": "luminous-003", "description": "The custom model name. This does not work with embedding models" }, "baseCustomUrl": { "type": "string", "example": "https://api.aleph-alpha.com" } } }, "projectId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } } } }, "responses": { "201": { "description": "Returns LargeLanguageModel metadata object.", "content": { "application/json": { "schema": { "type": "object", "required": [ "name", "modelType", "provider", "connectionId" ], "properties": { "name": { "type": "string", "example": "LLM Name" }, "description": { "type": "string", "example": "LLM meaningful description" }, "modelType": { "type": "string", "enum": [ "gpt-3.5-turbo", "gpt-3.5-turbo-instruct", "text-davinci-003", "gpt-4", "text-embedding-ada-002", "luminous-extended-control", "luminous-embedding-128", "claude-v1-100k", "claude-instant-v1", "claude-3-opus-20240229", "text-bison@001", "custom-model", "gemini-1.0-pro" ] }, "modelGroup": { "type": "string", "enum": [ "chat", "completion" ] }, "isCustomModel": { "type": "boolean", "example": true }, "provider": { "type": "string", "enum": [ "azureOpenAI", "openAI", "anthropic", "googleVertexAI", "googleGemini", "alephAlpha" ] }, "connectionId": { "type": "string", "description": "The reference id of the GenerativeAI Provider Connection", "format": "uuid" }, "isDefault": { "type": "boolean", "description": "Sets the LLM to default (fallback) if no other LLM is set", "example": false }, "openAI": { "type": "object", "description": "OpenAI specific meta data", "properties": { "customModel": { "type": "string", "example": "gpt-4-32k-0613", "description": "The custom model name. This does not work with embedding models" } } }, "anthropic": { "type": "object", "description": "Anthropic specific meta data", "properties": { "customModel": { "type": "string", "example": "claude-3-opus-20240229", "description": "The custom model name. This does not work with embedding models" } } }, "azureOpenAI": { "type": "object", "description": "Azure OpenAI specific meta data", "properties": { "resourceName": { "type": "string" }, "deploymentName": { "type": "string" }, "apiVersion": { "type": "string" }, "baseCustomUrl": { "type": "string", "example": [ "https://.openai.azure.com/openai/deployments//chat/completions?api-version=", "https://.openai.azure.com/openai/deployments//completions?api-version=", "https://.openai.azure.com/openai/deployments//embeddings?api-version=" ] } } }, "googleVertexAI": { "type": "object", "description": "Google VertexAI specific meta data", "properties": { "location": { "type": "string" }, "apiEndpoint": { "type": "string" }, "publisher": { "type": "string" } } }, "googleGemini": { "type": "object", "description": "Google Gemini specific meta data", "properties": { "location": { "type": "string" } } }, "alephAlpha": { "type": "object", "description": "Aleph Alpha specific meta data", "properties": { "customModel": { "type": "string", "example": "luminous-003", "description": "The custom model name. This does not work with embedding models" }, "baseCustomUrl": { "type": "string", "example": "https://api.aleph-alpha.com" } } }, "referenceId": { "type": "string", "description": "The reference id of the LargeLanguageModel", "format": "uuid" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "get": { "operationId": "indexLargeLanguageModels_2_0", "summary": "Get all LargeLanguageModels", "description": "Get metadata for all [LargeLanguageModel](doc:largeLanguageModels) resources in a project.", "tags": [ "LargeLanguageModels v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "query", "name": "projectId", "description": "Filter by projectId", "required": false, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "query", "name": "filter", "required": false, "schema": { "type": "string" }, "description": "Filter records by specific field eg:name." }, { "in": "query", "name": "limit", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100 }, "description": "The maximum number of items to return. The default is 25." }, { "in": "query", "name": "skip", "required": false, "schema": { "type": "integer", "minimum": 0 }, "description": "The number of items to skip. The default is 0. Used along with a limit of a pagination." }, { "in": "query", "name": "sort", "required": false, "schema": { "type": "string", "minLength": 1 }, "description": "The order of the sorting items-`Desc` (descending) or `Asc` (ascending). For example, to sort the records by name in ascending order, specify `name:Asc`." }, { "in": "query", "name": "next", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the nextCursor value from the response to get the next set of records. Used along with limit for pagination." }, { "in": "query", "name": "previous", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the previousCursor value from the response to get the previous set of records. Used along with limit for pagination." } ], "responses": { "200": { "description": "Returns array of a LargeLanguageModel metadata objects", "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "required": [ "name", "modelType", "provider", "connectionId" ], "properties": { "name": { "type": "string", "example": "LLM Name" }, "description": { "type": "string", "example": "LLM meaningful description" }, "modelType": { "type": "string", "enum": [ "gpt-3.5-turbo", "gpt-3.5-turbo-instruct", "text-davinci-003", "gpt-4", "text-embedding-ada-002", "luminous-extended-control", "luminous-embedding-128", "claude-v1-100k", "claude-instant-v1", "claude-3-opus-20240229", "text-bison@001", "custom-model", "gemini-1.0-pro" ] }, "modelGroup": { "type": "string", "enum": [ "chat", "completion" ] }, "isCustomModel": { "type": "boolean", "example": true }, "provider": { "type": "string", "enum": [ "azureOpenAI", "openAI", "anthropic", "googleVertexAI", "googleGemini", "alephAlpha" ] }, "connectionId": { "type": "string", "description": "The reference id of the GenerativeAI Provider Connection", "format": "uuid" }, "isDefault": { "type": "boolean", "description": "Sets the LLM to default (fallback) if no other LLM is set", "example": false }, "openAI": { "type": "object", "description": "OpenAI specific meta data", "properties": { "customModel": { "type": "string", "example": "gpt-4-32k-0613", "description": "The custom model name. This does not work with embedding models" } } }, "anthropic": { "type": "object", "description": "Anthropic specific meta data", "properties": { "customModel": { "type": "string", "example": "claude-3-opus-20240229", "description": "The custom model name. This does not work with embedding models" } } }, "azureOpenAI": { "type": "object", "description": "Azure OpenAI specific meta data", "properties": { "resourceName": { "type": "string" }, "deploymentName": { "type": "string" }, "apiVersion": { "type": "string" }, "baseCustomUrl": { "type": "string", "example": [ "https://.openai.azure.com/openai/deployments//chat/completions?api-version=", "https://.openai.azure.com/openai/deployments//completions?api-version=", "https://.openai.azure.com/openai/deployments//embeddings?api-version=" ] } } }, "googleVertexAI": { "type": "object", "description": "Google VertexAI specific meta data", "properties": { "location": { "type": "string" }, "apiEndpoint": { "type": "string" }, "publisher": { "type": "string" } } }, "googleGemini": { "type": "object", "description": "Google Gemini specific meta data", "properties": { "location": { "type": "string" } } }, "alephAlpha": { "type": "object", "description": "Aleph Alpha specific meta data", "properties": { "customModel": { "type": "string", "example": "luminous-003", "description": "The custom model name. This does not work with embedding models" }, "baseCustomUrl": { "type": "string", "example": "https://api.aleph-alpha.com" } } }, "referenceId": { "type": "string", "description": "The reference id of the LargeLanguageModel", "format": "uuid" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" } }, "total": { "type": "integer", "example": 1 }, "next": { "oneOf": [ { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, { "nullable": true } ], "example": "5ce7c2d833ea1e04d7e6c432" }, "previous": { "oneOf": [ { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, { "nullable": true } ], "example": null } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/largelanguagemodels/{largeLanguageModelId}": { "delete": { "operationId": "deleteLargeLanguageModel_2_0", "summary": "Delete a LargeLanguageModel", "description": "Delete a [LargeLanguageModel](doc:largeLanguageModel).", "tags": [ "LargeLanguageModels v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "largeLanguageModelId", "description": "Id for the LargeLangugeModel", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "204": { "description": "Successfully deleted LargeLanguageModel" }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "get": { "operationId": "readLargeLanguageModel_2_0", "summary": "Get a LargeLanguageModel", "description": "Get a single [LargeLanguageModel](doc:largeLanguageModel) resource in a project.", "tags": [ "LargeLanguageModels v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "largeLanguageModelId", "description": "Id for the LargeLangugeModel", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "200": { "description": "Returns LargeLanguageModel object", "content": { "application/json": { "schema": { "type": "object", "required": [ "name", "modelType", "provider", "connectionId" ], "properties": { "name": { "type": "string", "example": "LLM Name" }, "description": { "type": "string", "example": "LLM meaningful description" }, "modelType": { "type": "string", "enum": [ "gpt-3.5-turbo", "gpt-3.5-turbo-instruct", "text-davinci-003", "gpt-4", "text-embedding-ada-002", "luminous-extended-control", "luminous-embedding-128", "claude-v1-100k", "claude-instant-v1", "claude-3-opus-20240229", "text-bison@001", "custom-model", "gemini-1.0-pro" ] }, "modelGroup": { "type": "string", "enum": [ "chat", "completion" ] }, "isCustomModel": { "type": "boolean", "example": true }, "provider": { "type": "string", "enum": [ "azureOpenAI", "openAI", "anthropic", "googleVertexAI", "googleGemini", "alephAlpha" ] }, "connectionId": { "type": "string", "description": "The reference id of the GenerativeAI Provider Connection", "format": "uuid" }, "isDefault": { "type": "boolean", "description": "Sets the LLM to default (fallback) if no other LLM is set", "example": false }, "openAI": { "type": "object", "description": "OpenAI specific meta data", "properties": { "customModel": { "type": "string", "example": "gpt-4-32k-0613", "description": "The custom model name. This does not work with embedding models" } } }, "anthropic": { "type": "object", "description": "Anthropic specific meta data", "properties": { "customModel": { "type": "string", "example": "claude-3-opus-20240229", "description": "The custom model name. This does not work with embedding models" } } }, "azureOpenAI": { "type": "object", "description": "Azure OpenAI specific meta data", "properties": { "resourceName": { "type": "string" }, "deploymentName": { "type": "string" }, "apiVersion": { "type": "string" }, "baseCustomUrl": { "type": "string", "example": [ "https://.openai.azure.com/openai/deployments//chat/completions?api-version=", "https://.openai.azure.com/openai/deployments//completions?api-version=", "https://.openai.azure.com/openai/deployments//embeddings?api-version=" ] } } }, "googleVertexAI": { "type": "object", "description": "Google VertexAI specific meta data", "properties": { "location": { "type": "string" }, "apiEndpoint": { "type": "string" }, "publisher": { "type": "string" } } }, "googleGemini": { "type": "object", "description": "Google Gemini specific meta data", "properties": { "location": { "type": "string" } } }, "alephAlpha": { "type": "object", "description": "Aleph Alpha specific meta data", "properties": { "customModel": { "type": "string", "example": "luminous-003", "description": "The custom model name. This does not work with embedding models" }, "baseCustomUrl": { "type": "string", "example": "https://api.aleph-alpha.com" } } }, "referenceId": { "type": "string", "description": "The reference id of the LargeLanguageModel", "format": "uuid" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "patch": { "operationId": "updateLargeLanguageModel_2_0", "summary": "Updates a LargeLanguageModel", "description": "Updates a [LargeLanguageModel](doc:largeLanguageModel).", "tags": [ "LargeLanguageModels v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "largeLanguageModelId", "description": "Id for the LargeLangugeModel", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "example": "LLM Name" }, "description": { "type": "string", "example": "LLM meaningful description" }, "provider": { "type": "string", "enum": [ "azureOpenAI", "openAI", "anthropic", "googleVertexAI", "googleGemini", "alephAlpha" ] }, "connectionId": { "type": "string", "description": "The reference id of the GenerativeAI Provider Connection", "format": "uuid" }, "isDefault": { "type": "boolean", "description": "Sets the LLM to default (fallback) if no other LLM is set", "example": false } } } } } }, "responses": { "204": { "description": "Successfully updated Flow" }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/largelanguagemodels/{largeLanguageModelId}/test": { "post": { "operationId": "testLargeLanguageModel_2_0", "summary": "Validates the largeLanguageModel provider creedentials", "description": "Validates the creedentials making a connection to the generativeAI Provider", "tags": [ "LargeLanguageModels v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "largeLanguageModelId", "description": "Id for the LargeLangugeModel", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "projectId" ], "properties": { "projectId": { "type": "string" } } } } } }, "responses": { "200": { "description": "Credentials have been validated and the connection was successful.", "content": { "application/json": { "schema": { "type": "object", "properties": { "voiceProvider": { "type": "string" }, "isCredentialsValid": { "type": "boolean" }, "msg": { "type": "string" }, "msgErr": { "type": "string" } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/lexicons/{lexiconId}/entries/{entryId}/keyphrases": { "post": { "operationId": "addKeyphraseToLexiconEntry_2_0", "summary": "Add a Keyphrase to a Lexicon Entry", "description": "Add a Keyphrase to a Lexicon Entry.", "tags": [ "Lexicons v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "lexiconId", "description": "The Id of the Lexicon", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "path", "name": "entryId", "description": "The id of an entry in the Lexicon", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "value" ], "properties": { "value": { "type": "string", "description": "a keyphrase", "example": "pizza" } } } } } }, "responses": { "201": { "description": "Successfully created the Keyphrase." }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "get": { "operationId": "indexLexiconEntryKeyphrases_2_0", "summary": "Get keyphrases of a Lexicon Entry", "description": "Get 25 keyphrases of a [Lexicon Entry](https://docs.cognigy.com/ai/resources/build/lexicons/) by default. To change the default value, use the `limit` query parameter. Additionally, you can filter, sort, and paginate the results.", "tags": [ "Lexicons v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "lexiconId", "description": "The Id of the Lexicon", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "path", "name": "entryId", "description": "The id of an entry in the Lexicon", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "query", "name": "projectId", "description": "Filter by projectId", "required": false, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "query", "name": "filter", "required": false, "schema": { "type": "string" }, "description": "The `value` field to filter the lexicon keyphrases" }, { "in": "query", "name": "limit", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100 }, "description": "The maximum number of items to return. The default is 25." }, { "in": "query", "name": "skip", "required": false, "schema": { "type": "integer", "minimum": 0 }, "description": "The number of items to skip. The default is 0. Used along with a limit of a pagination." }, { "in": "query", "name": "sort", "required": false, "schema": { "type": "string", "minLength": 1 }, "description": "The order of the sorting items-`Desc` (descending) or `Asc` (ascending). For example, to sort the records by name in ascending order, specify `name:Asc`." }, { "in": "query", "name": "next", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the nextCursor value from the response to get the next set of records. Used along with limit for pagination." }, { "in": "query", "name": "previous", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the previousCursor value from the response to get the previous set of records. Used along with limit for pagination." } ], "responses": { "200": { "description": "Returns array of a Keyphrases of a Lexicon Entry", "content": { "application/json": { "schema": { "type": "array", "items": { "type": "object", "properties": { "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "mainKeyphrase": { "description": "the keyphrase value", "example": "pizza" }, "data": { "type": "string", "description": "Additional JSON-data of the lexicon entry", "example": {} }, "keyphrases": { "type": "object", "properties": { "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "value": { "type": "string", "description": "the keyphrase value", "example": "pizza" }, "isMainKeyphrase": { "type": "boolean", "description": "Indicator if the Keyphrase is the mainKeyphrase", "example": true } } }, "slotReferences": { "type": "array", "description": "The used slots by the lexicon entry", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/lexicons/{lexiconId}/entries/{entryId}/slots": { "post": { "operationId": "addSlotToLexiconEntry_2_0", "summary": "Add a Slot to a Lexicon Entry", "description": "Add a Slot to a Lexicon Entry.", "tags": [ "Lexicons v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "lexiconId", "description": "The Id of the Lexicon", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "path", "name": "entryId", "description": "The id of an entry in the Lexicon", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "value" ], "properties": { "value": { "type": "string", "description": "a slot", "example": "food" } } } } } }, "responses": { "201": { "description": "Successfully created the Slot." }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/lexicons/{lexiconId}/entries": { "patch": { "operationId": "batchLexiconEntries_2_0", "summary": "Batch Operations on Lexicon Entries", "description": "Batch Operations on Lexicon Entries.", "tags": [ "Lexicons v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "lexiconId", "description": "The Id of the Lexicon", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "operations": { "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "op": { "type": "string", "enum": [ "delete" ] }, "id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } }, { "type": "object", "properties": { "op": { "type": "string", "enum": [ "create" ] }, "value": { "type": "object", "required": [ "mainKeyphrase" ], "properties": { "data": { "type": "string", "description": "Additional JSON-data of the lexicon entry", "example": "{\"key1\": \"value1\" }" }, "slotReferences": { "type": "array", "description": "The used slots by the lexicon entry", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "mainKeyphrase": { "type": "string", "description": "the keyphrase value", "example": "pizza" } } } } }, { "type": "object", "properties": { "op": { "type": "string", "enum": [ "update" ] }, "id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "value": { "type": "object", "required": [ "mainKeyphrase" ], "properties": { "data": { "type": "string", "description": "Additional JSON-data of the lexicon entry", "example": "{\"key1\": \"value1\" }" }, "slotReferences": { "type": "array", "description": "The used slots by the lexicon entry", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "mainKeyphrase": { "type": "string", "description": "the keyphrase value", "example": "pizza" } } } } } ] } } } } } } }, "responses": { "200": { "description": "Successfully ran the batch operations.", "content": { "application/json": { "schema": { "type": "object", "properties": { "created": { "type": "array", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "updated": { "type": "array", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "deleted": { "type": "array", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "post": { "operationId": "createLexiconEntry_2_0", "summary": "Create an Entry", "description": "Create an Entry in a lexicon.", "tags": [ "Lexicons v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "lexiconId", "description": "The Id of the Lexicon", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "required": [ "mainKeyphrase" ], "properties": { "data": { "type": "string", "description": "Additional JSON-data of the lexicon entry", "example": "{\"key1\": \"value1\" }" }, "slotReferences": { "type": "array", "description": "The used slots by the lexicon entry", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "mainKeyphrase": { "type": "string", "description": "the keyphrase value", "example": "pizza" } } } } } }, "responses": { "201": { "description": "Created Entry Object.", "content": { "application/json": { "schema": { "type": "object", "required": [ "mainKeyphrase" ], "properties": { "data": { "type": "string", "description": "Additional JSON-data of the lexicon entry", "example": "{\"key1\": \"value1\" }" }, "slotReferences": { "type": "array", "description": "The used slots by the lexicon entry", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "mainKeyphrase": { "type": "string", "description": "the keyphrase value", "example": "pizza" }, "keyphrases": { "type": "object", "properties": { "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "value": { "type": "string", "description": "the keyphrase value", "example": "pizza" }, "isMainKeyphrase": { "type": "boolean", "description": "Indicator if the Keyphrase is the mainKeyphrase", "example": true } } }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "get": { "operationId": "indexLexiconEntries_2_0", "summary": "Get entries of a Lexicon", "description": "Get 25 entries of a [Lexicon](https://docs.cognigy.com/ai/resources/build/lexicons/) by default. To change the default value, use the `limit` query parameter. Additionally, you can filter, sort, and paginate the results.", "tags": [ "Lexicons v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "lexiconId", "description": "The Id of the Lexicon", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "query", "name": "projectId", "description": "Filter by projectId", "required": false, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "query", "name": "limit", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100 }, "description": "The maximum number of items to return. The default is 25." }, { "in": "query", "name": "skip", "required": false, "schema": { "type": "integer", "minimum": 0 }, "description": "The number of items to skip. The default is 0. Used along with a limit of a pagination." }, { "in": "query", "name": "sort", "required": false, "schema": { "type": "string", "minLength": 1 }, "description": "The order of the sorting items-`Desc` (descending) or `Asc` (ascending). For example, to sort the records by name in ascending order, specify `name:Asc`." }, { "in": "query", "name": "next", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the nextCursor value from the response to get the next set of records. Used along with limit for pagination." }, { "in": "query", "name": "previous", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the previousCursor value from the response to get the previous set of records. Used along with limit for pagination." } ], "responses": { "200": { "description": "Returns array of a Lexicon Entries", "content": { "application/json": { "schema": { "type": "array", "items": { "type": "object", "properties": { "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "mainKeyphrase": { "description": "the keyphrase value", "example": "pizza" }, "data": { "type": "string", "description": "Additional JSON-data of the lexicon entry", "example": {} }, "keyphrases": { "type": "object", "properties": { "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "value": { "type": "string", "description": "the keyphrase value", "example": "pizza" }, "isMainKeyphrase": { "type": "boolean", "description": "Indicator if the Keyphrase is the mainKeyphrase", "example": true } } }, "slotReferences": { "type": "array", "description": "The used slots by the lexicon entry", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/lexicons": { "patch": { "operationId": "batchLexicons_2_0", "summary": "Batch Operations on Lexicons", "description": "Batch Operations on Lexicons.", "tags": [ "Lexicons v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "query", "name": "projectId", "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "operations": { "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "op": { "type": "string", "enum": [ "delete" ] }, "id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } }, { "type": "object", "properties": { "op": { "type": "string", "enum": [ "create" ] }, "value": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the lexicon", "example": "EU countries" }, "description": { "type": "string", "description": "A meaningful description of the lexicon", "example": "Countries members of the European Union, e.g. Spain" } } } } }, { "type": "object", "properties": { "op": { "type": "string", "enum": [ "update" ] }, "id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "value": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the lexicon", "example": "EU countries" }, "description": { "type": "string", "description": "A meaningful description of the lexicon", "example": "Countries members of the European Union, e.g. Spain" } } } } } ] } } } } } } }, "responses": { "200": { "description": "Successfully ran the batch operations.", "content": { "application/json": { "schema": { "type": "object", "properties": { "created": { "type": "array", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "updated": { "type": "array", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "deleted": { "type": "array", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "post": { "operationId": "createLexicon_2_0", "summary": "Create a new Lexicon", "description": "Create a new [Lexicon](doc:lexicon) resource in a project.", "tags": [ "Lexicons v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "query", "name": "resourceId", "description": "An Id of a resource within the corresponding project to copy from", "required": false, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "query", "name": "shouldGenerateLexiconEntries", "description": "Flag to allow the Lexicon creation to use the generative AI to generate entries.", "example": true, "required": false, "schema": { "type": "boolean" } }, { "in": "query", "name": "languageCode", "description": "Language code.", "required": false, "schema": { "type": "string", "example": "en-US" } }, { "in": "query", "name": "shouldGenerateSynonyms", "description": "Flag to allow the Lexicon creation to use the generative AI to generate synonyms.", "example": false, "required": false, "schema": { "type": "boolean" } }, { "in": "query", "name": "generateLexiconEntriesLimit", "description": "Number of entries to be generated by the Generative AI.", "example": 8, "required": false, "schema": { "type": "integer" } }, { "in": "query", "name": "defaultSlot", "description": "Default Slot where to associate the generated Lexicon entries.", "example": "testSlot", "required": false, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the lexicon", "example": "EU countries" }, "description": { "type": "string", "description": "A meaningful description of the lexicon", "example": "Countries members of the European Union, e.g. Spain" }, "projectId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } } } }, "responses": { "201": { "description": "Returns Lexicon metadata object.", "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the lexicon", "example": "EU countries" }, "description": { "type": "string", "description": "A meaningful description of the lexicon", "example": "Countries members of the European Union, e.g. Spain" }, "referenceId": { "type": "string", "format": "uuid" }, "values": { "deprecated": true }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "get": { "operationId": "indexLexicons_2_0", "summary": "Get Lexicons", "description": "Get 25 [Lexicons](https://docs.cognigy.com/ai/resources/build/lexicons/) in a project by default. To change the default value, use the `limit` query parameter. Additionally, you can filter, sort, and paginate the results.", "tags": [ "Lexicons v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "query", "name": "projectId", "description": "Filter by projectId", "required": false, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "query", "name": "filter", "required": false, "schema": { "type": "string" }, "description": "The name of the lexicon to filter the records" }, { "in": "query", "name": "limit", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100 }, "description": "The maximum number of items to return. The default is 25." }, { "in": "query", "name": "skip", "required": false, "schema": { "type": "integer", "minimum": 0 }, "description": "The number of items to skip. The default is 0. Used along with a limit of a pagination." }, { "in": "query", "name": "sort", "required": false, "schema": { "type": "string", "minLength": 1 }, "description": "The order of the sorting items-`Desc` (descending) or `Asc` (ascending). For example, to sort the records by name in ascending order, specify `name:Asc`." }, { "in": "query", "name": "next", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the nextCursor value from the response to get the next set of records. Used along with limit for pagination." }, { "in": "query", "name": "previous", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the previousCursor value from the response to get the previous set of records. Used along with limit for pagination." } ], "responses": { "200": { "description": "Returns array of a Lexicons", "content": { "application/json": { "schema": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the lexicon", "example": "New Lexicon" }, "description": { "type": "string", "description": "A meaningful description of the lexicon", "example": "Countries members of the European Union, e.g. Spain" }, "referenceId": { "type": "string", "format": "uuid" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/lexicons/{lexiconId}/slots": { "patch": { "operationId": "batchLexiconSlots_2_0", "summary": "Batch Operations on Lexicon Slots", "description": "Batch Operations on Lexicon Slots.", "tags": [ "Lexicons v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "lexiconId", "description": "The Id of the Lexicon", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "operations": { "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "op": { "type": "string", "enum": [ "delete" ] }, "id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } }, { "type": "object", "properties": { "op": { "type": "string", "enum": [ "create" ] }, "value": { "type": "object", "required": [ "mainKeyphrase" ], "properties": { "data": { "type": "string", "description": "Additional JSON-data of the lexicon entry", "example": "{\"key1\": \"value1\" }" }, "slotReferences": { "type": "array", "description": "The used slots by the lexicon entry", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "mainKeyphrase": { "type": "string", "description": "the keyphrase value", "example": "pizza" } } } } }, { "type": "object", "properties": { "op": { "type": "string", "enum": [ "update" ] }, "id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "value": { "type": "object", "required": [ "mainKeyphrase" ], "properties": { "data": { "type": "string", "description": "Additional JSON-data of the lexicon entry", "example": "{\"key1\": \"value1\" }" }, "slotReferences": { "type": "array", "description": "The used slots by the lexicon entry", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "mainKeyphrase": { "type": "string", "description": "the keyphrase value", "example": "pizza" } } } } } ] } } } } } } }, "responses": { "200": { "description": "Successfully ran the batch operations.", "content": { "application/json": { "schema": { "type": "object", "properties": { "created": { "type": "array", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "updated": { "type": "array", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "deleted": { "type": "array", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "post": { "operationId": "createLexiconSlot_2_0", "summary": "Create a Slot", "description": "Create a [Slot](doc:lexicon) in the lexicon. You can assign slots to keyphrases.", "tags": [ "Lexicons v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "lexiconId", "description": "The Id of the Lexicon", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the slot", "example": "food" } } } } } }, "responses": { "201": { "description": "The created Slot", "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the slot", "example": "food" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "get": { "operationId": "indexLexiconSlots_2_0", "summary": "Get slots of a Lexicon", "description": "Get 25 slots of a [Lexicon](https://docs.cognigy.com/ai/resources/build/lexicons/) by default. To change the default value, use the `limit` query parameter. Additionally, you can filter, sort, and paginate the results.", "tags": [ "Lexicons v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "lexiconId", "description": "The Id of the Lexicon", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "query", "name": "filter", "required": false, "schema": { "type": "string" }, "description": "The name of the lexicon slot to filter the records" }, { "in": "query", "name": "limit", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100 }, "description": "The maximum number of items to return. The default is 25." }, { "in": "query", "name": "skip", "required": false, "schema": { "type": "integer", "minimum": 0 }, "description": "The number of items to skip. The default is 0. Used along with a limit of a pagination." }, { "in": "query", "name": "sort", "required": false, "schema": { "type": "string", "minLength": 1 }, "description": "The order of the sorting items-`Desc` (descending) or `Asc` (ascending). For example, to sort the records by name in ascending order, specify `name:Asc`." }, { "in": "query", "name": "next", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the nextCursor value from the response to get the next set of records. Used along with limit for pagination." }, { "in": "query", "name": "previous", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the previousCursor value from the response to get the previous set of records. Used along with limit for pagination." } ], "responses": { "200": { "description": "Returns an array of a lexicon slots", "content": { "application/json": { "schema": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the slot", "example": "food" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/lexicons/{lexiconId}/downloadlink": { "post": { "operationId": "composeLexiconDownloadLink_2_0", "summary": "Creates a download link to a Lexicon", "description": "Creates a download link to a [Lexicon](doc:lexicon).", "tags": [ "Lexicons v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "lexiconId", "description": "The Id of the Lexicon", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "200": { "description": "Returning a link to download the Lexicon", "content": { "application/json": { "schema": { "type": "object", "properties": { "downloadLink": { "type": "string", "format": "uri" } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/lexicons/{lexiconId}": { "delete": { "operationId": "deleteLexicon_2_0", "summary": "Delete a Lexicon", "description": "Delete a [Lexicon](doc:lexicon) resource in a project.", "tags": [ "Lexicons v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "lexiconId", "description": "The Id of the Lexicon", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "204": { "description": "Successfully deleted the resource." }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "get": { "operationId": "readLexicon_2_0", "summary": "Get a Lexicon", "description": "Get a single [Lexicon](doc:lexicon) resource in a project.", "tags": [ "Lexicons v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "lexiconId", "description": "The Id of the Lexicon", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "query", "name": "metaOnly", "description": "Return only the lexicon meta data if set to true", "required": false, "schema": { "type": "boolean", "enum": [ true, false ] } } ], "responses": { "200": { "description": "Returns Lexicon Object", "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the lexicon", "example": "EU countries" }, "description": { "type": "string", "description": "A meaningful description of the lexicon", "example": "Countries members of the European Union, e.g. Spain" }, "referenceId": { "type": "string", "format": "uuid" }, "values": { "deprecated": true }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "patch": { "operationId": "updateLexicon_2_0", "summary": "Update a Lexicon", "description": "Update a [Lexicon](doc:lexicon) resource in a project.", "tags": [ "Lexicons v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "lexiconId", "description": "The Id of the Lexicon", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the lexicon", "example": "EU countries" }, "description": { "type": "string", "description": "A meaningful description of the lexicon", "example": "Countries members of the European Union, e.g. Spain" } } } } } }, "responses": { "204": { "description": "Successfully updated Lexicon." }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/lexicons/{lexiconId}/entries/{entryId}": { "delete": { "operationId": "deleteLexiconEntry_2_0", "summary": "Delete an Entry", "description": "Delete an [Entry](doc:lexicon).", "tags": [ "Lexicons v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "lexiconId", "description": "The Id of the Lexicon", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "path", "name": "entryId", "description": "The id of an entry in the Lexicon", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "204": { "description": "Successfully deleted the entry." }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "get": { "operationId": "readLexiconEntry_2_0", "summary": "Get a LexiconEntry", "description": "Get a single [LexiconEntry](doc:lexicon) resource in a project.", "tags": [ "Lexicons v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "lexiconId", "description": "The Id of the Lexicon", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "path", "name": "entryId", "description": "The id of an entry in the Lexicon", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "200": { "description": "Returns Lexicon Entry Object", "content": { "application/json": { "schema": { "type": "object", "required": [ "mainKeyphrase" ], "properties": { "data": { "type": "string", "description": "Additional JSON-data of the lexicon entry", "example": "{\"key1\": \"value1\" }" }, "slotReferences": { "type": "array", "description": "The used slots by the lexicon entry", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "mainKeyphrase": { "type": "string", "description": "the keyphrase value", "example": "pizza" }, "keyphrases": { "type": "object", "properties": { "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "value": { "type": "string", "description": "the keyphrase value", "example": "pizza" }, "isMainKeyphrase": { "type": "boolean", "description": "Indicator if the Keyphrase is the mainKeyphrase", "example": true } } }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "patch": { "operationId": "updateLexiconEntry_2_0", "summary": "Update a Lexicon Entry", "description": "Update a [Lexicon Entry](doc:lexicon) data object.", "tags": [ "Lexicons v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "lexiconId", "description": "The Id of the Lexicon", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "path", "name": "entryId", "description": "The id of an entry in the Lexicon", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "mainKeyphrase" ], "properties": { "data": { "type": "string", "description": "Additional JSON-data of the lexicon entry", "example": "{\"key1\": \"value1\" }" }, "slotReferences": { "type": "array", "description": "The used slots by the lexicon entry", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "mainKeyphrase": { "type": "string", "description": "the keyphrase value", "example": "pizza" } } } } } }, "responses": { "204": { "description": "Successfully updated Entry." }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/lexicons/{lexiconId}/slots/{slotId}": { "delete": { "operationId": "deleteLexiconSlot_2_0", "summary": "Delete a Slot", "description": "Delete a [Slot](doc:lexicon) from the lexicon.", "tags": [ "Lexicons v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "lexiconId", "description": "The Id of the Lexicon", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "path", "name": "slotId", "description": "The id of a slot in the Lexicon", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "204": { "description": "Successfully deleted slot." }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "patch": { "operationId": "updateLexiconSlot_2_0", "summary": "Update a Slot", "description": "Update a [Slot](doc:lexicon).", "tags": [ "Lexicons v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "lexiconId", "description": "The Id of the Lexicon", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "path", "name": "slotId", "description": "The id of a slot in the Lexicon", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the slot", "example": "food" } } } } } }, "responses": { "204": { "description": "Successfully updated Slot." }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/lexicons/{lexiconId}/export": { "get": { "operationId": "exportFromLexicon_2_0", "summary": "Create a task to export lexicon data as csv", "description": "Export a [Lexicon](doc:Lexicon) resource. Currently you can export only csv formatted data.", "tags": [ "Lexicons v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "lexiconId", "description": "The Id of the Lexicon", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "202": { "description": "Successfully started downloading the lexicon data.", "content": { "application/json": { "schema": { "type": "object", "properties": { "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "status": { "type": "string", "description": "The status of the task", "example": "queued", "enum": [ "queued", "active", "done", "cancelling", "cancelled", "error" ] }, "type": { "type": "string", "example": "trainIntents" }, "parameters": { "type": "object" }, "lastChangedAt": { "type": "number", "example": 1594243850 }, "lastCreatedAt": { "type": "number", "example": 1594243850 }, "currentStep": { "type": "integer", "example": 0 }, "totalStep": { "type": "integer", "example": 100 } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/lexicons/{lexiconId}/import": { "post": { "operationId": "importIntoLexicon_2_0", "summary": "Import a Lexicon", "description": "Import a [Lexicon](doc:lexicon) resource. Currently you can import csv formatted data.", "tags": [ "Lexicons v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "lexiconId", "description": "The Id of the Lexicon", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "requestBody": { "required": true, "content": { "multipart/form-data": { "schema": { "type": "object", "properties": { "mode": { "type": "string", "example": "skip", "enum": [ "skip", "overwrite", "merge" ] }, "file": { "type": "string", "format": "binary" } } }, "encoding": { "file": { "contentType": "text/csv" } } } } }, "responses": { "202": { "description": "Successfully uploaded your Lexicon data and created a Task for importing it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "status": { "type": "string", "description": "The status of the task", "example": "queued", "enum": [ "queued", "active", "done", "cancelling", "cancelled", "error" ] }, "type": { "type": "string", "example": "trainIntents" }, "parameters": { "type": "object" }, "lastChangedAt": { "type": "number", "example": 1594243850 }, "lastCreatedAt": { "type": "number", "example": 1594243850 }, "currentStep": { "type": "integer", "example": 0 }, "totalStep": { "type": "integer", "example": 100 } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/lexicons/{lexiconId}/keyphrases": { "get": { "operationId": "indexLexiconKeyphrases_2_0", "summary": "Get keyphrases of a Lexicon", "description": "Get 25 keyphrases of a [Lexicon](https://docs.cognigy.com/ai/resources/build/lexicons/) by default. To change the default value, use the `limit` query parameter. Additionally, you can filter, sort, and paginate the results.", "tags": [ "Lexicons v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "lexiconId", "description": "The Id of the Lexicon", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "query", "name": "projectId", "description": "Filter by projectId", "required": false, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "query", "name": "filter", "required": false, "schema": { "type": "string" }, "description": "The `value` field to filter the lexicon keyphrases" }, { "in": "query", "name": "limit", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100 }, "description": "The maximum number of items to return. The default is 25." }, { "in": "query", "name": "skip", "required": false, "schema": { "type": "integer", "minimum": 0 }, "description": "The number of items to skip. The default is 0. Used along with a limit of a pagination." }, { "in": "query", "name": "sort", "required": false, "schema": { "type": "string", "minLength": 1 }, "description": "The order of the sorting items-`Desc` (descending) or `Asc` (ascending). For example, to sort the records by name in ascending order, specify `name:Asc`." }, { "in": "query", "name": "next", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the nextCursor value from the response to get the next set of records. Used along with limit for pagination." }, { "in": "query", "name": "previous", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the previousCursor value from the response to get the previous set of records. Used along with limit for pagination." } ], "responses": { "200": { "description": "Returns array of a Lexicon Keyphrases", "content": { "application/json": { "schema": { "type": "array", "items": { "type": "object", "properties": { "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "mainKeyphrase": { "description": "the keyphrase value", "example": "pizza" }, "data": { "type": "string", "description": "Additional JSON-data of the lexicon entry", "example": {} }, "keyphrases": { "type": "object", "properties": { "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "value": { "type": "string", "description": "the keyphrase value", "example": "pizza" }, "isMainKeyphrase": { "type": "boolean", "description": "Indicator if the Keyphrase is the mainKeyphrase", "example": true } } }, "slotReferences": { "type": "array", "description": "The used slots by the lexicon entry", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/lexicons/{lexiconId}/entries/{entryId}/keyphrases/{keyphraseId}": { "post": { "operationId": "removeKeyphraseFromLexiconEntry_2_0", "summary": "Remove a Keyphrase from a Lexicon Entry", "description": "Remove a Keyphrase from a Lexicon Entry", "tags": [ "Lexicons v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "lexiconId", "description": "The Id of the Lexicon", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "path", "name": "entryId", "description": "The id of an entry in the Lexicon", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "path", "name": "keyphraseId", "description": "The id of a keyphrase in the Lexicon", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "204": { "description": "Successfully removed the keyphrase from the entry." }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/lexicons/{lexiconId}/entries/{entryId}/slots/{slotId}": { "post": { "operationId": "removeSlotFromLexiconEntry_2_0", "summary": "Remove a Slot from a Lexicon Entry", "description": "Remove a Slot from a Lexicon Entry", "tags": [ "Lexicons v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "lexiconId", "description": "The Id of the Lexicon", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "path", "name": "entryId", "description": "The id of an entry in the Lexicon", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "path", "name": "slotId", "description": "The id of a slot in the Lexicon", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "204": { "description": "Successfully removed the slot from the entry." }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/lexicons/{lexiconId}/keyphrases/{keyphraseId}": { "patch": { "operationId": "updateLexiconKeyphrase_2_0", "summary": "Update a Keyphrase", "description": "Update a [Keyphrase](doc:lexicon).", "tags": [ "Lexicons v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "lexiconId", "description": "The Id of the Lexicon", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "path", "name": "keyphraseId", "description": "The id of a keyphrase in the Lexicon", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the slot", "example": "food" }, "isMainKeyphrase": { "type": "boolean", "description": "Indicates if it is main", "example": true } } } } } }, "responses": { "204": { "description": "Successfully updated Keyphrase." }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/locales": { "post": { "operationId": "createLocale_2_0", "summary": "Create a new Locale", "description": "Create a new [Locale](doc:Locale) in a project.", "tags": [ "Locales v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the Locale", "example": "English" }, "primary": { "type": "boolean" }, "nluLanguage": { "type": "string", "example": "en-US", "enum": [ "ge-GE", "da-DK", "en-AU", "en-CA", "en-IN", "en-GB", "en-US", "de-DE", "ja-JP", "ko-KR", "es-ES", "nl-NL", "ar-AE", "fi-FI", "fr-FR", "it-IT", "nn-NO", "pl-PL", "sv-SE", "th-TH", "zh-CN", "vi-VN", "pt-BR", "ru-RU", "pt-PT", "tr-TR", "hi-IN", "bn-IN", "ta-IN" ] }, "fallbackLocaleReference": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "projectId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } } } }, "responses": { "201": { "description": "Returns Locale metadata object.", "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the Locale", "example": "English" }, "primary": { "type": "boolean" }, "nluLanguage": { "type": "string", "example": "en-US", "enum": [ "ge-GE", "da-DK", "en-AU", "en-CA", "en-IN", "en-GB", "en-US", "de-DE", "ja-JP", "ko-KR", "es-ES", "nl-NL", "ar-AE", "fi-FI", "fr-FR", "it-IT", "nn-NO", "pl-PL", "sv-SE", "th-TH", "zh-CN", "vi-VN", "pt-BR", "ru-RU", "pt-PT", "tr-TR", "hi-IN", "bn-IN", "ta-IN" ] }, "fallbackLocaleReference": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "get": { "operationId": "indexLocales_2_0", "summary": "Get Locales", "description": "Get 25 [Locales](https://docs.cognigy.com/ai/resources/manage/localization/) in a project by default. To change the default value, use the `limit` query parameter. Additionally, you can filter, sort, and paginate the results.", "tags": [ "Locales v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "query", "name": "projectId", "description": "Filter by projectId", "required": false, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "query", "name": "filter", "required": false, "schema": { "type": "string" }, "description": "The name of the locale to filter the records" }, { "in": "query", "name": "limit", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100 }, "description": "The maximum number of items to return. The default is 25." }, { "in": "query", "name": "skip", "required": false, "schema": { "type": "integer", "minimum": 0 }, "description": "The number of items to skip. The default is 0. Used along with a limit of a pagination." }, { "in": "query", "name": "sort", "required": false, "schema": { "type": "string", "minLength": 1 }, "description": "The order of the sorting items-`Desc` (descending) or `Asc` (ascending). For example, to sort the records by name in ascending order, specify `name:Asc`." }, { "in": "query", "name": "next", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the nextCursor value from the response to get the next set of records. Used along with limit for pagination." }, { "in": "query", "name": "previous", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the previousCursor value from the response to get the previous set of records. Used along with limit for pagination." } ], "responses": { "200": { "description": "Returns array of a Locale metadata objects", "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the Locale", "example": "English" }, "nluLanguage": { "type": "string", "example": "en-US", "enum": [ "ge-GE", "da-DK", "en-AU", "en-CA", "en-IN", "en-GB", "en-US", "de-DE", "ja-JP", "ko-KR", "es-ES", "nl-NL", "ar-AE", "fi-FI", "fr-FR", "it-IT", "nn-NO", "pl-PL", "sv-SE", "th-TH", "zh-CN", "vi-VN", "pt-BR", "ru-RU", "pt-PT", "tr-TR", "hi-IN", "bn-IN", "ta-IN" ] }, "primary": { "type": "boolean" }, "fallbackLocaleReference": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" } }, "total": { "type": "integer", "example": 1 }, "next": { "oneOf": [ { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, { "nullable": true } ], "example": "5ce7c2d833ea1e04d7e6c432" }, "previous": { "oneOf": [ { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, { "nullable": true } ], "example": null } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/locales/{localeId}": { "delete": { "operationId": "deleteLocale_2_0", "summary": "Delete a Locale", "description": "Delete a non-primary [Locale](doc:Locale) in a project.", "tags": [ "Locales v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "localeId", "description": "The Id of the Locale", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "204": { "description": "Sucessfully deleted the locale." }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "get": { "operationId": "readLocale_2_0", "summary": "Reads a Locale", "description": "Reads a [Locale](doc:Locale).", "tags": [ "Locales v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "localeId", "description": "The Id of the Locale", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "200": { "description": "Returns the Locale object.", "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the Locale", "example": "English" }, "primary": { "type": "boolean" }, "nluLanguage": { "type": "string", "example": "en-US", "enum": [ "ge-GE", "da-DK", "en-AU", "en-CA", "en-IN", "en-GB", "en-US", "de-DE", "ja-JP", "ko-KR", "es-ES", "nl-NL", "ar-AE", "fi-FI", "fr-FR", "it-IT", "nn-NO", "pl-PL", "sv-SE", "th-TH", "zh-CN", "vi-VN", "pt-BR", "ru-RU", "pt-PT", "tr-TR", "hi-IN", "bn-IN", "ta-IN" ] }, "fallbackLocaleReference": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "patch": { "operationId": "updateLocale_2_0", "summary": "Updates a Locale", "description": "Updates a [Locale](doc:Locale).", "tags": [ "Locales v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "localeId", "description": "The Id of the Locale", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the Locale", "example": "English" }, "primary": { "type": "boolean" }, "nluLanguage": { "type": "string", "example": "en-US", "enum": [ "ge-GE", "da-DK", "en-AU", "en-CA", "en-IN", "en-GB", "en-US", "de-DE", "ja-JP", "ko-KR", "es-ES", "nl-NL", "ar-AE", "fi-FI", "fr-FR", "it-IT", "nn-NO", "pl-PL", "sv-SE", "th-TH", "zh-CN", "vi-VN", "pt-BR", "ru-RU", "pt-PT", "tr-TR", "hi-IN", "bn-IN", "ta-IN" ] }, "fallbackLocaleReference": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } } } }, "responses": { "200": { "description": "Returns the Locale object.", "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the Locale", "example": "English" }, "primary": { "type": "boolean" }, "nluLanguage": { "type": "string", "example": "en-US", "enum": [ "ge-GE", "da-DK", "en-AU", "en-CA", "en-IN", "en-GB", "en-US", "de-DE", "ja-JP", "ko-KR", "es-ES", "nl-NL", "ar-AE", "fi-FI", "fr-FR", "it-IT", "nn-NO", "pl-PL", "sv-SE", "th-TH", "zh-CN", "vi-VN", "pt-BR", "ru-RU", "pt-PT", "tr-TR", "hi-IN", "bn-IN", "ta-IN" ] }, "fallbackLocaleReference": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/locales/{localeId}/yesnointents/{intentId}": { "delete": { "operationId": "deleteYesNoIntent_2_0", "summary": "Delete an YesNoIntent", "description": "Delete an [Intent](doc:endpoint), once deleted you will not have an option of creating it, you will need a new locale to have the yesNoIntents.", "tags": [ "YesNoIntents v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "localeId", "description": "The Id of the Locale", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "path", "name": "intentId", "description": "The Id of the Intent", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "204": { "description": "Successfully deleted endpoint" }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "patch": { "operationId": "updateYesNoIntent_2_0", "summary": "Update a YesNoIntent", "description": "Update a yesNoIntent resource in a project.", "tags": [ "YesNoIntents v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "localeId", "description": "The Id of the Locale", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "path", "name": "intentId", "description": "The Id of the Intent", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "rules": { "type": "array", "items": { "type": "string" }, "description": "The intent rules", "example": [ "this should be a valid rule" ] }, "isDisabled": { "type": "boolean" } } } } } }, "responses": { "200": { "description": "Returns an object containing the yesIntent, noIntent, rejectIntent for the given locale", "content": { "application/json": { "schema": { "type": "object", "properties": { "yesIntent": { "type": "object", "properties": { "isDisabled": { "type": "boolean" }, "name": { "type": "string", "example": "pizza" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "rules": { "type": "array", "items": { "type": "string" } } } }, "noIntent": { "type": "object", "properties": { "isDisabled": { "type": "boolean" }, "name": { "type": "string", "example": "pizza" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "rules": { "type": "array", "items": { "type": "string" } } } }, "rejectIntent": { "type": "object", "properties": { "isDisabled": { "type": "boolean" }, "name": { "type": "string", "example": "pizza" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "rules": { "type": "array", "items": { "type": "string" } } } } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/locales/{localeId}/yesnointents": { "get": { "operationId": "readYesNoIntents_2_0", "summary": "Get YesNoIntents", "description": "Get the [YesNoIntents](https://docs.cognigy.com/ai/nlu/nlu-overview/yes-no-intents/) of a locale.", "tags": [ "YesNoIntents v2.0" ], "parameters": [ { "in": "path", "name": "localeId", "description": "The Id of the Locale", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "200": { "description": "Returns an object containing the yesIntent, noIntent, rejectIntent for the given locale", "content": { "application/json": { "schema": { "type": "object", "properties": { "yesIntent": { "type": "object", "properties": { "isDisabled": { "type": "boolean" }, "name": { "type": "string", "example": "pizza" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "rules": { "type": "array", "items": { "type": "string" } } } }, "noIntent": { "type": "object", "properties": { "isDisabled": { "type": "boolean" }, "name": { "type": "string", "example": "pizza" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "rules": { "type": "array", "items": { "type": "string" } } } }, "rejectIntent": { "type": "object", "properties": { "isDisabled": { "type": "boolean" }, "name": { "type": "string", "example": "pizza" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "rules": { "type": "array", "items": { "type": "string" } } } } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/locales/{localeId}/yesnointents/train": { "post": { "operationId": "trainYesNoIntents_2_0", "summary": "Create a Task to Train the YesNoIntents of a locale", "description": "Create a Task to Train the [YesNoIntents](doc:intent) of a locale", "tags": [ "YesNoIntents v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "localeId", "description": "The Id of the Locale", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "202": { "description": "Successfully created Tasks to train YesNoIntents for all the locales", "content": { "application/json": { "schema": { "type": "array", "items": { "type": "object", "properties": { "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "status": { "type": "string", "description": "The status of the task", "example": "queued", "enum": [ "queued", "active", "done", "cancelling", "cancelled", "error" ] }, "type": { "type": "string", "example": "trainIntents" }, "parameters": { "type": "object" }, "lastChangedAt": { "type": "number", "example": 1594243850 }, "lastCreatedAt": { "type": "number", "example": 1594243850 }, "currentStep": { "type": "integer", "example": 0 }, "totalStep": { "type": "integer", "example": 100 } } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/locales/{localeId}/yesnointents/{intentId}/sentences": { "post": { "operationId": "createYesNoSentence_2_0", "summary": "Create a new Sentence for a yesNoIntent", "description": "Create a new [Sentence](doc:sentence) resource in a project.", "tags": [ "YesNoIntents v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "localeId", "description": "The Id of the Locale", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "path", "name": "intentId", "description": "The Id of the Intent", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "text": { "type": "string", "example": "I want to buy a pizza." } } } } } }, "responses": { "201": { "description": "Returns Sentence metadata object.", "content": { "application/json": { "schema": { "type": "object", "properties": { "localeReference": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "feedbackReport": { "type": "object", "properties": { "findings": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "poorScore", "fairScore", "goodScore", "overlap", "wrongIntent" ] } } } }, "info": { "type": "object", "properties": { "trueIntent": { "type": "string" }, "topIntent": { "type": "string" }, "runnerUp": { "type": "string" }, "topScore": { "type": "number" }, "runnerUpScore": { "type": "number" }, "difference": { "type": "number" }, "trueIntentName": { "type": "string" }, "topIntentName": { "type": "string" }, "runnerUpIntentName": { "type": "string" } } } } }, "text": { "type": "string", "example": "I want to buy a pizza." }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "get": { "operationId": "indexYesNoSentences_2_0", "summary": "Get Sentences", "description": "Get 25 [Sentences](https://docs.cognigy.com/ai/nlu/nlu-overview/ml-intents/#example-sentences) in a project by default. To change the default value, use the `limit` query parameter. Additionally, you can filter, sort, and paginate the results.", "tags": [ "YesNoIntents v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "localeId", "description": "The Id of the Locale", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "path", "name": "intentId", "description": "The Id of the Intent", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "query", "name": "filter", "required": false, "schema": { "type": "string" }, "description": "The text of the sentence to filter the records" }, { "in": "query", "name": "limit", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100 }, "description": "The maximum number of items to return. The default is 25." }, { "in": "query", "name": "skip", "required": false, "schema": { "type": "integer", "minimum": 0 }, "description": "The number of items to skip. The default is 0. Used along with a limit of a pagination." }, { "in": "query", "name": "sort", "required": false, "schema": { "type": "string", "minLength": 1 }, "description": "The order of the sorting items-`Desc` (descending) or `Asc` (ascending). For example, to sort the records by name in ascending order, specify `name:Asc`." }, { "in": "query", "name": "next", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the nextCursor value from the response to get the next set of records. Used along with limit for pagination." }, { "in": "query", "name": "previous", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the previousCursor value from the response to get the previous set of records. Used along with limit for pagination." } ], "responses": { "200": { "description": "Returns array of a Sentence metadata objects", "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "text": { "type": "string", "example": "I want to buy a pizza." }, "localeReference": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "slots": { "type": "array", "items": { "type": "object", "additionalProperties": false, "properties": { "tagReference": { "type": "string" }, "lexiconReference": { "type": "string" } } } }, "feedbackReport": { "type": "object", "properties": { "findings": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "poorScore", "fairScore", "goodScore", "overlap", "wrongIntent" ] } } } }, "info": { "type": "object", "properties": { "trueIntent": { "type": "string" }, "topIntent": { "type": "string" }, "runnerUp": { "type": "string" }, "topScore": { "type": "number" }, "runnerUpScore": { "type": "number" }, "difference": { "type": "number" }, "trueIntentName": { "type": "string" }, "topIntentName": { "type": "string" }, "runnerUpIntentName": { "type": "string" } } } } }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" } }, "total": { "type": "integer", "example": 1 }, "next": { "oneOf": [ { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, { "nullable": true } ], "example": "5ce7c2d833ea1e04d7e6c432" }, "previous": { "oneOf": [ { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, { "nullable": true } ], "example": null } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/locales/{localeId}/yesnointents/{intentId}/sentences/{sentenceId}": { "delete": { "operationId": "deleteYesNoSentence_2_0", "summary": "Delete an YesNoSentence", "description": "Delete an [Sentence](doc:sentence).", "tags": [ "YesNoIntents v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "localeId", "description": "The Id of the Locale", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "path", "name": "intentId", "description": "The Id of the Intent", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "path", "name": "sentenceId", "description": "The Id of the Sentence", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "204": { "description": "Successfully deleted sentence" }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "get": { "operationId": "readYesNoSentence_2_0", "summary": "Get a Sentence", "description": "Get a single [Sentence](doc:sentence) resource in a project.", "tags": [ "YesNoIntents v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "localeId", "description": "The Id of the Locale", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "path", "name": "intentId", "description": "The Id of the Intent", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "path", "name": "sentenceId", "description": "The Id of the Sentence", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "200": { "description": "Returns Sentence Object", "content": { "application/json": { "schema": { "type": "object", "properties": { "localeReference": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "feedbackReport": { "type": "object", "properties": { "findings": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "poorScore", "fairScore", "goodScore", "overlap", "wrongIntent" ] } } } }, "info": { "type": "object", "properties": { "trueIntent": { "type": "string" }, "topIntent": { "type": "string" }, "runnerUp": { "type": "string" }, "topScore": { "type": "number" }, "runnerUpScore": { "type": "number" }, "difference": { "type": "number" }, "trueIntentName": { "type": "string" }, "topIntentName": { "type": "string" }, "runnerUpIntentName": { "type": "string" } } } } }, "text": { "type": "string", "example": "I want to buy a pizza." }, "slots": { "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "type": { "type": "string", "enum": [ "anySlot" ] }, "name": { "type": "string" }, "start": { "type": "number" }, "end": { "type": "number" } } }, { "type": "object", "properties": { "type": { "type": "string", "enum": [ "systemSlot" ] }, "dimension": { "type": "string" }, "start": { "type": "number" }, "end": { "type": "number" } } }, { "type": "object", "properties": { "type": { "type": "string", "enum": [ "lexiconSlot" ] }, "lexiconReference": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "slotReference": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "name": { "type": "string" }, "start": { "type": "number" }, "end": { "type": "number" } } } ] } }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "patch": { "operationId": "updateYesNoSentence_2_0", "summary": "Update a Sentence", "description": "Update a [Sentence](doc:sentence) resource in a project.", "tags": [ "YesNoIntents v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "localeId", "description": "The Id of the Locale", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "path", "name": "intentId", "description": "The Id of the Intent", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "path", "name": "sentenceId", "description": "The Id of the Sentence", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "text": { "type": "string", "example": "I want to buy a pizza." } } } } } }, "responses": { "204": { "description": "Successfully updated Sentence" }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/nluconnectors": { "patch": { "operationId": "batchNLUConnectors_2_0", "summary": "Batch Operations on NLUConnectors", "description": "Batch Operations on NLUConnectors.", "tags": [ "NLUConnectors v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "query", "name": "projectId", "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "operations": { "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "op": { "type": "string", "enum": [ "delete" ] }, "id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } }, { "type": "object", "properties": { "op": { "type": "string", "enum": [ "create" ] }, "value": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the NLUConnector", "example": "New NLUConnector" }, "type": { "type": "string", "description": "The NLUConnector type", "example": "cognigy", "enum": [ "alexa", "dialogflow", "dialogflowBuiltIn", "amazonLexBuiltIn", "luis", "watson", "noNlu", "cognigy", "code", "generativeAI", "lex" ] }, "settings": { "oneOf": [ { "type": "object", "description": "Settings used by the Alexa NLUConnector", "properties": { "invocationName": { "type": "string", "description": "The invocation name of the Alexa skill. Necessary to start Alexa simulations." }, "reparseAlexaSlots": { "type": "boolean", "description": "Whether to reparse slots from Alexa with our own keyphrase mapper. Used by Alexa." }, "skill": { "type": "object", "properties": { "lastUpdated": { "type": "string", "description": "When the skill was last updated" }, "nameByLocale": { "type": "object", "description": "Gives the name of the skill for different locales", "properties": { "en-US": { "type": "string" }, "de-DE": { "type": "string" }, "ja-JP": { "type": "string" }, "en-GB": { "type": "string" }, "en-IN": { "type": "string" } } }, "skillId": { "type": "string", "description": "The unique id of the skill" }, "stage": { "type": "string", "description": "The current stage of the skills life cycle (e.g. is it in development, production..)" } } } } }, { "type": "object", "description": "Settings used by the DialogFlow NLUConnector", "properties": { "dialogflowApiVersion": { "type": "integer", "description": "The version of the dialogflow API to use.", "enum": [ 1, 2 ] }, "dialogflowProjectId": { "type": "string", "description": "The projectId of the Dialogflow Agent." }, "accessToken": { "description": "The access token used to authenticate requests. Used by DialogFlow.", "type": "string" }, "privateKey": { "type": "string", "description": "The private key of a Google Service Account that has the access right to use the Dialogflow API. It is stored as a string." } } }, { "type": "object", "description": "Settings used by the LUIS NLUConnector", "properties": { "authenticationURL": { "type": "string", "description": "The URL Used to authenticate requests by LUIS." } } }, { "type": "object", "description": "Settings used by the Watson NLUConnector", "properties": { "apikey": { "type": "string", "description": "Apikey for accessing the Watson NLU Api" }, "workspaceid": { "type": "string", "description": "Skill ID for accessing the Assistant skill" }, "serviceURL": { "type": "string", "description": "The URL used to authenticate requests by Watson" } } }, { "type": "object", "description": "Settings used by the Lex NLUConnector", "properties": { "accessKeyId": { "type": "string", "description": "Apikey for accessing the Lex NLU Api" }, "secretAccessKey": { "type": "string", "description": "Secret Access Key for accessing the Lex NLU Api" }, "awsRegion": { "type": "string", "description": "The AWS region the Lex bot is deployed to" }, "botId": { "type": "string", "description": "Id of the Lex bot" }, "botAliasId": { "type": "string", "description": "Alias of the Lex bot" } } } ] }, "transformer": { "type": "object", "properties": { "abortOnError": { "type": "string", "description": "If true, then we will abort the message processing if the transformer throws an error. Otherwise, we will continue with normal message processing in the event of an error.", "example": false }, "transformerStackEnabled": { "type": "string", "description": "If true, then we will write the transformer stack in the input object, when the channel is adminconsole.", "example": false }, "transformer": { "type": "string", "description": "The transformer object as written by the user. This will be displayed in the UI since it includes typings." }, "preNluTransformerEnabled": { "type": "string", "example": false }, "postNluTransformerEnabled": { "type": "string", "example": false }, "nluCodeTransformerEnabled": { "type": "string", "example": false } } } } } } }, { "type": "object", "properties": { "op": { "type": "string", "enum": [ "update" ] }, "id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "value": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the NLUConnector", "example": "New NLUConnector" }, "type": { "type": "string", "description": "The NLUConnector type", "example": "cognigy", "enum": [ "alexa", "dialogflow", "dialogflowBuiltIn", "amazonLexBuiltIn", "luis", "watson", "noNlu", "cognigy", "code", "generativeAI", "lex" ] }, "settings": { "oneOf": [ { "type": "object", "description": "Settings used by the Alexa NLUConnector", "properties": { "invocationName": { "type": "string", "description": "The invocation name of the Alexa skill. Necessary to start Alexa simulations." }, "reparseAlexaSlots": { "type": "boolean", "description": "Whether to reparse slots from Alexa with our own keyphrase mapper. Used by Alexa." }, "skill": { "type": "object", "properties": { "lastUpdated": { "type": "string", "description": "When the skill was last updated" }, "nameByLocale": { "type": "object", "description": "Gives the name of the skill for different locales", "properties": { "en-US": { "type": "string" }, "de-DE": { "type": "string" }, "ja-JP": { "type": "string" }, "en-GB": { "type": "string" }, "en-IN": { "type": "string" } } }, "skillId": { "type": "string", "description": "The unique id of the skill" }, "stage": { "type": "string", "description": "The current stage of the skills life cycle (e.g. is it in development, production..)" } } } } }, { "type": "object", "description": "Settings used by the DialogFlow NLUConnector", "properties": { "dialogflowApiVersion": { "type": "integer", "description": "The version of the dialogflow API to use.", "enum": [ 1, 2 ] }, "dialogflowProjectId": { "type": "string", "description": "The projectId of the Dialogflow Agent." }, "accessToken": { "description": "The access token used to authenticate requests. Used by DialogFlow.", "type": "string" }, "privateKey": { "type": "string", "description": "The private key of a Google Service Account that has the access right to use the Dialogflow API. It is stored as a string." } } }, { "type": "object", "description": "Settings used by the LUIS NLUConnector", "properties": { "authenticationURL": { "type": "string", "description": "The URL Used to authenticate requests by LUIS." } } }, { "type": "object", "description": "Settings used by the Watson NLUConnector", "properties": { "apikey": { "type": "string", "description": "Apikey for accessing the Watson NLU Api" }, "workspaceid": { "type": "string", "description": "Skill ID for accessing the Assistant skill" }, "serviceURL": { "type": "string", "description": "The URL used to authenticate requests by Watson" } } }, { "type": "object", "description": "Settings used by the Lex NLUConnector", "properties": { "accessKeyId": { "type": "string", "description": "Apikey for accessing the Lex NLU Api" }, "secretAccessKey": { "type": "string", "description": "Secret Access Key for accessing the Lex NLU Api" }, "awsRegion": { "type": "string", "description": "The AWS region the Lex bot is deployed to" }, "botId": { "type": "string", "description": "Id of the Lex bot" }, "botAliasId": { "type": "string", "description": "Alias of the Lex bot" } } } ] }, "transformer": { "type": "object", "properties": { "abortOnError": { "type": "string", "description": "If true, then we will abort the message processing if the transformer throws an error. Otherwise, we will continue with normal message processing in the event of an error.", "example": false }, "transformerStackEnabled": { "type": "string", "description": "If true, then we will write the transformer stack in the input object, when the channel is adminconsole.", "example": false }, "transformer": { "type": "string", "description": "The transformer object as written by the user. This will be displayed in the UI since it includes typings." }, "preNluTransformerEnabled": { "type": "string", "example": false }, "postNluTransformerEnabled": { "type": "string", "example": false }, "nluCodeTransformerEnabled": { "type": "string", "example": false } } } } } } } ] } } } } } } }, "responses": { "200": { "description": "Successfully ran the batch operations.", "content": { "application/json": { "schema": { "type": "object", "properties": { "created": { "type": "array", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "updated": { "type": "array", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "deleted": { "type": "array", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "post": { "operationId": "createNLUConnector_2_0", "summary": "Create a new NLUConnector", "description": "Create a new [NLUConnector](doc:NLUConnector) resource in a project.", "tags": [ "NLUConnectors v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "query", "name": "resourceId", "description": "An Id of a resource within the corresponding project to copy from", "required": false, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the NLUConnector", "example": "New NLUConnector" }, "type": { "type": "string", "description": "The NLUConnector type", "example": "cognigy", "enum": [ "alexa", "dialogflow", "dialogflowBuiltIn", "amazonLexBuiltIn", "luis", "watson", "noNlu", "cognigy", "code", "generativeAI", "lex" ] }, "settings": { "oneOf": [ { "type": "object", "description": "Settings used by the Alexa NLUConnector", "properties": { "invocationName": { "type": "string", "description": "The invocation name of the Alexa skill. Necessary to start Alexa simulations." }, "reparseAlexaSlots": { "type": "boolean", "description": "Whether to reparse slots from Alexa with our own keyphrase mapper. Used by Alexa." }, "skill": { "type": "object", "properties": { "lastUpdated": { "type": "string", "description": "When the skill was last updated" }, "nameByLocale": { "type": "object", "description": "Gives the name of the skill for different locales", "properties": { "en-US": { "type": "string" }, "de-DE": { "type": "string" }, "ja-JP": { "type": "string" }, "en-GB": { "type": "string" }, "en-IN": { "type": "string" } } }, "skillId": { "type": "string", "description": "The unique id of the skill" }, "stage": { "type": "string", "description": "The current stage of the skills life cycle (e.g. is it in development, production..)" } } } } }, { "type": "object", "description": "Settings used by the DialogFlow NLUConnector", "properties": { "dialogflowApiVersion": { "type": "integer", "description": "The version of the dialogflow API to use.", "enum": [ 1, 2 ] }, "dialogflowProjectId": { "type": "string", "description": "The projectId of the Dialogflow Agent." }, "accessToken": { "description": "The access token used to authenticate requests. Used by DialogFlow.", "type": "string" }, "privateKey": { "type": "string", "description": "The private key of a Google Service Account that has the access right to use the Dialogflow API. It is stored as a string." } } }, { "type": "object", "description": "Settings used by the LUIS NLUConnector", "properties": { "authenticationURL": { "type": "string", "description": "The URL Used to authenticate requests by LUIS." } } }, { "type": "object", "description": "Settings used by the Watson NLUConnector", "properties": { "apikey": { "type": "string", "description": "Apikey for accessing the Watson NLU Api" }, "workspaceid": { "type": "string", "description": "Skill ID for accessing the Assistant skill" }, "serviceURL": { "type": "string", "description": "The URL used to authenticate requests by Watson" } } }, { "type": "object", "description": "Settings used by the Lex NLUConnector", "properties": { "accessKeyId": { "type": "string", "description": "Apikey for accessing the Lex NLU Api" }, "secretAccessKey": { "type": "string", "description": "Secret Access Key for accessing the Lex NLU Api" }, "awsRegion": { "type": "string", "description": "The AWS region the Lex bot is deployed to" }, "botId": { "type": "string", "description": "Id of the Lex bot" }, "botAliasId": { "type": "string", "description": "Alias of the Lex bot" } } } ] }, "transformer": { "type": "object", "properties": { "abortOnError": { "type": "string", "description": "If true, then we will abort the message processing if the transformer throws an error. Otherwise, we will continue with normal message processing in the event of an error.", "example": false }, "transformerStackEnabled": { "type": "string", "description": "If true, then we will write the transformer stack in the input object, when the channel is adminconsole.", "example": false }, "transformer": { "type": "string", "description": "The transformer object as written by the user. This will be displayed in the UI since it includes typings." }, "preNluTransformerEnabled": { "type": "string", "example": false }, "postNluTransformerEnabled": { "type": "string", "example": false }, "nluCodeTransformerEnabled": { "type": "string", "example": false } } }, "projectId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } } } }, "responses": { "201": { "description": "Returns NLUConnector metadata object.", "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the NLUConnector", "example": "New NLUConnector" }, "type": { "type": "string", "description": "The NLUConnector type", "example": "cognigy", "enum": [ "alexa", "dialogflow", "dialogflowBuiltIn", "amazonLexBuiltIn", "luis", "watson", "noNlu", "cognigy", "code", "generativeAI", "lex" ] }, "settings": { "oneOf": [ { "type": "object", "description": "Settings used by the Alexa NLUConnector", "properties": { "invocationName": { "type": "string", "description": "The invocation name of the Alexa skill. Necessary to start Alexa simulations." }, "reparseAlexaSlots": { "type": "boolean", "description": "Whether to reparse slots from Alexa with our own keyphrase mapper. Used by Alexa." }, "skill": { "type": "object", "properties": { "lastUpdated": { "type": "string", "description": "When the skill was last updated" }, "nameByLocale": { "type": "object", "description": "Gives the name of the skill for different locales", "properties": { "en-US": { "type": "string" }, "de-DE": { "type": "string" }, "ja-JP": { "type": "string" }, "en-GB": { "type": "string" }, "en-IN": { "type": "string" } } }, "skillId": { "type": "string", "description": "The unique id of the skill" }, "stage": { "type": "string", "description": "The current stage of the skills life cycle (e.g. is it in development, production..)" } } } } }, { "type": "object", "description": "Settings used by the DialogFlow NLUConnector", "properties": { "dialogflowApiVersion": { "type": "integer", "description": "The version of the dialogflow API to use.", "enum": [ 1, 2 ] }, "dialogflowProjectId": { "type": "string", "description": "The projectId of the Dialogflow Agent." }, "accessToken": { "description": "The access token used to authenticate requests. Used by DialogFlow.", "type": "string" }, "privateKey": { "type": "string", "description": "The private key of a Google Service Account that has the access right to use the Dialogflow API. It is stored as a string." } } }, { "type": "object", "description": "Settings used by the LUIS NLUConnector", "properties": { "authenticationURL": { "type": "string", "description": "The URL Used to authenticate requests by LUIS." } } }, { "type": "object", "description": "Settings used by the Watson NLUConnector", "properties": { "apikey": { "type": "string", "description": "Apikey for accessing the Watson NLU Api" }, "workspaceid": { "type": "string", "description": "Skill ID for accessing the Assistant skill" }, "serviceURL": { "type": "string", "description": "The URL used to authenticate requests by Watson" } } }, { "type": "object", "description": "Settings used by the Lex NLUConnector", "properties": { "accessKeyId": { "type": "string", "description": "Apikey for accessing the Lex NLU Api" }, "secretAccessKey": { "type": "string", "description": "Secret Access Key for accessing the Lex NLU Api" }, "awsRegion": { "type": "string", "description": "The AWS region the Lex bot is deployed to" }, "botId": { "type": "string", "description": "Id of the Lex bot" }, "botAliasId": { "type": "string", "description": "Alias of the Lex bot" } } } ] }, "transformer": { "type": "object", "properties": { "abortOnError": { "type": "string", "description": "If true, then we will abort the message processing if the transformer throws an error. Otherwise, we will continue with normal message processing in the event of an error.", "example": false }, "transformerStackEnabled": { "type": "string", "description": "If true, then we will write the transformer stack in the input object, when the channel is adminconsole.", "example": false }, "transformer": { "type": "string", "description": "The transformer object as written by the user. This will be displayed in the UI since it includes typings." }, "preNluTransformerEnabled": { "type": "string", "example": false }, "postNluTransformerEnabled": { "type": "string", "example": false }, "nluCodeTransformerEnabled": { "type": "string", "example": false } } }, "referenceId": { "type": "string", "format": "uuid" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "get": { "operationId": "indexNLUConnectors_2_0", "summary": "Get NLUConnectors", "description": "Get 25 [NLU Connectors](https://docs.cognigy.com/ai/resources/build/nlu-connectors/) in a project by default. To change the default value, use the `limit` query parameter. Additionally, you can filter, sort, and paginate the results.", "tags": [ "NLUConnectors v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "query", "name": "projectId", "description": "Filter by projectId", "required": false, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "query", "name": "filter", "required": false, "schema": { "type": "string" }, "description": "The name of the NLU connector to filter the records" }, { "in": "query", "name": "limit", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100 }, "description": "The maximum number of items to return. The default is 25." }, { "in": "query", "name": "skip", "required": false, "schema": { "type": "integer", "minimum": 0 }, "description": "The number of items to skip. The default is 0. Used along with a limit of a pagination." }, { "in": "query", "name": "sort", "required": false, "schema": { "type": "string", "minLength": 1 }, "description": "The order of the sorting items-`Desc` (descending) or `Asc` (ascending). For example, to sort the records by name in ascending order, specify `name:Asc`." }, { "in": "query", "name": "next", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the nextCursor value from the response to get the next set of records. Used along with limit for pagination." }, { "in": "query", "name": "previous", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the previousCursor value from the response to get the previous set of records. Used along with limit for pagination." } ], "responses": { "200": { "description": "Returns array of a NLUConnector metadata objects", "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the NLUConnector", "example": "New NLUConnector" }, "referenceId": { "type": "string", "format": "uuid" }, "type": { "type": "string", "description": "The NLUConnector type", "example": "cognigy", "enum": [ "alexa", "dialogflow", "dialogflowBuiltIn", "amazonLexBuiltIn", "luis", "watson", "noNlu", "cognigy", "code", "generativeAI", "lex" ] }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" } }, "total": { "type": "integer", "example": 1 }, "next": { "oneOf": [ { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, { "nullable": true } ], "example": "5ce7c2d833ea1e04d7e6c432" }, "previous": { "oneOf": [ { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, { "nullable": true } ], "example": null } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/nluconnectors/{nluConnectorId}": { "delete": { "operationId": "deleteNLUConnector_2_0", "summary": "Delete an NLUConnector", "description": "Delete an [NLUConnector](doc:nluconnector).", "tags": [ "NLUConnectors v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "nluConnectorId", "description": "The Id of the NLUConnector", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "204": { "description": "Successfully deleted nluconnector" }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "get": { "operationId": "readNLUConnector_2_0", "summary": "Get an NLUConnector", "description": "Get a single [NLUConnector](doc:nluconnector) resource in a project.", "tags": [ "NLUConnectors v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "nluConnectorId", "description": "The Id of the NLUConnector", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "200": { "description": "Returns NLUConnector Object", "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the NLUConnector", "example": "New NLUConnector" }, "type": { "type": "string", "description": "The NLUConnector type", "example": "cognigy", "enum": [ "alexa", "dialogflow", "dialogflowBuiltIn", "amazonLexBuiltIn", "luis", "watson", "noNlu", "cognigy", "code", "generativeAI", "lex" ] }, "settings": { "oneOf": [ { "type": "object", "description": "Settings used by the Alexa NLUConnector", "properties": { "invocationName": { "type": "string", "description": "The invocation name of the Alexa skill. Necessary to start Alexa simulations." }, "reparseAlexaSlots": { "type": "boolean", "description": "Whether to reparse slots from Alexa with our own keyphrase mapper. Used by Alexa." }, "skill": { "type": "object", "properties": { "lastUpdated": { "type": "string", "description": "When the skill was last updated" }, "nameByLocale": { "type": "object", "description": "Gives the name of the skill for different locales", "properties": { "en-US": { "type": "string" }, "de-DE": { "type": "string" }, "ja-JP": { "type": "string" }, "en-GB": { "type": "string" }, "en-IN": { "type": "string" } } }, "skillId": { "type": "string", "description": "The unique id of the skill" }, "stage": { "type": "string", "description": "The current stage of the skills life cycle (e.g. is it in development, production..)" } } } } }, { "type": "object", "description": "Settings used by the DialogFlow NLUConnector", "properties": { "dialogflowApiVersion": { "type": "integer", "description": "The version of the dialogflow API to use.", "enum": [ 1, 2 ] }, "dialogflowProjectId": { "type": "string", "description": "The projectId of the Dialogflow Agent." }, "accessToken": { "description": "The access token used to authenticate requests. Used by DialogFlow.", "type": "string" }, "privateKey": { "type": "string", "description": "The private key of a Google Service Account that has the access right to use the Dialogflow API. It is stored as a string." } } }, { "type": "object", "description": "Settings used by the LUIS NLUConnector", "properties": { "authenticationURL": { "type": "string", "description": "The URL Used to authenticate requests by LUIS." } } }, { "type": "object", "description": "Settings used by the Watson NLUConnector", "properties": { "apikey": { "type": "string", "description": "Apikey for accessing the Watson NLU Api" }, "workspaceid": { "type": "string", "description": "Skill ID for accessing the Assistant skill" }, "serviceURL": { "type": "string", "description": "The URL used to authenticate requests by Watson" } } }, { "type": "object", "description": "Settings used by the Lex NLUConnector", "properties": { "accessKeyId": { "type": "string", "description": "Apikey for accessing the Lex NLU Api" }, "secretAccessKey": { "type": "string", "description": "Secret Access Key for accessing the Lex NLU Api" }, "awsRegion": { "type": "string", "description": "The AWS region the Lex bot is deployed to" }, "botId": { "type": "string", "description": "Id of the Lex bot" }, "botAliasId": { "type": "string", "description": "Alias of the Lex bot" } } } ] }, "transformer": { "type": "object", "properties": { "abortOnError": { "type": "string", "description": "If true, then we will abort the message processing if the transformer throws an error. Otherwise, we will continue with normal message processing in the event of an error.", "example": false }, "transformerStackEnabled": { "type": "string", "description": "If true, then we will write the transformer stack in the input object, when the channel is adminconsole.", "example": false }, "transformer": { "type": "string", "description": "The transformer object as written by the user. This will be displayed in the UI since it includes typings." }, "preNluTransformerEnabled": { "type": "string", "example": false }, "postNluTransformerEnabled": { "type": "string", "example": false }, "nluCodeTransformerEnabled": { "type": "string", "example": false } } }, "referenceId": { "type": "string", "format": "uuid" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "patch": { "operationId": "updateNLUConnector", "summary": "Update an NLUConnector", "description": "Update an [NLUConnector](doc:nluconnector) resource in a project.", "tags": [ "NLUConnectors v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "nluConnectorId", "description": "The Id of the NLUConnector", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the NLUConnector", "example": "New NLUConnector" }, "type": { "type": "string", "description": "The NLUConnector type", "example": "cognigy", "enum": [ "alexa", "dialogflow", "dialogflowBuiltIn", "amazonLexBuiltIn", "luis", "watson", "noNlu", "cognigy", "code", "generativeAI", "lex" ] }, "settings": { "oneOf": [ { "type": "object", "description": "Settings used by the Alexa NLUConnector", "properties": { "invocationName": { "type": "string", "description": "The invocation name of the Alexa skill. Necessary to start Alexa simulations." }, "reparseAlexaSlots": { "type": "boolean", "description": "Whether to reparse slots from Alexa with our own keyphrase mapper. Used by Alexa." }, "skill": { "type": "object", "properties": { "lastUpdated": { "type": "string", "description": "When the skill was last updated" }, "nameByLocale": { "type": "object", "description": "Gives the name of the skill for different locales", "properties": { "en-US": { "type": "string" }, "de-DE": { "type": "string" }, "ja-JP": { "type": "string" }, "en-GB": { "type": "string" }, "en-IN": { "type": "string" } } }, "skillId": { "type": "string", "description": "The unique id of the skill" }, "stage": { "type": "string", "description": "The current stage of the skills life cycle (e.g. is it in development, production..)" } } } } }, { "type": "object", "description": "Settings used by the DialogFlow NLUConnector", "properties": { "dialogflowApiVersion": { "type": "integer", "description": "The version of the dialogflow API to use.", "enum": [ 1, 2 ] }, "dialogflowProjectId": { "type": "string", "description": "The projectId of the Dialogflow Agent." }, "accessToken": { "description": "The access token used to authenticate requests. Used by DialogFlow.", "type": "string" }, "privateKey": { "type": "string", "description": "The private key of a Google Service Account that has the access right to use the Dialogflow API. It is stored as a string." } } }, { "type": "object", "description": "Settings used by the LUIS NLUConnector", "properties": { "authenticationURL": { "type": "string", "description": "The URL Used to authenticate requests by LUIS." } } }, { "type": "object", "description": "Settings used by the Watson NLUConnector", "properties": { "apikey": { "type": "string", "description": "Apikey for accessing the Watson NLU Api" }, "workspaceid": { "type": "string", "description": "Skill ID for accessing the Assistant skill" }, "serviceURL": { "type": "string", "description": "The URL used to authenticate requests by Watson" } } }, { "type": "object", "description": "Settings used by the Lex NLUConnector", "properties": { "accessKeyId": { "type": "string", "description": "Apikey for accessing the Lex NLU Api" }, "secretAccessKey": { "type": "string", "description": "Secret Access Key for accessing the Lex NLU Api" }, "awsRegion": { "type": "string", "description": "The AWS region the Lex bot is deployed to" }, "botId": { "type": "string", "description": "Id of the Lex bot" }, "botAliasId": { "type": "string", "description": "Alias of the Lex bot" } } } ] }, "transformer": { "type": "object", "properties": { "abortOnError": { "type": "string", "description": "If true, then we will abort the message processing if the transformer throws an error. Otherwise, we will continue with normal message processing in the event of an error.", "example": false }, "transformerStackEnabled": { "type": "string", "description": "If true, then we will write the transformer stack in the input object, when the channel is adminconsole.", "example": false }, "transformer": { "type": "string", "description": "The transformer object as written by the user. This will be displayed in the UI since it includes typings." }, "preNluTransformerEnabled": { "type": "string", "example": false }, "postNluTransformerEnabled": { "type": "string", "example": false }, "nluCodeTransformerEnabled": { "type": "string", "example": false } } } } } } } }, "responses": { "200": { "description": "Successfully updated NLUConnector" }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/optionsresolver": { "post": { "operationId": "optionsResolver_2_0", "summary": "Resolves the options for a field.", "description": "Resolves the options for a field.", "tags": [ "OptionsResolver v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "fieldKey": { "type": "string", "description": "The field key for which the options are to be resolved." }, "extension": { "type": "string", "description": "The extension name." }, "nodeType": { "type": "string", "description": "The node type which holds the options resolver field." }, "dependencies": { "type": "object", "description": "The dependency fields for the options resolver field." }, "projectId": { "type": "string", "description": "The project ID." } } } } } }, "responses": { "200": { "description": "Returns the resolved options for a field.", "content": { "application/json": { "schema": { "type": "object", "properties": { "options": { "type": "array", "items": { "type": "object", "properties": { "label": { "type": "string" }, "value": { "type": "string" } } } } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/packages/{packageId}/downloadlink": { "post": { "operationId": "composePackageDownloadLink", "summary": "Creates a download link to a Package", "description": "Creates a download link to a [Package](doc:package).", "tags": [ "Packages" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "packageId", "description": "The Id of the Package", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "200": { "description": "Returning a link to download the Package", "content": { "application/json": { "schema": { "type": "object", "properties": { "downloadLink": { "type": "string", "format": "uri" } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/packages": { "post": { "operationId": "createPackage_beta", "summary": "Create a Task to create a new Package", "description": "Create a Task to create a new [Package](doc:package)", "tags": [ "Packages" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the Package", "example": "New Package" }, "description": { "type": "string", "description": "The description of the Package", "example": "Version 1" }, "resourceIds": { "type": "array", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "projectId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } } } }, "responses": { "202": { "description": "Created a Task to create the Package.", "content": { "application/json": { "schema": { "type": "object", "properties": { "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "status": { "type": "string", "description": "The status of the task", "example": "queued", "enum": [ "queued", "active", "done", "cancelling", "cancelled", "error" ] }, "type": { "type": "string", "example": "trainIntents" }, "parameters": { "type": "object" }, "lastChangedAt": { "type": "number", "example": 1594243850 }, "lastCreatedAt": { "type": "number", "example": 1594243850 }, "currentStep": { "type": "integer", "example": 0 }, "totalStep": { "type": "integer", "example": 100 } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "get": { "operationId": "indexPackages_beta", "summary": "Get Packages", "description": "Get 25 [Packages](https://docs.cognigy.com/ai/resources/manage/packages/) in a project by default. To change the default value, use the `limit` query parameter. Additionally, you can filter, sort, and paginate the results.", "tags": [ "Packages" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "query", "name": "projectId", "description": "Filter by projectId", "required": false, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "query", "name": "filter", "required": false, "schema": { "type": "string" }, "description": "The name of the package to filter the records" }, { "in": "query", "name": "limit", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100 }, "description": "The maximum number of items to return. The default is 25." }, { "in": "query", "name": "skip", "required": false, "schema": { "type": "integer", "minimum": 0 }, "description": "The number of items to skip. The default is 0. Used along with a limit of a pagination." }, { "in": "query", "name": "sort", "required": false, "schema": { "type": "string", "minLength": 1 }, "description": "The order of the sorting items-`Desc` (descending) or `Asc` (ascending). For example, to sort the records by name in ascending order, specify `name:Asc`." }, { "in": "query", "name": "next", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the nextCursor value from the response to get the next set of records. Used along with limit for pagination." }, { "in": "query", "name": "previous", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the previousCursor value from the response to get the previous set of records. Used along with limit for pagination." } ], "responses": { "200": { "description": "Returns array of package metadata objects", "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "name": { "type": "string", "description": "The name of the Package", "example": "New Package" }, "description": { "type": "string", "description": "The description of the Package", "example": "Version 1" }, "hash": { "type": "string", "description": "The hash of the Package identifying the contents of the Package" }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 } } } }, "total": { "type": "integer", "example": 1 }, "next": { "oneOf": [ { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, { "nullable": true } ], "example": "5ce7c2d833ea1e04d7e6c432" }, "previous": { "oneOf": [ { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, { "nullable": true } ], "example": null } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/packages/{packageId}": { "delete": { "operationId": "deletePackage_beta", "summary": "Create a Task to delete a Package", "description": "Create a Task to delete a [Package](doc:package).", "tags": [ "Packages" ], "parameters": [ { "in": "path", "name": "packageId", "description": "The Id of the Package", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "202": { "description": "Successfully created Task to delete the Package.", "content": { "application/json": { "schema": { "type": "object", "properties": { "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "status": { "type": "string", "description": "The status of the task", "example": "queued", "enum": [ "queued", "active", "done", "cancelling", "cancelled", "error" ] }, "type": { "type": "string", "example": "trainIntents" }, "parameters": { "type": "object" }, "lastChangedAt": { "type": "number", "example": 1594243850 }, "lastCreatedAt": { "type": "number", "example": 1594243850 }, "currentStep": { "type": "integer", "example": 0 }, "totalStep": { "type": "integer", "example": 100 } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "get": { "operationId": "readPackage_beta", "summary": "Get a Package", "description": "Get a single [Package](doc:package).", "tags": [ "Packages" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "packageId", "description": "The Id of the Package", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "200": { "description": "Returns Package Object", "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the Package", "example": "New Package" }, "description": { "type": "string", "description": "The description of the Package", "example": "Version 1" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "hash": { "type": "string", "description": "The hash identifying the contents of the Package", "example": "Version 1" }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/packages/{packageId}/merge": { "post": { "operationId": "mergePackage_beta", "summary": "Created a Task to merge a Package", "description": "Created a Task to merge a [Package](doc:package).", "tags": [ "Packages" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "packageId", "description": "The Id of the Package", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "resourceIds" ], "properties": { "resourceIds": { "type": "array", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "strategies": { "type": "array", "items": { "type": "object", "properties": { "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "rename": { "type": "string", "description": "explicitly sets a new name for the imported resource", "example": "new flow" }, "autoRename": { "type": "boolean", "description": "If set to true, will append a \"counter-suffix\" to the name in\ncase the name already exists in the agent.\n", "default": true, "example": true }, "identityConflictStrategy": { "type": "string", "description": "Defines what should be done in case the agent already contains a resource\nwith the same id.\n", "default": "abort", "enum": [ "replace", "re-identify", "abort", "merge" ] }, "mergeStrategy": { "type": "object", "properties": { "replaceContent": { "type": "boolean" }, "replaceStructure": { "type": "boolean" }, "localeOverrides": { "type": "array", "items": { "type": "object", "properties": { "replaceContent": { "type": "boolean" }, "localeId": { "type": "string" } } } } } } } } }, "localeMapping": { "type": "array", "items": { "type": "object", "properties": { "agentLocaleId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "packageLocaleId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } } } } } } }, "responses": { "202": { "description": "Successfully created a Task to merge the Package.", "content": { "application/json": { "schema": { "type": "object", "properties": { "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "status": { "type": "string", "description": "The status of the task", "example": "queued", "enum": [ "queued", "active", "done", "cancelling", "cancelled", "error" ] }, "type": { "type": "string", "example": "trainIntents" }, "parameters": { "type": "object" }, "lastChangedAt": { "type": "number", "example": 1594243850 }, "lastCreatedAt": { "type": "number", "example": 1594243850 }, "currentStep": { "type": "integer", "example": 0 }, "totalStep": { "type": "integer", "example": 100 } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/packages/upload": { "post": { "operationId": "uploadPackage_beta", "summary": "Upload a Package", "description": "Upload a [Package](doc:package) and create a task to process it.", "tags": [ "Packages" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" } ], "requestBody": { "required": true, "content": { "multipart/form-data": { "schema": { "type": "object", "properties": { "projectId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "file": { "type": "string", "format": "binary" } } } } } }, "responses": { "202": { "description": "Successfully uploaded the Package and created a Task to process it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "status": { "type": "string", "description": "The status of the task", "example": "queued", "enum": [ "queued", "active", "done", "cancelling", "cancelled", "error" ] }, "type": { "type": "string", "example": "trainIntents" }, "parameters": { "type": "object" }, "lastChangedAt": { "type": "number", "example": 1594243850 }, "lastCreatedAt": { "type": "number", "example": 1594243850 }, "currentStep": { "type": "integer", "example": 0 }, "totalStep": { "type": "integer", "example": 100 } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/playbooks": { "patch": { "operationId": "batchPlaybooks_2_0", "summary": "Batch Operations on Playbooks", "description": "Batch Operations on Playbooks.", "tags": [ "Playbooks v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "query", "name": "projectId", "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "operations": { "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "op": { "type": "string", "enum": [ "delete" ] }, "id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } }, { "type": "object", "properties": { "op": { "type": "string", "enum": [ "create" ] }, "value": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the Playbook", "example": "New Playbook" }, "abortOnError": { "type": "boolean", "description": "Flag wheter to stop Playbook execution when an assert-error occured" }, "timeout": { "type": "integer", "description": "A time (in ms) after which a playbook step is 'invalid/failed'", "example": 2000, "minimum": 1 } } } } }, { "type": "object", "properties": { "op": { "type": "string", "enum": [ "update" ] }, "id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "value": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the Playbook", "example": "New Playbook" }, "abortOnError": { "type": "boolean", "description": "Flag wheter to stop Playbook execution when an assert-error occured" }, "timeout": { "type": "integer", "description": "A time (in ms) after which a playbook step is 'invalid/failed'", "example": 2000, "minimum": 1 } } } } } ] } } } } } } }, "responses": { "200": { "description": "Successfully ran the batch operations.", "content": { "application/json": { "schema": { "type": "object", "properties": { "created": { "type": "array", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "updated": { "type": "array", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "deleted": { "type": "array", "items": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "post": { "operationId": "createPlaybook_2_0", "summary": "Create a new Playbook", "description": "Create a new [Playbook](doc:playbook) resource in a project.", "tags": [ "Playbooks v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "query", "name": "projectId", "description": "Filter by projectId", "required": false, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "query", "name": "resourceId", "description": "An Id of a resource within the corresponding project to copy from", "required": false, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the Playbook", "example": "New Playbook" }, "abortOnError": { "type": "boolean", "description": "Flag wheter to stop Playbook execution when an assert-error occured" }, "timeout": { "type": "integer", "description": "A time (in ms) after which a playbook step is 'invalid/failed'", "example": 2000, "minimum": 1 }, "projectId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } } } }, "responses": { "201": { "description": "Returns Playbook metadata object.", "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the Playbook", "example": "New Playbook" }, "abortOnError": { "type": "boolean", "description": "Flag wheter to stop Playbook execution when an assert-error occured" }, "timeout": { "type": "integer", "description": "A time (in ms) after which a playbook step is 'invalid/failed'", "example": 2000, "minimum": 1 }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "steps": { "type": "array", "items": { "type": "object", "properties": { "text": { "type": "string", "description": "The text of the playbook step", "example": "hello world!" }, "data": { "type": "string", "description": "The data of this playbook step", "example": {} }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "asserts": { "type": "array", "items": { "type": "object", "properties": { "text": { "type": "string", "description": "The text of the playbook step", "example": "hello world!" }, "data": { "type": "string", "description": "The data of this playbook step", "example": {} }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } } } } } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "get": { "operationId": "indexPlaybooks_2_0", "summary": "Get Playbooks", "description": "Get 25 [Playbooks](https://docs.cognigy.com/ai/resources/test/playbooks/) in a project by default. To change the default value, use the `limit` query parameter. Additionally, you can filter, sort, and paginate the results.", "tags": [ "Playbooks v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "query", "name": "projectId", "description": "Filter by projectId", "required": false, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "query", "name": "filter", "required": false, "schema": { "type": "string" }, "description": "The name of the playbook to filter the records" }, { "in": "query", "name": "limit", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100 }, "description": "The maximum number of items to return. The default is 25." }, { "in": "query", "name": "skip", "required": false, "schema": { "type": "integer", "minimum": 0 }, "description": "The number of items to skip. The default is 0. Used along with a limit of a pagination." }, { "in": "query", "name": "sort", "required": false, "schema": { "type": "string", "minLength": 1 }, "description": "The order of the sorting items-`Desc` (descending) or `Asc` (ascending). For example, to sort the records by name in ascending order, specify `name:Asc`." }, { "in": "query", "name": "next", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the nextCursor value from the response to get the next set of records. Used along with limit for pagination." }, { "in": "query", "name": "previous", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the previousCursor value from the response to get the previous set of records. Used along with limit for pagination." } ], "responses": { "200": { "description": "Returns array of a Playbook metadata objects", "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the playbook", "example": "New Playbook" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" } }, "total": { "type": "integer", "example": 1 }, "next": { "oneOf": [ { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, { "nullable": true } ], "example": "5ce7c2d833ea1e04d7e6c432" }, "previous": { "oneOf": [ { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, { "nullable": true } ], "example": null } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/playbooks/{playbookId}/steps/order": { "post": { "operationId": "changePlaybookStepOrder_2_0", "summary": "Change the order of the steps", "description": "Change the order of the [Steps](doc:playbook)", "tags": [ "Playbooks v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "playbookId", "description": "The Id of the Playbook", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "sentenceIds": { "type": "string" } } } } } }, "responses": { "204": { "description": "Successfully changed the order of the Playbook" }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/playbooks/{playbookId}/steps": { "post": { "operationId": "createPlaybookStep_2_0", "summary": "Create a new Playbook Step", "description": "Create a new [Step](doc:playbook) in a Playbook.", "tags": [ "Playbooks v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "playbookId", "description": "The Id of the Playbook", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "text": { "type": "string", "description": "The text of the playbook step", "example": "hello world!" }, "data": { "type": "string", "description": "The data of this playbook step", "example": {} } } } } } }, "responses": { "201": { "description": "Returns Playbook metadata object.", "content": { "application/json": { "schema": { "type": "object", "properties": { "text": { "type": "string", "description": "The text of the playbook step", "example": "hello world!" }, "data": { "type": "string", "description": "The data of this playbook step", "example": {} }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "asserts": { "type": "array", "items": { "type": "object", "properties": { "text": { "type": "string", "description": "The text of the playbook step", "example": "hello world!" }, "data": { "type": "string", "description": "The data of this playbook step", "example": {} }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/playbooks/{playbookId}/steps/{stepId}/asserts": { "post": { "operationId": "createPlaybookStepAssert_2_0", "summary": "Create a new Playbook Step Assert", "description": "Create a new [Assert](doc:playbook) in a Playbook Step.", "tags": [ "Playbooks v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "playbookId", "description": "The Id of the Playbook", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "path", "name": "stepId", "description": "The Id of the Playbook Step", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "description": "The type of the Assert", "enum": [ "assertText", "assertData", "assertState", "assertContext", "assertIntent", "assertSlot" ] }, "params": { "type": "object" } } } } } }, "responses": { "201": { "description": "Returns Playbook metadata object.", "content": { "application/json": { "schema": { "type": "object", "properties": { "text": { "type": "string", "description": "The text of the playbook step", "example": "hello world!" }, "data": { "type": "string", "description": "The data of this playbook step", "example": {} }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/playbooks/{playbookId}": { "delete": { "operationId": "deletePlaybook_2_0", "summary": "Delete a Playbook", "description": "Delete a [Playbook](doc:playbook) resource in a project.", "tags": [ "Playbooks v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "playbookId", "description": "The Id of the Playbook", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "204": { "description": "Successfully deleted the Playbook" }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "get": { "operationId": "readPlaybook_2_0", "summary": "Get a Playbook", "description": "Get a single [Playbook](doc:playbook) resource in a project.", "tags": [ "Playbooks v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "playbookId", "description": "The Id of the Playbook", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "200": { "description": "Returns Playbook Object", "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the Playbook", "example": "New Playbook" }, "abortOnError": { "type": "boolean", "description": "Flag wheter to stop Playbook execution when an assert-error occured" }, "timeout": { "type": "integer", "description": "A time (in ms) after which a playbook step is 'invalid/failed'", "example": 2000, "minimum": 1 }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "steps": { "type": "array", "items": { "type": "object", "properties": { "text": { "type": "string", "description": "The text of the playbook step", "example": "hello world!" }, "data": { "type": "string", "description": "The data of this playbook step", "example": {} }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "asserts": { "type": "array", "items": { "type": "object", "properties": { "text": { "type": "string", "description": "The text of the playbook step", "example": "hello world!" }, "data": { "type": "string", "description": "The data of this playbook step", "example": {} }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } } } } } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "patch": { "operationId": "updatePlaybook_2_0", "summary": "Update a Playbook", "description": "Update a [Playbook](doc:playbook) resource in a project.", "tags": [ "Playbooks v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "playbookId", "description": "The Id of the Playbook", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the Playbook", "example": "New Playbook" }, "abortOnError": { "type": "boolean", "description": "Flag wheter to stop Playbook execution when an assert-error occured" }, "timeout": { "type": "integer", "description": "A time (in ms) after which a playbook step is 'invalid/failed'", "example": 2000, "minimum": 1 } } } } } }, "responses": { "204": { "description": "Successfully updated the Playbook." }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/playbooks/{playbookId}/runs/{playbookRunId}": { "delete": { "operationId": "deletePlaybookRun_2_0", "summary": "Delete a Playbook Run", "description": "Deletes a Playbook Run from a project.", "tags": [ "Playbooks v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "playbookId", "description": "The Id of the Playbook", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "path", "name": "playbookRunId", "description": "The Id of the Playbook Run", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "204": { "description": "Successfully deleted the Playbook Run" }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "get": { "operationId": "readPlaybookRun_2_0", "summary": "Returns a Playbook Run", "description": "Returns all properties of a Playbook Run in a project.", "tags": [ "Playbooks v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "playbookId", "description": "The Id of the Playbook", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "path", "name": "playbookRunId", "description": "The Id of the Playbook Run", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "200": { "description": "Returns Playbook Run object", "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "type": "string", "enum": [ "successful", "failed" ], "description": "Whether the playbook run was successful or failed", "example": "successful" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "stepResults": { "type": "array", "items": { "type": "object", "properties": { "status": { "type": "string", "enum": [ "successful", "failed" ], "description": "Whether this playbook step was successful or failed", "example": "failed" }, "text": { "type": "string", "description": "Text which we shoot into the system", "example": "Hello, how are you?" }, "data": { "type": "object", "description": "Data which we shoot into the system" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "asserts": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "string", "description": "Type of the assert", "example": "assertText" }, "status": { "type": "string", "enum": [ "successful", "failed" ], "description": "Whether this playbook step was successful or failed", "example": "failed" }, "params": { "type": "object", "description": "Parameters for the assert" }, "negate": { "type": "boolean", "description": "Whether the assert was negated", "example": false }, "actual": { "type": "object", "description": "Actual output" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } } } } }, "flowId": { "type": "string", "description": "Reference Id of the flow", "example": "uuid" }, "localeId": { "type": "string", "description": "Reference Id of the locale", "example": "uuid" }, "entrypoint": { "type": "string", "description": "snapshot or project ID", "example": "^[a-z0-9]{24}$" } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/playbooks/{playbookId}/steps/{stepId}": { "delete": { "operationId": "deletePlaybookStep_2_0", "summary": "Delete a Playbook Step", "description": "Delete a [Step](doc:playbook) in a Playbook.", "tags": [ "Playbooks v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "playbookId", "description": "The Id of the Playbook", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "path", "name": "stepId", "description": "The Id of the Playbook Step", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "204": { "description": "Successfully deleted the Playbook Step" }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "patch": { "operationId": "updatePlaybookStepAssert_2_0", "summary": "Update a Playbook Step Assert", "description": "Update an [Assert](doc:playbook) in a Playbook.", "tags": [ "Playbooks v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "playbookId", "description": "The Id of the Playbook", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "path", "name": "stepId", "description": "The Id of the Playbook Step", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "text": { "type": "string", "description": "The text of the playbook step", "example": "hello world!" }, "data": { "type": "string", "description": "The data of this playbook step", "example": {} }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } } } }, "responses": { "204": { "description": "Successfully updated the PlaybookStepAssert" }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/playbooks/{playbookId}/steps/{stepId}/asserts/{assertId}": { "delete": { "operationId": "deletePlaybookStepAssert_2_0", "summary": "Delete a Playbook Step Assert", "description": "Delete an [Assert](doc:playbook) in a Playbook Step.", "tags": [ "Playbooks v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "playbookId", "description": "The Id of the Playbook", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "path", "name": "stepId", "description": "The Id of the Playbook Step", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "path", "name": "assertId", "description": "The Id of the Playbook Step Assert", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "204": { "description": "Successfully deleted the Playbook Step Assert" }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/playbooks/{playbookId}/runs": { "get": { "operationId": "indexPlaybookRuns_2_0", "summary": "Returns meta-data for all Playbook Runs", "description": "Returns paginated meta-data for all Playbook Run in a project.", "tags": [ "Playbooks v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "query", "name": "projectId", "description": "Filter by projectId", "required": false, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "query", "name": "filter", "required": false, "schema": { "type": "string" }, "description": "Filter records by specific field eg:name." }, { "in": "query", "name": "limit", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100 }, "description": "The maximum number of items to return. The default is 25." }, { "in": "query", "name": "skip", "required": false, "schema": { "type": "integer", "minimum": 0 }, "description": "The number of items to skip. The default is 0. Used along with a limit of a pagination." }, { "in": "query", "name": "sort", "required": false, "schema": { "type": "string", "minLength": 1 }, "description": "The order of the sorting items-`Desc` (descending) or `Asc` (ascending). For example, to sort the records by name in ascending order, specify `name:Asc`." }, { "in": "query", "name": "next", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the nextCursor value from the response to get the next set of records. Used along with limit for pagination." }, { "in": "query", "name": "previous", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the previousCursor value from the response to get the previous set of records. Used along with limit for pagination." }, { "in": "path", "name": "playbookId", "description": "The Id of the Playbook", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "200": { "description": "Returns array of Playbook Run metadata objects", "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n", "properties": { "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "status": { "type": "string", "enum": [ "successful", "failed" ], "description": "Status of the whole Playbook Run", "example": "successful" } } } }, "total": { "type": "integer", "example": 1 }, "next": { "oneOf": [ { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, { "nullable": true } ], "example": "5ce7c2d833ea1e04d7e6c432" }, "previous": { "oneOf": [ { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, { "nullable": true } ], "example": null } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/playbooks/{playbookId}/schedule": { "post": { "operationId": "schedulePlaybookRun_2_0", "summary": "Schedule a Playbook Run via task-manager", "description": "Returns the taskId and starts a new Playbook Run.", "tags": [ "Playbooks v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "playbookId", "description": "The Id of the Playbook", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "entrypoint": { "type": "string", "description": "snapshot or project ID", "example": "61f25579055c2f43c249a181" }, "flowId": { "type": "string", "description": "The reference ID of the flow", "example": "010d1970-89b9-4012-892b-53c78ef6c117" }, "localeId": { "type": "string", "description": "The reference ID of locale", "example": "8b3b45e2-48f9-446d-a4c5-35d8284a01b2" } } } } } }, "responses": { "204": { "description": "Successfully scheduled the Playbook Run." }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/projects": { "post": { "operationId": "createProject_2_0", "summary": "Create a new Project", "description": "Create a new [Project](doc:project) resource in a project.", "tags": [ "Projects v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the Project", "example": "New Project" }, "color": { "type": "string", "example": "blue", "oneOf": [ { "type": "string", "example": "none", "enum": [ "aliceBlue", "antiqueWhite", "aqua", "aquamarine", "azure", "beige", "bisque", "black", "blanchedAlmond", "blue", "blueViolet", "brown", "burlyWood", "cadetBlue", "chartreuse", "chocolate", "coral", "cornflowerBlue", "cornsilk", "crimson", "cyan", "darkBlue", "darkCyan", "darkGoldenRod", "darkGray", "darkGrey", "darkGreen", "darkKhaki", "darkMagenta", "darkOliveGreen", "darkOrange", "darkOrchid", "darkRed", "darkSalmon", "darkSeaGreen", "darkSlateBlue", "darkSlateGray", "darkSlateGrey", "darkTurquoise", "darkViolet", "deepPink", "deepSkyBlue", "dimGray", "dimGrey", "dodgerBlue", "fireBrick", "floralWhite", "forestGreen", "fuchsia", "gainsboro", "ghostWhite", "gold", "goldenRod", "gray", "grey", "green", "greenYellow", "honeyDew", "hotPink", "indianRed", "indigo", "ivory", "khaki", "lavender", "lavenderBlush", "lawnGreen", "lemonChiffon", "lightBlue", "lightCoral", "lightCyan", "lightGoldenRodYellow", "lightGray", "lightGrey", "lightGreen", "lightPink", "lightSalmon", "lightSeaGreen", "lightSkyBlue", "lightSlateGray", "lightSlateGrey", "lightSteelBlue", "lightYellow", "lime", "limeGreen", "linen", "magenta", "maroon", "mediumAquaMarine", "mediumBlue", "mediumOrchid", "mediumPurple", "mediumSeaGreen", "mediumSlateBlue", "mediumSpringGreen", "mediumTurquoise", "mediumVioletRed", "midnightBlue", "mintCream", "mistyRose", "moccasin", "navajoWhite", "navy", "oldLace", "olive", "oliveDrab", "orange", "orangeRed", "orchid", "paleGoldenRod", "paleGreen", "paleTurquoise", "paleVioletRed", "papayaWhip", "peachPuff", "peru", "pink", "plum", "powderBlue", "purple", "rebeccaPurple", "red", "rosyBrown", "royalBlue", "saddleBrown", "salmon", "sandyBrown", "seaGreen", "seaShell", "sienna", "silver", "skyBlue", "slateBlue", "slateGray", "slateGrey", "snow", "springGreen", "steelBlue", "tan", "teal", "thistle", "tomato", "turquoise", "violet", "wheat", "white", "whiteSmoke", "yellow", "yellowGreen", "none", "transparent" ] }, { "type": "string", "example": "cognigyGrey", "enum": [ "amber", "blueGrey", "cognigyBlue", "cognigyGrey", "deepOrange", "deepPurple", "lightBlue", "lightGreen" ] } ] }, "handoverConfiguration": { "type": "object", "properties": { "setupLiveAgentInbox": { "type": "boolean" }, "whisperAssistConfiguration": { "type": "string", "enum": [ "none", "basic", "template" ] } } }, "locale": { "type": "string", "example": "en-US", "enum": [ "ge-GE", "da-DK", "en-AU", "en-CA", "en-IN", "en-GB", "en-US", "de-DE", "ja-JP", "ko-KR", "es-ES", "nl-NL", "ar-AE", "fi-FI", "fr-FR", "it-IT", "nn-NO", "pl-PL", "sv-SE", "th-TH", "zh-CN", "vi-VN", "pt-BR", "ru-RU", "pt-PT", "tr-TR", "hi-IN", "bn-IN", "ta-IN" ] } } } } } }, "responses": { "201": { "description": "Returns Project", "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the Project", "example": "New Project" }, "color": { "type": "string", "example": "blue", "oneOf": [ { "type": "string", "example": "none", "enum": [ "aliceBlue", "antiqueWhite", "aqua", "aquamarine", "azure", "beige", "bisque", "black", "blanchedAlmond", "blue", "blueViolet", "brown", "burlyWood", "cadetBlue", "chartreuse", "chocolate", "coral", "cornflowerBlue", "cornsilk", "crimson", "cyan", "darkBlue", "darkCyan", "darkGoldenRod", "darkGray", "darkGrey", "darkGreen", "darkKhaki", "darkMagenta", "darkOliveGreen", "darkOrange", "darkOrchid", "darkRed", "darkSalmon", "darkSeaGreen", "darkSlateBlue", "darkSlateGray", "darkSlateGrey", "darkTurquoise", "darkViolet", "deepPink", "deepSkyBlue", "dimGray", "dimGrey", "dodgerBlue", "fireBrick", "floralWhite", "forestGreen", "fuchsia", "gainsboro", "ghostWhite", "gold", "goldenRod", "gray", "grey", "green", "greenYellow", "honeyDew", "hotPink", "indianRed", "indigo", "ivory", "khaki", "lavender", "lavenderBlush", "lawnGreen", "lemonChiffon", "lightBlue", "lightCoral", "lightCyan", "lightGoldenRodYellow", "lightGray", "lightGrey", "lightGreen", "lightPink", "lightSalmon", "lightSeaGreen", "lightSkyBlue", "lightSlateGray", "lightSlateGrey", "lightSteelBlue", "lightYellow", "lime", "limeGreen", "linen", "magenta", "maroon", "mediumAquaMarine", "mediumBlue", "mediumOrchid", "mediumPurple", "mediumSeaGreen", "mediumSlateBlue", "mediumSpringGreen", "mediumTurquoise", "mediumVioletRed", "midnightBlue", "mintCream", "mistyRose", "moccasin", "navajoWhite", "navy", "oldLace", "olive", "oliveDrab", "orange", "orangeRed", "orchid", "paleGoldenRod", "paleGreen", "paleTurquoise", "paleVioletRed", "papayaWhip", "peachPuff", "peru", "pink", "plum", "powderBlue", "purple", "rebeccaPurple", "red", "rosyBrown", "royalBlue", "saddleBrown", "salmon", "sandyBrown", "seaGreen", "seaShell", "sienna", "silver", "skyBlue", "slateBlue", "slateGray", "slateGrey", "snow", "springGreen", "steelBlue", "tan", "teal", "thistle", "tomato", "turquoise", "violet", "wheat", "white", "whiteSmoke", "yellow", "yellowGreen", "none", "transparent" ] }, { "type": "string", "example": "cognigyGrey", "enum": [ "amber", "blueGrey", "cognigyBlue", "cognigyGrey", "deepOrange", "deepPurple", "lightBlue", "lightGreen" ] } ] }, "handoverConfiguration": { "type": "object", "properties": { "setupLiveAgentInbox": { "type": "boolean" }, "whisperAssistConfiguration": { "type": "string", "enum": [ "none", "basic", "template" ] } } }, "liveAgentDefaultInbox": { "type": "number", "description": "Live agent default inbox Id for the project" }, "primaryLocaleReference": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "get": { "operationId": "indexProjects_2_0", "summary": "Get Projects", "description": "Get 25 [Projects](https://docs.cognigy.com/ai/resources/agents/agents/) by default. To change the default value, use the `limit` query parameter. Additionally, you can filter, sort, and paginate the results.", "tags": [ "Projects v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "query", "name": "filter", "required": false, "schema": { "type": "string" }, "description": "The name of the project to filter the records" }, { "in": "query", "name": "limit", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100 }, "description": "The maximum number of items to return. The default is 25." }, { "in": "query", "name": "skip", "required": false, "schema": { "type": "integer", "minimum": 0 }, "description": "The number of items to skip. The default is 0. Used along with a limit of a pagination." }, { "in": "query", "name": "sort", "required": false, "schema": { "type": "string", "minLength": 1 }, "description": "The order of the sorting items-`Desc` (descending) or `Asc` (ascending). For example, to sort the records by name in ascending order, specify `name:Asc`." }, { "in": "query", "name": "next", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the nextCursor value from the response to get the next set of records. Used along with limit for pagination." }, { "in": "query", "name": "previous", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the previousCursor value from the response to get the previous set of records. Used along with limit for pagination." }, { "in": "query", "description": "If the requester is admin, then with ignoreOwnership true all projects within the organisation will be listed", "name": "ignoreOwnership", "required": false, "schema": { "type": "boolean" }, "example": false } ], "responses": { "200": { "description": "Returns an array of Projects", "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the Project", "example": "New Project" }, "color": { "type": "string", "example": "blue", "oneOf": [ { "type": "string", "example": "none", "enum": [ "aliceBlue", "antiqueWhite", "aqua", "aquamarine", "azure", "beige", "bisque", "black", "blanchedAlmond", "blue", "blueViolet", "brown", "burlyWood", "cadetBlue", "chartreuse", "chocolate", "coral", "cornflowerBlue", "cornsilk", "crimson", "cyan", "darkBlue", "darkCyan", "darkGoldenRod", "darkGray", "darkGrey", "darkGreen", "darkKhaki", "darkMagenta", "darkOliveGreen", "darkOrange", "darkOrchid", "darkRed", "darkSalmon", "darkSeaGreen", "darkSlateBlue", "darkSlateGray", "darkSlateGrey", "darkTurquoise", "darkViolet", "deepPink", "deepSkyBlue", "dimGray", "dimGrey", "dodgerBlue", "fireBrick", "floralWhite", "forestGreen", "fuchsia", "gainsboro", "ghostWhite", "gold", "goldenRod", "gray", "grey", "green", "greenYellow", "honeyDew", "hotPink", "indianRed", "indigo", "ivory", "khaki", "lavender", "lavenderBlush", "lawnGreen", "lemonChiffon", "lightBlue", "lightCoral", "lightCyan", "lightGoldenRodYellow", "lightGray", "lightGrey", "lightGreen", "lightPink", "lightSalmon", "lightSeaGreen", "lightSkyBlue", "lightSlateGray", "lightSlateGrey", "lightSteelBlue", "lightYellow", "lime", "limeGreen", "linen", "magenta", "maroon", "mediumAquaMarine", "mediumBlue", "mediumOrchid", "mediumPurple", "mediumSeaGreen", "mediumSlateBlue", "mediumSpringGreen", "mediumTurquoise", "mediumVioletRed", "midnightBlue", "mintCream", "mistyRose", "moccasin", "navajoWhite", "navy", "oldLace", "olive", "oliveDrab", "orange", "orangeRed", "orchid", "paleGoldenRod", "paleGreen", "paleTurquoise", "paleVioletRed", "papayaWhip", "peachPuff", "peru", "pink", "plum", "powderBlue", "purple", "rebeccaPurple", "red", "rosyBrown", "royalBlue", "saddleBrown", "salmon", "sandyBrown", "seaGreen", "seaShell", "sienna", "silver", "skyBlue", "slateBlue", "slateGray", "slateGrey", "snow", "springGreen", "steelBlue", "tan", "teal", "thistle", "tomato", "turquoise", "violet", "wheat", "white", "whiteSmoke", "yellow", "yellowGreen", "none", "transparent" ] }, { "type": "string", "example": "cognigyGrey", "enum": [ "amber", "blueGrey", "cognigyBlue", "cognigyGrey", "deepOrange", "deepPurple", "lightBlue", "lightGreen" ] } ] }, "handoverConfiguration": { "type": "object", "properties": { "setupLiveAgentInbox": { "type": "boolean" }, "whisperAssistConfiguration": { "type": "string", "enum": [ "none", "basic", "template" ] } } }, "liveAgentDefaultInbox": { "type": "number", "description": "Live agent default inbox Id for the project" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" } }, "total": { "type": "integer", "example": 1 }, "next": { "oneOf": [ { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, { "nullable": true } ], "example": "5ce7c2d833ea1e04d7e6c432" }, "previous": { "oneOf": [ { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, { "nullable": true } ], "example": null } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/projects/createbytemplate": { "post": { "operationId": "createProjectByTemplate_2_0", "summary": "Create a new Project based on a template", "description": "Create a new [Project](doc:project) resource in a project based on a template.", "tags": [ "Projects v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the Project", "example": "New Project" }, "color": { "type": "string", "example": "blue", "oneOf": [ { "type": "string", "example": "none", "enum": [ "aliceBlue", "antiqueWhite", "aqua", "aquamarine", "azure", "beige", "bisque", "black", "blanchedAlmond", "blue", "blueViolet", "brown", "burlyWood", "cadetBlue", "chartreuse", "chocolate", "coral", "cornflowerBlue", "cornsilk", "crimson", "cyan", "darkBlue", "darkCyan", "darkGoldenRod", "darkGray", "darkGrey", "darkGreen", "darkKhaki", "darkMagenta", "darkOliveGreen", "darkOrange", "darkOrchid", "darkRed", "darkSalmon", "darkSeaGreen", "darkSlateBlue", "darkSlateGray", "darkSlateGrey", "darkTurquoise", "darkViolet", "deepPink", "deepSkyBlue", "dimGray", "dimGrey", "dodgerBlue", "fireBrick", "floralWhite", "forestGreen", "fuchsia", "gainsboro", "ghostWhite", "gold", "goldenRod", "gray", "grey", "green", "greenYellow", "honeyDew", "hotPink", "indianRed", "indigo", "ivory", "khaki", "lavender", "lavenderBlush", "lawnGreen", "lemonChiffon", "lightBlue", "lightCoral", "lightCyan", "lightGoldenRodYellow", "lightGray", "lightGrey", "lightGreen", "lightPink", "lightSalmon", "lightSeaGreen", "lightSkyBlue", "lightSlateGray", "lightSlateGrey", "lightSteelBlue", "lightYellow", "lime", "limeGreen", "linen", "magenta", "maroon", "mediumAquaMarine", "mediumBlue", "mediumOrchid", "mediumPurple", "mediumSeaGreen", "mediumSlateBlue", "mediumSpringGreen", "mediumTurquoise", "mediumVioletRed", "midnightBlue", "mintCream", "mistyRose", "moccasin", "navajoWhite", "navy", "oldLace", "olive", "oliveDrab", "orange", "orangeRed", "orchid", "paleGoldenRod", "paleGreen", "paleTurquoise", "paleVioletRed", "papayaWhip", "peachPuff", "peru", "pink", "plum", "powderBlue", "purple", "rebeccaPurple", "red", "rosyBrown", "royalBlue", "saddleBrown", "salmon", "sandyBrown", "seaGreen", "seaShell", "sienna", "silver", "skyBlue", "slateBlue", "slateGray", "slateGrey", "snow", "springGreen", "steelBlue", "tan", "teal", "thistle", "tomato", "turquoise", "violet", "wheat", "white", "whiteSmoke", "yellow", "yellowGreen", "none", "transparent" ] }, { "type": "string", "example": "cognigyGrey", "enum": [ "amber", "blueGrey", "cognigyBlue", "cognigyGrey", "deepOrange", "deepPurple", "lightBlue", "lightGreen" ] } ] }, "handoverConfiguration": { "type": "object", "properties": { "setupLiveAgentInbox": { "type": "boolean" }, "whisperAssistConfiguration": { "type": "string", "enum": [ "none", "basic", "template" ] } } }, "locale": { "type": "string", "example": "en-US", "enum": [ "ge-GE", "da-DK", "en-AU", "en-CA", "en-IN", "en-GB", "en-US", "de-DE", "ja-JP", "ko-KR", "es-ES", "nl-NL", "ar-AE", "fi-FI", "fr-FR", "it-IT", "nn-NO", "pl-PL", "sv-SE", "th-TH", "zh-CN", "vi-VN", "pt-BR", "ru-RU", "pt-PT", "tr-TR", "hi-IN", "bn-IN", "ta-IN" ] }, "templateConfiguration": { "type": "object", "properties": { "endpoints": { "type": "array", "items": { "type": "object", "properties": { "channel": { "type": "string" } } } }, "skills": { "type": "array", "items": { "type": "string" } }, "template": { "type": "string" } } } } } } } }, "responses": { "202": { "description": "Successfully created Task to create Project by template", "content": { "application/json": { "schema": { "type": "object", "properties": { "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "status": { "type": "string", "description": "The status of the task", "example": "queued", "enum": [ "queued", "active", "done", "cancelling", "cancelled", "error" ] }, "type": { "type": "string", "example": "trainIntents" }, "parameters": { "type": "object" }, "lastChangedAt": { "type": "number", "example": 1594243850 }, "lastCreatedAt": { "type": "number", "example": 1594243850 }, "currentStep": { "type": "integer", "example": 0 }, "totalStep": { "type": "integer", "example": 100 } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/projects/{projectId}": { "delete": { "operationId": "deleteProject_2_0", "summary": "Delete a Project", "description": "Delete a [Project](doc:project) resource in a project.", "tags": [ "Projects v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "projectId", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "202": { "description": "Successfully deleted the Project." }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "get": { "operationId": "readProject_2_0", "summary": "Get a Project", "description": "Get a single [Project](doc:project) resource in a project.", "tags": [ "Projects v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "projectId", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "200": { "description": "Returns Project Object", "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the Project", "example": "New Project" }, "color": { "type": "string", "example": "blue", "oneOf": [ { "type": "string", "example": "none", "enum": [ "aliceBlue", "antiqueWhite", "aqua", "aquamarine", "azure", "beige", "bisque", "black", "blanchedAlmond", "blue", "blueViolet", "brown", "burlyWood", "cadetBlue", "chartreuse", "chocolate", "coral", "cornflowerBlue", "cornsilk", "crimson", "cyan", "darkBlue", "darkCyan", "darkGoldenRod", "darkGray", "darkGrey", "darkGreen", "darkKhaki", "darkMagenta", "darkOliveGreen", "darkOrange", "darkOrchid", "darkRed", "darkSalmon", "darkSeaGreen", "darkSlateBlue", "darkSlateGray", "darkSlateGrey", "darkTurquoise", "darkViolet", "deepPink", "deepSkyBlue", "dimGray", "dimGrey", "dodgerBlue", "fireBrick", "floralWhite", "forestGreen", "fuchsia", "gainsboro", "ghostWhite", "gold", "goldenRod", "gray", "grey", "green", "greenYellow", "honeyDew", "hotPink", "indianRed", "indigo", "ivory", "khaki", "lavender", "lavenderBlush", "lawnGreen", "lemonChiffon", "lightBlue", "lightCoral", "lightCyan", "lightGoldenRodYellow", "lightGray", "lightGrey", "lightGreen", "lightPink", "lightSalmon", "lightSeaGreen", "lightSkyBlue", "lightSlateGray", "lightSlateGrey", "lightSteelBlue", "lightYellow", "lime", "limeGreen", "linen", "magenta", "maroon", "mediumAquaMarine", "mediumBlue", "mediumOrchid", "mediumPurple", "mediumSeaGreen", "mediumSlateBlue", "mediumSpringGreen", "mediumTurquoise", "mediumVioletRed", "midnightBlue", "mintCream", "mistyRose", "moccasin", "navajoWhite", "navy", "oldLace", "olive", "oliveDrab", "orange", "orangeRed", "orchid", "paleGoldenRod", "paleGreen", "paleTurquoise", "paleVioletRed", "papayaWhip", "peachPuff", "peru", "pink", "plum", "powderBlue", "purple", "rebeccaPurple", "red", "rosyBrown", "royalBlue", "saddleBrown", "salmon", "sandyBrown", "seaGreen", "seaShell", "sienna", "silver", "skyBlue", "slateBlue", "slateGray", "slateGrey", "snow", "springGreen", "steelBlue", "tan", "teal", "thistle", "tomato", "turquoise", "violet", "wheat", "white", "whiteSmoke", "yellow", "yellowGreen", "none", "transparent" ] }, { "type": "string", "example": "cognigyGrey", "enum": [ "amber", "blueGrey", "cognigyBlue", "cognigyGrey", "deepOrange", "deepPurple", "lightBlue", "lightGreen" ] } ] }, "handoverConfiguration": { "type": "object", "properties": { "setupLiveAgentInbox": { "type": "boolean" }, "whisperAssistConfiguration": { "type": "string", "enum": [ "none", "basic", "template" ] } } }, "liveAgentDefaultInbox": { "type": "number", "description": "Live agent default inbox Id for the project" }, "primaryLocaleReference": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "patch": { "operationId": "updateProject_2_0", "summary": "Update a Project", "description": "Update a [Project](doc:project) resource in a project.", "tags": [ "Projects v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "projectId", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the Project", "example": "New Project" }, "color": { "type": "string", "example": "blue", "oneOf": [ { "type": "string", "example": "none", "enum": [ "aliceBlue", "antiqueWhite", "aqua", "aquamarine", "azure", "beige", "bisque", "black", "blanchedAlmond", "blue", "blueViolet", "brown", "burlyWood", "cadetBlue", "chartreuse", "chocolate", "coral", "cornflowerBlue", "cornsilk", "crimson", "cyan", "darkBlue", "darkCyan", "darkGoldenRod", "darkGray", "darkGrey", "darkGreen", "darkKhaki", "darkMagenta", "darkOliveGreen", "darkOrange", "darkOrchid", "darkRed", "darkSalmon", "darkSeaGreen", "darkSlateBlue", "darkSlateGray", "darkSlateGrey", "darkTurquoise", "darkViolet", "deepPink", "deepSkyBlue", "dimGray", "dimGrey", "dodgerBlue", "fireBrick", "floralWhite", "forestGreen", "fuchsia", "gainsboro", "ghostWhite", "gold", "goldenRod", "gray", "grey", "green", "greenYellow", "honeyDew", "hotPink", "indianRed", "indigo", "ivory", "khaki", "lavender", "lavenderBlush", "lawnGreen", "lemonChiffon", "lightBlue", "lightCoral", "lightCyan", "lightGoldenRodYellow", "lightGray", "lightGrey", "lightGreen", "lightPink", "lightSalmon", "lightSeaGreen", "lightSkyBlue", "lightSlateGray", "lightSlateGrey", "lightSteelBlue", "lightYellow", "lime", "limeGreen", "linen", "magenta", "maroon", "mediumAquaMarine", "mediumBlue", "mediumOrchid", "mediumPurple", "mediumSeaGreen", "mediumSlateBlue", "mediumSpringGreen", "mediumTurquoise", "mediumVioletRed", "midnightBlue", "mintCream", "mistyRose", "moccasin", "navajoWhite", "navy", "oldLace", "olive", "oliveDrab", "orange", "orangeRed", "orchid", "paleGoldenRod", "paleGreen", "paleTurquoise", "paleVioletRed", "papayaWhip", "peachPuff", "peru", "pink", "plum", "powderBlue", "purple", "rebeccaPurple", "red", "rosyBrown", "royalBlue", "saddleBrown", "salmon", "sandyBrown", "seaGreen", "seaShell", "sienna", "silver", "skyBlue", "slateBlue", "slateGray", "slateGrey", "snow", "springGreen", "steelBlue", "tan", "teal", "thistle", "tomato", "turquoise", "violet", "wheat", "white", "whiteSmoke", "yellow", "yellowGreen", "none", "transparent" ] }, { "type": "string", "example": "cognigyGrey", "enum": [ "amber", "blueGrey", "cognigyBlue", "cognigyGrey", "deepOrange", "deepPurple", "lightBlue", "lightGreen" ] } ] }, "handoverConfiguration": { "type": "object", "properties": { "setupLiveAgentInbox": { "type": "boolean" }, "whisperAssistConfiguration": { "type": "string", "enum": [ "none", "basic", "template" ] } } } } } } } }, "responses": { "201": { "description": "Successfully updated the Project." }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/projects/{projectId}/graph": { "get": { "operationId": "projectGraph_2_0", "summary": "Get a Graph of the Project.", "description": "Get a Graph of the Project.", "tags": [ "Projects v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "projectId", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "query", "name": "snapshots", "schema": { "type": "string", "default": false, "enum": [ false, true ] } }, { "in": "query", "name": "packages", "schema": { "type": "string", "default": false, "enum": [ false, true ] } } ], "responses": { "200": { "description": "Returns a Graph of the Project.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": { "oneOf": [ { "type": "object", "properties": { "type": { "type": "string", "example": "project", "enum": [ "project", "snapshot" ] }, "name": { "type": "string", "description": "The name of the Resource", "example": "lexicon" }, "resources": { "type": "array", "items": { "type": "object", "properties": { "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "name": { "type": "string", "description": "The name of the Resource", "example": "lexicon" }, "properties": { "type": "object" } } } } } } ] } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/projects/{projectId}/settings": { "get": { "operationId": "readAgentSettings_2_0", "summary": "Get the Project Settings", "description": "Get the Settings of [Project](doc:project).", "tags": [ "Projects v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "projectId", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "200": { "description": "Returns the Settings of the Project", "content": { "application/json": { "schema": { "type": "object", "properties": { "timezone": { "type": "string", "description": "Timezone according to IANA Timezone Database (2020a)", "example": "Europe/Berlin", "enum": [ "Africa/Abidjan", "Africa/Accra", "Africa/Addis_Ababa", "Africa/Algiers", "Africa/Asmara", "Africa/Asmera", "Africa/Bamako", "Africa/Bangui", "Africa/Banjul", "Africa/Bissau", "Africa/Blantyre", "Africa/Brazzaville", "Africa/Bujumbura", "Africa/Cairo", "Africa/Casablanca", "Africa/Ceuta", "Africa/Conakry", "Africa/Dakar", "Africa/Dar_es_Salaam", "Africa/Djibouti", "Africa/Douala", "Africa/El_Aaiun", "Africa/Freetown", "Africa/Gaborone", "Africa/Harare", "Africa/Johannesburg", "Africa/Juba", "Africa/Kampala", "Africa/Khartoum", "Africa/Kigali", "Africa/Kinshasa", "Africa/Lagos", "Africa/Libreville", "Africa/Lome", "Africa/Luanda", "Africa/Lubumbashi", "Africa/Lusaka", "Africa/Malabo", "Africa/Maputo", "Africa/Maseru", "Africa/Mbabane", "Africa/Mogadishu", "Africa/Monrovia", "Africa/Nairobi", "Africa/Ndjamena", "Africa/Niamey", "Africa/Nouakchott", "Africa/Ouagadougou", "Africa/Porto-Novo", "Africa/Sao_Tome", "Africa/Timbuktu", "Africa/Tripoli", "Africa/Tunis", "Africa/Windhoek", "America/Adak", "America/Anchorage", "America/Anguilla", "America/Antigua", "America/Araguaina", "America/Argentina/Buenos_Aires", "America/Argentina/Catamarca", "America/Argentina/ComodRivadavia", "America/Argentina/Cordoba", "America/Argentina/Jujuy", "America/Argentina/La_Rioja", "America/Argentina/Mendoza", "America/Argentina/Rio_Gallegos", "America/Argentina/Salta", "America/Argentina/San_Juan", "America/Argentina/San_Luis", "America/Argentina/Tucuman", "America/Argentina/Ushuaia", "America/Aruba", "America/Asuncion", "America/Atikokan", "America/Atka", "America/Bahia", "America/Bahia_Banderas", "America/Barbados", "America/Belem", "America/Belize", "America/Blanc-Sablon", "America/Boa_Vista", "America/Bogota", "America/Boise", "America/Buenos_Aires", "America/Cambridge_Bay", "America/Campo_Grande", "America/Cancun", "America/Caracas", "America/Catamarca", "America/Cayenne", "America/Cayman", "America/Chicago", "America/Chihuahua", "America/Coral_Harbour", "America/Cordoba", "America/Costa_Rica", "America/Creston", "America/Cuiaba", "America/Curacao", "America/Danmarkshavn", "America/Dawson", "America/Dawson_Creek", "America/Denver", "America/Detroit", "America/Dominica", "America/Edmonton", "America/Eirunepe", "America/El_Salvador", "America/Ensenada", "America/Fort_Nelson", "America/Fort_Wayne", "America/Fortaleza", "America/Glace_Bay", "America/Godthab", "America/Goose_Bay", "America/Grand_Turk", "America/Grenada", "America/Guadeloupe", "America/Guatemala", "America/Guayaquil", "America/Guyana", "America/Halifax", "America/Havana", "America/Hermosillo", "America/Indiana/Indianapolis", "America/Indiana/Knox", "America/Indiana/Marengo", "America/Indiana/Petersburg", "America/Indiana/Tell_City", "America/Indiana/Vevay", "America/Indiana/Vincennes", "America/Indiana/Winamac", "America/Indianapolis", "America/Inuvik", "America/Iqaluit", "America/Jamaica", "America/Jujuy", "America/Juneau", "America/Kentucky/Louisville", "America/Kentucky/Monticello", "America/Knox_IN", "America/Kralendijk", "America/La_Paz", "America/Lima", "America/Los_Angeles", "America/Louisville", "America/Lower_Princes", "America/Maceio", "America/Managua", "America/Manaus", "America/Marigot", "America/Martinique", "America/Matamoros", "America/Mazatlan", "America/Mendoza", "America/Menominee", "America/Merida", "America/Metlakatla", "America/Mexico_City", "America/Miquelon", "America/Moncton", "America/Monterrey", "America/Montevideo", "America/Montreal", "America/Montserrat", "America/Nassau", "America/New_York", "America/Nipigon", "America/Nome", "America/Noronha", "America/North_Dakota/Beulah", "America/North_Dakota/Center", "America/North_Dakota/New_Salem", "America/Ojinaga", "America/Panama", "America/Pangnirtung", "America/Paramaribo", "America/Phoenix", "America/Port-au-Prince", "America/Port_of_Spain", "America/Porto_Acre", "America/Porto_Velho", "America/Puerto_Rico", "America/Punta_Arenas", "America/Rainy_River", "America/Rankin_Inlet", "America/Recife", "America/Regina", "America/Resolute", "America/Rio_Branco", "America/Rosario", "America/Santa_Isabel", "America/Santarem", "America/Santiago", "America/Santo_Domingo", "America/Sao_Paulo", "America/Scoresbysund", "America/Shiprock", "America/Sitka", "America/St_Barthelemy", "America/St_Johns", "America/St_Kitts", "America/St_Lucia", "America/St_Thomas", "America/St_Vincent", "America/Swift_Current", "America/Tegucigalpa", "America/Thule", "America/Thunder_Bay", "America/Tijuana", "America/Toronto", "America/Tortola", "America/Vancouver", "America/Virgin", "America/Whitehorse", "America/Winnipeg", "America/Yakutat", "America/Yellowknife", "Antarctica/Casey", "Antarctica/Davis", "Antarctica/DumontDUrville", "Antarctica/Macquarie", "Antarctica/Mawson", "Antarctica/McMurdo", "Antarctica/Palmer", "Antarctica/Rothera", "Antarctica/South_Pole", "Antarctica/Syowa", "Antarctica/Troll", "Antarctica/Vostok", "Arctic/Longyearbyen", "Asia/Aden", "Asia/Almaty", "Asia/Amman", "Asia/Anadyr", "Asia/Aqtau", "Asia/Aqtobe", "Asia/Ashgabat", "Asia/Ashkhabad", "Asia/Atyrau", "Asia/Baghdad", "Asia/Bahrain", "Asia/Baku", "Asia/Bangkok", "Asia/Barnaul", "Asia/Beirut", "Asia/Bishkek", "Asia/Brunei", "Asia/Calcutta", "Asia/Chita", "Asia/Choibalsan", "Asia/Chongqing", "Asia/Chungking", "Asia/Colombo", "Asia/Dacca", "Asia/Damascus", "Asia/Dhaka", "Asia/Dili", "Asia/Dubai", "Asia/Dushanbe", "Asia/Famagusta", "Asia/Gaza", "Asia/Harbin", "Asia/Hebron", "Asia/Ho_Chi_Minh", "Asia/Hong_Kong", "Asia/Hovd", "Asia/Irkutsk", "Asia/Istanbul", "Asia/Jakarta", "Asia/Jayapura", "Asia/Jerusalem", "Asia/Kabul", "Asia/Kamchatka", "Asia/Karachi", "Asia/Kashgar", "Asia/Kathmandu", "Asia/Katmandu", "Asia/Khandyga", "Asia/Kolkata", "Asia/Krasnoyarsk", "Asia/Kuala_Lumpur", "Asia/Kuching", "Asia/Kuwait", "Asia/Macao", "Asia/Macau", "Asia/Magadan", "Asia/Makassar", "Asia/Manila", "Asia/Muscat", "Asia/Nicosia", "Asia/Novokuznetsk", "Asia/Novosibirsk", "Asia/Omsk", "Asia/Oral", "Asia/Phnom_Penh", "Asia/Pontianak", "Asia/Pyongyang", "Asia/Qatar", "Asia/Qyzylorda", "Asia/Rangoon", "Asia/Riyadh", "Asia/Saigon", "Asia/Sakhalin", "Asia/Samarkand", "Asia/Seoul", "Asia/Shanghai", "Asia/Singapore", "Asia/Srednekolymsk", "Asia/Taipei", "Asia/Tashkent", "Asia/Tbilisi", "Asia/Tehran", "Asia/Tel_Aviv", "Asia/Thimbu", "Asia/Thimphu", "Asia/Tokyo", "Asia/Tomsk", "Asia/Ujung_Pandang", "Asia/Ulaanbaatar", "Asia/Ulan_Bator", "Asia/Urumqi", "Asia/Ust-Nera", "Asia/Vientiane", "Asia/Vladivostok", "Asia/Yakutsk", "Asia/Yangon", "Asia/Yekaterinburg", "Asia/Yerevan", "Atlantic/Azores", "Atlantic/Bermuda", "Atlantic/Canary", "Atlantic/Cape_Verde", "Atlantic/Faeroe", "Atlantic/Faroe", "Atlantic/Jan_Mayen", "Atlantic/Madeira", "Atlantic/Reykjavik", "Atlantic/South_Georgia", "Atlantic/St_Helena", "Atlantic/Stanley", "Australia/ACT", "Australia/Adelaide", "Australia/Brisbane", "Australia/Broken_Hill", "Australia/Canberra", "Australia/Currie", "Australia/Darwin", "Australia/Eucla", "Australia/Hobart", "Australia/LHI", "Australia/Lindeman", "Australia/Lord_Howe", "Australia/Melbourne", "Australia/NSW", "Australia/North", "Australia/Perth", "Australia/Queensland", "Australia/South", "Australia/Sydney", "Australia/Tasmania", "Australia/Victoria", "Australia/West", "Australia/Yancowinna", "Brazil/Acre", "Brazil/DeNoronha", "Brazil/East", "Brazil/West", "CET", "CST6CDT", "Canada/Atlantic", "Canada/Central", "Canada/Eastern", "Canada/Mountain", "Canada/Newfoundland", "Canada/Pacific", "Canada/Saskatchewan", "Canada/Yukon", "Chile/Continental", "Chile/EasterIsland", "Cuba", "EET", "EST", "EST5EDT", "Egypt", "Eire", "Etc/GMT", "Etc/GMT+0", "Etc/GMT+1", "Etc/GMT+10", "Etc/GMT+11", "Etc/GMT+12", "Etc/GMT+2", "Etc/GMT+3", "Etc/GMT+4", "Etc/GMT+5", "Etc/GMT+6", "Etc/GMT+7", "Etc/GMT+8", "Etc/GMT+9", "Etc/GMT-0", "Etc/GMT-1", "Etc/GMT-10", "Etc/GMT-11", "Etc/GMT-12", "Etc/GMT-13", "Etc/GMT-14", "Etc/GMT-2", "Etc/GMT-3", "Etc/GMT-4", "Etc/GMT-5", "Etc/GMT-6", "Etc/GMT-7", "Etc/GMT-8", "Etc/GMT-9", "Etc/GMT0", "Etc/Greenwich", "Etc/UCT", "Etc/UTC", "Etc/Universal", "Etc/Zulu", "Europe/Amsterdam", "Europe/Andorra", "Europe/Astrakhan", "Europe/Athens", "Europe/Belfast", "Europe/Belgrade", "Europe/Berlin", "Europe/Bratislava", "Europe/Brussels", "Europe/Bucharest", "Europe/Budapest", "Europe/Busingen", "Europe/Chisinau", "Europe/Copenhagen", "Europe/Dublin", "Europe/Gibraltar", "Europe/Guernsey", "Europe/Helsinki", "Europe/Isle_of_Man", "Europe/Istanbul", "Europe/Jersey", "Europe/Kaliningrad", "Europe/Kiev", "Europe/Kirov", "Europe/Lisbon", "Europe/Ljubljana", "Europe/London", "Europe/Luxembourg", "Europe/Madrid", "Europe/Malta", "Europe/Mariehamn", "Europe/Minsk", "Europe/Monaco", "Europe/Moscow", "Europe/Nicosia", "Europe/Oslo", "Europe/Paris", "Europe/Podgorica", "Europe/Prague", "Europe/Riga", "Europe/Rome", "Europe/Samara", "Europe/San_Marino", "Europe/Sarajevo", "Europe/Saratov", "Europe/Simferopol", "Europe/Skopje", "Europe/Sofia", "Europe/Stockholm", "Europe/Tallinn", "Europe/Tirane", "Europe/Tiraspol", "Europe/Ulyanovsk", "Europe/Uzhgorod", "Europe/Vaduz", "Europe/Vatican", "Europe/Vienna", "Europe/Vilnius", "Europe/Volgograd", "Europe/Warsaw", "Europe/Zagreb", "Europe/Zaporozhye", "Europe/Zurich", "GB", "GB-Eire", "GMT", "GMT+0", "GMT-0", "GMT0", "Greenwich", "HST", "Hongkong", "Iceland", "Indian/Antananarivo", "Indian/Chagos", "Indian/Christmas", "Indian/Cocos", "Indian/Comoro", "Indian/Kerguelen", "Indian/Mahe", "Indian/Maldives", "Indian/Mauritius", "Indian/Mayotte", "Indian/Reunion", "Iran", "Israel", "Jamaica", "Japan", "Kwajalein", "Libya", "MET", "MST", "MST7MDT", "Mexico/BajaNorte", "Mexico/BajaSur", "Mexico/General", "NZ", "NZ-CHAT", "Navajo", "PRC", "PST8PDT", "Pacific/Apia", "Pacific/Auckland", "Pacific/Bougainville", "Pacific/Chatham", "Pacific/Chuuk", "Pacific/Easter", "Pacific/Efate", "Pacific/Enderbury", "Pacific/Fakaofo", "Pacific/Fiji", "Pacific/Funafuti", "Pacific/Galapagos", "Pacific/Gambier", "Pacific/Guadalcanal", "Pacific/Guam", "Pacific/Honolulu", "Pacific/Johnston", "Pacific/Kiritimati", "Pacific/Kosrae", "Pacific/Kwajalein", "Pacific/Majuro", "Pacific/Marquesas", "Pacific/Midway", "Pacific/Nauru", "Pacific/Niue", "Pacific/Norfolk", "Pacific/Noumea", "Pacific/Pago_Pago", "Pacific/Palau", "Pacific/Pitcairn", "Pacific/Pohnpei", "Pacific/Ponape", "Pacific/Port_Moresby", "Pacific/Rarotonga", "Pacific/Saipan", "Pacific/Samoa", "Pacific/Tahiti", "Pacific/Tarawa", "Pacific/Tongatapu", "Pacific/Truk", "Pacific/Wake", "Pacific/Wallis", "Pacific/Yap", "Poland", "Portugal", "ROC", "ROK", "Singapore", "Turkey", "UCT", "US/Alaska", "US/Aleutian", "US/Arizona", "US/Central", "US/East-Indiana", "US/Eastern", "US/Hawaii", "US/Indiana-Starke", "US/Michigan", "US/Mountain", "US/Pacific", "US/Pacific-New", "US/Samoa", "UTC", "Universal", "W-SU", "WET", "Zulu" ] }, "useCaseSensitiveIntentMapping": { "type": "boolean" }, "collectAnalytics": { "type": "boolean" }, "trackDataOnlyInputs": { "type": "boolean" }, "translationSettings": { "type": "object", "properties": { "provider": { "type": "string", "description": "Supported Translation Providers", "enum": [ "none", "microsoft", "google", "deepl" ] }, "connections": { "type": "object", "properties": { "microsoft": { "type": "object", "properties": { "connecionId": { "type": "string", "description": "ReferenceId to the connection provider" }, "retries": { "type": "string", "description": "Number of retries", "default": 1 }, "timeout": { "type": "string", "description": "Timeout in milliseconds", "default": 3000 }, "cacheExpiry": { "type": "string", "description": "Cache expiry in milliseconds", "default": 0 }, "customBaseUrl": { "type": "string", "description": "Custom base url", "default": "" } } }, "deepl": { "type": "object", "properties": { "connecionId": { "type": "string", "description": "ReferenceId to the connection provider" }, "retries": { "type": "string", "description": "Number of retries", "default": 1 }, "timeout": { "type": "string", "description": "Timeout in milliseconds", "default": 3000 }, "cacheExpiry": { "type": "string", "description": "Cache expiry in milliseconds", "default": 0 }, "customBaseUrl": { "type": "string", "description": "Custom base url", "default": "" } } }, "google": { "type": "object", "properties": { "connecionId": { "type": "string", "description": "ReferenceId to the connection provider" }, "retries": { "type": "string", "description": "Number of retries", "default": 1 }, "timeout": { "type": "string", "description": "Timeout in milliseconds", "default": 3000 }, "cacheExpiry": { "type": "string", "description": "Cache expiry in milliseconds", "default": 0 }, "customBaseUrl": { "type": "string", "description": "Custom base url", "default": "" } } } } } } }, "audioPreviewSettings": { "type": "object", "properties": { "provider": { "type": "string", "description": "Supported AudioPreview Providers", "enum": [ null, "microsoft", "google", "aws" ] }, "connections": { "type": "object", "properties": { "microsoft": { "type": "object", "properties": { "connecionId": { "type": "string", "description": "ReferenceId to the connection provider" } } }, "aws": { "type": "object", "properties": { "connecionId": { "type": "string", "description": "ReferenceId to the connection provider" } } }, "google": { "type": "object", "properties": { "connecionId": { "type": "string", "description": "ReferenceId to the connection provider" } } } } } } }, "generativeAISettings": { "type": "object", "properties": { "enabled": { "type": "boolean" }, "useCasesSettings": { "type": "object", "properties": { "intentSentenceGeneration": { "type": "object", "properties": { "enabled": { "type": "boolean", "description": "Enable/Disable the usecase." }, "largeLanguageModelId": { "type": "string", "description": "reference Id to the LargeLanguageModel object" }, "temperature": { "type": "integer", "minimum": 0, "maximum": 1, "description": "Defines the creativity of the model" } } }, "aiEnhancedOutputs": { "type": "object", "properties": { "enabled": { "type": "boolean", "description": "Enable/Disable the usecase." }, "largeLanguageModelId": { "type": "string", "description": "reference Id to the LargeLanguageModel object" }, "temperature": { "type": "integer", "minimum": 0, "maximum": 1, "description": "Defines the creativity of the model" } } }, "lexiconGeneration": { "type": "object", "properties": { "enabled": { "type": "boolean", "description": "Enable/Disable the usecase." }, "largeLanguageModelId": { "type": "string", "description": "reference Id to the LargeLanguageModel object" }, "temperature": { "type": "integer", "minimum": 0, "maximum": 1, "description": "Defines the creativity of the model" } } }, "flowGeneration": { "type": "object", "properties": { "enabled": { "type": "boolean", "description": "Enable/Disable the usecase." }, "largeLanguageModelId": { "type": "string", "description": "reference Id to the LargeLanguageModel object" }, "temperature": { "type": "integer", "minimum": 0, "maximum": 1, "description": "Defines the creativity of the model" } } }, "gptConversation": { "type": "object", "properties": { "enabled": { "type": "boolean", "description": "Enable/Disable the usecase." }, "largeLanguageModelId": { "type": "string", "description": "reference Id to the LargeLanguageModel object" }, "temperature": { "type": "integer", "minimum": 0, "maximum": 1, "description": "Defines the creativity of the model" } } }, "gptPromptNode": { "type": "object", "properties": { "enabled": { "type": "boolean", "description": "Enable/Disable the usecase." }, "largeLanguageModelId": { "type": "string", "description": "reference Id to the LargeLanguageModel object" }, "temperature": { "type": "integer", "minimum": 0, "maximum": 1, "description": "Defines the creativity of the model" } } }, "generateNodeOutput": { "type": "object", "properties": { "enabled": { "type": "boolean", "description": "Enable/Disable the usecase." }, "largeLanguageModelId": { "type": "string", "description": "reference Id to the LargeLanguageModel object" }, "temperature": { "type": "integer", "minimum": 0, "maximum": 1, "description": "Defines the creativity of the model" } } }, "knowledgeSearch": { "type": "object", "properties": { "enabled": { "type": "boolean", "description": "Enable/Disable the usecase." }, "largeLanguageModelId": { "type": "string", "description": "reference Id to the LargeLanguageModel object" }, "temperature": { "type": "integer", "minimum": 0, "maximum": 1, "description": "Defines the creativity of the model" } } } } } } }, "currencySettings": { "type": "object", "properties": { "currency": { "type": "string", "example": "USD" } } }, "knowledgeAISettings": { "type": "object", "properties": { "fileExtractor": { "type": "string", "description": "Options for the Knowledge AI File Extractor", "enum": [ "default", "legacy", "azure" ] }, "azureDIConnectionId": { "type": "string", "description": "ReferenceId of the Azure AI Document Intelligence Connection", "example": "f66e99eb-db8f-433c-977f-69160d9a6bdb" } } }, "intentThreshold": { "type": "object", "properties": { "lower": { "type": "number", "example": 0.4 }, "upper": { "type": "number", "example": 0.5 } } }, "learnNewExampleSentences": { "type": "boolean" }, "learnNewExampleSentencesThreshold": { "type": "integer" }, "negativeConfirmationWords": { "type": "array", "items": { "type": "string" } }, "positiveConfirmationWords": { "type": "array", "items": { "type": "string" } }, "systemSlots": { "type": "object", "properties": { "useAgeSlots": { "type": "boolean" }, "useDateSlots": { "type": "boolean" }, "useDistanceSlots": { "type": "boolean" }, "useDurationSlots": { "type": "boolean" }, "useEmailSlots": { "type": "boolean" }, "useMoneySlots": { "type": "boolean" }, "useNumberSlots": { "type": "boolean" }, "usePercentageSlots": { "type": "boolean" }, "useTemperatureSlots": { "type": "boolean" }, "useURLSlots": { "type": "boolean" } } }, "yesNoLogic": { "type": "string", "enum": [ "yesNoIntents", "yesNoIntentsWithRules", "confirmationWords" ] }, "yesNoIntentThreshold": { "type": "integer" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChangedBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, "description": "The IEntityMeta defines meta information every entity within the system has. These are dates when a resource was created and modified as well as information about the user who initially created a resource and who modified it the last time.\n" } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "patch": { "operationId": "updateAgentSettings_2_0", "summary": "Update the Settings of a Project", "description": "Update the Settings of a [Project](doc:project).", "tags": [ "Projects v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "projectId", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "timezone": { "type": "string", "description": "Timezone according to IANA Timezone Database (2020a)", "example": "Europe/Berlin", "enum": [ "Africa/Abidjan", "Africa/Accra", "Africa/Addis_Ababa", "Africa/Algiers", "Africa/Asmara", "Africa/Asmera", "Africa/Bamako", "Africa/Bangui", "Africa/Banjul", "Africa/Bissau", "Africa/Blantyre", "Africa/Brazzaville", "Africa/Bujumbura", "Africa/Cairo", "Africa/Casablanca", "Africa/Ceuta", "Africa/Conakry", "Africa/Dakar", "Africa/Dar_es_Salaam", "Africa/Djibouti", "Africa/Douala", "Africa/El_Aaiun", "Africa/Freetown", "Africa/Gaborone", "Africa/Harare", "Africa/Johannesburg", "Africa/Juba", "Africa/Kampala", "Africa/Khartoum", "Africa/Kigali", "Africa/Kinshasa", "Africa/Lagos", "Africa/Libreville", "Africa/Lome", "Africa/Luanda", "Africa/Lubumbashi", "Africa/Lusaka", "Africa/Malabo", "Africa/Maputo", "Africa/Maseru", "Africa/Mbabane", "Africa/Mogadishu", "Africa/Monrovia", "Africa/Nairobi", "Africa/Ndjamena", "Africa/Niamey", "Africa/Nouakchott", "Africa/Ouagadougou", "Africa/Porto-Novo", "Africa/Sao_Tome", "Africa/Timbuktu", "Africa/Tripoli", "Africa/Tunis", "Africa/Windhoek", "America/Adak", "America/Anchorage", "America/Anguilla", "America/Antigua", "America/Araguaina", "America/Argentina/Buenos_Aires", "America/Argentina/Catamarca", "America/Argentina/ComodRivadavia", "America/Argentina/Cordoba", "America/Argentina/Jujuy", "America/Argentina/La_Rioja", "America/Argentina/Mendoza", "America/Argentina/Rio_Gallegos", "America/Argentina/Salta", "America/Argentina/San_Juan", "America/Argentina/San_Luis", "America/Argentina/Tucuman", "America/Argentina/Ushuaia", "America/Aruba", "America/Asuncion", "America/Atikokan", "America/Atka", "America/Bahia", "America/Bahia_Banderas", "America/Barbados", "America/Belem", "America/Belize", "America/Blanc-Sablon", "America/Boa_Vista", "America/Bogota", "America/Boise", "America/Buenos_Aires", "America/Cambridge_Bay", "America/Campo_Grande", "America/Cancun", "America/Caracas", "America/Catamarca", "America/Cayenne", "America/Cayman", "America/Chicago", "America/Chihuahua", "America/Coral_Harbour", "America/Cordoba", "America/Costa_Rica", "America/Creston", "America/Cuiaba", "America/Curacao", "America/Danmarkshavn", "America/Dawson", "America/Dawson_Creek", "America/Denver", "America/Detroit", "America/Dominica", "America/Edmonton", "America/Eirunepe", "America/El_Salvador", "America/Ensenada", "America/Fort_Nelson", "America/Fort_Wayne", "America/Fortaleza", "America/Glace_Bay", "America/Godthab", "America/Goose_Bay", "America/Grand_Turk", "America/Grenada", "America/Guadeloupe", "America/Guatemala", "America/Guayaquil", "America/Guyana", "America/Halifax", "America/Havana", "America/Hermosillo", "America/Indiana/Indianapolis", "America/Indiana/Knox", "America/Indiana/Marengo", "America/Indiana/Petersburg", "America/Indiana/Tell_City", "America/Indiana/Vevay", "America/Indiana/Vincennes", "America/Indiana/Winamac", "America/Indianapolis", "America/Inuvik", "America/Iqaluit", "America/Jamaica", "America/Jujuy", "America/Juneau", "America/Kentucky/Louisville", "America/Kentucky/Monticello", "America/Knox_IN", "America/Kralendijk", "America/La_Paz", "America/Lima", "America/Los_Angeles", "America/Louisville", "America/Lower_Princes", "America/Maceio", "America/Managua", "America/Manaus", "America/Marigot", "America/Martinique", "America/Matamoros", "America/Mazatlan", "America/Mendoza", "America/Menominee", "America/Merida", "America/Metlakatla", "America/Mexico_City", "America/Miquelon", "America/Moncton", "America/Monterrey", "America/Montevideo", "America/Montreal", "America/Montserrat", "America/Nassau", "America/New_York", "America/Nipigon", "America/Nome", "America/Noronha", "America/North_Dakota/Beulah", "America/North_Dakota/Center", "America/North_Dakota/New_Salem", "America/Ojinaga", "America/Panama", "America/Pangnirtung", "America/Paramaribo", "America/Phoenix", "America/Port-au-Prince", "America/Port_of_Spain", "America/Porto_Acre", "America/Porto_Velho", "America/Puerto_Rico", "America/Punta_Arenas", "America/Rainy_River", "America/Rankin_Inlet", "America/Recife", "America/Regina", "America/Resolute", "America/Rio_Branco", "America/Rosario", "America/Santa_Isabel", "America/Santarem", "America/Santiago", "America/Santo_Domingo", "America/Sao_Paulo", "America/Scoresbysund", "America/Shiprock", "America/Sitka", "America/St_Barthelemy", "America/St_Johns", "America/St_Kitts", "America/St_Lucia", "America/St_Thomas", "America/St_Vincent", "America/Swift_Current", "America/Tegucigalpa", "America/Thule", "America/Thunder_Bay", "America/Tijuana", "America/Toronto", "America/Tortola", "America/Vancouver", "America/Virgin", "America/Whitehorse", "America/Winnipeg", "America/Yakutat", "America/Yellowknife", "Antarctica/Casey", "Antarctica/Davis", "Antarctica/DumontDUrville", "Antarctica/Macquarie", "Antarctica/Mawson", "Antarctica/McMurdo", "Antarctica/Palmer", "Antarctica/Rothera", "Antarctica/South_Pole", "Antarctica/Syowa", "Antarctica/Troll", "Antarctica/Vostok", "Arctic/Longyearbyen", "Asia/Aden", "Asia/Almaty", "Asia/Amman", "Asia/Anadyr", "Asia/Aqtau", "Asia/Aqtobe", "Asia/Ashgabat", "Asia/Ashkhabad", "Asia/Atyrau", "Asia/Baghdad", "Asia/Bahrain", "Asia/Baku", "Asia/Bangkok", "Asia/Barnaul", "Asia/Beirut", "Asia/Bishkek", "Asia/Brunei", "Asia/Calcutta", "Asia/Chita", "Asia/Choibalsan", "Asia/Chongqing", "Asia/Chungking", "Asia/Colombo", "Asia/Dacca", "Asia/Damascus", "Asia/Dhaka", "Asia/Dili", "Asia/Dubai", "Asia/Dushanbe", "Asia/Famagusta", "Asia/Gaza", "Asia/Harbin", "Asia/Hebron", "Asia/Ho_Chi_Minh", "Asia/Hong_Kong", "Asia/Hovd", "Asia/Irkutsk", "Asia/Istanbul", "Asia/Jakarta", "Asia/Jayapura", "Asia/Jerusalem", "Asia/Kabul", "Asia/Kamchatka", "Asia/Karachi", "Asia/Kashgar", "Asia/Kathmandu", "Asia/Katmandu", "Asia/Khandyga", "Asia/Kolkata", "Asia/Krasnoyarsk", "Asia/Kuala_Lumpur", "Asia/Kuching", "Asia/Kuwait", "Asia/Macao", "Asia/Macau", "Asia/Magadan", "Asia/Makassar", "Asia/Manila", "Asia/Muscat", "Asia/Nicosia", "Asia/Novokuznetsk", "Asia/Novosibirsk", "Asia/Omsk", "Asia/Oral", "Asia/Phnom_Penh", "Asia/Pontianak", "Asia/Pyongyang", "Asia/Qatar", "Asia/Qyzylorda", "Asia/Rangoon", "Asia/Riyadh", "Asia/Saigon", "Asia/Sakhalin", "Asia/Samarkand", "Asia/Seoul", "Asia/Shanghai", "Asia/Singapore", "Asia/Srednekolymsk", "Asia/Taipei", "Asia/Tashkent", "Asia/Tbilisi", "Asia/Tehran", "Asia/Tel_Aviv", "Asia/Thimbu", "Asia/Thimphu", "Asia/Tokyo", "Asia/Tomsk", "Asia/Ujung_Pandang", "Asia/Ulaanbaatar", "Asia/Ulan_Bator", "Asia/Urumqi", "Asia/Ust-Nera", "Asia/Vientiane", "Asia/Vladivostok", "Asia/Yakutsk", "Asia/Yangon", "Asia/Yekaterinburg", "Asia/Yerevan", "Atlantic/Azores", "Atlantic/Bermuda", "Atlantic/Canary", "Atlantic/Cape_Verde", "Atlantic/Faeroe", "Atlantic/Faroe", "Atlantic/Jan_Mayen", "Atlantic/Madeira", "Atlantic/Reykjavik", "Atlantic/South_Georgia", "Atlantic/St_Helena", "Atlantic/Stanley", "Australia/ACT", "Australia/Adelaide", "Australia/Brisbane", "Australia/Broken_Hill", "Australia/Canberra", "Australia/Currie", "Australia/Darwin", "Australia/Eucla", "Australia/Hobart", "Australia/LHI", "Australia/Lindeman", "Australia/Lord_Howe", "Australia/Melbourne", "Australia/NSW", "Australia/North", "Australia/Perth", "Australia/Queensland", "Australia/South", "Australia/Sydney", "Australia/Tasmania", "Australia/Victoria", "Australia/West", "Australia/Yancowinna", "Brazil/Acre", "Brazil/DeNoronha", "Brazil/East", "Brazil/West", "CET", "CST6CDT", "Canada/Atlantic", "Canada/Central", "Canada/Eastern", "Canada/Mountain", "Canada/Newfoundland", "Canada/Pacific", "Canada/Saskatchewan", "Canada/Yukon", "Chile/Continental", "Chile/EasterIsland", "Cuba", "EET", "EST", "EST5EDT", "Egypt", "Eire", "Etc/GMT", "Etc/GMT+0", "Etc/GMT+1", "Etc/GMT+10", "Etc/GMT+11", "Etc/GMT+12", "Etc/GMT+2", "Etc/GMT+3", "Etc/GMT+4", "Etc/GMT+5", "Etc/GMT+6", "Etc/GMT+7", "Etc/GMT+8", "Etc/GMT+9", "Etc/GMT-0", "Etc/GMT-1", "Etc/GMT-10", "Etc/GMT-11", "Etc/GMT-12", "Etc/GMT-13", "Etc/GMT-14", "Etc/GMT-2", "Etc/GMT-3", "Etc/GMT-4", "Etc/GMT-5", "Etc/GMT-6", "Etc/GMT-7", "Etc/GMT-8", "Etc/GMT-9", "Etc/GMT0", "Etc/Greenwich", "Etc/UCT", "Etc/UTC", "Etc/Universal", "Etc/Zulu", "Europe/Amsterdam", "Europe/Andorra", "Europe/Astrakhan", "Europe/Athens", "Europe/Belfast", "Europe/Belgrade", "Europe/Berlin", "Europe/Bratislava", "Europe/Brussels", "Europe/Bucharest", "Europe/Budapest", "Europe/Busingen", "Europe/Chisinau", "Europe/Copenhagen", "Europe/Dublin", "Europe/Gibraltar", "Europe/Guernsey", "Europe/Helsinki", "Europe/Isle_of_Man", "Europe/Istanbul", "Europe/Jersey", "Europe/Kaliningrad", "Europe/Kiev", "Europe/Kirov", "Europe/Lisbon", "Europe/Ljubljana", "Europe/London", "Europe/Luxembourg", "Europe/Madrid", "Europe/Malta", "Europe/Mariehamn", "Europe/Minsk", "Europe/Monaco", "Europe/Moscow", "Europe/Nicosia", "Europe/Oslo", "Europe/Paris", "Europe/Podgorica", "Europe/Prague", "Europe/Riga", "Europe/Rome", "Europe/Samara", "Europe/San_Marino", "Europe/Sarajevo", "Europe/Saratov", "Europe/Simferopol", "Europe/Skopje", "Europe/Sofia", "Europe/Stockholm", "Europe/Tallinn", "Europe/Tirane", "Europe/Tiraspol", "Europe/Ulyanovsk", "Europe/Uzhgorod", "Europe/Vaduz", "Europe/Vatican", "Europe/Vienna", "Europe/Vilnius", "Europe/Volgograd", "Europe/Warsaw", "Europe/Zagreb", "Europe/Zaporozhye", "Europe/Zurich", "GB", "GB-Eire", "GMT", "GMT+0", "GMT-0", "GMT0", "Greenwich", "HST", "Hongkong", "Iceland", "Indian/Antananarivo", "Indian/Chagos", "Indian/Christmas", "Indian/Cocos", "Indian/Comoro", "Indian/Kerguelen", "Indian/Mahe", "Indian/Maldives", "Indian/Mauritius", "Indian/Mayotte", "Indian/Reunion", "Iran", "Israel", "Jamaica", "Japan", "Kwajalein", "Libya", "MET", "MST", "MST7MDT", "Mexico/BajaNorte", "Mexico/BajaSur", "Mexico/General", "NZ", "NZ-CHAT", "Navajo", "PRC", "PST8PDT", "Pacific/Apia", "Pacific/Auckland", "Pacific/Bougainville", "Pacific/Chatham", "Pacific/Chuuk", "Pacific/Easter", "Pacific/Efate", "Pacific/Enderbury", "Pacific/Fakaofo", "Pacific/Fiji", "Pacific/Funafuti", "Pacific/Galapagos", "Pacific/Gambier", "Pacific/Guadalcanal", "Pacific/Guam", "Pacific/Honolulu", "Pacific/Johnston", "Pacific/Kiritimati", "Pacific/Kosrae", "Pacific/Kwajalein", "Pacific/Majuro", "Pacific/Marquesas", "Pacific/Midway", "Pacific/Nauru", "Pacific/Niue", "Pacific/Norfolk", "Pacific/Noumea", "Pacific/Pago_Pago", "Pacific/Palau", "Pacific/Pitcairn", "Pacific/Pohnpei", "Pacific/Ponape", "Pacific/Port_Moresby", "Pacific/Rarotonga", "Pacific/Saipan", "Pacific/Samoa", "Pacific/Tahiti", "Pacific/Tarawa", "Pacific/Tongatapu", "Pacific/Truk", "Pacific/Wake", "Pacific/Wallis", "Pacific/Yap", "Poland", "Portugal", "ROC", "ROK", "Singapore", "Turkey", "UCT", "US/Alaska", "US/Aleutian", "US/Arizona", "US/Central", "US/East-Indiana", "US/Eastern", "US/Hawaii", "US/Indiana-Starke", "US/Michigan", "US/Mountain", "US/Pacific", "US/Pacific-New", "US/Samoa", "UTC", "Universal", "W-SU", "WET", "Zulu" ] }, "useCaseSensitiveIntentMapping": { "type": "boolean" }, "collectAnalytics": { "type": "boolean" }, "trackDataOnlyInputs": { "type": "boolean" }, "translationSettings": { "type": "object", "properties": { "provider": { "type": "string", "description": "Supported Translation Providers", "enum": [ "none", "microsoft", "google", "deepl" ] }, "connections": { "type": "object", "properties": { "microsoft": { "type": "object", "properties": { "connecionId": { "type": "string", "description": "ReferenceId to the connection provider" }, "retries": { "type": "string", "description": "Number of retries", "default": 1 }, "timeout": { "type": "string", "description": "Timeout in milliseconds", "default": 3000 }, "cacheExpiry": { "type": "string", "description": "Cache expiry in milliseconds", "default": 0 }, "customBaseUrl": { "type": "string", "description": "Custom base url", "default": "" } } }, "deepl": { "type": "object", "properties": { "connecionId": { "type": "string", "description": "ReferenceId to the connection provider" }, "retries": { "type": "string", "description": "Number of retries", "default": 1 }, "timeout": { "type": "string", "description": "Timeout in milliseconds", "default": 3000 }, "cacheExpiry": { "type": "string", "description": "Cache expiry in milliseconds", "default": 0 }, "customBaseUrl": { "type": "string", "description": "Custom base url", "default": "" } } }, "google": { "type": "object", "properties": { "connecionId": { "type": "string", "description": "ReferenceId to the connection provider" }, "retries": { "type": "string", "description": "Number of retries", "default": 1 }, "timeout": { "type": "string", "description": "Timeout in milliseconds", "default": 3000 }, "cacheExpiry": { "type": "string", "description": "Cache expiry in milliseconds", "default": 0 }, "customBaseUrl": { "type": "string", "description": "Custom base url", "default": "" } } } } } } }, "audioPreviewSettings": { "type": "object", "properties": { "provider": { "type": "string", "description": "Supported AudioPreview Providers", "enum": [ null, "microsoft", "google", "aws" ] }, "connections": { "type": "object", "properties": { "microsoft": { "type": "object", "properties": { "connecionId": { "type": "string", "description": "ReferenceId to the connection provider" } } }, "aws": { "type": "object", "properties": { "connecionId": { "type": "string", "description": "ReferenceId to the connection provider" } } }, "google": { "type": "object", "properties": { "connecionId": { "type": "string", "description": "ReferenceId to the connection provider" } } } } } } }, "generativeAISettings": { "type": "object", "properties": { "enabled": { "type": "boolean" }, "useCasesSettings": { "type": "object", "properties": { "intentSentenceGeneration": { "type": "object", "properties": { "enabled": { "type": "boolean", "description": "Enable/Disable the usecase." }, "largeLanguageModelId": { "type": "string", "description": "reference Id to the LargeLanguageModel object" }, "temperature": { "type": "integer", "minimum": 0, "maximum": 1, "description": "Defines the creativity of the model" } } }, "aiEnhancedOutputs": { "type": "object", "properties": { "enabled": { "type": "boolean", "description": "Enable/Disable the usecase." }, "largeLanguageModelId": { "type": "string", "description": "reference Id to the LargeLanguageModel object" }, "temperature": { "type": "integer", "minimum": 0, "maximum": 1, "description": "Defines the creativity of the model" } } }, "lexiconGeneration": { "type": "object", "properties": { "enabled": { "type": "boolean", "description": "Enable/Disable the usecase." }, "largeLanguageModelId": { "type": "string", "description": "reference Id to the LargeLanguageModel object" }, "temperature": { "type": "integer", "minimum": 0, "maximum": 1, "description": "Defines the creativity of the model" } } }, "flowGeneration": { "type": "object", "properties": { "enabled": { "type": "boolean", "description": "Enable/Disable the usecase." }, "largeLanguageModelId": { "type": "string", "description": "reference Id to the LargeLanguageModel object" }, "temperature": { "type": "integer", "minimum": 0, "maximum": 1, "description": "Defines the creativity of the model" } } }, "gptConversation": { "type": "object", "properties": { "enabled": { "type": "boolean", "description": "Enable/Disable the usecase." }, "largeLanguageModelId": { "type": "string", "description": "reference Id to the LargeLanguageModel object" }, "temperature": { "type": "integer", "minimum": 0, "maximum": 1, "description": "Defines the creativity of the model" } } }, "gptPromptNode": { "type": "object", "properties": { "enabled": { "type": "boolean", "description": "Enable/Disable the usecase." }, "largeLanguageModelId": { "type": "string", "description": "reference Id to the LargeLanguageModel object" }, "temperature": { "type": "integer", "minimum": 0, "maximum": 1, "description": "Defines the creativity of the model" } } }, "generateNodeOutput": { "type": "object", "properties": { "enabled": { "type": "boolean", "description": "Enable/Disable the usecase." }, "largeLanguageModelId": { "type": "string", "description": "reference Id to the LargeLanguageModel object" }, "temperature": { "type": "integer", "minimum": 0, "maximum": 1, "description": "Defines the creativity of the model" } } }, "knowledgeSearch": { "type": "object", "properties": { "enabled": { "type": "boolean", "description": "Enable/Disable the usecase." }, "largeLanguageModelId": { "type": "string", "description": "reference Id to the LargeLanguageModel object" }, "temperature": { "type": "integer", "minimum": 0, "maximum": 1, "description": "Defines the creativity of the model" } } } } } } }, "currencySettings": { "type": "object", "properties": { "currency": { "type": "string", "example": "USD" } } }, "knowledgeAISettings": { "type": "object", "properties": { "fileExtractor": { "type": "string", "description": "Options for the Knowledge AI File Extractor", "enum": [ "default", "legacy", "azure" ] }, "azureDIConnectionId": { "type": "string", "description": "ReferenceId of the Azure AI Document Intelligence Connection", "example": "f66e99eb-db8f-433c-977f-69160d9a6bdb" } } }, "intentThreshold": { "type": "object", "properties": { "lower": { "type": "number", "example": 0.4 }, "upper": { "type": "number", "example": 0.5 } } }, "learnNewExampleSentences": { "type": "boolean" }, "learnNewExampleSentencesThreshold": { "type": "integer" }, "negativeConfirmationWords": { "type": "array", "items": { "type": "string" } }, "positiveConfirmationWords": { "type": "array", "items": { "type": "string" } }, "systemSlots": { "type": "object", "properties": { "useAgeSlots": { "type": "boolean" }, "useDateSlots": { "type": "boolean" }, "useDistanceSlots": { "type": "boolean" }, "useDurationSlots": { "type": "boolean" }, "useEmailSlots": { "type": "boolean" }, "useMoneySlots": { "type": "boolean" }, "useNumberSlots": { "type": "boolean" }, "usePercentageSlots": { "type": "boolean" }, "useTemperatureSlots": { "type": "boolean" }, "useURLSlots": { "type": "boolean" } } }, "yesNoLogic": { "type": "string", "enum": [ "yesNoIntents", "yesNoIntentsWithRules", "confirmationWords" ] }, "yesNoIntentThreshold": { "type": "integer" } } } } } }, "responses": { "204": { "description": "Successfully updated the AgentSettings" }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/projects/{projectId}/settings/setupgenerativeai": { "post": { "operationId": "setupCognigyGenerativeAI", "summary": "Sets up a Cognigy GenerativeAI configurations.", "description": "Sets up a Cognigy GenerativeAI for a project.", "tags": [ "Projects v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "projectId", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "200": { "description": "Cognigy GenerativeAI was successfully setup for the project and returns the full project settings with generativeAI configuration or an error message." }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/projects/{projectId}/settings/translation/test": { "post": { "operationId": "testTranslationSettings_2_0", "summary": "Validates the provided credentials for the translation provider", "description": "Validates the configuration making a connection to the Translation Provider", "tags": [ "Projects v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "projectId", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "200": { "description": "Translation configuration have been validated and the connection was successful.", "content": { "application/json": { "schema": { "type": "object", "properties": { "language": { "type": "string" }, "error": { "type": "object" }, "msg": { "type": "string" } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/projects/{projectId}/snippets": { "post": { "operationId": "createSnippet_2_0", "summary": "Create a new Snippet", "description": "Create a new [snippet](doc:snippet) resource in a project.", "tags": [ "Snippets v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "projectId", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "label": { "type": "string", "description": "The snippet Name", "example": "New snippet" } } } } } }, "responses": { "201": { "description": "Returns snippet metadata object." }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "get": { "operationId": "indexSnippets_2_0", "summary": "Get snippets", "description": "Get 25 snippet resources in a project. To change the default value, use the `limit` query parameter. Additionally, you can filter, sort, and paginate the results.", "tags": [ "Snippets v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "projectId", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "query", "name": "filter", "required": false, "schema": { "type": "string" }, "description": "The label of the snippet to filter the records" }, { "in": "query", "name": "limit", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100 }, "description": "The maximum number of items to return. The default is 25." }, { "in": "query", "name": "skip", "required": false, "schema": { "type": "integer", "minimum": 0 }, "description": "The number of items to skip. The default is 0. Used along with a limit of a pagination." }, { "in": "query", "name": "sort", "required": false, "schema": { "type": "string", "minLength": 1 }, "description": "The order of the sorting items-`Desc` (descending) or `Asc` (ascending). For example, to sort the records by name in ascending order, specify `name:Asc`." }, { "in": "query", "name": "next", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the nextCursor value from the response to get the next set of records. Used along with limit for pagination." }, { "in": "query", "name": "previous", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the previousCursor value from the response to get the previous set of records. Used along with limit for pagination." } ], "responses": { "200": { "description": "Returns array of a snippet metadata objects" }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/projects/{projectId}/snippets/{snippetId}": { "delete": { "operationId": "deleteSnippet_2_0", "summary": "Delete a snippet", "description": "Delete a [snippet](doc:snippet) resource in a project.", "tags": [ "Snippets v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "projectId", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "path", "name": "snippetId", "description": "snippet ID", "required": true, "schema": { "type": "string" } } ], "responses": { "204": { "description": "Returns the Project with resources after deleting the specified resource." }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/projects/{projectId}/trainallflows": { "post": { "operationId": "trainallflows_2_0", "summary": "Train all flows in a project", "description": "Train all flows in project [Project](doc:project).", "tags": [ "Projects v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "projectId", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "202": { "description": "Successfully created Task to train all Flows in the Project.", "content": { "application/json": { "schema": { "type": "object", "properties": { "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "status": { "type": "string", "description": "The status of the task", "example": "queued", "enum": [ "queued", "active", "done", "cancelling", "cancelled", "error" ] }, "type": { "type": "string", "example": "trainIntents" }, "parameters": { "type": "object" }, "lastChangedAt": { "type": "number", "example": 1594243850 }, "lastCreatedAt": { "type": "number", "example": 1594243850 }, "currentStep": { "type": "integer", "example": 0 }, "totalStep": { "type": "integer", "example": 100 } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/projects/{projectId}/yesnointents/train": { "post": { "operationId": "trainYesNoIntentsProject_2_0", "summary": "Create Tasks to Train the YesNoIntents for all the locales in a project", "description": "Create Tasks to Train the [YesNoIntents](doc:intent) of all locales in a project", "tags": [ "YesNoIntents v2.0", "Projects v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "projectId", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "202": { "description": "Successfully created Tasks to train YesNoIntents for all the locales", "content": { "application/json": { "schema": { "type": "array", "items": { "type": "object", "properties": { "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "status": { "type": "string", "description": "The status of the task", "example": "queued", "enum": [ "queued", "active", "done", "cancelling", "cancelled", "error" ] }, "type": { "type": "string", "example": "trainIntents" }, "parameters": { "type": "object" }, "lastChangedAt": { "type": "number", "example": 1594243850 }, "lastCreatedAt": { "type": "number", "example": 1594243850 }, "currentStep": { "type": "integer", "example": 0 }, "totalStep": { "type": "integer", "example": 100 } } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/projects/validateprojectname": { "post": { "operationId": "validateProjectName_2_0", "summary": "Checks for name conflicts.", "description": "Checks whether the given name is allowed in the current organization or already being used.", "tags": [ "Projects v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" } ], "responses": { "204": { "description": "The project name can be used." }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The project name can't be used as it is already being used." }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/search": { "get": { "operationId": "searchResources_2_0", "summary": "A global search", "description": "A global search", "tags": [ "Search v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "query", "name": "projectId", "description": "Filter by projectId", "required": false, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "query", "name": "filter", "required": false, "schema": { "type": "string" }, "description": "Filter records by specific field eg:name." }, { "in": "query", "name": "limit", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100 }, "description": "The maximum number of items to return. The default is 25." }, { "in": "query", "name": "skip", "required": false, "schema": { "type": "integer", "minimum": 0 }, "description": "The number of items to skip. The default is 0. Used along with a limit of a pagination." }, { "in": "query", "name": "sort", "required": false, "schema": { "type": "string", "minLength": 1 }, "description": "The order of the sorting items-`Desc` (descending) or `Asc` (ascending). For example, to sort the records by name in ascending order, specify `name:Asc`." }, { "in": "query", "name": "next", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the nextCursor value from the response to get the next set of records. Used along with limit for pagination." }, { "in": "query", "name": "previous", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the previousCursor value from the response to get the previous set of records. Used along with limit for pagination." } ], "responses": { "200": { "description": "Returns array of search results", "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "name": { "type": "string", "description": "The name of the Resource", "example": "pizza-endpoint" }, "type": { "type": "string", "description": "The type of a resource", "example": "endpoint", "enum": [ "endpoint", "extension", "flow", "function", "lexicon", "milestone", "nluconnector", "playbook", "project", "snapshot" ] }, "subType": { "oneOf": [ { "type": "string", "description": "The NLUConnector type", "example": "cognigy", "enum": [ "alexa", "dialogflow", "dialogflowBuiltIn", "amazonLexBuiltIn", "luis", "watson", "noNlu", "cognigy", "code", "generativeAI", "lex" ] }, { "type": "string", "example": "webchat2", "enum": [ "facebook", "alexa", "slack", "generic", "inject", "rest", "realtime", "socket", "adminconsole", "webchat2", "dialogflow", "twilio", "twilio-sms", "line", "intercom", "microsoftBotFramework", "microsoftTeams", "sunshineConversations", "admin-webchat", "avaya", "nonConversational", "voiceGateway2", "amazonLex", "workplace", "webhook", "abstractRest", "userlike", "ringCentralEngage", "audioCodes", "bandwidth", "whatsapp", "eightByEight", "genesysBotConnector", "niceCXOne", "agentAssistVoice", "webchat3" ] }, { "type": "string", "description": "Supported Generative AI Providers", "enum": [ "openAI", "azureOpenAI", "anthropic", "googleVertexAI", "googleGemini", "alephAlpha" ] } ] }, "projectId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "lastChanged": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 } } } }, "total": { "type": "integer", "example": 1 }, "next": { "oneOf": [ { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, { "nullable": true } ], "example": "5ce7c2d833ea1e04d7e6c432" }, "previous": { "oneOf": [ { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, { "nullable": true } ], "example": null } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/snapshots/{snapshotId}/downloadlink": { "post": { "operationId": "composeSnapshotDownloadLink_2_0", "summary": "Creates a download link to a Snapshot", "description": "Creates a download link to a [Snapshot](doc:snapshot).", "tags": [ "Snapshots v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "snapshotId", "description": "The Id of the Snapshot", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "projectId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } } } }, "responses": { "200": { "description": "Returning a link to download the Snapshot", "content": { "application/json": { "schema": { "type": "object", "properties": { "downloadLink": { "type": "string", "format": "uri" } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/snapshots": { "post": { "operationId": "createSnapshot_2_0", "summary": "Create a Task to create a new Snapshot", "description": "Create a Task to create a new [Snapshot](doc:snapshot) resource in a project.", "tags": [ "Snapshots v2.0" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the Snapshot", "example": "New Snapshot" }, "description": { "type": "string", "description": "The description of the Snapshot", "example": "Version 1" }, "projectId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } } } }, "responses": { "202": { "description": "Created a Task to create the Snapshot.", "content": { "application/json": { "schema": { "type": "object", "properties": { "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "status": { "type": "string", "description": "The status of the task", "example": "queued", "enum": [ "queued", "active", "done", "cancelling", "cancelled", "error" ] }, "type": { "type": "string", "example": "trainIntents" }, "parameters": { "type": "object" }, "lastChangedAt": { "type": "number", "example": 1594243850 }, "lastCreatedAt": { "type": "number", "example": 1594243850 }, "currentStep": { "type": "integer", "example": 0 }, "totalStep": { "type": "integer", "example": 100 } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "get": { "operationId": "indexSnapshots_2_0", "summary": "Get Snapshots", "description": "Get 25 [Snapshots](https://docs.cognigy.com/ai/resources/deploy/snapshots/) of a project. To change the default value, use the `limit` query parameter. Additionally, you can filter, sort, and paginate the results.", "tags": [ "Snapshots v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "query", "name": "projectId", "description": "Filter by projectId", "required": false, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "query", "name": "filter", "required": false, "schema": { "type": "string" }, "description": "The name the snapshot to filter the records" }, { "in": "query", "name": "limit", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100 }, "description": "The maximum number of items to return. The default is 25." }, { "in": "query", "name": "skip", "required": false, "schema": { "type": "integer", "minimum": 0 }, "description": "The number of items to skip. The default is 0. Used along with a limit of a pagination." }, { "in": "query", "name": "sort", "required": false, "schema": { "type": "string", "minLength": 1 }, "description": "The order of the sorting items-`Desc` (descending) or `Asc` (ascending). For example, to sort the records by name in ascending order, specify `name:Asc`." }, { "in": "query", "name": "next", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the nextCursor value from the response to get the next set of records. Used along with limit for pagination." }, { "in": "query", "name": "previous", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the previousCursor value from the response to get the previous set of records. Used along with limit for pagination." } ], "responses": { "200": { "description": "Returns array of snapshot metadata objects", "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "name": { "type": "string", "description": "The name of the Snapshot", "example": "New Snapshot" }, "description": { "type": "string", "description": "The description of the Snapshot", "example": "Version 1" }, "isPackaged": { "type": "boolean", "description": "Whether the Snapshot has already been packaged and is ready for download" }, "packageExpiresAt": { "type": "number", "description": "The timestamp where the downloadable package expires" }, "hash": { "type": "string", "description": "The hash of the Snapshot identifying the contents of the Snapshot" }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "minimum": 0, "maximum": 2147483647, "example": 1527621049 } } } }, "total": { "type": "integer", "example": 1 }, "next": { "oneOf": [ { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, { "nullable": true } ], "example": "5ce7c2d833ea1e04d7e6c432" }, "previous": { "oneOf": [ { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, { "nullable": true } ], "example": null } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/snapshots/{snapshotId}": { "delete": { "operationId": "deleteSnapshot_2_0", "summary": "Create a Task to delete a Snapshot", "description": "Create a Task to delete a [Snapshot](doc:snapshot).", "tags": [ "Snapshots v2.0" ], "parameters": [ { "in": "path", "name": "snapshotId", "description": "The Id of the Snapshot", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "202": { "description": "Successfully created Task to delete the Snapshot.", "content": { "application/json": { "schema": { "type": "object", "properties": { "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "status": { "type": "string", "description": "The status of the task", "example": "queued", "enum": [ "queued", "active", "done", "cancelling", "cancelled", "error" ] }, "type": { "type": "string", "example": "trainIntents" }, "parameters": { "type": "object" }, "lastChangedAt": { "type": "number", "example": 1594243850 }, "lastCreatedAt": { "type": "number", "example": 1594243850 }, "currentStep": { "type": "integer", "example": 0 }, "totalStep": { "type": "integer", "example": 100 } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] }, "get": { "operationId": "readSnapshot_2_0", "summary": "Get a Snapshot", "description": "Get a single [Snapshot](doc:snapshot) resource in a snapshot.", "tags": [ "Snapshots v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "snapshotId", "description": "The Id of the Snapshot", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "200": { "description": "Returns Snapshot Object", "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the Snapshot", "example": "New Snapshot" }, "description": { "type": "string", "description": "The description of the Snapshot", "example": "Version 1" }, "isPackaged": { "type": "boolean", "description": "Whether the Snapshot has already been packaged and is ready for download" }, "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "hash": { "type": "string", "description": "The hash identifying the contents of the Snapshot", "example": "Version 1" }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "description": "Unix-timestamp", "example": 1694518620, "minimum": 0, "maximum": 2147483647 } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/snapshots/{snapshotId}/resources": { "get": { "operationId": "indexResourcesInSnapshot_2_0", "summary": "Get resources in a Snapshot", "description": "Get 25 resources of a specific type in a Snapshot by default. To change the default value, use the `limit` query parameter. Additionally, you can filter, sort, and paginate the results.", "tags": [ "Snapshots v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "snapshotId", "description": "The Id of the Snapshot", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } }, { "in": "query", "name": "resourceType", "description": "The type of a resource", "required": true, "schema": { "type": "string", "enum": [ "flow", "nluconnector", "locale", "flowState" ] } }, { "in": "query", "name": "filter", "required": false, "schema": { "type": "string" }, "description": "The name of the specific resource to filter the records" }, { "in": "query", "name": "limit", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100 }, "description": "The maximum number of items to return. The default is 25." }, { "in": "query", "name": "skip", "required": false, "schema": { "type": "integer", "minimum": 0 }, "description": "The number of items to skip. The default is 0. Used along with a limit of a pagination." }, { "in": "query", "name": "sort", "required": false, "schema": { "type": "string", "minLength": 1 }, "description": "The order of the sorting items-`Desc` (descending) or `Asc` (ascending). For example, to sort the records by name in ascending order, specify `name:Asc`." }, { "in": "query", "name": "next", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the nextCursor value from the response to get the next set of records. Used along with limit for pagination." }, { "in": "query", "name": "previous", "required": false, "schema": { "type": "string", "minLength": 24, "maxLength": 24 }, "description": "This should be the previousCursor value from the response to get the previous set of records. Used along with limit for pagination." } ], "responses": { "200": { "description": "Returns array of resource metadata objects", "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "name": { "type": "string", "description": "The name of the Resource", "example": "New Resource" }, "referenceId": { "type": "string", "description": "The reference ID of the resource" }, "resourceType": { "type": "string", "description": "The type of resource", "example": "flow" }, "createdBy": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "createdAt": { "type": "integer", "minimum": 0, "maximum": 2147483647, "example": 1527621049 } } } }, "total": { "type": "integer", "example": 1 }, "next": { "oneOf": [ { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, { "nullable": true } ], "example": "5ce7c2d833ea1e04d7e6c432" }, "previous": { "oneOf": [ { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, { "nullable": true } ], "example": null } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/snapshots/{snapshotId}/package": { "post": { "operationId": "packageSnapshot_2_0", "summary": "Create a Task to package a Snapshot", "description": "Create a Task to package a [Snapshot](doc:snapshot).", "tags": [ "Snapshots v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "snapshotId", "description": "The Id of the Snapshot", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "responses": { "202": { "description": "Succesfully started downloading the Snapshot.", "content": { "application/json": { "schema": { "type": "object", "properties": { "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "status": { "type": "string", "description": "The status of the task", "example": "queued", "enum": [ "queued", "active", "done", "cancelling", "cancelled", "error" ] }, "type": { "type": "string", "example": "trainIntents" }, "parameters": { "type": "object" }, "lastChangedAt": { "type": "number", "example": 1594243850 }, "lastCreatedAt": { "type": "number", "example": 1594243850 }, "currentStep": { "type": "integer", "example": 0 }, "totalStep": { "type": "integer", "example": 100 } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/snapshots/{snapshotId}/restore": { "post": { "operationId": "restoreSnapshot_2_0", "summary": "Created a Task to restore a Snapshot", "description": "Created a Task to restore a [Snapshot](doc:snapshot).", "tags": [ "Snapshots v2.0" ], "parameters": [ { "in": "path", "name": "snapshotId", "description": "The Id of the Snapshot", "required": true, "schema": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "projectId" ], "properties": { "projectId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 } } } } } }, "responses": { "202": { "description": "Successfully created a Task to restore the Snapshot.", "content": { "application/json": { "schema": { "type": "object", "properties": { "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "status": { "type": "string", "description": "The status of the task", "example": "queued", "enum": [ "queued", "active", "done", "cancelling", "cancelled", "error" ] }, "type": { "type": "string", "example": "trainIntents" }, "parameters": { "type": "object" }, "lastChangedAt": { "type": "number", "example": 1594243850 }, "lastCreatedAt": { "type": "number", "example": 1594243850 }, "currentStep": { "type": "integer", "example": 0 }, "totalStep": { "type": "integer", "example": 100 } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/snapshots/upload": { "post": { "operationId": "uploadSnapshotPackage_2_0", "summary": "Upload a Snapshot package", "description": "Upload a [Snapshot](doc:snapshot) package and create an task to process it.", "tags": [ "Snapshots v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" } ], "requestBody": { "required": true, "content": { "multipart/form-data": { "schema": { "type": "object", "properties": { "projectId": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "file": { "type": "string", "format": "binary" } } } } } }, "responses": { "202": { "description": "Successfully uploaded the Snapshot and created a Task to process it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "_id": { "type": "string", "example": "5ce7c2d833ea1e04d7e6c432", "pattern": "^[a-z0-9]{24}$", "minLength": 24, "maxLength": 24 }, "status": { "type": "string", "description": "The status of the task", "example": "queued", "enum": [ "queued", "active", "done", "cancelling", "cancelled", "error" ] }, "type": { "type": "string", "example": "trainIntents" }, "parameters": { "type": "object" }, "lastChangedAt": { "type": "number", "example": 1594243850 }, "lastCreatedAt": { "type": "number", "example": 1594243850 }, "currentStep": { "type": "integer", "example": 0 }, "totalStep": { "type": "integer", "example": 100 } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/users/changepassword": { "post": { "operationId": "changePassword_2_0", "summary": "Changes the password of a user.", "description": "Changes the password of a user with given email.", "tags": [ "Users v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "query", "name": "organisationId", "required": false, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "email", "newPassword", "oldPassword" ], "properties": { "email": { "type": "string", "description": "The email of the user" }, "oldPassword": { "type": "string", "description": "The current (old) password of the user" }, "newPassword": { "type": "string", "description": "The new password the user wants to use" } } } } } }, "responses": { "204": { "description": "The password was successfully changed." }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/users/requestpasswordreset": { "post": { "operationId": "requestPasswordReset_2_0", "summary": "Request a password reset", "description": "Request a password reset Mail", "tags": [ "Users v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "query", "name": "organisationId", "required": false, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "email" ], "properties": { "email": { "type": "string", "description": "The E-Mail-Adress of the corresponding user account" } } } } } }, "responses": { "204": { "description": "Successfully sent password reset Mail" }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/users/resetpassword": { "post": { "operationId": "resetPassword_2_0", "summary": "Reset the password", "description": "Reset the password by the given token", "tags": [ "Users v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "token", "newPassword" ], "properties": { "token": { "type": "string", "description": "The password reset token." }, "newPassword": { "type": "string", "description": "The new password." } } } } } }, "responses": { "200": { "description": "Successfully changed password.", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "example": true } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/users/validatepasswordresettoken": { "post": { "operationId": "validatePasswordResetToken_2_0", "summary": "validate password reset token", "description": "Check if the password reset token is still valid", "tags": [ "Users v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "token" ], "properties": { "token": { "type": "string", "description": "The password reset token." } } } } } }, "responses": { "204": { "description": "Password reset token is valid." }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/endpoint/inject": { "post": { "operationId": "inject_2_0", "summary": "Inject a Message to a Flow", "description": "Sends the injected message to the flow. Can be used to send a notification to a contact at some point after they stopped talking to your Flow, or after some API call is done.", "tags": [ "Endpoint v2.0" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "userId", "text", "data", "URLToken", "sessionId" ], "properties": { "userId": { "type": "string", "format": "email", "example": "user@example.com" }, "text": { "type": "string", "example": "inject text" }, "data": { "type": "object" }, "URLToken": { "type": "string", "example": "endpoint-url-token" }, "sessionId": { "type": "string", "example": "your-session-id" } } } } } }, "responses": { "200": { "description": "Returns success message.", "content": { "text/html": { "examples": { "response": { "value": "Message was sent to AI for Flow processing" } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/endpoint/notify": { "post": { "operationId": "notify_2_0", "summary": "Notify a Contact", "description": "Sends a notification directly to the contact without letting the input run through the attached flow.", "tags": [ "Endpoint v2.0" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "userId", "text", "data", "URLToken" ], "properties": { "userId": { "type": "string", "format": "email", "example": "user@example.com" }, "text": { "type": "string", "example": "inject text" }, "data": { "type": "object" }, "attachments": { "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "name": { "type": "string" }, "caption": { "type": "string" }, "url": { "type": "string" }, "type": { "type": "string", "enum": [ "file", "document" ] } }, "required": [ "name", "url", "type" ] }, { "type": "object", "properties": { "name": { "type": "string" }, "caption": { "type": "string" }, "url": { "type": "string" }, "type": { "type": "string", "enum": [ "image" ] } }, "required": [ "name", "url", "type" ] }, { "type": "object", "properties": { "name": { "type": "string" }, "caption": { "type": "string" }, "url": { "type": "string" }, "type": { "type": "string", "enum": [ "video" ] } }, "required": [ "name", "url", "type" ] }, { "type": "object", "properties": { "name": { "type": "string" }, "caption": { "type": "string" }, "url": { "type": "string" }, "type": { "type": "string", "enum": [ "audio" ] } }, "required": [ "name", "url", "type" ] }, { "type": "object", "properties": { "name": { "type": "string" }, "caption": { "type": "string" }, "url": { "type": "string" }, "type": { "type": "string", "enum": [ "sticker" ] } }, "required": [ "name", "url", "type" ] }, { "type": "object", "properties": { "type": { "type": "string", "enum": [ "contact" ] }, "addresses": { "type": "array", "items": { "type": "object", "properties": { "city": { "type": "string" }, "country": { "type": "string" }, "countryCode": { "type": "string" }, "state": { "type": "string" }, "street": { "type": "string" }, "type": { "type": "string", "enum": [ "HOME", "WORK" ] }, "zip": { "type": "string" }, "postOfficeBox": { "type": "string" }, "extendedAddress": { "type": "string" }, "latitude": { "type": "number" }, "longitude": { "type": "number" } } } }, "birthday": { "type": "string" }, "emails": { "type": "array", "items": { "type": "object", "properties": { "email": { "type": "string" }, "type": { "type": "string", "enum": [ "HOME", "WORK" ] } } } }, "urls": { "type": "array", "items": { "type": "object", "properties": { "url": { "type": "string" }, "type": { "type": "string", "enum": [ "HOME", "WORK" ] } } } }, "photos": { "type": "array", "items": { "type": "string" } }, "gender": { "type": "string" }, "languages": { "type": "array", "items": { "type": "string" } }, "timeZone": { "type": "string" }, "notes": { "type": "array", "items": { "type": "string" } } }, "required": [ "type" ] }, { "type": "object", "properties": { "type": { "type": "string", "enum": [ "location" ] }, "latitude": { "type": "number" }, "longitude": { "type": "number" }, "name": { "type": "string" }, "title": { "type": "string" }, "address": { "type": "string" } }, "required": [ "type", "latitude", "longitude" ] } ] } }, "URLToken": { "type": "string", "example": "endpoint-url-token" }, "sessionId": { "type": "string", "example": "your-session-id" } } } } } }, "responses": { "200": { "description": "Returns success message.", "content": { "text/html": { "examples": { "response": { "value": "Sucessfully sent message to user" } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/sessions/{sessionId}/context/inject": { "post": { "operationId": "injectContext_2_0", "summary": "Inject a Context", "tags": [ "Session v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "sessionId", "description": "The Id of the Session", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "userId", "context" ], "properties": { "userId": { "type": "string", "format": "email", "example": "user@example.com" }, "context": { "type": "object" } } } } } }, "responses": { "200": { "description": "Returns the injected context.", "content": { "application/json": { "schema": { "type": "object", "example": { "key": "value" } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/sessions/{sessionId}/state/inject": { "post": { "operationId": "injectState_2_0", "summary": "Inject a State", "tags": [ "Session v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "sessionId", "description": "The Id of the Session", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "state", "userId" ], "properties": { "state": { "type": "string", "example": "default" }, "userId": { "type": "string", "example": "mail@example.com" } } } } } }, "responses": { "200": { "description": "Returns the injected state.", "content": { "application/json": { "schema": { "type": "object", "properties": { "state": { "type": "string", "example": "default" } } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/sessions/{sessionId}/context/reset": { "post": { "operationId": "resetContext_2_0", "summary": "Reset a Context", "tags": [ "Session v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "sessionId", "description": "The Id of the Session", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "flowReferenceId", "entryPoint", "userId" ], "properties": { "flowReferenceId": { "type": "string", "format": "uuid" }, "entryPoint": { "type": "string", "format": "uuid" }, "userId": { "type": "string", "example": "mail@example.com" } } } } } }, "responses": { "200": { "description": "Returns the resetted context.", "content": { "application/json": { "schema": { "type": "object", "example": { "key": "value" } } } } }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } }, "/v2.0/sessions/{sessionId}/state/reset": { "post": { "operationId": "resetState_2_0", "summary": "Reset a State", "tags": [ "Session v2.0" ], "parameters": [ { "in": "header", "name": "Accept", "description": "The default media type is application/hal+json. Use application/json for pure data results.", "required": false, "schema": { "type": "string", "enum": [ "application/json", "application/hal+json", "application/xml", "text/xml", "text/csv" ] }, "example": "application/json" }, { "in": "path", "name": "sessionId", "description": "The Id of the Session", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "userId" ], "properties": { "userId": { "type": "string", "example": "mail@example.com" } } } } } }, "responses": { "204": { "description": "Successfully resetted the state" }, "400": { "description": "The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing)", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Request" }, "title": { "type": "string", "example": "Bad Request Error" }, "status": { "type": "number", "example": 400 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "401": { "description": "The request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Unauthorized" }, "title": { "type": "string", "example": "Unauthorized Error" }, "status": { "type": "number", "example": 401 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 401 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "402": { "description": "Upgrade your Plan to increase your Quota.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payment Required" }, "title": { "type": "string", "example": "Payment Required Error" }, "status": { "type": "number", "example": 402 }, "detail": { "type": "string", "example": "Validation failed. Missing payload." }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 402 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "403": { "description": "The server understood the request but refuses to authorize it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Forbidden" }, "title": { "type": "string", "example": "Forbidden Error" }, "status": { "type": "number", "example": 403 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "404": { "description": "The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Found" }, "title": { "type": "string", "example": "Not Found Error" }, "status": { "type": "number", "example": 404 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} }, "logLevel": { "type": "string", "example": "error" } } } } } }, "405": { "description": "The method received in the request-line is known by the origin server but not supported by the target resource.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Method Not Allowed" }, "title": { "type": "string", "example": "Method Not Allowed Error" }, "status": { "type": "number", "example": 405 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "409": { "description": "The request conflicts with current state of the server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Conflict" }, "title": { "type": "string", "example": "Conflict Error" }, "status": { "type": "number", "example": 409 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1004 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "413": { "description": "The request entity is larger than limits defined by server.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Payload Too Large" }, "title": { "type": "string", "example": "Payload Too Large Error" }, "status": { "type": "number", "example": 413 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "500": { "description": "The server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Internal Server Error" }, "title": { "type": "string", "example": "Internal Server Error" }, "status": { "type": "number", "example": 500 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "501": { "description": "The server does not support the functionality required to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Not Implemented" }, "title": { "type": "string", "example": "Not Implemented Error" }, "status": { "type": "number", "example": 501 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1009 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "502": { "description": "The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Bad Gateway" }, "title": { "type": "string", "example": "Bad Gateway Error" }, "status": { "type": "number", "example": 502 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "503": { "description": "The server is not ready to handle the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Service Unavailable" }, "title": { "type": "string", "example": "Service Unavailable Error" }, "status": { "type": "number", "example": 503 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 503 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } }, "504": { "description": "The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "Gateway Timeout" }, "title": { "type": "string", "example": "Gateway Timeout Error" }, "status": { "type": "number", "example": 504 }, "detail": { "type": "string" }, "instance": { "type": "string", "example": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432" }, "code": { "type": "string", "example": 1000 }, "traceId": { "type": "string", "example": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f" }, "details": { "type": "object", "example": {} } } } } } } }, "security": [ { "APIKeyHeader": [], "APIKeyQueryParam": [], "OAuth2": [] } ] } } } }