{ "opencollection": "1.0.0", "info": { "name": "Coveo Activity Activities Catalogs 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": "Catalogs", "type": "folder" }, "items": [ { "info": { "name": "Show Catalog", "type": "http" }, "http": { "method": "GET", "url": "https://platform.cloud.coveo.com/rest/organizations/:organizationId/catalogs/:catalogId", "params": [ { "name": "organizationId", "value": "", "type": "path", "description": "The unique identifier of the target [organization](https://docs.coveo.com/en/185/).
**Example:** `acmecorporation8tp8wu3`" }, { "name": "catalogId", "value": "", "type": "path", "description": "The unique identifier of the [catalog](https://docs.coveo.com/en/3143/) to show.
**Example:** `644e1dd7-2a7f-18fb-b8ed-ed78c3f92c2b`" } ] }, "docs": "Shows a [catalog](https://docs.coveo.com/en/3143/) in an [organization](https://docs.coveo.com/en/185/).

**Required privilege:** Catalogs - View

Privilege required\n```\n{\"owner\":\"COMMERCE\",\"targetDomain\":\"CATALOG\",\"type\":\"VIEW\",\"targetId\":\"*\"}\n```\n
" }, { "info": { "name": "Update Catalog", "type": "http" }, "http": { "method": "PUT", "url": "https://platform.cloud.coveo.com/rest/organizations/:organizationId/catalogs/:catalogId", "params": [ { "name": "organizationId", "value": "", "type": "path", "description": "The unique identifier of the target [organization](https://docs.coveo.com/en/185/).
**Example:** `acmecorporation8tp8wu3`" }, { "name": "catalogId", "value": "", "type": "path", "description": "The unique identifier of the [catalog](https://docs.coveo.com/en/3143/) to update.
**Example:** `644e1dd7-2a7f-18fb-b8ed-ed78c3f92c2b`" } ], "body": { "type": "json", "data": "{}" } }, "docs": "Updates a [catalog](https://docs.coveo.com/en/3143/) in an [organization](https://docs.coveo.com/en/185/).

**Required privilege:** Catalogs - Edit

Privilege required\n```\n{\"owner\":\"COMMERCE\",\"targetDomain\":\"CATALOG\",\"type\":\"EDIT\",\"targetId\":\"*\"}\n```\n
" }, { "info": { "name": "Delete Catalog", "type": "http" }, "http": { "method": "DELETE", "url": "https://platform.cloud.coveo.com/rest/organizations/:organizationId/catalogs/:catalogId", "params": [ { "name": "organizationId", "value": "", "type": "path", "description": "The unique identifier of the target [organization](https://docs.coveo.com/en/185/).
**Example:** `acmecorporation8tp8wu3`" }, { "name": "catalogId", "value": "", "type": "path", "description": "The unique identifier of the [catalog](https://docs.coveo.com/en/3143/) to delete.
**Example:** `644e1dd7-2a7f-18fb-b8ed-ed78c3f92c2b`" } ] }, "docs": "Deletes a [catalog](https://docs.coveo.com/en/3143/) in an [organization](https://docs.coveo.com/en/185/).

**Required privilege:** Catalogs - Edit

Privilege required\n```\n{\"owner\":\"COMMERCE\",\"targetDomain\":\"CATALOG\",\"type\":\"EDIT\",\"targetId\":\"*\"}\n```\n
" }, { "info": { "name": "List Catalogs", "type": "http" }, "http": { "method": "GET", "url": "https://platform.cloud.coveo.com/rest/organizations/:organizationId/catalogs", "params": [ { "name": "organizationId", "value": "", "type": "path", "description": "The unique identifier of the target [organization](https://docs.coveo.com/en/185/).
**Example:** `acmecorporation8tp8wu3`" }, { "name": "filter", "value": "", "type": "query", "description": "Filter that will be matched against the catalog id, name, description and its configuration name..
**Example:** `catalogName`" }, { "name": "catalogIds", "value": "", "type": "query", "description": "List of the unique identifiers of the [catalog](https://docs.coveo.com/en/3143/) to show.
**Example:** `[644e1dd7-2a7f-18fb-b8ed-ed78c3f92c2b]`" }, { "name": "sourceIds", "value": "", "type": "query", "description": "List of the unique identifiers of the sources" }, { "name": "page", "value": "", "type": "query", "description": "The 0-based index number of the page of catalogs to retrieve.
**Minimum:** `0`
**Default:** `0`" }, { "name": "pageSize", "value": "", "type": "query", "description": "The number of catalogs to list per page.
**Minimum:** `1`
**Maximum:** `1000`
**Default:** `10`" }, { "name": "enrichWithFields", "value": "", "type": "query", "description": "If true, catalog will be enriched with field suggestions. This requires a call to SearchAPI" }, { "name": "catalogSortingType", "value": "", "type": "query", "description": "The field to sort the returned catalogs by.
**Default:** `name`" }, { "name": "sortingDirection", "value": "", "type": "query", "description": "The `sortingType` order to list the catalogs in.
**Default:** `ASC`" } ] }, "docs": "Lists the [catalogs](https://docs.coveo.com/en/3143/) of an [organization](https://docs.coveo.com/en/185/).

**Required privilege:** Catalogs - View

Privilege required\n```\n{\"owner\":\"COMMERCE\",\"targetDomain\":\"CATALOG\",\"type\":\"VIEW\",\"targetId\":\"*\"}\n```\n
" }, { "info": { "name": "Create Catalog", "type": "http" }, "http": { "method": "POST", "url": "https://platform.cloud.coveo.com/rest/organizations/:organizationId/catalogs", "params": [ { "name": "organizationId", "value": "", "type": "path", "description": "The unique identifier of the target [organization](https://docs.coveo.com/en/185/).
**Example:** `acmecorporation8tp8wu3`" } ], "body": { "type": "json", "data": "{}" } }, "docs": "Creates a [catalog](https://docs.coveo.com/en/3143/) in an [organization](https://docs.coveo.com/en/185/).

**Required privilege:** Catalogs - Edit

Privilege required\n```\n{\"owner\":\"COMMERCE\",\"targetDomain\":\"CATALOG\",\"type\":\"EDIT\",\"targetId\":\"*\"}\n```\n
" }, { "info": { "name": "List Catalogs Using Catalog Ids as a Body for Filtering.", "type": "http" }, "http": { "method": "POST", "url": "https://platform.cloud.coveo.com/rest/organizations/:organizationId/catalogs/ids", "params": [ { "name": "organizationId", "value": "", "type": "path", "description": "The unique identifier of the target [organization](https://docs.coveo.com/en/185/).
**Example:** `acmecorporation8tp8wu3`" }, { "name": "filter", "value": "", "type": "query", "description": "Filter that will be matched against the catalog id, name, description and its configuration name..
**Example:** `catalogName`" }, { "name": "sourceIds", "value": "", "type": "query", "description": "List of the unique identifiers of the sources" }, { "name": "page", "value": "", "type": "query", "description": "The 0-based index number of the page of catalogs to retrieve.
**Minimum:** `0`
**Default:** `0`" }, { "name": "pageSize", "value": "", "type": "query", "description": "The number of catalogs to list per page.
**Minimum:** `1`
**Maximum:** `1000`
**Default:** `10`" } ], "body": { "type": "json", "data": "{}" } }, "docs": "Lists the [catalogs](https://docs.coveo.com/en/3143/) of an [organization](https://docs.coveo.com/en/185/).

**Required privilege:** Catalogs - View

Privilege required\n```\n{\"owner\":\"COMMERCE\",\"targetDomain\":\"CATALOG\",\"type\":\"VIEW\",\"targetId\":\"*\"}\n```\n
" }, { "info": { "name": "Suggest Fields", "type": "http" }, "http": { "method": "POST", "url": "https://platform.cloud.coveo.com/rest/organizations/:organizationId/catalogs/fieldsSuggestions", "params": [ { "name": "organizationId", "value": "", "type": "path", "description": "The unique identifier of the target [organization](https://docs.coveo.com/en/185/).
**Example:** `acmecorporation8tp8wu3`" } ], "body": { "type": "json", "data": "{}" } }, "docs": "Shows suggested fields and sample values for mapping in an [organization](https://docs.coveo.com/en/185/).

**Required privilege:** Execute Query

Privilege required\n```\n{\"owner\":\"SEARCH_API\",\"targetDomain\":\"EXECUTE_QUERY\",\"targetId\":\"*\"}\n```\n
" }, { "info": { "name": "Show Field Stats", "type": "http" }, "http": { "method": "GET", "url": "https://platform.cloud.coveo.com/rest/organizations/:organizationId/catalogs/:catalogId/fieldStats", "params": [ { "name": "organizationId", "value": "", "type": "path", "description": "The unique identifier of the target [organization](https://docs.coveo.com/en/185/).
**Example:** `acmecorporation8tp8wu3`" }, { "name": "catalogId", "value": "", "type": "path", "description": "The unique identifier of the [catalog](https://docs.coveo.com/en/3143/)." }, { "name": "forceRefresh", "value": "", "type": "query", "description": "If true, the database cache will be refreshed and the most up-to-date fields data returned." } ] }, "docs": "Retrieve statistics about the usage of fields by objects in the catalog's source.

**Required privilege:** Catalogs - View

Privilege required\n```\n{\"owner\":\"COMMERCE\",\"targetDomain\":\"CATALOG\",\"type\":\"VIEW\",\"targetId\":\"*\"}\n```\n
" }, { "info": { "name": "List Catalogs Within Specified Project and According to the Specified Filter.", "type": "http" }, "http": { "method": "GET", "url": "https://platform.cloud.coveo.com/rest/organizations/:organizationId/catalogs/project", "params": [ { "name": "organizationId", "value": "", "type": "path", "description": "The unique identifier of the target [organization](https://docs.coveo.com/en/185/).
**Example:** `acmecorporation8tp8wu3`" }, { "name": "filter", "value": "", "type": "query", "description": "Filter that will be matched against the catalog id, name, description and its configuration name..
**Example:** `catalogName`" }, { "name": "projectId", "value": "", "type": "query", "description": "Id of the project for which we want to retrieve the catalogs" }, { "name": "sourceIds", "value": "", "type": "query", "description": "List of the unique identifiers of the sources" }, { "name": "page", "value": "", "type": "query", "description": "The 0-based index number of the page of catalogs to retrieve.
**Minimum:** `0`
**Default:** `0`" }, { "name": "pageSize", "value": "", "type": "query", "description": "The number of catalogs to list per page.
**Minimum:** `1`
**Maximum:** `1000`
**Default:** `10`" }, { "name": "enrichWithFields", "value": "", "type": "query", "description": "If true, catalog will be enriched with field suggestions. This requires a call to SearchAPI" }, { "name": "catalogSortingType", "value": "", "type": "query", "description": "The field to sort the returned catalogs by.
**Default:** `name`" }, { "name": "sortingDirection", "value": "", "type": "query", "description": "The `sortingType` order to list the catalogs in.
**Default:** `ASC`" } ] }, "docs": "Lists the [catalogs](https://docs.coveo.com/en/3143/) of an [organization](https://docs.coveo.com/en/185/).

**Required privilege:** Catalogs - View

Privilege required\n```\n{\"owner\":\"COMMERCE\",\"targetDomain\":\"CATALOG\",\"type\":\"VIEW\",\"targetId\":\"*\"}\n```\n
" } ] } ], "bundled": true }