{ "opencollection": "1.0.0", "info": { "name": "Coveo Activity Activities Machine learning associations 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": "Machine learning associations", "type": "folder" }, "items": [ { "info": { "name": "List Query Pipeline ML Model Associations", "type": "http" }, "http": { "method": "GET", "url": "https://platform.cloud.coveo.com/rest/search/v2/admin/pipelines/:pipelineId/ml/model/associations", "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": "pipelineId", "value": "", "type": "path", "description": "The unique identifier of the target query pipeline." }, { "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." }, { "name": "filter", "value": "", "type": "query", "description": "Filter associations by model display name or description (case-insensitive substring match).\n\nFor example, `filter=product` will match associations where the model display name or description contains \"product\".\n\nBy default, all associations are returned when no filter is specified." } ], "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 page of Coveo Machine Learning model associations for a specific query pipeline.\n
\nPrivilege(s) required\n\n```json\n{\"level\":\"NORMAL\",\"owner\":\"SEARCH_API\",\"targetDomain\":\"QUERY_PIPELINE\",\"type\":\"VIEW\",\"targetId\":\"*\"}\n```\n
" }, { "info": { "name": "Associate an Existing Machine Learning Model with an Existing Pipeline.", "type": "http" }, "http": { "method": "POST", "url": "https://platform.cloud.coveo.com/rest/search/v2/admin/pipelines/:pipelineId/ml/model/associations", "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": "pipelineId", "value": "", "type": "path", "description": "The unique identifier of the target query pipeline." } ], "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": "
\nPrivilege(s) required\n\n```json\n{\"level\":\"NORMAL\",\"owner\":\"SEARCH_API\",\"targetDomain\":\"QUERY_PIPELINE\",\"type\":\"EDIT\",\"targetId\":\"{pipelineId}\"}\n```\n
" }, { "info": { "name": "Get a ML Model Association", "type": "http" }, "http": { "method": "GET", "url": "https://platform.cloud.coveo.com/rest/search/v2/admin/pipelines/:pipelineId/ml/model/associations/:associationId", "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": "pipelineId", "value": "", "type": "path", "description": "The unique identifier of the target query pipeline." }, { "name": "associationId", "value": "", "type": "path" } ], "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 Coveo Machine Learning model association.\n
\nPrivilege(s) required\n\n```json\n{\"level\":\"NORMAL\",\"owner\":\"SEARCH_API\",\"targetDomain\":\"QUERY_PIPELINE\",\"type\":\"VIEW\",\"targetId\":\"*\"}\n```\n
" }, { "info": { "name": "Update ML Model Association", "type": "http" }, "http": { "method": "PUT", "url": "https://platform.cloud.coveo.com/rest/search/v2/admin/pipelines/:pipelineId/ml/model/associations/:associationId", "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": "pipelineId", "value": "", "type": "path", "description": "The unique identifier of the target query pipeline." }, { "name": "associationId", "value": "", "type": "path" } ], "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": "Changes the configuration of an association in a pipeline.\n
\nPrivilege(s) required\n\n```json\n{\"level\":\"NORMAL\",\"owner\":\"SEARCH_API\",\"targetDomain\":\"QUERY_PIPELINE\",\"type\":\"EDIT\",\"targetId\":\"{pipelineId}\"}\n```\n
" }, { "info": { "name": "Remove Query Pipeline ML Model Association", "type": "http" }, "http": { "method": "DELETE", "url": "https://platform.cloud.coveo.com/rest/search/v2/admin/pipelines/:pipelineId/ml/model/associations/:associationId", "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": "pipelineId", "value": "", "type": "path", "description": "The unique identifier of the target query pipeline." }, { "name": "associationId", "value": "", "type": "path" } ], "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": "Removes a single existing association between a machine learning model and a query pipeline.\n
\nPrivilege(s) required\n\n```json\n{\"level\":\"NORMAL\",\"owner\":\"SEARCH_API\",\"targetDomain\":\"QUERY_PIPELINE\",\"type\":\"EDIT\",\"targetId\":\"{pipelineId}\"}\n```\n
" }, { "info": { "name": "Update ML Model Association Position", "type": "http" }, "http": { "method": "PUT", "url": "https://platform.cloud.coveo.com/rest/search/v2/admin/pipelines/:pipelineId/ml/model/associations/:associationId/position", "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": "pipelineId", "value": "", "type": "path", "description": "The unique identifier of the target query pipeline." }, { "name": "associationId", "value": "", "type": "path" }, { "name": "position", "value": "", "type": "query" } ], "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": "Changes the position of an association in a pipeline.\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 Pipeline ML Model Associations", "type": "http" }, "http": { "method": "POST", "url": "https://platform.cloud.coveo.com/rest/search/v2/admin/pipelines/:pipelineId/ml/model/associations/bulkGet", "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." }, { "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 page of Coveo Machine Learning model associations for a specific query pipeline.\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 ML Model Association Operation.", "type": "http" }, "http": { "method": "POST", "url": "https://platform.cloud.coveo.com/rest/search/v2/admin/pipelines/:pipelineId/ml/model/associations/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." }, { "name": "pipelineId", "value": "", "type": "path", "description": "The unique identifier of the target query pipeline." } ], "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 a Batch of ML Model Association Operations.", "type": "http" }, "http": { "method": "POST", "url": "https://platform.cloud.coveo.com/rest/search/v2/admin/pipelines/:pipelineId/ml/model/associations/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." }, { "name": "pipelineId", "value": "", "type": "path", "description": "The unique identifier of the target query pipeline." } ], "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": "\n Validate that a list of operations would be accepted by our API and executed.\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": "Returns the Version of ML Models Supported by the Organization in the Request.", "type": "http" }, "http": { "method": "GET", "url": "https://platform.cloud.coveo.com/rest/search/v2/admin/pipelines/ml/version", "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." } ], "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": "
\nPrivilege(s) required\n\n```json\n{\"level\":\"NORMAL\",\"owner\":\"SEARCH_API\",\"targetDomain\":\"QUERY_PIPELINE\",\"type\":\"VIEW\",\"targetId\":\"*\"}\n```\n
" } ] } ], "bundled": true }