1.
schema:
type: integer
format: Int32
default: 10
- name: filter
in: query
description: A filter that only retrieves matching Insight Panel configurations.
schema:
type: string
- name: order
in: query
description: 'The order in which the configurations are listed. The available values are: asc: items are sorted in ascending order.desc: items are sorted in descending order.filter parameter.
totalPages:
type: integer
description: The total number of item pages according to the perPage parameter.
deprecated: false
security:
- oauth2:
- full
post:
tags:
- Insight Panel
summary: Create an Insight Panel Configuration
description: Creates a new Insight Panel configuration.
operationId: insight-panel-configuration-create
parameters:
- name: organizationId
in: path
description: The unique identifier of the target [organization](https://docs.coveo.com/en/185/).1.
schema:
type: integer
format: Int32
default: 10
- name: filter
in: query
description: A filter that only retrieves matching Insight Panel configurations.
schema:
type: string
- name: order
in: query
description: 'The order in which the configurations are listed. The available values are: asc: items are sorted in ascending order.desc: items are sorted in descending order.filter parameter.
totalPages:
type: integer
description: The total number of item pages according to the perPage parameter.
deprecated: false
security:
- oauth2:
- full
x-codegen-request-body-name: body
/rest/organizations/{organizationId}/insightconfig/v1/configs/{configId}:
get:
tags:
- Insight Panel
summary: Get an Insight Panel Configuration
description: Gets a single Insight Panel configuration.
operationId: insight-panel-configuration-get
parameters:
- name: organizationId
in: path
description: The unique identifier of the target [organization](https://docs.coveo.com/en/185/).The basic query expression, typically the keywords entered by the end user in a query box.
Note: When logging a Search Usage Analytics event for a query, the queryText field of that event should be set to the q value of the corresponding query.
0, meaning that the entire HTML document is requested.
schema:
type: integer
responses:
'200':
description: The item's HTML preview.
content: {}
deprecated: false
security:
- oauth2:
- full
/rest/organizations/{organizationId}/insightconfig/v1/configs/projects/get:
get:
tags:
- Insight Panel
summary: Get Insight Configurations by Project
description: Retrieves insight panel configurations associated with a specific project in a [Coveo Cloud organization](https://docs.coveo.com/en/185/).asc: items are sorted in ascending order.desc: items are sorted in descending order.The total number of items that match the query for the current user (security trimming applied).
Note: When logging a Search Usage Analytics event for a query, the numberOfResults field of that event should be set to the totalCount value of the query (for reporting purposes).
The total number of items that match the query for the current user (security trimming applied) after duplicate filtering has been applied (see the duplicateFiltering query parameter).
The requestDuration added to the computing time (in milliseconds) that was required by the Search API.
The time (in milliseconds) that was required for the index to find the query items.
example: '1175' requestDuration: type: integer description:The indexDuration added to the time (in milliseconds) that was required to establish a connection between the Search API server and the index server.
The query UUID. Each query sent to the Search API has its own randomly generated searchUid.
Note: When logging a Search or Custom Usage Analytics event for a query, or a Click Usage Analytics event for an opened query result item, the searchQueryUid field of that event should be set to the searchUid value of the query response.
The name of the query pipeline to use for this request (bypassing its conditions, if it has any).
example: CustomQueryPipeline apiVersion: type: integer description:The version of the Search API that sent the query.
example: 2 exception: type: object properties: code: type: string context: type: string isFallbackToAdmin: type: boolean description:Whether the admin session ID was allowed and used by the Coveo for Salesforce search engine. The value will be set to true when this is the case, and might be absent or set to false otherwise.
The errors that did not make the query fail, but should be addressed. These might be security issues, deprecated behaviors, or any other kind of concern.
items: type: string errors: type: array description:The errors that critically changed the query behavior. These should be addressed right away to prevent future errors.
items: type: string index: type: string description:The identifier of the index mirror against which the query was executed (see the indexToken query parameter).
The Base64 encoded identifier of the index mirror to which the request was forwarded (see the index parameter).
If you do not specify an indexToken (or index) value, any index mirror could be used.
Note: Passing an indexToken (or index) value has no effect when the results of a specific request can be returned from cache (see the maximumAge query parameter).
The type of Coveo query pipeline Trigger statement (see Manage trigger rules).
example: notify content: type: object properties: {} description:The actions that the client should perform based on the Trigger statements defined in the query pipelines (see the pipeline query parameter).
Note: A trigger statement must have a condition. Otherwise, the Search API ignores it and does not include it in the triggers array of the query response (see Manage trigger rules).
The terms to highlight in each query result item. Includes all basic query expression keywords, as well as any word that was stemmed from a basic query expression keyword (see the q query parameter), unless the keyword was preceded by the no stemming Coveo query syntax operator (+).
The phrases to highlight in each query result item. This property is populated when the basic query expression (see the q query parameter) contains one or more exact phrase match requests (terms between double quote characters).
The query corrections suggested by the index, if the enableDidYouMean query parameter was set to true.
The facet results returned by the query. These results are included in the order they were requested in the facets query parameter.
The path to the suggested facet value (only applies to hierarchical facet value suggestions).
Example: If the suggested hierarchical facet value is Parrot, the returned path could be ["Animals", "Birds", "Parrot"].
The custom context information to send along with the request. Must be a dictionary of key-value pairs (JSON) where each key is a string, and each value is either a string or an array of strings.
Coveo Machine Learning models may use this information to provide contextually relevant output. Moreover, this information can be referred to in query expressions and QPL statements by using the $context object.
Note: When logging a Search Usage Analytics event for a query, the customData field of that event should include the same data as the context parameter of the query. However, each context key included in customData must be prefixed by context_ (e.g., the userRoles key in context becomes context_userRoles in customData).
See also the referrer parameter.
The locale of the current user. Must comply with IETF's BCP 47 definition.
Coveo Machine Learning models use this information to provide contextually relevant output. Moreover, this information can be referred to in query expressions and QPL statements by using the $locale object.
Note: When logging a Search Usage Analytics event, the language field of that event should match the language part of the locale value of the query (e.g., en-US in locale becomes en in language).
The tz database identifier of the time zone to use to correctly interpret dates in the query expression and result items.
If not specified, the default time zone of the server hosting the index is used.
Note: While no Coveo Machine Learning models use this information, it can nevertheless affect the ranking scores (and thus, potentially the order) or result items, as ranking expressions may be based on time constants.
example: America/New_York actionsHistory: type: array description:The previous query and page view actions made by the current user.
Coveo Machine Learning Content Recommendation models use this information to provide contextually relevant output.
Note: Page view actions are typically populated by the coveo.analytics.js script.
items: $ref: '#/components/schemas/ActionHistory' visitorId: type: string description:A GUID which represents the current user, who can either be authenticated or anonymous.
visitorId is deprecated and has been replaced by clientId in newer versions of the Coveo UI libraries. For compatibility, the new first-party cookie and local storage values are still named coveo_visitorId.
For older versions of the JavaScript Search Framework, the visitor ID is generated by the Coveo Usage Analytics service and stored in a non-expiring third-party cookie. Note: Third-party cookies have also been deprecated. This is unrelated to the deprecation of visitorId.
The maximum age of cached results, in milliseconds.
If the results of a specific request are available in the cache, and if those results are no older than the maximumAge value, the service returns those results rather than forwarding a new query to the index.
Note: This parameter is automatically overridden when staticQuery is set to true.
default and thumbnail.
default: default
conditions:
$ref: '#/components/schemas/RestConditions'
badge:
type: object
properties:
field:
type: string
description: The name of the field from which the value is retrieved.
label:
type: string
description: A specific label to display.
color:
type: string
description: The hexadecimal color code.
example: '#5080F0'
details:
type: array
items:
type: object
properties:
field:
type: string
label:
type: string
resultActions:
type: object
properties:
attachToCase:
type: object
properties:
enabled:
type: boolean
description: Users can attach items to the current CRM object (e.g., an opened case).
copyToClipboard:
type: object
properties:
enabled:
type: boolean
description: Users can copy a result to their clipboard.
quickView:
type: object
properties:
enabled:
type: boolean
description: Users can preview a result without leaving the search page.
sendAsEmail:
type: object
properties:
enabled:
type: boolean
description: Users can insert a link to an item into an email.
sendToFeed:
type: object
properties:
enabled:
type: boolean
description: Users can insert a link to an item into a post.
description: Indicates the actions that are available on each result.
facets:
type: array
description: The facets configured for the Insight Panel interface.
items:
type: object
properties:
field:
type: string
description: The name of the facet field.
label:
type: string
description: The title of the facet.
displayValuesAs:
type: string
description: Whether to display the facet values as checkboxes (multiple selection), links (single selection), or boxes (multiple selection). Possible values are checkbox, link, and box.
example: link
default: checkbox
tabs:
type: array
description: The tabs configured for the Insight Panel interface.
items:
type: object
properties:
label:
type: string
description: The caption for the tab.
example: People
conditions:
$ref: '#/components/schemas/RestConditions'
settings:
type: object
properties:
createArticle:
type: object
properties:
enabled:
type: boolean
fullSearch:
type: object
properties:
enabled:
type: boolean
description: The settings for the Insight Panel interface.
SettingsSection:
type: object
properties:
createArticle:
type: object
description: Display a button to create a knowledge article.
required: true
properties:
enabled:
type: boolean
fullSearch:
type: object
description: Display a button to open a full search page.
required: true
properties:
enabled:
type: boolean
userActions:
$ref: '#/components/schemas/UserActionsOptions'
TagParam:
type: object
properties:
enabled:
type: boolean
color:
type: string
example: '#FF00AA'
RestQueryResult:
type: object
properties:
title:
type: string
description: The item title.
Note: When logging a Click Usage Analytics event for an opened query result item, the documentTitle field of that event should be set to the title value of the opened query result item.
The item URI.
Notes:
uri value to create hyperlinks to the item. Use the clickUri value instead.documentUrl field of that event should be set to the uri value of the opened query result item.The human readable item URI.
Note: Avoid using the printableUri value to create hyperlinks to the item. Use the clickUri value instead.
The hyperlinkable item URI.
Notes:
clickUri value when you want to create hyperlinks to the item, rather than the uri or printableUri values.clickUri value is not necessarily unique for each item.The unique item identifier. You should consider the uniqueId value as an opaque string.
The contextual excerpt generated for the item (see the excerptLength query parameter).
retrieveFirstSentences query parameter).
example: Hello, I know Coveo currently hosts organizations in two independent cloud platforms, the new Coveo Cloud V2 and Coveo Cloud V1, the original Coveo offering in the cloud. I would like to learn the main differences between the two Coveo Cloud versions ...
summary:
type: string
description: The item summary (see the summaryLength query parameter).
flags:
type: string
description: The flags that are set on the item by the index. Distinct values are separated by semicolons.
example: HasHtmlVersion;HasMobileHtmlVersion
hasHtmlVersion:
type: boolean
description: Whether the index contains an HTML version of this item.
hasMobileHtmlVersion:
type: boolean
description: Whether the index contains a mobile HTML version of this item.
score:
type: integer
description: The total ranking score computed for the item (see the sortCriteria and rankingFunctions query parameters).
example: 1626
percentScore:
type: number
description: The item ranking score expressed as a percentage (see the sortCriteria and rankingFunctions query parameters).
example: 90.73539
rankingInfo:
type: string
description: The raw debug information generated by the index to detail how the item was ranked. This property is null unless the debug query parameter is set to true.
example: 'Document weights: Title: 0; Quality: 180; Date: 596; Adjacency: 0; Source: 500; Custom: 350; Collaborative rating: 0; QRE: 0; Ranking functions: 0; Total weight: 1626'
rating:
type: number
description: The item rating (see the enableCollaborativeRating query parameter).
Note: Unless collaborative rating is enabled for your index, the value of this property is always 3.
If applicable, represents the type of ranking modification that was applied to this result.
Note: When logging a Click Usage Analytics event for an opened query result item, the rankingModifier field of that event should be set to the rankingModifier value of the opened query result item, if available.
title string.
items:
$ref: '#/components/schemas/RestHighlightResponse'
firstSentencesHighlights:
type: array
description: The length and offset of each word to highlight in the item firstSentences string.
items:
$ref: '#/components/schemas/RestHighlightResponse'
excerptHighlights:
type: array
description: The length and offset of each word to highlight in the item excerpt string.
items:
$ref: '#/components/schemas/RestHighlightResponse'
printableUriHighlights:
type: array
description: The length and offset of each word to highlight in the item printableUri string.
items:
$ref: '#/components/schemas/RestHighlightResponse'
summaryHighlights:
type: array
description: The length and offset of each word to highlight in the item summary string.
items:
$ref: '#/components/schemas/RestHighlightResponse'
parentResult:
$ref: '#/components/schemas/RestQueryResult'
childResults:
type: array
description: An array of references to the children of this item, if result folding was applied (see the filterField query parameter). The query results contained in this field will have both their parent and child results set to null.
items:
$ref: '#/components/schemas/RestQueryResult'
totalNumberOfChildResults:
type: integer
description: The total number of children available in the index for this item, if result folding was applied (see the filterField query parameter).
absentTerms:
type: array
description: The basic query expression terms which this query result item does not match.
Note: This property is populated by terms from the query pipeline-processed q value (not from the original q value).
The values of the fields which were retrieved for this item (see the fieldsToInclude and fieldsToExclude query parameters).
Whether to force a successful response to include debug information.
Notes:
format parameter).true in production, as it has a negative impact on query performance.The constant query expression, typically populated with expressions that must apply to all queries sent from a specific search interface (e.g., from a specific tab). Once evaluated, the result sets of those expressions are kept in a special cache.
Tip: Avoid including dynamic content in the constant query expression. Otherwise, you risk filling up the cache with useless data, which can have a negative impact on performance.
facets: type: array description: The facet operations to perform on the query results. items: $ref: '#/components/schemas/ServiceRestFacetRequest' firstResult: type: integer description:The 0-based position of the first result to return in the non-paginated result set.
Along with the numberOfResults parameter, this allows you to retrieve a specific page of result items.
The number of results to return.
Along with the firstResult parameter, this allows you to retrieve a specific page of result items.
This parameter also defines the maximum number of results which can be returned by the Coveo ML Recommencations feature.
Note: The maximum numberOfResults value depends on the index settings of your Coveo organization. By default, a Coveo index can return a maximum of 5,000 items per query.
The names of the fields to include with each item in the query results. If specified, no other fields will be included.
Note: If you specify both an array of fields to include and an array of fields to exclude (see the fieldsToExclude parameter), the fieldsToExclude parameter has no effect at all.
If you do not explicitly specify an array of values for this parameter (or for the fieldsToExclude parameter), each query result item will include all of its available fields.
Important: This feature is still in an experimental state.
Whether to enable the Coveo ML query suggestions Did You Mean feature, which populates the queryCorrection property of a successful response with keyword correction suggestions.
Notes:
q parameter).enableDidYouMean and enableMLDidYouMean parameters are set to true, the output of both features will appear in the queryCorrections array.The criteria to use for sorting the query results.
Allowed values:
relevancy: use standard index ranking factors (adjacency, TDIDF, etc.) and custom ranking expressions (QREs and QRFs) to compute a ranking score for each query result item, and sort the query results by descending score value.date ascending/date descending: use the @date field to sort the query results. This field typically contains the last modification date of each item.qre: use only custom ranking expressions (QREs and QRFs) to compute a ranking score for each query result item, and sort the query results by descending score value.nosort: do not sort the query results; the index will return result items in an essentially random order.@[field] ascending/@[field] descending: sort using the value of a specific sortable field (replace [field] with the name of the target field).You can specify a list of comma-separated sort criteria. However, this only works when combining:
@views descending,@likes descending).date ascending,@views descending).Examples:
date ascending@author ascendingdate descending,@views descending,@likes descendingThe second level of origin of the request, typically the identifier of the selected tab in the graphical search interface from which the request originates.
Coveo Machine Learning models use this information to provide contextually relevant output.
Note: When logging a Search usage analytics event for a query, the originLevel2 field of that event should be set to the tab value of the query (or to the "default" string, if no tab value was specified in the query).
debug parameter is set to true.
UpdatedChangeInfo:
allOf:
- $ref: '#/components/schemas/ChangeInfo'
- type: object
description: Information about the most recent version update.
UserActionsOptions:
type: object
description: Options to configure a view of the actions taken by the user who submitted the case.
properties:
enabled:
type: boolean
description: Whether to enable the feature.
required: true
recentClickedDocuments:
type: object
description: Whether to show documents recently clicked by the user.
required: true
properties:
enabled:
type: boolean
recentQueries:
type: object
description: Whether to show recent queries performed by the user.
required: true
properties:
enabled:
type: boolean
timeline:
type: object
description: Whether to show a timeline of the user's actions.
required: true
properties:
enabled:
type: boolean
InsightPanelResultTemplate:
type: object
description: Template
properties:
name:
type: string
description: The name of the template
example: Example Template
required: true
layout:
$ref: '#/components/schemas/TemplateLayout'
conditions:
type: array
items:
$ref: '#/components/schemas/Condition'
badge:
$ref: '#/components/schemas/Badge'
details:
type: array
items:
$ref: '#/components/schemas/Detail'
resultActions:
$ref: '#/components/schemas/ResultActions'
tags:
$ref: '#/components/schemas/Tags'
Tags:
type: object
description: The tags allowed to be displayed.
properties:
recommended:
$ref: '#/components/schemas/TagParam'
viewedByCustomer:
$ref: '#/components/schemas/TagParam'
featured:
$ref: '#/components/schemas/TagParam'
Page:
type: object
properties:
totalPages:
type: integer
description: The total number of pages.
totalEntries:
type: integer
description: The total number of items.
InsightPanelInterface:
type: object
properties:
id:
type: string
description: The unique identifier of the Insight Panel interface.
example: e35eb3f4-353e-4ab8-96b8-35c09d5951c9
required: true
name:
type: string
description: The name of the Insight Panel interface
example: Example Insight Panel
required: true
resultTemplates:
type: array
items:
$ref: '#/components/schemas/InsightPanelResultTemplate'
facets:
type: array
items:
$ref: '#/components/schemas/Facet'
tabs:
type: array
items:
$ref: '#/components/schemas/Tab'
settings:
$ref: '#/components/schemas/SettingsSection'
RestListOfInsightPanelConfigurationsWithProjects:
type: object
properties:
configurations:
type: array
items:
$ref: '#/components/schemas/RestInsightPanelConfigurationWithProjects'
totalEntries:
type: integer
format: int32
description: The total number of configurations
example: 1
totalPages:
type: integer
format: int32
description: The total number of pages
example: 1
RestInsightPanelConfiguration:
type: object
properties:
id:
type: string
description: The unique identifier of the Insight Panel configuration.
name:
type: string
description: The name of the Insight Panel configuration.
example: My Insight Panel
pipeline:
type: object
properties:
id:
type: string
description: The unique identifier of the query pipeline.
name:
type: string
description: The name of the query pipeline.
models:
type: object
properties:
art:
type: object
properties:
enabled:
type: boolean
description: Indicates whether an Automatic Relevance Tuning (ART) model is configured for the query pipeline.
dne:
type: object
properties:
enabled:
type: boolean
description: Indicates whether a Dynamic Navigation Experience (DNE) model is configured for the query pipeline.
qs:
type: object
properties:
enabled:
type: boolean
description: Indicates whether a Query Suggestion (QS) model is configured for the query pipeline.
description: Information about the machine learning models.
description: Information about the query pipeline.
contextFields:
type: object
properties: {}
description: A dictionary in which the keys represent context keys, and the values are CRM field names.
example:
subject: case_subject
description: case_description
searchHub:
type: string
description: The search hub value that is recorded by Usage Analytics events.
interfaces:
type: array
description: A list of interface IDs that are bound to the Insight Panel configuration.
example:
- interface-id-1
- interface-id-2
items:
type: string
InterfaceVersionInfo:
type: object
properties:
version:
type: integer
description: The sequential number attributed to the version.
label:
type: string
description: An optional label describing the version changes.
required: false
created:
type: object
$ref: '#/components/schemas/CreatedChangeInfo'
updated:
type: object
$ref: '#/components/schemas/UpdatedChangeInfo'
isPublished:
type: boolean
description: Indicates whether the version is currently published.
restoredFromVersion:
type: integer
description: Indicates the origin of the current version, if it was restored.
required: false
ResultActions:
type: object
description: The available result actions.
enum:
- attachToCase
- copyToClipboard
- quickView
- sendAsEmail
- sendToFeed
properties:
attachToCase:
type: object
properties:
enabled:
type: boolean
copyToClipboard:
type: object
properties:
enabled:
type: boolean
quickView:
type: object
properties:
enabled:
type: boolean
sendAsEmail:
type: object
properties:
enabled:
type: boolean
sendToFeed:
type: object
properties:
enabled:
type: boolean
Facet:
type: object
description: The list of facets to display.
properties:
field:
type: string
required: true
label:
type: string
displayValueAs:
type: string
RestConditions:
type: array
items:
type: object
RestContentId:
type: object
properties:
contentIdKey:
type: string
contentIdValue:
type: string
RestInsightPanelConfigurationListIds:
required:
- ids
type: object
properties:
ids:
type: array
description: A list of configuration ids.
example:
- config-id-1
- config-id-2
items:
type: string
ActionHistory:
required:
- name
- time
type: object
properties:
name:
type: string
description: 'The action history event name.
Possible values:
- **Query**
- **PageView**'
example: PageView
value:
type: string
description: The action history value, which is either a query expression or a page URI, depending on the action history event `name`.
time:
type: string
description: The time when the action history event was sent from the client.
Condition:
type: object
description: The conditions a result needs to meet to use the template.
properties:
field:
type: string
conditionType:
type: string
description: The type of condition to apply on a field.
enum:
- isDefined
- isNotDefined
- mustMatch
- mustNotMatch
ServiceRestFacetRequest:
required:
- field
- type
type: object
properties:
field:
type: string
description: The name of the field on which to base the facet request.
Note: This must reference a field whose Facet option is enabled (see Add or edit a field).
example: author type: type: string description: Request facet values representing specific values (e.g., Alice Smith, Bob Jones, etc.). default: specific RestHierarchicalFacetResponseValue: type: object properties: field: type: string description: The name of the field on which the facet is based. example: author moreValuesAvailable: type: boolean description: Whether additional values are available for the facet. values: type: array description: The returned facet values. items: type: object properties: value: type: string description:The name of the facet value.
Note: In the case of a hierarchical facet value, this represents a single path segment.
example: Alice Smith state: type: string description: The current state of the facet value in the search interface. default: idle enum: - idle - selected - excluded numberOfResults: type: integer description:The number of query results that can be expected if the facet value is selected in the search interface.
Note: This property only gets populated when the facet currently has no selected or excluded values.
endInclusive: type: boolean description: Whether to include theend value in the range.
default: false
children:
type: array
description: The children of this hierarchical facet value.
Each child is a full-fledged hierarchical facet value that may in turn have its own children and so forth, up to a maximum depth of 50 levels.
items: $ref: '#/components/schemas/RestHierarchicalFacetResponseValue' moreValuesAvailable: type: boolean description: Whether additional values are available for the facet. isSuggested: type: boolean isAutoSelected: type: boolean description: Whether the facet value was automatically selected by Coveo ML. path: type: array items: type: string isLeafValue: type: boolean description: Whether the hierarchical value is a childless node. mlScore: type: number description: The ranking score computed by Coveo ML DNE for this facet. indexScore: type: number description: The ranking score computed by the index for this facet. isFromAutoSelect: type: boolean description: Whether the facet was recommended by Coveo ML. RestInsightPanelConfigurationUpdate: required: - contextFields - interfaces - name - pipeline type: object properties: name: type: string description: The name of the Insight Panel configuration. example: My Insight Panel pipeline: type: string description: The ID of the query pipeline to use. contextFields: type: object properties: {} description: A dictionary in which the keys represent context keys, and the values are CRM field names. example: subject: case_subject description: case_description interfaces: type: array description: A list of interface IDs that are bound to the Insight Panel configuration. example: - interface-id-1 - interface-id-2 items: type: string parameters: versions-page: name: page description: The 0-based number of the page of versions to list. in: query schema: type: integer default: 0 minimum: 0 maximum: 100 versions-per-page: name: perPage description: The number of versions to include per page. in: query schema: type: integer default: 10 minimum: 1 maximum: 100 version-number: name: versionNumber description: The sequential number identifying a version. in: path required: true schema: type: integer minimum: 1 insight-panel-interface-id: name: interfaceId description: The unique identifier of the target Insight Panel interface. example: 123e4567-e89b-12d3-a456-426614174000 in: path required: true schema: type: string versions-filter: name: filter description: A substring that must appear in a version label for this version to appear in results. in: query schema: type: string page: name: page description: The 0-based number of the page of configurations to list. in: query schema: type: integer minimum: 0 maximum: 100 perPage: name: perPage description: The maximum number of configurations to include per page. in: query schema: type: integer minimum: 0 maximum: 20 organization-id: name: organizationId description: The unique identifier of the target [organization](https://docs.coveo.com/en/185/). example: mycoveocloudv2organizationg8tp8wu3 in: path required: true schema: type: string filter: name: filter description: A substring that must appear in a search interface configuration name for this configuration to appear in results. example: Store in: query schema: type: string versions-order: name: order description: 'The sort direction of the versions based on the version number.