{ "opencollection": "1.0.0", "info": { "name": "Coveo Activity Activities Pipelines API", "version": "1.0.0" }, "request": { "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://platform.cloud.coveo.com/oauth/authorize", "accessTokenUrl": "https://platform.cloud.coveo.com/oauth/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "items": [ { "info": { "name": "Pipelines", "type": "folder" }, "items": [ { "info": { "name": "List Query Pipelines", "type": "http" }, "http": { "method": "GET", "url": "https://platform.cloud.coveo.com/rest/search/v1/admin/pipelines", "params": [ { "name": "isOrderAscending", "value": "", "type": "query", "description": "Whether to sort the results in ascending order." }, { "name": "filter", "value": "", "type": "query", "description": "The query filter to match.\n\nThis allows you to search within query pipeline statement definitions and descriptions.\n\nBy default, results are not required to match a specific query filter." }, { "name": "sortBy", "value": "", "type": "query", "description": "The sort criteria to apply on the results.\n\n**Allowed values:** `definition`, `description`, and `position`.\n\n**Default:** `position`" }, { "name": "page", "value": "", "type": "query", "description": "The 0-based number of the page of results to get." }, { "name": "excludeAbTestTargets", "value": "", "type": "query", "description": "Whether to exclude the A/B test targets from the result." }, { "name": "perPage", "value": "", "type": "query", "description": "The number of results to include per page." }, { "name": "organizationId", "value": "mycoveocloudv2organization", "type": "query", "description": "The unique identifier of the target Coveo Cloud organization.\n\nSpecifying a value for this parameter is only necessary when you are authenticating the API call with an OAuth2 token." }, { "name": "enablePagination", "value": "", "type": "query", "description": "Whether to receive the pipelines in a paginated format." } ], "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://platform.cloud.coveo.com/oauth/authorize", "accessTokenUrl": "https://platform.cloud.coveo.com/oauth/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Gets a sorted page of query pipelines matching certain criteria.\n
\nPrivilege(s) required\n\n```json\n{\"level\":\"NORMAL\",\"owner\":\"SEARCH_API\",\"targetDomain\":\"QUERY_PIPELINE\",\"type\":\"VIEW\",\"targetId\":\"*\"}\n```\n
" }, { "info": { "name": "Create Query Pipeline", "type": "http" }, "http": { "method": "POST", "url": "https://platform.cloud.coveo.com/rest/search/v1/admin/pipelines", "params": [ { "name": "organizationId", "value": "mycoveocloudv2organization", "type": "query", "description": "The unique identifier of the target Coveo Cloud organization.\n\nSpecifying a value for this parameter is only necessary when you are authenticating the API call with an OAuth2 token." } ], "body": { "type": "json", "data": "{}" }, "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://platform.cloud.coveo.com/oauth/authorize", "accessTokenUrl": "https://platform.cloud.coveo.com/oauth/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Creates a new query pipeline.\n
\nPrivilege(s) required\n\n```json\n{\"level\":\"NORMAL\",\"owner\":\"SEARCH_API\",\"targetDomain\":\"QUERY_PIPELINE\",\"type\":\"CREATE\",\"targetId\":\"*\"}\n```\n
" }, { "info": { "name": "Get Query Pipeline", "type": "http" }, "http": { "method": "GET", "url": "https://platform.cloud.coveo.com/rest/search/v1/admin/pipelines/:pipelineId", "params": [ { "name": "pipelineId", "value": "", "type": "path", "description": "The unique identifier of the target query pipeline." }, { "name": "organizationId", "value": "mycoveocloudv2organization", "type": "query", "description": "The unique identifier of the target Coveo Cloud organization.\n\nSpecifying a value for this parameter is only necessary when you are authenticating the API call with an OAuth2 token." } ], "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://platform.cloud.coveo.com/oauth/authorize", "accessTokenUrl": "https://platform.cloud.coveo.com/oauth/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Gets a single query pipeline.\n
\nPrivilege(s) required\n\n```json\n{\"level\":\"NORMAL\",\"owner\":\"SEARCH_API\",\"targetDomain\":\"QUERY_PIPELINE\",\"type\":\"VIEW\",\"targetId\":\"{pipelineId}\"}\n```\n
" }, { "info": { "name": "Update Query Pipeline", "type": "http" }, "http": { "method": "PUT", "url": "https://platform.cloud.coveo.com/rest/search/v1/admin/pipelines/:pipelineId", "params": [ { "name": "pipelineId", "value": "", "type": "path", "description": "The unique identifier of the target query pipeline." }, { "name": "organizationId", "value": "mycoveocloudv2organization", "type": "query", "description": "The unique identifier of the target Coveo Cloud organization.\n\nSpecifying a value for this parameter is only necessary when you are authenticating the API call with an OAuth2 token." } ], "body": { "type": "json", "data": "{}" }, "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://platform.cloud.coveo.com/oauth/authorize", "accessTokenUrl": "https://platform.cloud.coveo.com/oauth/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Modifies a single query pipeline.\n
\nPrivilege(s) required\n\n```json\n{\"level\":\"NORMAL\",\"owner\":\"SEARCH_API\",\"targetDomain\":\"QUERY_PIPELINE\",\"type\":\"VIEW\",\"targetId\":\"{pipelineId}\"},\n{\"level\":\"NORMAL\",\"owner\":\"SEARCH_API\",\"targetDomain\":\"QUERY_PIPELINE\",\"type\":\"EDIT\",\"targetId\":\"{pipelineId}\"}\n```\n
" }, { "info": { "name": "Delete Query Pipeline", "type": "http" }, "http": { "method": "DELETE", "url": "https://platform.cloud.coveo.com/rest/search/v1/admin/pipelines/:pipelineId", "params": [ { "name": "pipelineId", "value": "", "type": "path", "description": "The unique identifier of the target query pipeline." }, { "name": "organizationId", "value": "mycoveocloudv2organization", "type": "query", "description": "The unique identifier of the target Coveo Cloud organization.\n\nSpecifying a value for this parameter is only necessary when you are authenticating the API call with an OAuth2 token." } ], "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://platform.cloud.coveo.com/oauth/authorize", "accessTokenUrl": "https://platform.cloud.coveo.com/oauth/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Deletes a single query pipeline.\n
\nPrivilege(s) required\n\n```json\n{\"level\":\"NORMAL\",\"owner\":\"SEARCH_API\",\"targetDomain\":\"QUERY_PIPELINE\",\"type\":\"VIEW\",\"targetId\":\"{pipelineId}\"},\n{\"level\":\"NORMAL\",\"owner\":\"SEARCH_API\",\"targetDomain\":\"QUERY_PIPELINE\",\"type\":\"EDIT\",\"targetId\":\"{pipelineId}\"}\n```\n
" }, { "info": { "name": "Copy Query Pipeline", "type": "http" }, "http": { "method": "POST", "url": "https://platform.cloud.coveo.com/rest/search/v1/admin/pipelines/:pipelineId/duplicate", "params": [ { "name": "pipelineId", "value": "", "type": "path", "description": "The unique identifier of the target query pipeline." }, { "name": "organizationId", "value": "mycoveocloudv2organization", "type": "query", "description": "The unique identifier of the target Coveo Cloud organization.\n\nSpecifying a value for this parameter is only necessary when you are authenticating the API call with an OAuth2 token." } ], "body": { "type": "json", "data": "{}" }, "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://platform.cloud.coveo.com/oauth/authorize", "accessTokenUrl": "https://platform.cloud.coveo.com/oauth/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Duplicates a single query pipeline.\n
\nPrivilege(s) required\n\n```json\n{\"level\":\"NORMAL\",\"owner\":\"SEARCH_API\",\"targetDomain\":\"QUERY_PIPELINE\",\"type\":\"VIEW\",\"targetId\":\"*\"},\n{\"level\":\"NORMAL\",\"owner\":\"SEARCH_API\",\"targetDomain\":\"QUERY_PIPELINE\",\"type\":\"CREATE\",\"targetId\":\"*\"}\n```\n
" }, { "info": { "name": "Swap Query Pipeline Names", "type": "http" }, "http": { "method": "POST", "url": "https://platform.cloud.coveo.com/rest/search/v1/admin/pipelines/:pipelineId/swap", "params": [ { "name": "pipelineId", "value": "", "type": "path", "description": "The unique identifier of the target query pipeline." }, { "name": "other", "value": "", "type": "query", "description": "The unique identifier of the query pipeline to swap names with." }, { "name": "organizationId", "value": "mycoveocloudv2organization", "type": "query", "description": "The unique identifier of the target Coveo Cloud organization.\n\nSpecifying a value for this parameter is only necessary when you are authenticating the API call with an OAuth2 token." } ], "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://platform.cloud.coveo.com/oauth/authorize", "accessTokenUrl": "https://platform.cloud.coveo.com/oauth/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Swaps the names of two query pipelines. Doing so will affect the routing of incoming queries whose `pipeline` parameter is defined as the `name` value of one of the swapped query pipelines.\n
\nPrivilege(s) required\n\n```json\n{\"level\":\"NORMAL\",\"owner\":\"SEARCH_API\",\"targetDomain\":\"QUERY_PIPELINE\",\"type\":\"EDIT\",\"targetId\":\"{pipelineId}\"}\n```\n
" }, { "info": { "name": "List Query Pipelines", "type": "http" }, "http": { "method": "POST", "url": "https://platform.cloud.coveo.com/rest/search/v1/admin/pipelines/bulkGet", "params": [ { "name": "organizationId", "value": "mycoveocloudv2organization", "type": "query", "description": "The unique identifier of the target Coveo Cloud organization.\n\nSpecifying a value for this parameter is only necessary when you are authenticating the API call with an OAuth2 token." }, { "name": "isOrderAscending", "value": "", "type": "query", "description": "Whether to sort the results in ascending order." }, { "name": "filter", "value": "", "type": "query", "description": "The query filter to match.\n\nThis allows you to search within query pipeline statement definitions and descriptions.\n\nBy default, results are not required to match a specific query filter." }, { "name": "sortBy", "value": "", "type": "query", "description": "The sort criteria to apply on the results.\n\n**Allowed values:** `definition`, `description`, and `position`.\n\n**Default:** `position`" }, { "name": "page", "value": "", "type": "query", "description": "The 0-based number of the page of results to get." }, { "name": "perPage", "value": "", "type": "query", "description": "The number of results to include per page." } ], "body": { "type": "json", "data": "{}" }, "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://platform.cloud.coveo.com/oauth/authorize", "accessTokenUrl": "https://platform.cloud.coveo.com/oauth/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Gets a sorted page of query pipelines matching certain criteria.\n
\nPrivilege(s) required\n\n```json\n{\"level\":\"NORMAL\",\"owner\":\"SEARCH_API\",\"targetDomain\":\"QUERY_PIPELINE\",\"type\":\"VIEW\",\"targetId\":\"*\"}\n```\n
" }, { "info": { "name": "Validate a Single Pipeline Operation.", "type": "http" }, "http": { "method": "POST", "url": "https://platform.cloud.coveo.com/rest/search/v1/admin/pipelines/validate", "params": [ { "name": "organizationId", "value": "mycoveocloudv2organization", "type": "query", "description": "The unique identifier of the target Coveo Cloud organization.\n\nSpecifying a value for this parameter is only necessary when you are authenticating the API call with an OAuth2 token." } ], "body": { "type": "json", "data": "{}" }, "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://platform.cloud.coveo.com/oauth/authorize", "accessTokenUrl": "https://platform.cloud.coveo.com/oauth/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Validate that a specific operation would be accepted by our API and executed.\n
\nPrivilege(s) required\n\n```json\n{\"level\":\"NORMAL\",\"owner\":\"SEARCH_API\",\"targetDomain\":\"QUERY_PIPELINE\",\"type\":\"VIEW\",\"targetId\":\"*\"}\n```\n
" }, { "info": { "name": "Validate Batch of Pipeline Operations.", "type": "http" }, "http": { "method": "POST", "url": "https://platform.cloud.coveo.com/rest/search/v1/admin/pipelines/validate/batch", "params": [ { "name": "organizationId", "value": "mycoveocloudv2organization", "type": "query", "description": "The unique identifier of the target Coveo Cloud organization.\n\nSpecifying a value for this parameter is only necessary when you are authenticating the API call with an OAuth2 token." } ], "body": { "type": "json", "data": "{}" }, "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://platform.cloud.coveo.com/oauth/authorize", "accessTokenUrl": "https://platform.cloud.coveo.com/oauth/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "\r\n Validate that a list of operations would be accepted by our API and executed.\r\n A maximum of 15 can be processed per request.\n
\nPrivilege(s) required\n\n```json\n{\"level\":\"NORMAL\",\"owner\":\"SEARCH_API\",\"targetDomain\":\"QUERY_PIPELINE\",\"type\":\"VIEW\",\"targetId\":\"*\"}\n```\n
" }, { "info": { "name": "Import Query Pipeline Statements", "type": "http" }, "http": { "method": "POST", "url": "https://platform.cloud.coveo.com/rest/search/v1/admin/pipelines/:pipelineId/statements/import", "params": [ { "name": "pipelineId", "value": "", "type": "path", "description": "The unique identifier of the target query pipeline." }, { "name": "feature", "value": "", "type": "query", "description": "The query pipeline feature to match.\n\n**Allowed values:** `when`, `filter`, `trigger`, `stop`, `thesaurus`, `topClicks`, `querySuggest`, `rankingweight`, `recommendation`, and `queryParamOverride`.\n\nBy default, results are not required to match a specific query pipeline feature." }, { "name": "organizationId", "value": "mycoveocloudv2organization", "type": "query", "description": "The unique identifier of the target Coveo Cloud organization.\n\nSpecifying a value for this parameter is only necessary when you are authenticating the API call with an OAuth2 token." } ], "body": { "type": "multipart-form", "data": [ { "name": "fileName", "type": "text", "value": "" } ] }, "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://platform.cloud.coveo.com/oauth/authorize", "accessTokenUrl": "https://platform.cloud.coveo.com/oauth/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Import the definition, condition, and description of statements from a CSV file to a specific query pipeline.\n
\nPrivilege(s) required\n\n```json\n{\"level\":\"NORMAL\",\"owner\":\"SEARCH_API\",\"targetDomain\":\"QUERY_PIPELINE\",\"type\":\"EDIT\",\"targetId\":\"{pipelineId}\"}\n```\n
" } ] } ], "bundled": true }