openapi: 3.0.1 info: title: Coveo Source API description: API for Coveo Platform termsOfService: https://www.coveo.com/en/support/terms-agreements contact: name: Coveo url: https://connect.coveo.com/s/discussions version: 1.0.0 servers: - url: https://platform.cloud.coveo.com description: Coveo public API endpoint security: - oauth2: - full tags: - name: Sources description: Operations specific to source schedules - name: Sources description: Operations specific to fields in sources paths: /rest/organizations/{organizationId}/sources/{sourceId}: get: tags: - Sources summary: Get a Single Source description: '
Privilege required ``` {"owner":"PLATFORM","targetDomain":"SOURCE","type":"VIEW","targetId":"*"} ```
' operationId: getSource parameters: - name: organizationId in: path required: true schema: type: string - name: sourceId in: path required: true schema: type: string responses: '200': description: OK content: '*/*': schema: oneOf: - $ref: '#/components/schemas/SourceModel' - $ref: '#/components/schemas/AmazonS3SourceModel' - $ref: '#/components/schemas/BoxEnterprise2SourceModel' - $ref: '#/components/schemas/CatalogSourceModel' - $ref: '#/components/schemas/Confluence2HostedSourceModel' - $ref: '#/components/schemas/Confluence2SourceModel' - $ref: '#/components/schemas/CustomSourceModel' - $ref: '#/components/schemas/DatabaseSourceModel' - $ref: '#/components/schemas/DropboxForBusinessSourceModel' - $ref: '#/components/schemas/FileSourceModel' - $ref: '#/components/schemas/GenericRestSourceModel' - $ref: '#/components/schemas/GoogleDriveDomainWideSourceModel' - $ref: '#/components/schemas/GraphQlSourceModel' - $ref: '#/components/schemas/Jira2HostedSourceModel' - $ref: '#/components/schemas/Jira2SourceModel' - $ref: '#/components/schemas/JiveHostedSourceModel' - $ref: '#/components/schemas/JiveSourceModel' - $ref: '#/components/schemas/KhorosSourceModel' - $ref: '#/components/schemas/MicrosoftDynamicsSourceModel' - $ref: '#/components/schemas/PushSourceModel' - $ref: '#/components/schemas/RSSSourceModel' - $ref: '#/components/schemas/SAPSourceModel' - $ref: '#/components/schemas/SalesforceSitesSourceModel' - $ref: '#/components/schemas/SalesforceSourceModel' - $ref: '#/components/schemas/ServiceNowSourceModel' - $ref: '#/components/schemas/SharePointOnline2SourceModel' - $ref: '#/components/schemas/SharePointSourceModel' - $ref: '#/components/schemas/ShopifySourceModel' - $ref: '#/components/schemas/SitecoreSourceModel' - $ref: '#/components/schemas/SitemapSourceModel' - $ref: '#/components/schemas/SlackSourceModel' - $ref: '#/components/schemas/Web2SourceModel' - $ref: '#/components/schemas/YouTubeSourceModel' - $ref: '#/components/schemas/ZendeskSourceModel' x-pretty-name: getSource x-required-privilege: owner: PLATFORM targetDomain: SOURCE type: VIEW targetId: '*' x-required-privileges: - owner: PLATFORM targetDomain: SOURCE type: VIEW targetId: '*' x-ui-operation-id: /rest/organizations/paramId/sources/paramId_get put: tags: - Sources summary: Update a Source from Simple Configuration description: '
Privilege required ``` {"owner":"PLATFORM","targetDomain":"SOURCE","type":"EDIT","targetId":"{sourceId}"} ```
' operationId: updateSource parameters: - name: organizationId in: path required: true schema: type: string - name: sourceId in: path required: true schema: type: string - name: updateSecurityProviders in: query required: false schema: type: boolean default: true - name: rebuild in: query required: false schema: type: boolean default: true requestBody: content: application/json: schema: oneOf: - $ref: '#/components/schemas/SourceModel' - $ref: '#/components/schemas/AmazonS3SourceModel' - $ref: '#/components/schemas/BoxEnterprise2SourceModel' - $ref: '#/components/schemas/CatalogSourceModel' - $ref: '#/components/schemas/Confluence2HostedSourceModel' - $ref: '#/components/schemas/Confluence2SourceModel' - $ref: '#/components/schemas/CustomSourceModel' - $ref: '#/components/schemas/DatabaseSourceModel' - $ref: '#/components/schemas/DropboxForBusinessSourceModel' - $ref: '#/components/schemas/FileSourceModel' - $ref: '#/components/schemas/GenericRestSourceModel' - $ref: '#/components/schemas/GoogleDriveDomainWideSourceModel' - $ref: '#/components/schemas/GraphQlSourceModel' - $ref: '#/components/schemas/Jira2HostedSourceModel' - $ref: '#/components/schemas/Jira2SourceModel' - $ref: '#/components/schemas/JiveHostedSourceModel' - $ref: '#/components/schemas/JiveSourceModel' - $ref: '#/components/schemas/KhorosSourceModel' - $ref: '#/components/schemas/MicrosoftDynamicsSourceModel' - $ref: '#/components/schemas/PushSourceModel' - $ref: '#/components/schemas/RSSSourceModel' - $ref: '#/components/schemas/SAPSourceModel' - $ref: '#/components/schemas/SalesforceSitesSourceModel' - $ref: '#/components/schemas/SalesforceSourceModel' - $ref: '#/components/schemas/ServiceNowSourceModel' - $ref: '#/components/schemas/SharePointOnline2SourceModel' - $ref: '#/components/schemas/SharePointSourceModel' - $ref: '#/components/schemas/ShopifySourceModel' - $ref: '#/components/schemas/SitecoreSourceModel' - $ref: '#/components/schemas/SitemapSourceModel' - $ref: '#/components/schemas/SlackSourceModel' - $ref: '#/components/schemas/Web2SourceModel' - $ref: '#/components/schemas/YouTubeSourceModel' - $ref: '#/components/schemas/ZendeskSourceModel' required: true responses: '200': description: OK content: '*/*': schema: oneOf: - $ref: '#/components/schemas/SourceModel' - $ref: '#/components/schemas/AmazonS3SourceModel' - $ref: '#/components/schemas/BoxEnterprise2SourceModel' - $ref: '#/components/schemas/CatalogSourceModel' - $ref: '#/components/schemas/Confluence2HostedSourceModel' - $ref: '#/components/schemas/Confluence2SourceModel' - $ref: '#/components/schemas/CustomSourceModel' - $ref: '#/components/schemas/DatabaseSourceModel' - $ref: '#/components/schemas/DropboxForBusinessSourceModel' - $ref: '#/components/schemas/FileSourceModel' - $ref: '#/components/schemas/GenericRestSourceModel' - $ref: '#/components/schemas/GoogleDriveDomainWideSourceModel' - $ref: '#/components/schemas/GraphQlSourceModel' - $ref: '#/components/schemas/Jira2HostedSourceModel' - $ref: '#/components/schemas/Jira2SourceModel' - $ref: '#/components/schemas/JiveHostedSourceModel' - $ref: '#/components/schemas/JiveSourceModel' - $ref: '#/components/schemas/KhorosSourceModel' - $ref: '#/components/schemas/MicrosoftDynamicsSourceModel' - $ref: '#/components/schemas/PushSourceModel' - $ref: '#/components/schemas/RSSSourceModel' - $ref: '#/components/schemas/SAPSourceModel' - $ref: '#/components/schemas/SalesforceSitesSourceModel' - $ref: '#/components/schemas/SalesforceSourceModel' - $ref: '#/components/schemas/ServiceNowSourceModel' - $ref: '#/components/schemas/SharePointOnline2SourceModel' - $ref: '#/components/schemas/SharePointSourceModel' - $ref: '#/components/schemas/ShopifySourceModel' - $ref: '#/components/schemas/SitecoreSourceModel' - $ref: '#/components/schemas/SitemapSourceModel' - $ref: '#/components/schemas/SlackSourceModel' - $ref: '#/components/schemas/Web2SourceModel' - $ref: '#/components/schemas/YouTubeSourceModel' - $ref: '#/components/schemas/ZendeskSourceModel' x-pretty-name: updateSource x-required-privilege: owner: PLATFORM targetDomain: SOURCE type: EDIT targetId: '{sourceId}' x-required-privileges: - owner: PLATFORM targetDomain: SOURCE type: EDIT targetId: '{sourceId}' x-ui-operation-id: /rest/organizations/paramId/sources/paramId_put delete: tags: - Sources summary: Delete a Source description: '
Privilege required ``` {"owner":"PLATFORM","targetDomain":"SOURCE","type":"EDIT","targetId":"{sourceId}"} ```
' operationId: deleteSource parameters: - name: organizationId in: path required: true schema: type: string - name: sourceId in: path required: true schema: type: string responses: '200': description: OK content: '*/*': schema: oneOf: - $ref: '#/components/schemas/SourceModel' - $ref: '#/components/schemas/AmazonS3SourceModel' - $ref: '#/components/schemas/BoxEnterprise2SourceModel' - $ref: '#/components/schemas/CatalogSourceModel' - $ref: '#/components/schemas/Confluence2HostedSourceModel' - $ref: '#/components/schemas/Confluence2SourceModel' - $ref: '#/components/schemas/CustomSourceModel' - $ref: '#/components/schemas/DatabaseSourceModel' - $ref: '#/components/schemas/DropboxForBusinessSourceModel' - $ref: '#/components/schemas/FileSourceModel' - $ref: '#/components/schemas/GenericRestSourceModel' - $ref: '#/components/schemas/GoogleDriveDomainWideSourceModel' - $ref: '#/components/schemas/GraphQlSourceModel' - $ref: '#/components/schemas/Jira2HostedSourceModel' - $ref: '#/components/schemas/Jira2SourceModel' - $ref: '#/components/schemas/JiveHostedSourceModel' - $ref: '#/components/schemas/JiveSourceModel' - $ref: '#/components/schemas/KhorosSourceModel' - $ref: '#/components/schemas/MicrosoftDynamicsSourceModel' - $ref: '#/components/schemas/PushSourceModel' - $ref: '#/components/schemas/RSSSourceModel' - $ref: '#/components/schemas/SAPSourceModel' - $ref: '#/components/schemas/SalesforceSitesSourceModel' - $ref: '#/components/schemas/SalesforceSourceModel' - $ref: '#/components/schemas/ServiceNowSourceModel' - $ref: '#/components/schemas/SharePointOnline2SourceModel' - $ref: '#/components/schemas/SharePointSourceModel' - $ref: '#/components/schemas/ShopifySourceModel' - $ref: '#/components/schemas/SitecoreSourceModel' - $ref: '#/components/schemas/SitemapSourceModel' - $ref: '#/components/schemas/SlackSourceModel' - $ref: '#/components/schemas/Web2SourceModel' - $ref: '#/components/schemas/YouTubeSourceModel' - $ref: '#/components/schemas/ZendeskSourceModel' x-pretty-name: deleteSource x-required-privilege: owner: PLATFORM targetDomain: SOURCE type: EDIT targetId: '{sourceId}' x-required-privileges: - owner: PLATFORM targetDomain: SOURCE type: EDIT targetId: '{sourceId}' x-ui-operation-id: /rest/organizations/paramId/sources/paramId_delete /rest/organizations/{organizationId}/sources/{sourceId}/schedules/{scheduleId}: get: tags: - Sources summary: Get a Source Schedule description: '
Privilege required ``` {"owner":"PLATFORM","targetDomain":"SOURCE","type":"VIEW","targetId":"*"} ```
' operationId: getSourceSchedule parameters: - name: organizationId in: path required: true schema: type: string - name: sourceId in: path required: true schema: type: string - name: scheduleId in: path required: true schema: type: string responses: '200': description: OK content: '*/*': schema: $ref: '#/components/schemas/ScheduleModel' x-pretty-name: getSourceSchedule x-required-privilege: owner: PLATFORM targetDomain: SOURCE type: VIEW targetId: '*' x-required-privileges: - owner: PLATFORM targetDomain: SOURCE type: VIEW targetId: '*' x-ui-operation-id: /rest/organizations/paramId/sources/paramId/schedules/paramId_get put: tags: - Sources summary: Update a Source Schedule description: '
Privilege required ``` {"owner":"PLATFORM","targetDomain":"SOURCE","type":"EDIT","targetId":"{sourceId}"} ```
' operationId: updateSourceSchedule parameters: - name: organizationId in: path required: true schema: type: string - name: sourceId in: path required: true schema: type: string - name: scheduleId in: path required: true schema: type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/ScheduleModel' required: true responses: '201': description: Created content: '*/*': schema: $ref: '#/components/schemas/ScheduleModel' x-pretty-name: updateSourceSchedule x-required-privilege: owner: PLATFORM targetDomain: SOURCE type: EDIT targetId: '{sourceId}' x-required-privileges: - owner: PLATFORM targetDomain: SOURCE type: EDIT targetId: '{sourceId}' x-ui-operation-id: /rest/organizations/paramId/sources/paramId/schedules/paramId_put delete: tags: - Sources summary: Delete a Source Schedule description: '
Privilege required ``` {"owner":"PLATFORM","targetDomain":"SOURCE","type":"EDIT","targetId":"{sourceId}"} ```
' operationId: deleteSourceSchedule parameters: - name: organizationId in: path required: true schema: type: string - name: sourceId in: path required: true schema: type: string - name: scheduleId in: path required: true schema: type: string responses: '204': description: No Content x-pretty-name: deleteSourceSchedule x-required-privilege: owner: PLATFORM targetDomain: SOURCE type: EDIT targetId: '{sourceId}' x-required-privileges: - owner: PLATFORM targetDomain: SOURCE type: EDIT targetId: '{sourceId}' x-ui-operation-id: /rest/organizations/paramId/sources/paramId/schedules/paramId_delete /rest/organizations/{organizationId}/sources/{sourceId}/raw: get: tags: - Sources summary: Get the Raw Configuration of a Source description: '
Privilege required ``` {"owner":"PLATFORM","targetDomain":"SOURCE","type":"VIEW","targetId":"*"} ```
' operationId: getRawSource parameters: - name: organizationId in: path required: true schema: type: string - name: sourceId in: path required: true schema: type: string - name: includeMappings in: query required: false schema: type: boolean default: true responses: '200': description: OK content: '*/*': schema: $ref: '#/components/schemas/RawSourceConfig' x-pretty-name: getRawSource x-required-privilege: owner: PLATFORM targetDomain: SOURCE type: VIEW targetId: '*' x-required-privileges: - owner: PLATFORM targetDomain: SOURCE type: VIEW targetId: '*' x-ui-operation-id: /rest/organizations/paramId/sources/paramId/raw_get put: tags: - Sources summary: Update a Source from Raw Configuration description: '
Privilege required ``` {"owner":"PLATFORM","targetDomain":"SOURCE","type":"EDIT","targetId":"{sourceId}"} ```
' operationId: updateRawSource parameters: - name: organizationId in: path required: true schema: type: string - name: sourceId in: path required: true schema: type: string - name: updateSecurityProviders in: query required: false schema: type: boolean default: true - name: rebuild in: query required: false schema: type: boolean default: true requestBody: content: application/json: schema: $ref: '#/components/schemas/RawSourceConfig' required: true responses: '200': description: OK content: '*/*': schema: oneOf: - $ref: '#/components/schemas/SourceModel' - $ref: '#/components/schemas/AmazonS3SourceModel' - $ref: '#/components/schemas/BoxEnterprise2SourceModel' - $ref: '#/components/schemas/CatalogSourceModel' - $ref: '#/components/schemas/Confluence2HostedSourceModel' - $ref: '#/components/schemas/Confluence2SourceModel' - $ref: '#/components/schemas/CustomSourceModel' - $ref: '#/components/schemas/DatabaseSourceModel' - $ref: '#/components/schemas/DropboxForBusinessSourceModel' - $ref: '#/components/schemas/FileSourceModel' - $ref: '#/components/schemas/GenericRestSourceModel' - $ref: '#/components/schemas/GoogleDriveDomainWideSourceModel' - $ref: '#/components/schemas/GraphQlSourceModel' - $ref: '#/components/schemas/Jira2HostedSourceModel' - $ref: '#/components/schemas/Jira2SourceModel' - $ref: '#/components/schemas/JiveHostedSourceModel' - $ref: '#/components/schemas/JiveSourceModel' - $ref: '#/components/schemas/KhorosSourceModel' - $ref: '#/components/schemas/MicrosoftDynamicsSourceModel' - $ref: '#/components/schemas/PushSourceModel' - $ref: '#/components/schemas/RSSSourceModel' - $ref: '#/components/schemas/SAPSourceModel' - $ref: '#/components/schemas/SalesforceSitesSourceModel' - $ref: '#/components/schemas/SalesforceSourceModel' - $ref: '#/components/schemas/ServiceNowSourceModel' - $ref: '#/components/schemas/SharePointOnline2SourceModel' - $ref: '#/components/schemas/SharePointSourceModel' - $ref: '#/components/schemas/ShopifySourceModel' - $ref: '#/components/schemas/SitecoreSourceModel' - $ref: '#/components/schemas/SitemapSourceModel' - $ref: '#/components/schemas/SlackSourceModel' - $ref: '#/components/schemas/Web2SourceModel' - $ref: '#/components/schemas/YouTubeSourceModel' - $ref: '#/components/schemas/ZendeskSourceModel' x-pretty-name: updateRawSource x-required-privilege: owner: PLATFORM targetDomain: SOURCE type: EDIT targetId: '{sourceId}' x-required-privileges: - owner: PLATFORM targetDomain: SOURCE type: EDIT targetId: '{sourceId}' x-ui-operation-id: /rest/organizations/paramId/sources/paramId/raw_put /rest/organizations/{organizationId}/sources/{sourceId}/permissions/update: put: tags: - Sources summary: Update Source Permissions description: '
Privilege required ``` {"owner":"PLATFORM","targetDomain":"SOURCE","type":"EDIT","targetId":"{sourceId}"} ```
' operationId: updateSourcePermissions parameters: - name: organizationId in: path required: true schema: type: string - name: sourceId in: path required: true schema: type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/SourcePermissionsUpdateModel' required: true responses: '200': description: OK content: '*/*': schema: oneOf: - $ref: '#/components/schemas/SourceModel' - $ref: '#/components/schemas/AmazonS3SourceModel' - $ref: '#/components/schemas/BoxEnterprise2SourceModel' - $ref: '#/components/schemas/CatalogSourceModel' - $ref: '#/components/schemas/Confluence2HostedSourceModel' - $ref: '#/components/schemas/Confluence2SourceModel' - $ref: '#/components/schemas/CustomSourceModel' - $ref: '#/components/schemas/DatabaseSourceModel' - $ref: '#/components/schemas/DropboxForBusinessSourceModel' - $ref: '#/components/schemas/FileSourceModel' - $ref: '#/components/schemas/GenericRestSourceModel' - $ref: '#/components/schemas/GoogleDriveDomainWideSourceModel' - $ref: '#/components/schemas/GraphQlSourceModel' - $ref: '#/components/schemas/Jira2HostedSourceModel' - $ref: '#/components/schemas/Jira2SourceModel' - $ref: '#/components/schemas/JiveHostedSourceModel' - $ref: '#/components/schemas/JiveSourceModel' - $ref: '#/components/schemas/KhorosSourceModel' - $ref: '#/components/schemas/MicrosoftDynamicsSourceModel' - $ref: '#/components/schemas/PushSourceModel' - $ref: '#/components/schemas/RSSSourceModel' - $ref: '#/components/schemas/SAPSourceModel' - $ref: '#/components/schemas/SalesforceSitesSourceModel' - $ref: '#/components/schemas/SalesforceSourceModel' - $ref: '#/components/schemas/ServiceNowSourceModel' - $ref: '#/components/schemas/SharePointOnline2SourceModel' - $ref: '#/components/schemas/SharePointSourceModel' - $ref: '#/components/schemas/ShopifySourceModel' - $ref: '#/components/schemas/SitecoreSourceModel' - $ref: '#/components/schemas/SitemapSourceModel' - $ref: '#/components/schemas/SlackSourceModel' - $ref: '#/components/schemas/Web2SourceModel' - $ref: '#/components/schemas/YouTubeSourceModel' - $ref: '#/components/schemas/ZendeskSourceModel' x-pretty-name: updateSourcePermissions x-required-privilege: owner: PLATFORM targetDomain: SOURCE type: EDIT targetId: '{sourceId}' x-required-privileges: - owner: PLATFORM targetDomain: SOURCE type: EDIT targetId: '{sourceId}' x-ui-operation-id: /rest/organizations/paramId/sources/paramId/permissions/update_put /rest/organizations/{organizationId}/sources/{sourceId}/mappings: get: tags: - Mappings summary: Show Mapping Configuration description: 'Shows the [mapping](https://docs.coveo.com/en/217/) configuration of a [source](https://docs.coveo.com/en/246/).
See [Managing the Mapping Configuration of a Source](https://docs.coveo.com/en/29/).
**Required privilege:** Sources - View

Privilege required ``` {"owner":"PLATFORM","targetDomain":"SOURCE","type":"VIEW","targetId":"*"} ```
' operationId: getMappingsConfiguration parameters: - name: organizationId in: path description: The unique identifier of the target [organization](https://docs.coveo.com/en/185/).
**Example:** `mycoveocloudv2organizationg8tp8wu3` required: true schema: type: string - name: sourceId in: path description: The unique identifier of the target [source](https://docs.coveo.com/en/246/).
**Example:** `mycoveocloudv2organizationg8tp8wu3-gravodalyysjsu34camnvxm2d2y` required: true schema: type: string responses: '200': description: OK content: '*/*': schema: $ref: '#/components/schemas/MappingsConfigurationModel' x-pretty-name: getMappingsConfiguration x-required-privilege: owner: PLATFORM targetDomain: SOURCE type: VIEW targetId: '*' x-required-privileges: - owner: PLATFORM targetDomain: SOURCE type: VIEW targetId: '*' x-ui-operation-id: /rest/organizations/paramId/sources/paramId/mappings_get put: tags: - Mappings summary: Update Mapping Configuration description: 'Updates the [mapping](https://docs.coveo.com/en/217/) configuration of a [source](https://docs.coveo.com/en/246/).
See [Managing the Mapping Configuration of a Source](https://docs.coveo.com/en/29/).
**Required privilege:** Sources - Edit

Privilege required ``` {"owner":"PLATFORM","targetDomain":"SOURCE","type":"EDIT","targetId":"{sourceId}"} ```
' operationId: updateMappingsConfiguration parameters: - name: organizationId in: path description: The unique identifier of the target [organization](https://docs.coveo.com/en/185/).
**Example:** `mycoveocloudv2organizationg8tp8wu3` required: true schema: type: string - name: sourceId in: path description: The unique identifier of the target [source](https://docs.coveo.com/en/246/).
**Example:** `mycoveocloudv2organizationg8tp8wu3-gravodalyysjsu34camnvxm2d2y` required: true schema: type: string - name: rebuild in: query description: Whether to rebuild the [source](https://docs.coveo.com/en/246/) after the operation.
**Default:** `false` required: false schema: type: boolean default: false requestBody: content: application/json: schema: $ref: '#/components/schemas/MappingsConfigurationModel' required: true responses: '200': description: OK content: '*/*': schema: $ref: '#/components/schemas/MappingsConfigurationModel' x-pretty-name: updateMappingsConfiguration x-required-privilege: owner: PLATFORM targetDomain: SOURCE type: EDIT targetId: '{sourceId}' x-required-privileges: - owner: PLATFORM targetDomain: SOURCE type: EDIT targetId: '{sourceId}' x-ui-operation-id: /rest/organizations/paramId/sources/paramId/mappings_put /rest/organizations/{organizationId}/sources/{sourceId}/mappings/types/{typeId}: get: tags: - Mappings summary: List Specific Mappings of Given Type description: 'Lists the [mappings](https://docs.coveo.com/en/217/) of a specific [item](https://docs.coveo.com/en/210/) type.
**Required privilege:** Sources - View

Privilege required ``` {"owner":"PLATFORM","targetDomain":"SOURCE","type":"VIEW","targetId":"*"} ```
' operationId: getMappingTypeSettings parameters: - name: organizationId in: path description: The unique identifier of the target [organization](https://docs.coveo.com/en/185/).
**Example:** `mycoveocloudv2organizationg8tp8wu3` required: true schema: type: string - name: sourceId in: path description: The unique identifier of the target [source](https://docs.coveo.com/en/246/).
**Example:** `mycoveocloudv2organizationg8tp8wu3-gravodalyysjsu34camnvxm2d2y` required: true schema: type: string - name: typeId in: path description: The specific [mapping](https://docs.coveo.com/en/217/) type to show.
**Example:** `Video` required: true schema: type: string responses: '200': description: OK content: '*/*': schema: $ref: '#/components/schemas/TypedMappingSettingsModel' x-pretty-name: getMappingTypeSettings x-required-privilege: owner: PLATFORM targetDomain: SOURCE type: VIEW targetId: '*' x-required-privileges: - owner: PLATFORM targetDomain: SOURCE type: VIEW targetId: '*' x-ui-operation-id: /rest/organizations/paramId/sources/paramId/mappings/types/paramId_get put: tags: - Mappings summary: Update Specific Mappings of Given Type description: 'Updates the [mappings](https://docs.coveo.com/en/217/) of a specific [item](https://docs.coveo.com/en/210/) type.
**Required privilege:** Sources - Edit

Privilege required ``` {"owner":"PLATFORM","targetDomain":"SOURCE","type":"EDIT","targetId":"{sourceId}"} ```
' operationId: updateMappingTypeSettings parameters: - name: organizationId in: path description: The unique identifier of the target [organization](https://docs.coveo.com/en/185/).
**Example:** `mycoveocloudv2organizationg8tp8wu3` required: true schema: type: string - name: sourceId in: path description: The unique identifier of the target [source](https://docs.coveo.com/en/246/).
**Example:** `mycoveocloudv2organizationg8tp8wu3-gravodalyysjsu34camnvxm2d2y` required: true schema: type: string - name: typeId in: path description: The specific [mapping](https://docs.coveo.com/en/217/) type to update.
**Example:** `Video` required: true schema: type: string - name: rebuild in: query description: Whether to rebuild the [source](https://docs.coveo.com/en/246/) after the operation.
**Default:** `false` required: false schema: type: boolean default: false requestBody: content: application/json: schema: $ref: '#/components/schemas/BaseTypedMappingSettingsModelBaseRuleModel' required: true responses: '200': description: OK content: '*/*': schema: $ref: '#/components/schemas/TypedMappingSettingsModel' x-pretty-name: updateMappingTypeSettings x-required-privilege: owner: PLATFORM targetDomain: SOURCE type: EDIT targetId: '{sourceId}' x-required-privileges: - owner: PLATFORM targetDomain: SOURCE type: EDIT targetId: '{sourceId}' x-ui-operation-id: /rest/organizations/paramId/sources/paramId/mappings/types/paramId_put delete: tags: - Mappings summary: Delete Specific Mappings of Given Type description: 'Deletes the [mappings](https://docs.coveo.com/en/217/) of a specific [item](https://docs.coveo.com/en/210/) type.
**Required privilege:** Sources - Edit

Privilege required ``` {"owner":"PLATFORM","targetDomain":"SOURCE","type":"EDIT","targetId":"{sourceId}"} ```
' operationId: deleteMappingType parameters: - name: organizationId in: path description: The unique identifier of the target [organization](https://docs.coveo.com/en/185/).
**Example:** `mycoveocloudv2organizationg8tp8wu3` required: true schema: type: string - name: sourceId in: path description: The unique identifier of the target [source](https://docs.coveo.com/en/246/).
**Example:** `mycoveocloudv2organizationg8tp8wu3-gravodalyysjsu34camnvxm2d2y` required: true schema: type: string - name: typeId in: path description: The specific [mapping](https://docs.coveo.com/en/217/) item type to delete.
**Example:** `Video` required: true schema: type: string - name: rebuild in: query description: Whether to rebuild the [source](https://docs.coveo.com/en/246/) after the operation.
**Default:** `false` required: false schema: type: boolean default: false responses: '204': description: No Content x-pretty-name: deleteMappingType x-required-privilege: owner: PLATFORM targetDomain: SOURCE type: EDIT targetId: '{sourceId}' x-required-privileges: - owner: PLATFORM targetDomain: SOURCE type: EDIT targetId: '{sourceId}' x-ui-operation-id: /rest/organizations/paramId/sources/paramId/mappings/types/paramId_delete /rest/organizations/{organizationId}/sources/{sourceId}/mappings/types/{typeId}/rules/{ruleId}: get: tags: - Mappings summary: Show Specific Mapping Rule description: 'Shows the [mapping](https://docs.coveo.com/en/217/) rules of a specific [item](https://docs.coveo.com/en/210/) type.
**Required privilege:** Sources - View

Privilege required ``` {"owner":"PLATFORM","targetDomain":"SOURCE","type":"VIEW","targetId":"*"} ```
' operationId: getMappingTypeSettingsRule parameters: - name: organizationId in: path description: The unique identifier of the target [organization](https://docs.coveo.com/en/185/).
**Example:** `mycoveocloudv2organizationg8tp8wu3` required: true schema: type: string - name: sourceId in: path description: The unique identifier of the target [source](https://docs.coveo.com/en/246/).
**Example:** `mycoveocloudv2organizationg8tp8wu3-gravodalyysjsu34camnvxm2d2y` required: true schema: type: string - name: typeId in: path description: The target specific [mapping](https://docs.coveo.com/en/217/) type.
**Example:** `Video` required: true schema: type: string - name: ruleId in: path description: The unique identifier of the specific [mapping](https://docs.coveo.com/en/217/) rule to show.
**Example:** `wb74lavk6rmbjol3wqhamdspbi` required: true schema: type: string responses: '200': description: OK content: '*/*': schema: $ref: '#/components/schemas/RuleModel' x-pretty-name: getMappingTypeSettingsRule x-required-privilege: owner: PLATFORM targetDomain: SOURCE type: VIEW targetId: '*' x-required-privileges: - owner: PLATFORM targetDomain: SOURCE type: VIEW targetId: '*' x-ui-operation-id: /rest/organizations/paramId/sources/paramId/mappings/types/paramId/rules/paramId_get put: tags: - Mappings summary: Update Specific Mapping Rule description: 'Updates a [mapping](https://docs.coveo.com/en/217/) rule of a specific [item](https://docs.coveo.com/en/210/) type.
**Required privilege:** Sources - Edit

Privilege required ``` {"owner":"PLATFORM","targetDomain":"SOURCE","type":"EDIT","targetId":"{sourceId}"} ```
' operationId: updateMappingTypeSettingsRule parameters: - name: organizationId in: path description: The unique identifier of the target [organization](https://docs.coveo.com/en/185/).
**Example:** `mycoveocloudv2organizationg8tp8wu3` required: true schema: type: string - name: sourceId in: path description: The unique identifier of the target [source](https://docs.coveo.com/en/246/).
**Example:** `mycoveocloudv2organizationg8tp8wu3-gravodalyysjsu34camnvxm2d2y` required: true schema: type: string - name: typeId in: path description: The target specific [mapping](https://docs.coveo.com/en/217/) type.
**Example:** `Video` required: true schema: type: string - name: ruleId in: path description: The unique identifier of the specific [mapping](https://docs.coveo.com/en/217/) rule to update.
**Example:** `wb74lavk6rmbjol3wqhamdspbi` required: true schema: type: string - name: rebuild in: query description: Whether to rebuild the [source](https://docs.coveo.com/en/246/) after the operation.
**Default:** `false` required: false schema: type: boolean default: false requestBody: content: application/json: schema: $ref: '#/components/schemas/BaseRuleModel' required: true responses: '200': description: OK content: '*/*': schema: $ref: '#/components/schemas/RuleModel' x-pretty-name: updateMappingTypeSettingsRule x-required-privilege: owner: PLATFORM targetDomain: SOURCE type: EDIT targetId: '{sourceId}' x-required-privileges: - owner: PLATFORM targetDomain: SOURCE type: EDIT targetId: '{sourceId}' x-ui-operation-id: /rest/organizations/paramId/sources/paramId/mappings/types/paramId/rules/paramId_put delete: tags: - Mappings summary: Delete Specific Mapping Rule description: 'Deletes a [mapping](https://docs.coveo.com/en/217/) rule of a specific [item](https://docs.coveo.com/en/210/) type.
**Required privilege:** Sources - Edit

Privilege required ``` {"owner":"PLATFORM","targetDomain":"SOURCE","type":"EDIT","targetId":"{sourceId}"} ```
' operationId: deleteMappingTypeSettingsRule parameters: - name: organizationId in: path description: The unique identifier of the target [organization](https://docs.coveo.com/en/185/).
**Example:** `mycoveocloudv2organizationg8tp8wu3` required: true schema: type: string - name: sourceId in: path description: The unique identifier of the target [source](https://docs.coveo.com/en/246/).
**Example:** `mycoveocloudv2organizationg8tp8wu3-gravodalyysjsu34camnvxm2d2y` required: true schema: type: string - name: typeId in: path description: The target specific [mapping](https://docs.coveo.com/en/217/) type.
**Example:** `Video` required: true schema: type: string - name: ruleId in: path description: The unique identifier of the specific [mapping](https://docs.coveo.com/en/217/) rule to delete.
**Example:** `wb74lavk6rmbjol3wqhamdspbi` required: true schema: type: string - name: rebuild in: query description: Whether to rebuild the [source](https://docs.coveo.com/en/246/) after the operation.
**Default:** `false` required: false schema: type: boolean default: false responses: '204': description: No Content x-pretty-name: deleteMappingTypeSettingsRule x-required-privilege: owner: PLATFORM targetDomain: SOURCE type: EDIT targetId: '{sourceId}' x-required-privileges: - owner: PLATFORM targetDomain: SOURCE type: EDIT targetId: '{sourceId}' x-ui-operation-id: /rest/organizations/paramId/sources/paramId/mappings/types/paramId/rules/paramId_delete /rest/organizations/{organizationId}/sources/{sourceId}/mappings/common: get: tags: - Mappings summary: List Common Mappings description: 'Lists the common [mappings](https://docs.coveo.com/en/217/) of a [source](https://docs.coveo.com/en/246/) (i.e., the mappings that apply to all [item](https://docs.coveo.com/en/210/) types).
**Required privilege:** Sources - View

Privilege required ``` {"owner":"PLATFORM","targetDomain":"SOURCE","type":"VIEW","targetId":"*"} ```
' operationId: getCommonMappingSettings parameters: - name: organizationId in: path description: The unique identifier of the target [organization](https://docs.coveo.com/en/185/).
**Example:** `mycoveocloudv2organizationg8tp8wu3` required: true schema: type: string - name: sourceId in: path description: The unique identifier of the target [source](https://docs.coveo.com/en/246/).
**Example:** `mycoveocloudv2organizationg8tp8wu3-gravodalyysjsu34camnvxm2d2y` required: true schema: type: string responses: '200': description: OK content: '*/*': schema: $ref: '#/components/schemas/CommonMappingSettingsModel' x-pretty-name: getCommonMappingSettings x-required-privilege: owner: PLATFORM targetDomain: SOURCE type: VIEW targetId: '*' x-required-privileges: - owner: PLATFORM targetDomain: SOURCE type: VIEW targetId: '*' x-ui-operation-id: /rest/organizations/paramId/sources/paramId/mappings/common_get put: tags: - Mappings summary: Update Common Mappings description: 'Updates the common [mappings](https://docs.coveo.com/en/217/) of a [source](https://docs.coveo.com/en/246/), (i.e., the mappings that apply to all [item](https://docs.coveo.com/en/210/) types).
**Required privilege:** Sources - Edit

Privilege required ``` {"owner":"PLATFORM","targetDomain":"SOURCE","type":"EDIT","targetId":"{sourceId}"} ```
' operationId: updateCommonMappingSettings parameters: - name: organizationId in: path description: The unique identifier of the target [organization](https://docs.coveo.com/en/185/).
**Example:** `mycoveocloudv2organizationg8tp8wu3` required: true schema: type: string - name: sourceId in: path description: The unique identifier of the target [source](https://docs.coveo.com/en/246/).
**Example:** `mycoveocloudv2organizationg8tp8wu3-gravodalyysjsu34camnvxm2d2y` required: true schema: type: string - name: rebuild in: query description: Whether to rebuild the [source](https://docs.coveo.com/en/246/) after the operation.
**Default:** `false` required: false schema: type: boolean default: false requestBody: content: application/json: schema: $ref: '#/components/schemas/CommonMappingSettingsModel' required: true responses: '200': description: OK content: '*/*': schema: $ref: '#/components/schemas/CommonMappingSettingsModel' x-pretty-name: updateCommonMappingSettings x-required-privilege: owner: PLATFORM targetDomain: SOURCE type: EDIT targetId: '{sourceId}' x-required-privileges: - owner: PLATFORM targetDomain: SOURCE type: EDIT targetId: '{sourceId}' x-ui-operation-id: /rest/organizations/paramId/sources/paramId/mappings/common_put /rest/organizations/{organizationId}/sources/{sourceId}/mappings/common/rules/{ruleId}: get: tags: - Mappings summary: Show Common Mapping Rule description: 'Shows a common [mapping](https://docs.coveo.com/en/217/) rule (i.e., a mapping rule that applies to all [item](https://docs.coveo.com/en/210/) types).
**Required privilege:** Sources - View

Privilege required ``` {"owner":"PLATFORM","targetDomain":"SOURCE","type":"VIEW","targetId":"*"} ```
' operationId: getCommonMappingSettingsRule parameters: - name: organizationId in: path description: The unique identifier of the target [organization](https://docs.coveo.com/en/185/).
**Example:** `mycoveocloudv2organizationg8tp8wu3` required: true schema: type: string - name: sourceId in: path description: The unique identifier of the target [source](https://docs.coveo.com/en/246/).
**Example:** `mycoveocloudv2organizationg8tp8wu3-gravodalyysjsu34camnvxm2d2y` required: true schema: type: string - name: ruleId in: path description: The unique identifier of the mapping rule to show.
**Example:** `teghteb76mvjttvufmxecasmzy` required: true schema: type: string responses: '200': description: OK content: '*/*': schema: $ref: '#/components/schemas/RuleModel' x-pretty-name: getCommonMappingSettingsRule x-required-privilege: owner: PLATFORM targetDomain: SOURCE type: VIEW targetId: '*' x-required-privileges: - owner: PLATFORM targetDomain: SOURCE type: VIEW targetId: '*' x-ui-operation-id: /rest/organizations/paramId/sources/paramId/mappings/common/rules/paramId_get put: tags: - Mappings summary: Update Common Mapping Rule description: 'Updates a common [mapping](https://docs.coveo.com/en/217/) rule (i.e., a mapping rule that applies to all [item](https://docs.coveo.com/en/210/) types).
**Required privilege:** Sources - Edit

Privilege required ``` {"owner":"PLATFORM","targetDomain":"SOURCE","type":"EDIT","targetId":"{sourceId}"} ```
' operationId: updateCommonMappingSettingsRule parameters: - name: organizationId in: path description: The unique identifier of the target [organization](https://docs.coveo.com/en/185/).
**Example:** `mycoveocloudv2organizationg8tp8wu3` required: true schema: type: string - name: sourceId in: path description: The unique identifier of the target [source](https://docs.coveo.com/en/246/).
**Example:** `mycoveocloudv2organizationg8tp8wu3-gravodalyysjsu34camnvxm2d2y` required: true schema: type: string - name: ruleId in: path description: The unique identifier of the mapping rule to update.
**Example:** `teghteb76mvjttvufmxecasmzy` required: true schema: type: string - name: rebuild in: query description: Whether to rebuild the [source](https://docs.coveo.com/en/246/) after the operation.
**Default:** `false` required: false schema: type: boolean default: false requestBody: content: application/json: schema: $ref: '#/components/schemas/BaseRuleModel' required: true responses: '200': description: OK content: '*/*': schema: $ref: '#/components/schemas/RuleModel' x-pretty-name: updateCommonMappingSettingsRule x-required-privilege: owner: PLATFORM targetDomain: SOURCE type: EDIT targetId: '{sourceId}' x-required-privileges: - owner: PLATFORM targetDomain: SOURCE type: EDIT targetId: '{sourceId}' x-ui-operation-id: /rest/organizations/paramId/sources/paramId/mappings/common/rules/paramId_put delete: tags: - Mappings summary: Delete Common Mapping Rule description: 'Deletes a common [mapping](https://docs.coveo.com/en/217/) rule in a [source](https://docs.coveo.com/en/246/), (i.e., a mapping rule that applies to all [item](https://docs.coveo.com/en/210/) types.)
**Required privilege:** Sources - Edit

Privilege required ``` {"owner":"PLATFORM","targetDomain":"SOURCE","type":"EDIT","targetId":"{sourceId}"} ```
' operationId: deleteCommonMappingSettingsRule parameters: - name: organizationId in: path description: The unique identifier of the target [organization](https://docs.coveo.com/en/185/).
**Example:** `mycoveocloudv2organizationg8tp8wu3` required: true schema: type: string - name: sourceId in: path description: The unique identifier of the target [source](https://docs.coveo.com/en/246/).
**Example:** `mycoveocloudv2organizationg8tp8wu3-gravodalyysjsu34camnvxm2d2y` required: true schema: type: string - name: ruleId in: path description: The unique identifier of the mapping rule to delete.
**Example:** `teghteb76mvjttvufmxecasmzy` required: true schema: type: string - name: rebuild in: query description: Whether to rebuild the [source](https://docs.coveo.com/en/246/) after the operation.
**Default:** `false` required: false schema: type: boolean default: false responses: '204': description: No Content x-pretty-name: deleteCommonMappingSettingsRule x-required-privilege: owner: PLATFORM targetDomain: SOURCE type: EDIT targetId: '{sourceId}' x-required-privileges: - owner: PLATFORM targetDomain: SOURCE type: EDIT targetId: '{sourceId}' x-ui-operation-id: /rest/organizations/paramId/sources/paramId/mappings/common/rules/paramId_delete /rest/organizations/{organizationId}/sources/{sourceId}/extensions: get: tags: - Source Extension Configurations summary: List Extension Configurations description: 'Lists the [extension](https://docs.coveo.com/en/206/) configurations of a [source](https://docs.coveo.com/en/246/).
**Required privilege:** Sources - View

Privilege required ``` {"owner":"PLATFORM","targetDomain":"SOURCE","type":"VIEW","targetId":"*"} ```
' operationId: getSourceExtensions parameters: - name: organizationId in: path description: The unique identifier of the target [organization](https://docs.coveo.com/en/185/).
**Example:** `mycoveocloudv2organizationg8tp8wu3` required: true schema: type: string - name: sourceId in: path description: The unique identifier of the target [source](https://docs.coveo.com/en/246/).
**Example:** `mycoveocloudv2organizationg8tp8wu3-gravodalyysjsu34camnvxm2d2y` required: true schema: type: string responses: '200': description: OK content: '*/*': schema: $ref: '#/components/schemas/SourceExtensionsMap' x-pretty-name: getSourceExtensions x-required-privilege: owner: PLATFORM targetDomain: SOURCE type: VIEW targetId: '*' x-required-privileges: - owner: PLATFORM targetDomain: SOURCE type: VIEW targetId: '*' x-ui-operation-id: /rest/organizations/paramId/sources/paramId/extensions_get put: tags: - Source Extension Configurations summary: Update Extension Configurations description: 'Updates the [extension](https://docs.coveo.com/en/206/) configurations of a [source](https://docs.coveo.com/en/246/).
**Required privilege:** Sources - Edit

Privilege required ``` {"owner":"PLATFORM","targetDomain":"SOURCE","type":"EDIT","targetId":"{sourceId}"} ```
' operationId: setSourceExtensions parameters: - name: organizationId in: path description: The unique identifier of the target [organization](https://docs.coveo.com/en/185/).
**Example:** `mycoveocloudv2organizationg8tp8wu3` required: true schema: type: string - name: sourceId in: path description: The unique identifier of the target [source](https://docs.coveo.com/en/246/).
**Example:** `mycoveocloudv2organizationg8tp8wu3-gravodalyysjsu34camnvxm2d2y` required: true schema: type: string - name: rebuild in: query description: Whether to rebuild the [source](https://docs.coveo.com/en/246/) after the operation.
**Default:** `false` required: false schema: type: boolean default: false requestBody: content: application/json: schema: $ref: '#/components/schemas/SourceExtensionsMap' required: true responses: '204': description: No Content x-pretty-name: setSourceExtensions x-required-privilege: owner: PLATFORM targetDomain: SOURCE type: EDIT targetId: '{sourceId}' x-required-privileges: - owner: PLATFORM targetDomain: SOURCE type: EDIT targetId: '{sourceId}' x-ui-operation-id: /rest/organizations/paramId/sources/paramId/extensions_put /rest/organizations/{organizationId}/sources/fields/{fieldId}: get: tags: - Sources summary: Get a Single Field for an Organization description: '
Privilege required ``` {"owner":"PLATFORM","targetDomain":"FIELD","type":"VIEW","targetId":"*"} ```
' operationId: getField parameters: - name: organizationId in: path required: true schema: type: string - name: fieldId in: path required: true schema: type: string - name: includeMappings in: query required: false schema: type: boolean default: true responses: '200': description: OK content: '*/*': schema: $ref: '#/components/schemas/SourceFieldModel' x-pretty-name: getField x-required-privilege: owner: PLATFORM targetDomain: FIELD type: VIEW targetId: '*' x-required-privileges: - owner: PLATFORM targetDomain: FIELD type: VIEW targetId: '*' x-ui-operation-id: /rest/organizations/paramId/sources/fields/paramId_get put: tags: - Sources summary: Update a Field for an Organization description: '
Privilege required ``` {"owner":"PLATFORM","targetDomain":"FIELD","type":"EDIT","targetId":"*"} ```
' operationId: updateField parameters: - name: organizationId in: path required: true schema: type: string - name: fieldId in: path required: true schema: type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/SourceFieldModel' required: true responses: '204': description: No Content x-pretty-name: updateField x-required-privilege: owner: PLATFORM targetDomain: FIELD type: EDIT targetId: '*' x-required-privileges: - owner: PLATFORM targetDomain: FIELD type: EDIT targetId: '*' x-ui-operation-id: /rest/organizations/paramId/sources/fields/paramId_put delete: tags: - Sources summary: Removes a Specific Field from an Organization description: '
Privilege required ``` {"owner":"PLATFORM","targetDomain":"FIELD","type":"EDIT","targetId":"*"} ```
' operationId: removeField parameters: - name: organizationId in: path required: true schema: type: string - name: fieldId in: path required: true schema: type: string responses: '204': description: No Content x-pretty-name: removeField x-required-privilege: owner: PLATFORM targetDomain: FIELD type: EDIT targetId: '*' x-required-privileges: - owner: PLATFORM targetDomain: FIELD type: EDIT targetId: '*' x-ui-operation-id: /rest/organizations/paramId/sources/fields/paramId_delete /rest/organizations/{organizationId}/sources/fields/batch/update: put: tags: - Sources summary: Update a Field for an Organization description: '
Privilege required ``` {"owner":"PLATFORM","targetDomain":"FIELD","type":"EDIT","targetId":"*"} ```
' operationId: updateFields parameters: - name: organizationId in: path required: true schema: type: string requestBody: content: application/json: schema: type: array items: $ref: '#/components/schemas/SourceFieldModel' required: true responses: '204': description: No Content x-pretty-name: updateFields x-required-privilege: owner: PLATFORM targetDomain: FIELD type: EDIT targetId: '*' x-required-privileges: - owner: PLATFORM targetDomain: FIELD type: EDIT targetId: '*' x-ui-operation-id: /rest/organizations/paramId/sources/fields/batch/update_put /rest/sourceconfiguration/salesforce/schema: get: tags: - Salesforce Source Configuration summary: Get Complete Schema (objects and Fields) operationId: getSchema parameters: - name: accessToken in: query required: false schema: type: string default: '' - name: idUrl in: query required: false schema: type: string default: '' - name: refreshToken in: query required: false schema: type: string default: '' - name: refreshTokenGuid in: query required: false schema: type: string default: '' - name: schemaVersion in: query required: false schema: type: string default: EXPRESS enum: - CLOUDV1 - LEGACY - EXPRESS - name: sandbox in: query required: false schema: type: boolean default: false - name: serviceCloudIndexed in: query required: false schema: type: boolean default: false - name: knowledgeIndexed in: query required: false schema: type: boolean default: false - name: contentIndexed in: query required: false schema: type: boolean default: false - name: chatterIndexed in: query required: false schema: type: boolean default: false - name: cloudCrazeProductsIndexed in: query required: false schema: type: boolean default: false - name: cloudCrazeOrdersIndexed in: query required: false schema: type: boolean default: false responses: '200': description: OK content: '*/*': schema: type: array items: $ref: '#/components/schemas/SalesforceObject' x-pretty-name: getSchema x-ui-operation-id: /rest/sourceconfiguration/salesforce/schema_get post: tags: - Salesforce Source Configuration summary: Refresh Complete Schema (objects and Fields) operationId: refreshSchema parameters: - name: accessToken in: query required: false schema: type: string default: '' - name: idUrl in: query required: false schema: type: string default: '' - name: refreshToken in: query required: false schema: type: string default: '' - name: refreshTokenGuid in: query required: false schema: type: string default: '' - name: schemaVersion in: query required: false schema: type: string default: EXPRESS enum: - CLOUDV1 - LEGACY - EXPRESS - name: sandbox in: query required: false schema: type: boolean default: false - name: serviceCloudIndexed in: query required: false schema: type: boolean default: false - name: knowledgeIndexed in: query required: false schema: type: boolean default: false - name: contentIndexed in: query required: false schema: type: boolean default: false - name: chatterIndexed in: query required: false schema: type: boolean default: false - name: cloudCrazeProductsIndexed in: query required: false schema: type: boolean default: false - name: cloudCrazeOrdersIndexed in: query required: false schema: type: boolean default: false requestBody: content: application/json: schema: type: array items: $ref: '#/components/schemas/SalesforceObject' required: true responses: '200': description: OK content: '*/*': schema: type: array items: $ref: '#/components/schemas/SalesforceObject' x-pretty-name: refreshSchema x-ui-operation-id: /rest/sourceconfiguration/salesforce/schema_post /rest/sourceconfiguration/salesforce/parseOTG: post: tags: - Salesforce Source Configuration summary: Parse an ObjectsToGet to a Schema operationId: parseOTG parameters: - name: schemaVersion in: query required: false schema: type: string default: EXPRESS enum: - CLOUDV1 - LEGACY - EXPRESS requestBody: content: application/json: schema: type: string required: true responses: '200': description: OK content: '*/*': schema: type: array items: $ref: '#/components/schemas/SalesforceObject' x-pretty-name: parseOTG x-ui-operation-id: /rest/sourceconfiguration/salesforce/parseOTG_post /rest/sourceconfiguration/salesforce/objects: get: tags: - Salesforce Source Configuration summary: Get Objects operationId: getDefaultObjects parameters: - name: accessToken in: query required: false schema: type: string default: '' - name: idUrl in: query required: false schema: type: string default: '' - name: refreshToken in: query required: false schema: type: string default: '' - name: refreshTokenGuid in: query required: false schema: type: string default: '' - name: schemaVersion in: query required: false schema: type: string default: EXPRESS enum: - CLOUDV1 - LEGACY - EXPRESS - name: sandbox in: query required: false schema: type: boolean default: false - name: serviceCloudIndexed in: query required: false schema: type: boolean default: false - name: knowledgeIndexed in: query required: false schema: type: boolean default: false - name: contentIndexed in: query required: false schema: type: boolean default: false - name: chatterIndexed in: query required: false schema: type: boolean default: false - name: cloudCrazeProductsIndexed in: query required: false schema: type: boolean default: false - name: cloudCrazeOrdersIndexed in: query required: false schema: type: boolean default: false responses: '200': description: OK content: '*/*': schema: type: array items: $ref: '#/components/schemas/SalesforceObject' x-pretty-name: getDefaultObjects x-ui-operation-id: /rest/sourceconfiguration/salesforce/objects_get post: tags: - Salesforce Source Configuration summary: Refresh Objects operationId: refreshObjects parameters: - name: accessToken in: query required: false schema: type: string default: '' - name: idUrl in: query required: false schema: type: string default: '' - name: refreshToken in: query required: false schema: type: string default: '' - name: refreshTokenGuid in: query required: false schema: type: string default: '' - name: schemaVersion in: query required: false schema: type: string default: EXPRESS enum: - CLOUDV1 - LEGACY - EXPRESS - name: sandbox in: query required: false schema: type: boolean default: false requestBody: content: application/json: schema: type: array items: $ref: '#/components/schemas/SalesforceObject' required: true responses: '200': description: OK content: '*/*': schema: type: array items: $ref: '#/components/schemas/SalesforceObject' x-pretty-name: refreshObjects x-ui-operation-id: /rest/sourceconfiguration/salesforce/objects_post /rest/sourceconfiguration/salesforce/objects/{objectName}/fields: get: tags: - Salesforce Source Configuration summary: Get Fields for a Given Object operationId: getFields parameters: - name: objectName in: path required: true schema: type: string - name: accessToken in: query required: false schema: type: string default: '' - name: idUrl in: query required: false schema: type: string default: '' - name: refreshToken in: query required: false schema: type: string default: '' - name: refreshTokenGuid in: query required: false schema: type: string default: '' - name: schemaVersion in: query required: false schema: type: string default: EXPRESS enum: - CLOUDV1 - LEGACY - EXPRESS - name: sandbox in: query required: false schema: type: boolean default: false responses: '200': description: OK content: '*/*': schema: type: array items: $ref: '#/components/schemas/SalesforceField' deprecated: true x-pretty-name: getFields x-ui-operation-id: /rest/sourceconfiguration/salesforce/objects/paramId/fields_get post: tags: - Salesforce Source Configuration summary: Refresh Fields for a Given Object operationId: refreshFields parameters: - name: objectName in: path required: true schema: type: string - name: accessToken in: query required: false schema: type: string default: '' - name: idUrl in: query required: false schema: type: string default: '' - name: refreshToken in: query required: false schema: type: string default: '' - name: refreshTokenGuid in: query required: false schema: type: string default: '' - name: schemaVersion in: query required: false schema: type: string default: EXPRESS enum: - CLOUDV1 - LEGACY - EXPRESS - name: sandbox in: query required: false schema: type: boolean default: false requestBody: content: application/json: schema: type: array items: $ref: '#/components/schemas/SalesforceField' required: true responses: '200': description: OK content: '*/*': schema: type: array items: $ref: '#/components/schemas/SalesforceField' x-pretty-name: refreshFields x-ui-operation-id: /rest/sourceconfiguration/salesforce/objects/paramId/fields_post /rest/sourceconfiguration/salesforce/generateOTG: post: tags: - Salesforce Source Configuration summary: Generate an ObjectsToGet Given a Schema operationId: generateOTG parameters: - name: schemaVersion in: query required: false schema: type: string default: EXPRESS enum: - CLOUDV1 - LEGACY - EXPRESS requestBody: content: application/json: schema: type: array items: $ref: '#/components/schemas/SalesforceObject' required: true responses: '200': description: OK content: application/json: schema: type: string x-pretty-name: generateOTG x-ui-operation-id: /rest/sourceconfiguration/salesforce/generateOTG_post /rest/organizations/{organizationId}/sources: get: tags: - Sources summary: Get a Subset of Sources for an Organization description: '
Privilege required ``` {"owner":"PLATFORM","targetDomain":"SOURCE","type":"VIEW","targetId":"*"} ```
' operationId: getSources parameters: - name: organizationId in: path required: true schema: type: string - name: page in: query required: false schema: type: integer format: int32 default: 0 - name: perPage in: query required: false schema: type: integer format: int32 default: 100 - name: filter in: query description: Optional filter string. Must be at least 2 characters long to be applied. required: false schema: type: string - name: sortingType in: query required: false schema: type: string default: NAME enum: - TYPE - NAME - STATUS - CONTENT - LAST_MODIFIED_DATE - LAST_OPERATION - CONTENT_TOTAL_DOCUMENT_SIZE - STATUS_PRIORITY - name: sortingOrder in: query required: false schema: type: string default: ASC enum: - ASC - DESC - name: writeAccessOnly in: query required: false schema: type: boolean default: false - name: filterStatusType in: query required: false schema: type: string enum: - CREATING - REFRESHING - PAUSED - PAUSED_ON_ERROR - IDLE - ERROR - name: filterLastOperationType in: query required: false schema: type: string enum: - INCREMENTAL_REFRESH - FULL_REFRESH - REBUILD - name: filterLastOperationResultType in: query required: false schema: type: string enum: - SUCCESS - ERROR - ABORT - name: filterHostType in: query required: false schema: type: string enum: - CLOUD - CRAWLING_MODULE - PUSH - name: stringFilterType in: query required: false schema: type: string enum: - WILDCARD - EXACTMATCH responses: '200': description: OK content: '*/*': schema: type: array items: oneOf: - $ref: '#/components/schemas/SourceModel' - $ref: '#/components/schemas/AmazonS3SourceModel' - $ref: '#/components/schemas/BoxEnterprise2SourceModel' - $ref: '#/components/schemas/CatalogSourceModel' - $ref: '#/components/schemas/Confluence2HostedSourceModel' - $ref: '#/components/schemas/Confluence2SourceModel' - $ref: '#/components/schemas/CustomSourceModel' - $ref: '#/components/schemas/DatabaseSourceModel' - $ref: '#/components/schemas/DropboxForBusinessSourceModel' - $ref: '#/components/schemas/FileSourceModel' - $ref: '#/components/schemas/GenericRestSourceModel' - $ref: '#/components/schemas/GoogleDriveDomainWideSourceModel' - $ref: '#/components/schemas/GraphQlSourceModel' - $ref: '#/components/schemas/Jira2HostedSourceModel' - $ref: '#/components/schemas/Jira2SourceModel' - $ref: '#/components/schemas/JiveHostedSourceModel' - $ref: '#/components/schemas/JiveSourceModel' - $ref: '#/components/schemas/KhorosSourceModel' - $ref: '#/components/schemas/MicrosoftDynamicsSourceModel' - $ref: '#/components/schemas/PushSourceModel' - $ref: '#/components/schemas/RSSSourceModel' - $ref: '#/components/schemas/SAPSourceModel' - $ref: '#/components/schemas/SalesforceSitesSourceModel' - $ref: '#/components/schemas/SalesforceSourceModel' - $ref: '#/components/schemas/ServiceNowSourceModel' - $ref: '#/components/schemas/SharePointOnline2SourceModel' - $ref: '#/components/schemas/SharePointSourceModel' - $ref: '#/components/schemas/ShopifySourceModel' - $ref: '#/components/schemas/SitecoreSourceModel' - $ref: '#/components/schemas/SitemapSourceModel' - $ref: '#/components/schemas/SlackSourceModel' - $ref: '#/components/schemas/Web2SourceModel' - $ref: '#/components/schemas/YouTubeSourceModel' - $ref: '#/components/schemas/ZendeskSourceModel' x-pretty-name: getSources x-required-privilege: owner: PLATFORM targetDomain: SOURCE type: VIEW targetId: '*' x-required-privileges: - owner: PLATFORM targetDomain: SOURCE type: VIEW targetId: '*' x-ui-operation-id: /rest/organizations/paramId/sources_get post: tags: - Sources summary: Create a Source from Simple Configuration description: '
Privilege required ``` {"owner":"PLATFORM","targetDomain":"SOURCE","type":"CREATE","targetId":"*"} ```
' operationId: createSource parameters: - name: organizationId in: path required: true schema: type: string - name: updateSecurityProviders in: query required: false schema: type: boolean default: true - name: rebuild in: query required: false schema: type: boolean default: true requestBody: content: application/json: schema: oneOf: - $ref: '#/components/schemas/SourceModel' - $ref: '#/components/schemas/AmazonS3SourceModel' - $ref: '#/components/schemas/BoxEnterprise2SourceModel' - $ref: '#/components/schemas/CatalogSourceModel' - $ref: '#/components/schemas/Confluence2HostedSourceModel' - $ref: '#/components/schemas/Confluence2SourceModel' - $ref: '#/components/schemas/CustomSourceModel' - $ref: '#/components/schemas/DatabaseSourceModel' - $ref: '#/components/schemas/DropboxForBusinessSourceModel' - $ref: '#/components/schemas/FileSourceModel' - $ref: '#/components/schemas/GenericRestSourceModel' - $ref: '#/components/schemas/GoogleDriveDomainWideSourceModel' - $ref: '#/components/schemas/GraphQlSourceModel' - $ref: '#/components/schemas/Jira2HostedSourceModel' - $ref: '#/components/schemas/Jira2SourceModel' - $ref: '#/components/schemas/JiveHostedSourceModel' - $ref: '#/components/schemas/JiveSourceModel' - $ref: '#/components/schemas/KhorosSourceModel' - $ref: '#/components/schemas/MicrosoftDynamicsSourceModel' - $ref: '#/components/schemas/PushSourceModel' - $ref: '#/components/schemas/RSSSourceModel' - $ref: '#/components/schemas/SAPSourceModel' - $ref: '#/components/schemas/SalesforceSitesSourceModel' - $ref: '#/components/schemas/SalesforceSourceModel' - $ref: '#/components/schemas/ServiceNowSourceModel' - $ref: '#/components/schemas/SharePointOnline2SourceModel' - $ref: '#/components/schemas/SharePointSourceModel' - $ref: '#/components/schemas/ShopifySourceModel' - $ref: '#/components/schemas/SitecoreSourceModel' - $ref: '#/components/schemas/SitemapSourceModel' - $ref: '#/components/schemas/SlackSourceModel' - $ref: '#/components/schemas/Web2SourceModel' - $ref: '#/components/schemas/YouTubeSourceModel' - $ref: '#/components/schemas/ZendeskSourceModel' required: true responses: '201': description: Created content: '*/*': schema: oneOf: - $ref: '#/components/schemas/SourceModel' - $ref: '#/components/schemas/AmazonS3SourceModel' - $ref: '#/components/schemas/BoxEnterprise2SourceModel' - $ref: '#/components/schemas/CatalogSourceModel' - $ref: '#/components/schemas/Confluence2HostedSourceModel' - $ref: '#/components/schemas/Confluence2SourceModel' - $ref: '#/components/schemas/CustomSourceModel' - $ref: '#/components/schemas/DatabaseSourceModel' - $ref: '#/components/schemas/DropboxForBusinessSourceModel' - $ref: '#/components/schemas/FileSourceModel' - $ref: '#/components/schemas/GenericRestSourceModel' - $ref: '#/components/schemas/GoogleDriveDomainWideSourceModel' - $ref: '#/components/schemas/GraphQlSourceModel' - $ref: '#/components/schemas/Jira2HostedSourceModel' - $ref: '#/components/schemas/Jira2SourceModel' - $ref: '#/components/schemas/JiveHostedSourceModel' - $ref: '#/components/schemas/JiveSourceModel' - $ref: '#/components/schemas/KhorosSourceModel' - $ref: '#/components/schemas/MicrosoftDynamicsSourceModel' - $ref: '#/components/schemas/PushSourceModel' - $ref: '#/components/schemas/RSSSourceModel' - $ref: '#/components/schemas/SAPSourceModel' - $ref: '#/components/schemas/SalesforceSitesSourceModel' - $ref: '#/components/schemas/SalesforceSourceModel' - $ref: '#/components/schemas/ServiceNowSourceModel' - $ref: '#/components/schemas/SharePointOnline2SourceModel' - $ref: '#/components/schemas/SharePointSourceModel' - $ref: '#/components/schemas/ShopifySourceModel' - $ref: '#/components/schemas/SitecoreSourceModel' - $ref: '#/components/schemas/SitemapSourceModel' - $ref: '#/components/schemas/SlackSourceModel' - $ref: '#/components/schemas/Web2SourceModel' - $ref: '#/components/schemas/YouTubeSourceModel' - $ref: '#/components/schemas/ZendeskSourceModel' x-pretty-name: createSource x-required-privilege: owner: PLATFORM targetDomain: SOURCE type: CREATE targetId: '*' x-required-privileges: - owner: PLATFORM targetDomain: SOURCE type: CREATE targetId: '*' x-ui-operation-id: /rest/organizations/paramId/sources_post /rest/organizations/{organizationId}/sources/{sourceId}/tasks/abort: post: tags: - Sources summary: Abort a Source Task Related to a Given Activity. description: '
Privilege required ``` {"owner":"PLATFORM","targetDomain":"SOURCE","type":"EDIT","targetId":"{sourceId}"} ```
' operationId: abortTaskForActivity parameters: - name: organizationId in: path required: true schema: type: string - name: sourceId in: path required: true schema: type: string - name: activityId in: query required: true schema: type: string responses: '200': description: OK x-pretty-name: abortTaskForActivity x-required-privilege: owner: PLATFORM targetDomain: SOURCE type: EDIT targetId: '{sourceId}' x-required-privileges: - owner: PLATFORM targetDomain: SOURCE type: EDIT targetId: '{sourceId}' x-ui-operation-id: /rest/organizations/paramId/sources/paramId/tasks/abort_post /rest/organizations/{organizationId}/sources/{sourceId}/stopRefresh: post: tags: - Sources summary: Stop the Current Refresh Operation on a Source description: '
Privilege required ``` {"owner":"PLATFORM","targetDomain":"SOURCE","type":"EDIT","targetId":"{sourceId}"} ```
' operationId: stopRefresh parameters: - name: organizationId in: path required: true schema: type: string - name: sourceId in: path required: true schema: type: string responses: '200': description: OK content: '*/*': schema: oneOf: - $ref: '#/components/schemas/SourceModel' - $ref: '#/components/schemas/AmazonS3SourceModel' - $ref: '#/components/schemas/BoxEnterprise2SourceModel' - $ref: '#/components/schemas/CatalogSourceModel' - $ref: '#/components/schemas/Confluence2HostedSourceModel' - $ref: '#/components/schemas/Confluence2SourceModel' - $ref: '#/components/schemas/CustomSourceModel' - $ref: '#/components/schemas/DatabaseSourceModel' - $ref: '#/components/schemas/DropboxForBusinessSourceModel' - $ref: '#/components/schemas/FileSourceModel' - $ref: '#/components/schemas/GenericRestSourceModel' - $ref: '#/components/schemas/GoogleDriveDomainWideSourceModel' - $ref: '#/components/schemas/GraphQlSourceModel' - $ref: '#/components/schemas/Jira2HostedSourceModel' - $ref: '#/components/schemas/Jira2SourceModel' - $ref: '#/components/schemas/JiveHostedSourceModel' - $ref: '#/components/schemas/JiveSourceModel' - $ref: '#/components/schemas/KhorosSourceModel' - $ref: '#/components/schemas/MicrosoftDynamicsSourceModel' - $ref: '#/components/schemas/PushSourceModel' - $ref: '#/components/schemas/RSSSourceModel' - $ref: '#/components/schemas/SAPSourceModel' - $ref: '#/components/schemas/SalesforceSitesSourceModel' - $ref: '#/components/schemas/SalesforceSourceModel' - $ref: '#/components/schemas/ServiceNowSourceModel' - $ref: '#/components/schemas/SharePointOnline2SourceModel' - $ref: '#/components/schemas/SharePointSourceModel' - $ref: '#/components/schemas/ShopifySourceModel' - $ref: '#/components/schemas/SitecoreSourceModel' - $ref: '#/components/schemas/SitemapSourceModel' - $ref: '#/components/schemas/SlackSourceModel' - $ref: '#/components/schemas/Web2SourceModel' - $ref: '#/components/schemas/YouTubeSourceModel' - $ref: '#/components/schemas/ZendeskSourceModel' x-pretty-name: stopRefresh x-required-privilege: owner: PLATFORM targetDomain: SOURCE type: EDIT targetId: '{sourceId}' x-required-privileges: - owner: PLATFORM targetDomain: SOURCE type: EDIT targetId: '{sourceId}' x-ui-operation-id: /rest/organizations/paramId/sources/paramId/stopRefresh_post /rest/organizations/{organizationId}/sources/{sourceId}/startRefresh: post: tags: - Sources summary: Start a Refresh Operation on a Source description: '
Privilege required ``` {"owner":"PLATFORM","targetDomain":"SOURCE","type":"EDIT","targetId":"{sourceId}"} ```
' operationId: startRefresh parameters: - name: organizationId in: path required: true schema: type: string - name: sourceId in: path required: true schema: type: string responses: '200': description: OK content: '*/*': schema: oneOf: - $ref: '#/components/schemas/SourceModel' - $ref: '#/components/schemas/AmazonS3SourceModel' - $ref: '#/components/schemas/BoxEnterprise2SourceModel' - $ref: '#/components/schemas/CatalogSourceModel' - $ref: '#/components/schemas/Confluence2HostedSourceModel' - $ref: '#/components/schemas/Confluence2SourceModel' - $ref: '#/components/schemas/CustomSourceModel' - $ref: '#/components/schemas/DatabaseSourceModel' - $ref: '#/components/schemas/DropboxForBusinessSourceModel' - $ref: '#/components/schemas/FileSourceModel' - $ref: '#/components/schemas/GenericRestSourceModel' - $ref: '#/components/schemas/GoogleDriveDomainWideSourceModel' - $ref: '#/components/schemas/GraphQlSourceModel' - $ref: '#/components/schemas/Jira2HostedSourceModel' - $ref: '#/components/schemas/Jira2SourceModel' - $ref: '#/components/schemas/JiveHostedSourceModel' - $ref: '#/components/schemas/JiveSourceModel' - $ref: '#/components/schemas/KhorosSourceModel' - $ref: '#/components/schemas/MicrosoftDynamicsSourceModel' - $ref: '#/components/schemas/PushSourceModel' - $ref: '#/components/schemas/RSSSourceModel' - $ref: '#/components/schemas/SAPSourceModel' - $ref: '#/components/schemas/SalesforceSitesSourceModel' - $ref: '#/components/schemas/SalesforceSourceModel' - $ref: '#/components/schemas/ServiceNowSourceModel' - $ref: '#/components/schemas/SharePointOnline2SourceModel' - $ref: '#/components/schemas/SharePointSourceModel' - $ref: '#/components/schemas/ShopifySourceModel' - $ref: '#/components/schemas/SitecoreSourceModel' - $ref: '#/components/schemas/SitemapSourceModel' - $ref: '#/components/schemas/SlackSourceModel' - $ref: '#/components/schemas/Web2SourceModel' - $ref: '#/components/schemas/YouTubeSourceModel' - $ref: '#/components/schemas/ZendeskSourceModel' x-pretty-name: startRefresh x-required-privilege: owner: PLATFORM targetDomain: SOURCE type: EDIT targetId: '{sourceId}' x-required-privileges: - owner: PLATFORM targetDomain: SOURCE type: EDIT targetId: '{sourceId}' x-ui-operation-id: /rest/organizations/paramId/sources/paramId/startRefresh_post /rest/organizations/{organizationId}/sources/{sourceId}/schedules: get: tags: - Sources summary: Get All Source Schedules description: '
Privilege required ``` {"owner":"PLATFORM","targetDomain":"SOURCE","type":"VIEW","targetId":"*"} ```
' operationId: getSourceSchedules parameters: - name: organizationId in: path required: true schema: type: string - name: sourceId in: path required: true schema: type: string responses: '200': description: OK content: '*/*': schema: type: array items: $ref: '#/components/schemas/ScheduleModel' x-pretty-name: getSourceSchedules x-required-privilege: owner: PLATFORM targetDomain: SOURCE type: VIEW targetId: '*' x-required-privileges: - owner: PLATFORM targetDomain: SOURCE type: VIEW targetId: '*' x-ui-operation-id: /rest/organizations/paramId/sources/paramId/schedules_get post: tags: - Sources summary: Create a New Schedule for the Source description: '
Privilege required ``` {"owner":"PLATFORM","targetDomain":"SOURCE","type":"EDIT","targetId":"{sourceId}"} ```
' operationId: createSourceSchedule parameters: - name: organizationId in: path required: true schema: type: string - name: sourceId in: path required: true schema: type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/ScheduleModel' required: true responses: '201': description: Created content: '*/*': schema: $ref: '#/components/schemas/ScheduleModel' x-pretty-name: createSourceSchedule x-required-privilege: owner: PLATFORM targetDomain: SOURCE type: EDIT targetId: '{sourceId}' x-required-privileges: - owner: PLATFORM targetDomain: SOURCE type: EDIT targetId: '{sourceId}' x-ui-operation-id: /rest/organizations/paramId/sources/paramId/schedules_post /rest/organizations/{organizationId}/sources/{sourceId}/resumeRefresh: post: tags: - Sources summary: Resume the Current Refresh Operation on a Source description: '
Privilege required ``` {"owner":"PLATFORM","targetDomain":"SOURCE","type":"EDIT","targetId":"{sourceId}"} ```
' operationId: resumeRefresh parameters: - name: organizationId in: path required: true schema: type: string - name: sourceId in: path required: true schema: type: string responses: '200': description: OK content: '*/*': schema: oneOf: - $ref: '#/components/schemas/SourceModel' - $ref: '#/components/schemas/AmazonS3SourceModel' - $ref: '#/components/schemas/BoxEnterprise2SourceModel' - $ref: '#/components/schemas/CatalogSourceModel' - $ref: '#/components/schemas/Confluence2HostedSourceModel' - $ref: '#/components/schemas/Confluence2SourceModel' - $ref: '#/components/schemas/CustomSourceModel' - $ref: '#/components/schemas/DatabaseSourceModel' - $ref: '#/components/schemas/DropboxForBusinessSourceModel' - $ref: '#/components/schemas/FileSourceModel' - $ref: '#/components/schemas/GenericRestSourceModel' - $ref: '#/components/schemas/GoogleDriveDomainWideSourceModel' - $ref: '#/components/schemas/GraphQlSourceModel' - $ref: '#/components/schemas/Jira2HostedSourceModel' - $ref: '#/components/schemas/Jira2SourceModel' - $ref: '#/components/schemas/JiveHostedSourceModel' - $ref: '#/components/schemas/JiveSourceModel' - $ref: '#/components/schemas/KhorosSourceModel' - $ref: '#/components/schemas/MicrosoftDynamicsSourceModel' - $ref: '#/components/schemas/PushSourceModel' - $ref: '#/components/schemas/RSSSourceModel' - $ref: '#/components/schemas/SAPSourceModel' - $ref: '#/components/schemas/SalesforceSitesSourceModel' - $ref: '#/components/schemas/SalesforceSourceModel' - $ref: '#/components/schemas/ServiceNowSourceModel' - $ref: '#/components/schemas/SharePointOnline2SourceModel' - $ref: '#/components/schemas/SharePointSourceModel' - $ref: '#/components/schemas/ShopifySourceModel' - $ref: '#/components/schemas/SitecoreSourceModel' - $ref: '#/components/schemas/SitemapSourceModel' - $ref: '#/components/schemas/SlackSourceModel' - $ref: '#/components/schemas/Web2SourceModel' - $ref: '#/components/schemas/YouTubeSourceModel' - $ref: '#/components/schemas/ZendeskSourceModel' x-pretty-name: resumeRefresh x-required-privilege: owner: PLATFORM targetDomain: SOURCE type: EDIT targetId: '{sourceId}' x-required-privileges: - owner: PLATFORM targetDomain: SOURCE type: EDIT targetId: '{sourceId}' x-ui-operation-id: /rest/organizations/paramId/sources/paramId/resumeRefresh_post /rest/organizations/{organizationId}/sources/{sourceId}/rebuild: post: tags: - Sources summary: Apply a Rebuild Operation on a Source description: '
Privilege required ``` {"owner":"PLATFORM","targetDomain":"SOURCE","type":"EDIT","targetId":"{sourceId}"} ```
' operationId: rebuild parameters: - name: organizationId in: path required: true schema: type: string - name: sourceId in: path required: true schema: type: string responses: '200': description: OK content: '*/*': schema: oneOf: - $ref: '#/components/schemas/SourceModel' - $ref: '#/components/schemas/AmazonS3SourceModel' - $ref: '#/components/schemas/BoxEnterprise2SourceModel' - $ref: '#/components/schemas/CatalogSourceModel' - $ref: '#/components/schemas/Confluence2HostedSourceModel' - $ref: '#/components/schemas/Confluence2SourceModel' - $ref: '#/components/schemas/CustomSourceModel' - $ref: '#/components/schemas/DatabaseSourceModel' - $ref: '#/components/schemas/DropboxForBusinessSourceModel' - $ref: '#/components/schemas/FileSourceModel' - $ref: '#/components/schemas/GenericRestSourceModel' - $ref: '#/components/schemas/GoogleDriveDomainWideSourceModel' - $ref: '#/components/schemas/GraphQlSourceModel' - $ref: '#/components/schemas/Jira2HostedSourceModel' - $ref: '#/components/schemas/Jira2SourceModel' - $ref: '#/components/schemas/JiveHostedSourceModel' - $ref: '#/components/schemas/JiveSourceModel' - $ref: '#/components/schemas/KhorosSourceModel' - $ref: '#/components/schemas/MicrosoftDynamicsSourceModel' - $ref: '#/components/schemas/PushSourceModel' - $ref: '#/components/schemas/RSSSourceModel' - $ref: '#/components/schemas/SAPSourceModel' - $ref: '#/components/schemas/SalesforceSitesSourceModel' - $ref: '#/components/schemas/SalesforceSourceModel' - $ref: '#/components/schemas/ServiceNowSourceModel' - $ref: '#/components/schemas/SharePointOnline2SourceModel' - $ref: '#/components/schemas/SharePointSourceModel' - $ref: '#/components/schemas/ShopifySourceModel' - $ref: '#/components/schemas/SitecoreSourceModel' - $ref: '#/components/schemas/SitemapSourceModel' - $ref: '#/components/schemas/SlackSourceModel' - $ref: '#/components/schemas/Web2SourceModel' - $ref: '#/components/schemas/YouTubeSourceModel' - $ref: '#/components/schemas/ZendeskSourceModel' x-pretty-name: rebuild x-required-privilege: owner: PLATFORM targetDomain: SOURCE type: EDIT targetId: '{sourceId}' x-required-privileges: - owner: PLATFORM targetDomain: SOURCE type: EDIT targetId: '{sourceId}' x-ui-operation-id: /rest/organizations/paramId/sources/paramId/rebuild_post /rest/organizations/{organizationId}/sources/{sourceId}/pushRefresh: post: tags: - Sources summary: Sets the Refreshing State of a Push Source description: '
Privilege required ``` {"owner":"PLATFORM","targetDomain":"SOURCE","type":"EDIT","targetId":"{sourceId}"} ```
' operationId: setPushRefreshStatus parameters: - name: organizationId in: path required: true schema: type: string - name: sourceId in: path required: true schema: type: string - name: activityOperation in: query required: true schema: type: string enum: - APPLY - ARCHIVE - ARCHIVE_WARNING - BACKUP - CHANGE_ONLINE - CHANGE_READ_ONLY - COMMIT - CONFIG_CHANGE - CONFIG_CREATE - CREATE - DECLINE - DELETE - DISABLE - DUPLICATE - ENABLE - ENABLE_DISABLED_ENTITIES - EXPORT - FULL_REFRESH - HORIZONTAL_SCALING - IDLE - IMPORT - INCREMENTAL_REFRESH - LIMIT_ALMOST_REACHED - LIMIT_EXCEEDED - LIMIT_REACHED - LOG_REQUEST - METADATA_REPORT - MODEL_BUILD - MODEL_REFRESH - ORG_PROVISIONING_CHECK - PAUSE - PAUSE_ON_ERROR - REBUILD - REFRESH - REFRESH_CANCEL - REFRESH_ENTITIES_IN_ERROR - REFRESH_ENTITIES_NOT_UPDATED - REFRESH_ENTITY - REMEDIATE - RESIZE - RESTORE - RESUME - ROTATE - SCHEDULE_CHANGE - SCHEDULE_CREATE - SCHEDULE_DELETE - SEARCH_CERTIFICATE_UPDATE - SEARCH_INCIDENT - SEND_RESOURCE_SNAPSHOT - START - STOP - SYNCHRONIZE - TEST - UPDATE - UPGRADE - UPGRADE_REVERT - VALIDATE - VERTICAL_SCALING responses: '200': description: OK x-pretty-name: setPushRefreshStatus x-required-privilege: owner: PLATFORM targetDomain: SOURCE type: EDIT targetId: '{sourceId}' x-required-privileges: - owner: PLATFORM targetDomain: SOURCE type: EDIT targetId: '{sourceId}' x-ui-operation-id: /rest/organizations/paramId/sources/paramId/pushRefresh_post /rest/organizations/{organizationId}/sources/{sourceId}/pauseRefresh: post: tags: - Sources summary: Pause the Current Refresh Operation on a Source description: '
Privilege required ``` {"owner":"PLATFORM","targetDomain":"SOURCE","type":"EDIT","targetId":"{sourceId}"} ```
' operationId: pauseRefresh parameters: - name: organizationId in: path required: true schema: type: string - name: sourceId in: path required: true schema: type: string responses: '200': description: OK content: '*/*': schema: oneOf: - $ref: '#/components/schemas/SourceModel' - $ref: '#/components/schemas/AmazonS3SourceModel' - $ref: '#/components/schemas/BoxEnterprise2SourceModel' - $ref: '#/components/schemas/CatalogSourceModel' - $ref: '#/components/schemas/Confluence2HostedSourceModel' - $ref: '#/components/schemas/Confluence2SourceModel' - $ref: '#/components/schemas/CustomSourceModel' - $ref: '#/components/schemas/DatabaseSourceModel' - $ref: '#/components/schemas/DropboxForBusinessSourceModel' - $ref: '#/components/schemas/FileSourceModel' - $ref: '#/components/schemas/GenericRestSourceModel' - $ref: '#/components/schemas/GoogleDriveDomainWideSourceModel' - $ref: '#/components/schemas/GraphQlSourceModel' - $ref: '#/components/schemas/Jira2HostedSourceModel' - $ref: '#/components/schemas/Jira2SourceModel' - $ref: '#/components/schemas/JiveHostedSourceModel' - $ref: '#/components/schemas/JiveSourceModel' - $ref: '#/components/schemas/KhorosSourceModel' - $ref: '#/components/schemas/MicrosoftDynamicsSourceModel' - $ref: '#/components/schemas/PushSourceModel' - $ref: '#/components/schemas/RSSSourceModel' - $ref: '#/components/schemas/SAPSourceModel' - $ref: '#/components/schemas/SalesforceSitesSourceModel' - $ref: '#/components/schemas/SalesforceSourceModel' - $ref: '#/components/schemas/ServiceNowSourceModel' - $ref: '#/components/schemas/SharePointOnline2SourceModel' - $ref: '#/components/schemas/SharePointSourceModel' - $ref: '#/components/schemas/ShopifySourceModel' - $ref: '#/components/schemas/SitecoreSourceModel' - $ref: '#/components/schemas/SitemapSourceModel' - $ref: '#/components/schemas/SlackSourceModel' - $ref: '#/components/schemas/Web2SourceModel' - $ref: '#/components/schemas/YouTubeSourceModel' - $ref: '#/components/schemas/ZendeskSourceModel' x-pretty-name: pauseRefresh x-required-privilege: owner: PLATFORM targetDomain: SOURCE type: EDIT targetId: '{sourceId}' x-required-privileges: - owner: PLATFORM targetDomain: SOURCE type: EDIT targetId: '{sourceId}' x-ui-operation-id: /rest/organizations/paramId/sources/paramId/pauseRefresh_post /rest/organizations/{organizationId}/sources/{sourceId}/metadata: get: tags: - Metadata summary: Retrieve Metadata Report for a Source description: '
Privilege required ``` {"owner":"PLATFORM","targetDomain":"SOURCE","type":"EDIT","targetId":"{sourceId}"} AND {"owner":"PLATFORM","targetDomain":"SOURCE_METADATA","type":"VIEW","targetId":"*"} ```
' operationId: getSourceMetadataReport parameters: - name: organizationId in: path description: The unique identifier of the target [organization](https://docs.coveo.com/en/185/).
**Example:** `mycoveocloudv2organizationg8tp8wu3` required: true schema: type: string - name: sourceId in: path description: The unique identifier of the target [source](https://docs.coveo.com/en/246/).
**Example:** `mycoveocloudv2organizationg8tp8wu3-gravodalyysjsu34camnvxm2d2y` required: true schema: type: string - name: page in: query required: false schema: type: integer format: int32 default: 0 - name: perPage in: query required: false schema: type: integer format: int32 default: 100 - name: filter in: query description: Optional filter string. Must be at least 2 characters long to be applied. required: false schema: type: string - name: sortBy in: query required: false schema: type: string - name: order in: query required: false schema: type: string default: ASC responses: '200': description: OK content: '*/*': schema: $ref: '#/components/schemas/MetadataReportPageModel' x-pretty-name: getSourceMetadataReport x-required-privilege: owner: PLATFORM targetDomain: SOURCE type: EDIT targetId: '{sourceId}' x-required-privileges: - owner: PLATFORM targetDomain: SOURCE type: EDIT targetId: '{sourceId}' - owner: PLATFORM targetDomain: SOURCE_METADATA type: VIEW targetId: '*' x-ui-operation-id: /rest/organizations/paramId/sources/paramId/metadata_get post: tags: - Metadata summary: Create Metadata Report for a Source description: '
Privilege required ``` {"owner":"PLATFORM","targetDomain":"SOURCE","type":"EDIT","targetId":"{sourceId}"} AND {"owner":"PLATFORM","targetDomain":"SOURCE_METADATA","type":"VIEW","targetId":"*"} ```
' operationId: createMetadataReport parameters: - name: organizationId in: path description: The unique identifier of the target [organization](https://docs.coveo.com/en/185/).
**Example:** `mycoveocloudv2organizationg8tp8wu3` required: true schema: type: string - name: sourceId in: path description: The unique identifier of the target [source](https://docs.coveo.com/en/246/).
**Example:** `mycoveocloudv2organizationg8tp8wu3-gravodalyysjsu34camnvxm2d2y` required: true schema: type: string responses: '204': description: No Content x-pretty-name: createMetadataReport x-required-privilege: owner: PLATFORM targetDomain: SOURCE type: EDIT targetId: '{sourceId}' x-required-privileges: - owner: PLATFORM targetDomain: SOURCE type: EDIT targetId: '{sourceId}' - owner: PLATFORM targetDomain: SOURCE_METADATA type: VIEW targetId: '*' x-ui-operation-id: /rest/organizations/paramId/sources/paramId/metadata_post /rest/organizations/{organizationId}/sources/{sourceId}/mappings/types: get: tags: - Mappings summary: List Specific Mappings description: 'Lists the specific [mappings](https://docs.coveo.com/en/217/) of a [source](https://docs.coveo.com/en/246/) (i.e., the mappings that apply to specific [item](https://docs.coveo.com/en/210/) types).
**Required privilege:** Sources - View

Privilege required ``` {"owner":"PLATFORM","targetDomain":"SOURCE","type":"VIEW","targetId":"*"} ```
' operationId: getMappingTypes parameters: - name: organizationId in: path description: The unique identifier of the target [organization](https://docs.coveo.com/en/185/).
**Example:** `mycoveocloudv2organizationg8tp8wu3` required: true schema: type: string - name: sourceId in: path description: The unique identifier of the target [source](https://docs.coveo.com/en/246/).
**Example:** `mycoveocloudv2organizationg8tp8wu3-gravodalyysjsu34camnvxm2d2y` required: true schema: type: string responses: '200': description: OK content: '*/*': schema: type: array items: $ref: '#/components/schemas/TypedMappingSettingsModel' x-pretty-name: getMappingTypes x-required-privilege: owner: PLATFORM targetDomain: SOURCE type: VIEW targetId: '*' x-required-privileges: - owner: PLATFORM targetDomain: SOURCE type: VIEW targetId: '*' x-ui-operation-id: /rest/organizations/paramId/sources/paramId/mappings/types_get post: tags: - Mappings summary: Create Specific Mapping description: 'Creates a new specific [mapping](https://docs.coveo.com/en/217/) (i.e., a mapping that applies to a specific [item](https://docs.coveo.com/en/210/) type).
**Required privilege:** Sources - Edit

Privilege required ``` {"owner":"PLATFORM","targetDomain":"SOURCE","type":"EDIT","targetId":"{sourceId}"} ```
' operationId: addMappingTypes parameters: - name: organizationId in: path description: The unique identifier of the target [organization](https://docs.coveo.com/en/185/).
**Example:** `mycoveocloudv2organizationg8tp8wu3` required: true schema: type: string - name: sourceId in: path description: The unique identifier of the target [source](https://docs.coveo.com/en/246/).
**Example:** `mycoveocloudv2organizationg8tp8wu3-gravodalyysjsu34camnvxm2d2y` required: true schema: type: string - name: rebuild in: query description: Whether to rebuild the [source](https://docs.coveo.com/en/246/) after the operation.
**Default:** `false` required: false schema: type: boolean default: false requestBody: content: application/json: schema: $ref: '#/components/schemas/BaseTypedMappingSettingsModelBaseRuleModel' required: true responses: '201': description: Created content: '*/*': schema: $ref: '#/components/schemas/TypedMappingSettingsModel' x-pretty-name: addMappingTypes x-required-privilege: owner: PLATFORM targetDomain: SOURCE type: EDIT targetId: '{sourceId}' x-required-privileges: - owner: PLATFORM targetDomain: SOURCE type: EDIT targetId: '{sourceId}' x-ui-operation-id: /rest/organizations/paramId/sources/paramId/mappings/types_post /rest/organizations/{organizationId}/sources/{sourceId}/mappings/types/{typeId}/rules: get: tags: - Mappings summary: List Specific Mapping Rules of Given Type description: 'Lists the [mapping](https://docs.coveo.com/en/217/) rules of a specific [item](https://docs.coveo.com/en/210/) type.
**Required privilege:** Sources - View

Privilege required ``` {"owner":"PLATFORM","targetDomain":"SOURCE","type":"VIEW","targetId":"*"} ```
' operationId: getMappingTypeSettingRules parameters: - name: organizationId in: path description: The unique identifier of the target [organization](https://docs.coveo.com/en/185/).
**Example:** `mycoveocloudv2organizationg8tp8wu3` required: true schema: type: string - name: sourceId in: path description: The unique identifier of the target [source](https://docs.coveo.com/en/246/).
**Example:** `mycoveocloudv2organizationg8tp8wu3-gravodalyysjsu34camnvxm2d2y` required: true schema: type: string - name: typeId in: path description: The unique identifier of the specific [mapping](https://docs.coveo.com/en/217/) [item](https://docs.coveo.com/en/210/) type to show.
**Example:** `Video` required: true schema: type: string responses: '200': description: OK content: '*/*': schema: type: array items: $ref: '#/components/schemas/RuleModel' x-pretty-name: getMappingTypeSettingRules x-required-privilege: owner: PLATFORM targetDomain: SOURCE type: VIEW targetId: '*' x-required-privileges: - owner: PLATFORM targetDomain: SOURCE type: VIEW targetId: '*' x-ui-operation-id: /rest/organizations/paramId/sources/paramId/mappings/types/paramId/rules_get post: tags: - Mappings summary: Create Specific Mapping Rule of Given Type description: 'Creates a new [mapping](https://docs.coveo.com/en/217/) rule of a specific [item](https://docs.coveo.com/en/210/) type.
**Required privilege:** Sources - Edit

Privilege required ``` {"owner":"PLATFORM","targetDomain":"SOURCE","type":"EDIT","targetId":"{sourceId}"} ```
' operationId: addMappingTypeSettingRule parameters: - name: organizationId in: path description: The unique identifier of the target [organization](https://docs.coveo.com/en/185/).
**Example:** `mycoveocloudv2organizationg8tp8wu3` required: true schema: type: string - name: sourceId in: path description: The unique identifier of the target [source](https://docs.coveo.com/en/246/).
**Example:** `mycoveocloudv2organizationg8tp8wu3-gravodalyysjsu34camnvxm2d2y` required: true schema: type: string - name: typeId in: path description: The type of specific [mapping](https://docs.coveo.com/en/217/) rule to create.
**Example:** `Video` required: true schema: type: string - name: rebuild in: query description: Whether to rebuild the [source](https://docs.coveo.com/en/246/) after the operation.
**Default:** `false` required: false schema: type: boolean default: false requestBody: content: application/json: schema: $ref: '#/components/schemas/BaseRuleModel' required: true responses: '201': description: Created content: '*/*': schema: $ref: '#/components/schemas/RuleModel' x-pretty-name: addMappingTypeSettingRule x-required-privilege: owner: PLATFORM targetDomain: SOURCE type: EDIT targetId: '{sourceId}' x-required-privileges: - owner: PLATFORM targetDomain: SOURCE type: EDIT targetId: '{sourceId}' x-ui-operation-id: /rest/organizations/paramId/sources/paramId/mappings/types/paramId/rules_post /rest/organizations/{organizationId}/sources/{sourceId}/mappings/common/rules: get: tags: - Mappings summary: List Common Mapping Rules description: 'Lists the common [mapping](https://docs.coveo.com/en/217/) rules of a [source](https://docs.coveo.com/en/246/) (i.e., the mapping rules that apply to all [item](https://docs.coveo.com/en/210/) types).
**Required privilege:** Sources - View

Privilege required ``` {"owner":"PLATFORM","targetDomain":"SOURCE","type":"VIEW","targetId":"*"} ```
' operationId: getCommonMappingSettingsRules parameters: - name: organizationId in: path description: The unique identifier of the target [organization](https://docs.coveo.com/en/185/).
**Example:** `mycoveocloudv2organizationg8tp8wu3` required: true schema: type: string - name: sourceId in: path description: The unique identifier of the target [source](https://docs.coveo.com/en/246/).
**Example:** `mycoveocloudv2organizationg8tp8wu3-gravodalyysjsu34camnvxm2d2y` required: true schema: type: string responses: '200': description: OK content: '*/*': schema: type: array items: $ref: '#/components/schemas/RuleModel' x-pretty-name: getCommonMappingSettingsRules x-required-privilege: owner: PLATFORM targetDomain: SOURCE type: VIEW targetId: '*' x-required-privileges: - owner: PLATFORM targetDomain: SOURCE type: VIEW targetId: '*' x-ui-operation-id: /rest/organizations/paramId/sources/paramId/mappings/common/rules_get post: tags: - Mappings summary: Create Common Mapping Rule description: 'Creates a new [source](https://docs.coveo.com/en/246/) common [mapping](https://docs.coveo.com/en/217/) rule (i.e., a mapping rule that applies to all [item](https://docs.coveo.com/en/210/) types).
**Required privilege:** Sources - Edit

Privilege required ``` {"owner":"PLATFORM","targetDomain":"SOURCE","type":"EDIT","targetId":"{sourceId}"} ```
' operationId: addCommonMappingSettingsRule parameters: - name: organizationId in: path description: The unique identifier of the target [organization](https://docs.coveo.com/en/185/).
**Example:** `mycoveocloudv2organizationg8tp8wu3` required: true schema: type: string - name: sourceId in: path description: The unique identifier of the target [source](https://docs.coveo.com/en/246/).
**Example:** `mycoveocloudv2organizationg8tp8wu3-gravodalyysjsu34camnvxm2d2y` required: true schema: type: string - name: rebuild in: query description: Whether to rebuild the [source](https://docs.coveo.com/en/246/) after the operation.
**Default:** `false` required: false schema: type: boolean default: false requestBody: content: application/json: schema: $ref: '#/components/schemas/BaseRuleModel' required: true responses: '201': description: Created content: '*/*': schema: $ref: '#/components/schemas/RuleModel' x-pretty-name: addCommonMappingSettingsRule x-required-privilege: owner: PLATFORM targetDomain: SOURCE type: EDIT targetId: '{sourceId}' x-required-privileges: - owner: PLATFORM targetDomain: SOURCE type: EDIT targetId: '{sourceId}' x-ui-operation-id: /rest/organizations/paramId/sources/paramId/mappings/common/rules_post /rest/organizations/{organizationId}/sources/{sourceId}/mappings/batch/update: post: tags: - Mappings summary: Update Mapping Rules in Batch description: 'Updates [mappings](https://docs.coveo.com/en/217/) in batch for a specific [source](https://docs.coveo.com/en/246/).
**Required privilege:** Sources - Edit

Privilege required ``` {"owner":"PLATFORM","targetDomain":"SOURCE","type":"EDIT","targetId":"{sourceId}"} ```
' operationId: updateMappingTypesBatch parameters: - name: organizationId in: path description: The unique identifier of the target [organization](https://docs.coveo.com/en/185/).
**Example:** `mycoveocloudv2organizationg8tp8wu3` required: true schema: type: string - name: sourceId in: path description: The unique identifier of the target [source](https://docs.coveo.com/en/246/).
**Example:** `mycoveocloudv2organizationg8tp8wu3-gravodalyysjsu34camnvxm2d2y` required: true schema: type: string - name: rebuild in: query description: Whether to rebuild the [source](https://docs.coveo.com/en/246/) after the operation.
**Default:** `false` required: false schema: type: boolean default: false requestBody: content: application/json: schema: type: array description: The [mappings](https://docs.coveo.com/en/217/) to update. items: $ref: '#/components/schemas/TypedMappingSettingsModel' required: true responses: '201': description: Created content: '*/*': schema: $ref: '#/components/schemas/BatchOperationProgressModelTypedMappingSettingsModel' x-pretty-name: updateMappingTypesBatch x-required-privilege: owner: PLATFORM targetDomain: SOURCE type: EDIT targetId: '{sourceId}' x-required-privileges: - owner: PLATFORM targetDomain: SOURCE type: EDIT targetId: '{sourceId}' x-ui-operation-id: /rest/organizations/paramId/sources/paramId/mappings/batch/update_post /rest/organizations/{organizationId}/sources/{sourceId}/mappings/batch/delete: post: tags: - Mappings summary: Delete Mapping Rules in Batch description: 'Deletes [mappings](https://docs.coveo.com/en/217/) in batch for a specific [source](https://docs.coveo.com/en/246/).
**Required privilege:** Sources - Edit

Privilege required ``` {"owner":"PLATFORM","targetDomain":"SOURCE","type":"EDIT","targetId":"{sourceId}"} ```
' operationId: deleteMappingTypesBatch parameters: - name: organizationId in: path description: The unique identifier of the target [organization](https://docs.coveo.com/en/185/).
**Example:** `mycoveocloudv2organizationg8tp8wu3` required: true schema: type: string - name: sourceId in: path description: The unique identifier of the target [source](https://docs.coveo.com/en/246/).
**Example:** `mycoveocloudv2organizationg8tp8wu3-gravodalyysjsu34camnvxm2d2y` required: true schema: type: string - name: rebuild in: query description: Whether to rebuild the [source](https://docs.coveo.com/en/246/) after the operation.
**Default:** `false` required: false schema: type: boolean default: false requestBody: content: application/json: schema: type: array description: The [mappings](https://docs.coveo.com/en/217/) to delete. items: $ref: '#/components/schemas/TypedMappingSettingsModel' required: true responses: '201': description: Created content: '*/*': schema: $ref: '#/components/schemas/BatchOperationProgressModelTypedMappingSettingsModel' x-pretty-name: deleteMappingTypesBatch x-required-privilege: owner: PLATFORM targetDomain: SOURCE type: EDIT targetId: '{sourceId}' x-required-privileges: - owner: PLATFORM targetDomain: SOURCE type: EDIT targetId: '{sourceId}' x-ui-operation-id: /rest/organizations/paramId/sources/paramId/mappings/batch/delete_post /rest/organizations/{organizationId}/sources/{sourceId}/mappings/batch/create: post: tags: - Mappings summary: Create Mapping Rules in Batch description: 'Creates new [mappings](https://docs.coveo.com/en/217/) in batch for a specific [source](https://docs.coveo.com/en/246/).
**Required privilege:** Sources - Edit

Privilege required ``` {"owner":"PLATFORM","targetDomain":"SOURCE","type":"EDIT","targetId":"{sourceId}"} ```
' operationId: addMappingTypesBatch parameters: - name: organizationId in: path description: The unique identifier of the target [organization](https://docs.coveo.com/en/185/).
**Example:** `mycoveocloudv2organizationg8tp8wu3` required: true schema: type: string - name: sourceId in: path description: The unique identifier of the target [source](https://docs.coveo.com/en/246/).
**Example:** `mycoveocloudv2organizationg8tp8wu3-gravodalyysjsu34camnvxm2d2y` required: true schema: type: string - name: rebuild in: query description: Whether to rebuild the [source](https://docs.coveo.com/en/246/) after the operation.
**Default:** `false` required: false schema: type: boolean default: false requestBody: content: application/json: schema: type: array description: The [mappings](https://docs.coveo.com/en/217/) to create. items: $ref: '#/components/schemas/TypedMappingSettingsModel' required: true responses: '201': description: Created content: '*/*': schema: $ref: '#/components/schemas/BatchOperationProgressModelTypedMappingSettingsModel' x-pretty-name: addMappingTypesBatch x-required-privilege: owner: PLATFORM targetDomain: SOURCE type: EDIT targetId: '{sourceId}' x-required-privileges: - owner: PLATFORM targetDomain: SOURCE type: EDIT targetId: '{sourceId}' x-ui-operation-id: /rest/organizations/paramId/sources/paramId/mappings/batch/create_post /rest/organizations/{organizationId}/sources/{sourceId}/incrementalRefresh: post: tags: - Sources summary: Apply an Incremental Refresh Operation on a Source description: '
Privilege required ``` {"owner":"PLATFORM","targetDomain":"SOURCE","type":"EDIT","targetId":"{sourceId}"} ```
' operationId: incrementalRefresh parameters: - name: organizationId in: path required: true schema: type: string - name: sourceId in: path required: true schema: type: string responses: '200': description: OK content: '*/*': schema: oneOf: - $ref: '#/components/schemas/SourceModel' - $ref: '#/components/schemas/AmazonS3SourceModel' - $ref: '#/components/schemas/BoxEnterprise2SourceModel' - $ref: '#/components/schemas/CatalogSourceModel' - $ref: '#/components/schemas/Confluence2HostedSourceModel' - $ref: '#/components/schemas/Confluence2SourceModel' - $ref: '#/components/schemas/CustomSourceModel' - $ref: '#/components/schemas/DatabaseSourceModel' - $ref: '#/components/schemas/DropboxForBusinessSourceModel' - $ref: '#/components/schemas/FileSourceModel' - $ref: '#/components/schemas/GenericRestSourceModel' - $ref: '#/components/schemas/GoogleDriveDomainWideSourceModel' - $ref: '#/components/schemas/GraphQlSourceModel' - $ref: '#/components/schemas/Jira2HostedSourceModel' - $ref: '#/components/schemas/Jira2SourceModel' - $ref: '#/components/schemas/JiveHostedSourceModel' - $ref: '#/components/schemas/JiveSourceModel' - $ref: '#/components/schemas/KhorosSourceModel' - $ref: '#/components/schemas/MicrosoftDynamicsSourceModel' - $ref: '#/components/schemas/PushSourceModel' - $ref: '#/components/schemas/RSSSourceModel' - $ref: '#/components/schemas/SAPSourceModel' - $ref: '#/components/schemas/SalesforceSitesSourceModel' - $ref: '#/components/schemas/SalesforceSourceModel' - $ref: '#/components/schemas/ServiceNowSourceModel' - $ref: '#/components/schemas/SharePointOnline2SourceModel' - $ref: '#/components/schemas/SharePointSourceModel' - $ref: '#/components/schemas/ShopifySourceModel' - $ref: '#/components/schemas/SitecoreSourceModel' - $ref: '#/components/schemas/SitemapSourceModel' - $ref: '#/components/schemas/SlackSourceModel' - $ref: '#/components/schemas/Web2SourceModel' - $ref: '#/components/schemas/YouTubeSourceModel' - $ref: '#/components/schemas/ZendeskSourceModel' x-pretty-name: incrementalRefresh x-required-privilege: owner: PLATFORM targetDomain: SOURCE type: EDIT targetId: '{sourceId}' x-required-privileges: - owner: PLATFORM targetDomain: SOURCE type: EDIT targetId: '{sourceId}' x-ui-operation-id: /rest/organizations/paramId/sources/paramId/incrementalRefresh_post /rest/organizations/{organizationId}/sources/{sourceId}/fullRefresh: post: tags: - Sources summary: Apply a Full Refresh Operation on a Source description: '
Privilege required ``` {"owner":"PLATFORM","targetDomain":"SOURCE","type":"EDIT","targetId":"{sourceId}"} ```
' operationId: fullRefresh parameters: - name: organizationId in: path required: true schema: type: string - name: sourceId in: path required: true schema: type: string responses: '200': description: OK content: '*/*': schema: oneOf: - $ref: '#/components/schemas/SourceModel' - $ref: '#/components/schemas/AmazonS3SourceModel' - $ref: '#/components/schemas/BoxEnterprise2SourceModel' - $ref: '#/components/schemas/CatalogSourceModel' - $ref: '#/components/schemas/Confluence2HostedSourceModel' - $ref: '#/components/schemas/Confluence2SourceModel' - $ref: '#/components/schemas/CustomSourceModel' - $ref: '#/components/schemas/DatabaseSourceModel' - $ref: '#/components/schemas/DropboxForBusinessSourceModel' - $ref: '#/components/schemas/FileSourceModel' - $ref: '#/components/schemas/GenericRestSourceModel' - $ref: '#/components/schemas/GoogleDriveDomainWideSourceModel' - $ref: '#/components/schemas/GraphQlSourceModel' - $ref: '#/components/schemas/Jira2HostedSourceModel' - $ref: '#/components/schemas/Jira2SourceModel' - $ref: '#/components/schemas/JiveHostedSourceModel' - $ref: '#/components/schemas/JiveSourceModel' - $ref: '#/components/schemas/KhorosSourceModel' - $ref: '#/components/schemas/MicrosoftDynamicsSourceModel' - $ref: '#/components/schemas/PushSourceModel' - $ref: '#/components/schemas/RSSSourceModel' - $ref: '#/components/schemas/SAPSourceModel' - $ref: '#/components/schemas/SalesforceSitesSourceModel' - $ref: '#/components/schemas/SalesforceSourceModel' - $ref: '#/components/schemas/ServiceNowSourceModel' - $ref: '#/components/schemas/SharePointOnline2SourceModel' - $ref: '#/components/schemas/SharePointSourceModel' - $ref: '#/components/schemas/ShopifySourceModel' - $ref: '#/components/schemas/SitecoreSourceModel' - $ref: '#/components/schemas/SitemapSourceModel' - $ref: '#/components/schemas/SlackSourceModel' - $ref: '#/components/schemas/Web2SourceModel' - $ref: '#/components/schemas/YouTubeSourceModel' - $ref: '#/components/schemas/ZendeskSourceModel' x-pretty-name: fullRefresh x-required-privilege: owner: PLATFORM targetDomain: SOURCE type: EDIT targetId: '{sourceId}' x-required-privileges: - owner: PLATFORM targetDomain: SOURCE type: EDIT targetId: '{sourceId}' x-ui-operation-id: /rest/organizations/paramId/sources/paramId/fullRefresh_post /rest/organizations/{organizationId}/sources/{sourceId}/enable: post: tags: - Sources summary: Enable Schedules on a Source description: '
Privilege required ``` {"owner":"PLATFORM","targetDomain":"SOURCE","type":"EDIT","targetId":"{sourceId}"} ```
' operationId: enable parameters: - name: organizationId in: path required: true schema: type: string - name: sourceId in: path required: true schema: type: string responses: '200': description: OK content: '*/*': schema: oneOf: - $ref: '#/components/schemas/SourceModel' - $ref: '#/components/schemas/AmazonS3SourceModel' - $ref: '#/components/schemas/BoxEnterprise2SourceModel' - $ref: '#/components/schemas/CatalogSourceModel' - $ref: '#/components/schemas/Confluence2HostedSourceModel' - $ref: '#/components/schemas/Confluence2SourceModel' - $ref: '#/components/schemas/CustomSourceModel' - $ref: '#/components/schemas/DatabaseSourceModel' - $ref: '#/components/schemas/DropboxForBusinessSourceModel' - $ref: '#/components/schemas/FileSourceModel' - $ref: '#/components/schemas/GenericRestSourceModel' - $ref: '#/components/schemas/GoogleDriveDomainWideSourceModel' - $ref: '#/components/schemas/GraphQlSourceModel' - $ref: '#/components/schemas/Jira2HostedSourceModel' - $ref: '#/components/schemas/Jira2SourceModel' - $ref: '#/components/schemas/JiveHostedSourceModel' - $ref: '#/components/schemas/JiveSourceModel' - $ref: '#/components/schemas/KhorosSourceModel' - $ref: '#/components/schemas/MicrosoftDynamicsSourceModel' - $ref: '#/components/schemas/PushSourceModel' - $ref: '#/components/schemas/RSSSourceModel' - $ref: '#/components/schemas/SAPSourceModel' - $ref: '#/components/schemas/SalesforceSitesSourceModel' - $ref: '#/components/schemas/SalesforceSourceModel' - $ref: '#/components/schemas/ServiceNowSourceModel' - $ref: '#/components/schemas/SharePointOnline2SourceModel' - $ref: '#/components/schemas/SharePointSourceModel' - $ref: '#/components/schemas/ShopifySourceModel' - $ref: '#/components/schemas/SitecoreSourceModel' - $ref: '#/components/schemas/SitemapSourceModel' - $ref: '#/components/schemas/SlackSourceModel' - $ref: '#/components/schemas/Web2SourceModel' - $ref: '#/components/schemas/YouTubeSourceModel' - $ref: '#/components/schemas/ZendeskSourceModel' deprecated: true x-pretty-name: enable x-required-privilege: owner: PLATFORM targetDomain: SOURCE type: EDIT targetId: '{sourceId}' x-required-privileges: - owner: PLATFORM targetDomain: SOURCE type: EDIT targetId: '{sourceId}' x-ui-operation-id: /rest/organizations/paramId/sources/paramId/enable_post /rest/organizations/{organizationId}/sources/{sourceId}/duplicate: post: tags: - Sources summary: Duplicate a Source description: '
Privilege required ``` {"owner":"PLATFORM","targetDomain":"SOURCE","type":"EDIT","targetId":"{sourceId}"} AND {"owner":"PLATFORM","targetDomain":"SOURCE","type":"CREATE","targetId":"*"} ```
' operationId: duplicateSource parameters: - name: organizationId in: path required: true schema: type: string - name: sourceId in: path required: true schema: type: string - name: newSourceName in: query required: true schema: type: string - name: logicalIndexId in: query required: false schema: type: string responses: '201': description: Created content: '*/*': schema: oneOf: - $ref: '#/components/schemas/SourceModel' - $ref: '#/components/schemas/AmazonS3SourceModel' - $ref: '#/components/schemas/BoxEnterprise2SourceModel' - $ref: '#/components/schemas/CatalogSourceModel' - $ref: '#/components/schemas/Confluence2HostedSourceModel' - $ref: '#/components/schemas/Confluence2SourceModel' - $ref: '#/components/schemas/CustomSourceModel' - $ref: '#/components/schemas/DatabaseSourceModel' - $ref: '#/components/schemas/DropboxForBusinessSourceModel' - $ref: '#/components/schemas/FileSourceModel' - $ref: '#/components/schemas/GenericRestSourceModel' - $ref: '#/components/schemas/GoogleDriveDomainWideSourceModel' - $ref: '#/components/schemas/GraphQlSourceModel' - $ref: '#/components/schemas/Jira2HostedSourceModel' - $ref: '#/components/schemas/Jira2SourceModel' - $ref: '#/components/schemas/JiveHostedSourceModel' - $ref: '#/components/schemas/JiveSourceModel' - $ref: '#/components/schemas/KhorosSourceModel' - $ref: '#/components/schemas/MicrosoftDynamicsSourceModel' - $ref: '#/components/schemas/PushSourceModel' - $ref: '#/components/schemas/RSSSourceModel' - $ref: '#/components/schemas/SAPSourceModel' - $ref: '#/components/schemas/SalesforceSitesSourceModel' - $ref: '#/components/schemas/SalesforceSourceModel' - $ref: '#/components/schemas/ServiceNowSourceModel' - $ref: '#/components/schemas/SharePointOnline2SourceModel' - $ref: '#/components/schemas/SharePointSourceModel' - $ref: '#/components/schemas/ShopifySourceModel' - $ref: '#/components/schemas/SitecoreSourceModel' - $ref: '#/components/schemas/SitemapSourceModel' - $ref: '#/components/schemas/SlackSourceModel' - $ref: '#/components/schemas/Web2SourceModel' - $ref: '#/components/schemas/YouTubeSourceModel' - $ref: '#/components/schemas/ZendeskSourceModel' x-pretty-name: duplicateSource x-required-privilege: owner: PLATFORM targetDomain: SOURCE type: EDIT targetId: '{sourceId}' x-required-privileges: - owner: PLATFORM targetDomain: SOURCE type: EDIT targetId: '{sourceId}' - owner: PLATFORM targetDomain: SOURCE type: CREATE targetId: '*' x-ui-operation-id: /rest/organizations/paramId/sources/paramId/duplicate_post /rest/organizations/{organizationId}/sources/{sourceId}/disable: post: tags: - Sources summary: Disable Schedules on a Source description: '
Privilege required ``` {"owner":"PLATFORM","targetDomain":"SOURCE","type":"EDIT","targetId":"{sourceId}"} ```
' operationId: disable parameters: - name: organizationId in: path required: true schema: type: string - name: sourceId in: path required: true schema: type: string responses: '200': description: OK content: '*/*': schema: oneOf: - $ref: '#/components/schemas/SourceModel' - $ref: '#/components/schemas/AmazonS3SourceModel' - $ref: '#/components/schemas/BoxEnterprise2SourceModel' - $ref: '#/components/schemas/CatalogSourceModel' - $ref: '#/components/schemas/Confluence2HostedSourceModel' - $ref: '#/components/schemas/Confluence2SourceModel' - $ref: '#/components/schemas/CustomSourceModel' - $ref: '#/components/schemas/DatabaseSourceModel' - $ref: '#/components/schemas/DropboxForBusinessSourceModel' - $ref: '#/components/schemas/FileSourceModel' - $ref: '#/components/schemas/GenericRestSourceModel' - $ref: '#/components/schemas/GoogleDriveDomainWideSourceModel' - $ref: '#/components/schemas/GraphQlSourceModel' - $ref: '#/components/schemas/Jira2HostedSourceModel' - $ref: '#/components/schemas/Jira2SourceModel' - $ref: '#/components/schemas/JiveHostedSourceModel' - $ref: '#/components/schemas/JiveSourceModel' - $ref: '#/components/schemas/KhorosSourceModel' - $ref: '#/components/schemas/MicrosoftDynamicsSourceModel' - $ref: '#/components/schemas/PushSourceModel' - $ref: '#/components/schemas/RSSSourceModel' - $ref: '#/components/schemas/SAPSourceModel' - $ref: '#/components/schemas/SalesforceSitesSourceModel' - $ref: '#/components/schemas/SalesforceSourceModel' - $ref: '#/components/schemas/ServiceNowSourceModel' - $ref: '#/components/schemas/SharePointOnline2SourceModel' - $ref: '#/components/schemas/SharePointSourceModel' - $ref: '#/components/schemas/ShopifySourceModel' - $ref: '#/components/schemas/SitecoreSourceModel' - $ref: '#/components/schemas/SitemapSourceModel' - $ref: '#/components/schemas/SlackSourceModel' - $ref: '#/components/schemas/Web2SourceModel' - $ref: '#/components/schemas/YouTubeSourceModel' - $ref: '#/components/schemas/ZendeskSourceModel' deprecated: true x-pretty-name: disable x-required-privilege: owner: PLATFORM targetDomain: SOURCE type: EDIT targetId: '{sourceId}' x-required-privileges: - owner: PLATFORM targetDomain: SOURCE type: EDIT targetId: '{sourceId}' x-ui-operation-id: /rest/organizations/paramId/sources/paramId/disable_post /rest/organizations/{organizationId}/sources/{sourceId}/configuration/salesforce/evict: post: tags: - Sources summary: Evict the Salesforce Schema of a Source. description: '
Privilege required ``` {"owner":"PLATFORM","targetDomain":"SOURCE","type":"EDIT","targetId":"{sourceId}"} ```
' operationId: evictSchemaForSource parameters: - name: organizationId in: path required: true schema: type: string - name: sourceId in: path required: true schema: type: string responses: '200': description: OK x-pretty-name: evictSchemaForSource x-required-privilege: owner: PLATFORM targetDomain: SOURCE type: EDIT targetId: '{sourceId}' x-required-privileges: - owner: PLATFORM targetDomain: SOURCE type: EDIT targetId: '{sourceId}' x-ui-operation-id: /rest/organizations/paramId/sources/paramId/configuration/salesforce/evict_post /rest/organizations/{organizationId}/sources/{sourceId}/applyChanges: post: tags: - Sources summary: Apply Pending Changes on a Source description: '
Privilege required ``` {"owner":"PLATFORM","targetDomain":"SOURCE","type":"EDIT","targetId":"{sourceId}"} ```
' operationId: applyChanges parameters: - name: organizationId in: path required: true schema: type: string - name: sourceId in: path required: true schema: type: string responses: '204': description: No Content x-pretty-name: applyChanges x-required-privilege: owner: PLATFORM targetDomain: SOURCE type: EDIT targetId: '{sourceId}' x-required-privileges: - owner: PLATFORM targetDomain: SOURCE type: EDIT targetId: '{sourceId}' x-ui-operation-id: /rest/organizations/paramId/sources/paramId/applyChanges_post /rest/organizations/{organizationId}/sources/raw: post: tags: - Sources summary: Create a Source from Raw Configuration description: '
Privilege required ``` {"owner":"PLATFORM","targetDomain":"SOURCE","type":"CREATE","targetId":"*"} ```
' operationId: createRawSource parameters: - name: organizationId in: path required: true schema: type: string - name: updateSecurityProviders in: query required: false schema: type: boolean default: true - name: rebuild in: query required: false schema: type: boolean default: true requestBody: content: application/json: schema: $ref: '#/components/schemas/RawSourceConfig' required: true responses: '201': description: Created content: '*/*': schema: oneOf: - $ref: '#/components/schemas/SourceModel' - $ref: '#/components/schemas/AmazonS3SourceModel' - $ref: '#/components/schemas/BoxEnterprise2SourceModel' - $ref: '#/components/schemas/CatalogSourceModel' - $ref: '#/components/schemas/Confluence2HostedSourceModel' - $ref: '#/components/schemas/Confluence2SourceModel' - $ref: '#/components/schemas/CustomSourceModel' - $ref: '#/components/schemas/DatabaseSourceModel' - $ref: '#/components/schemas/DropboxForBusinessSourceModel' - $ref: '#/components/schemas/FileSourceModel' - $ref: '#/components/schemas/GenericRestSourceModel' - $ref: '#/components/schemas/GoogleDriveDomainWideSourceModel' - $ref: '#/components/schemas/GraphQlSourceModel' - $ref: '#/components/schemas/Jira2HostedSourceModel' - $ref: '#/components/schemas/Jira2SourceModel' - $ref: '#/components/schemas/JiveHostedSourceModel' - $ref: '#/components/schemas/JiveSourceModel' - $ref: '#/components/schemas/KhorosSourceModel' - $ref: '#/components/schemas/MicrosoftDynamicsSourceModel' - $ref: '#/components/schemas/PushSourceModel' - $ref: '#/components/schemas/RSSSourceModel' - $ref: '#/components/schemas/SAPSourceModel' - $ref: '#/components/schemas/SalesforceSitesSourceModel' - $ref: '#/components/schemas/SalesforceSourceModel' - $ref: '#/components/schemas/ServiceNowSourceModel' - $ref: '#/components/schemas/SharePointOnline2SourceModel' - $ref: '#/components/schemas/SharePointSourceModel' - $ref: '#/components/schemas/ShopifySourceModel' - $ref: '#/components/schemas/SitecoreSourceModel' - $ref: '#/components/schemas/SitemapSourceModel' - $ref: '#/components/schemas/SlackSourceModel' - $ref: '#/components/schemas/Web2SourceModel' - $ref: '#/components/schemas/YouTubeSourceModel' - $ref: '#/components/schemas/ZendeskSourceModel' x-pretty-name: createRawSource x-required-privilege: owner: PLATFORM targetDomain: SOURCE type: CREATE targetId: '*' x-required-privileges: - owner: PLATFORM targetDomain: SOURCE type: CREATE targetId: '*' x-ui-operation-id: /rest/organizations/paramId/sources/raw_post /rest/organizations/{organizationId}/sources/pages/ids: post: tags: - Sources summary: Get a Page Containing a Subset of Sources by Ids for an Organization. description: '
Privilege required ``` {"owner":"PLATFORM","targetDomain":"SOURCE","type":"VIEW","targetId":"*"} ```
' operationId: getSourcesAndPageInformationsByIds parameters: - name: organizationId in: path required: true schema: type: string - name: page in: query required: false schema: type: integer format: int32 default: 0 - name: perPage in: query required: false schema: type: integer format: int32 default: 100 - name: filter in: query description: Optional filter string. Must be at least 2 characters long to be applied. required: false schema: type: string - name: sortingType in: query required: false schema: type: string default: NAME enum: - TYPE - NAME - STATUS - CONTENT - LAST_MODIFIED_DATE - LAST_OPERATION - CONTENT_TOTAL_DOCUMENT_SIZE - STATUS_PRIORITY - name: sortingOrder in: query required: false schema: type: string default: ASC enum: - ASC - DESC - name: writeAccessOnly in: query required: false schema: type: boolean default: false - name: filterStatusType in: query required: false schema: type: string enum: - CREATING - REFRESHING - PAUSED - PAUSED_ON_ERROR - IDLE - ERROR - name: filterLastOperationType in: query required: false schema: type: string enum: - INCREMENTAL_REFRESH - FULL_REFRESH - REBUILD - name: filterLastOperationResultType in: query required: false schema: type: string enum: - SUCCESS - ERROR - ABORT - name: filterHostType in: query required: false schema: type: string enum: - CLOUD - CRAWLING_MODULE - PUSH - name: stringFilterType in: query required: false schema: type: string enum: - WILDCARD - EXACTMATCH requestBody: content: application/json: schema: uniqueItems: true type: array description: List of the unique identifiers of the targets [source](https://docs.coveo.com/en/246/).
**Example:** [`mycoveocloudv2organizationg8tp8wu3-gravodalyysjsu34camnvxm2d2y`, `mycoveocloudv2organizationg8tp8wu3-wsqbiw2mkrmktzu5jupmp72n3i`] items: type: string required: true responses: '200': description: OK content: '*/*': schema: $ref: '#/components/schemas/GetSourcesOutArgs' x-pretty-name: getSourcesAndPageInformationsByIds x-required-privilege: owner: PLATFORM targetDomain: SOURCE type: VIEW targetId: '*' x-required-privileges: - owner: PLATFORM targetDomain: SOURCE type: VIEW targetId: '*' x-ui-operation-id: /rest/organizations/paramId/sources/pages/ids_post /rest/organizations/{organizationId}/sources/fields: get: tags: - Sources summary: Get All Fields for an Organization description: '
Privilege required ``` {"owner":"PLATFORM","targetDomain":"FIELD","type":"VIEW","targetId":"*"} ```
' operationId: getFields_1 parameters: - name: organizationId in: path required: true schema: type: string - name: sourceId in: query required: false schema: type: string - name: includeMappings in: query required: false schema: type: boolean default: true responses: '200': description: OK content: '*/*': schema: type: array items: $ref: '#/components/schemas/SourceFieldModel' deprecated: true x-pretty-name: getFields x-required-privilege: owner: PLATFORM targetDomain: FIELD type: VIEW targetId: '*' x-required-privileges: - owner: PLATFORM targetDomain: FIELD type: VIEW targetId: '*' x-ui-operation-id: /rest/organizations/paramId/sources/fields_get post: tags: - Sources summary: Creates a Field for an Organization description: '
Privilege required ``` {"owner":"PLATFORM","targetDomain":"FIELD","type":"CREATE","targetId":"*"} ```
' operationId: createField parameters: - name: organizationId in: path required: true schema: type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/SourceFieldModel' required: true responses: '204': description: No Content x-pretty-name: createField x-required-privilege: owner: PLATFORM targetDomain: FIELD type: CREATE targetId: '*' x-required-privileges: - owner: PLATFORM targetDomain: FIELD type: CREATE targetId: '*' x-ui-operation-id: /rest/organizations/paramId/sources/fields_post /rest/organizations/{organizationId}/sources/fields/batch/create: post: tags: - Sources summary: Creates Fields for an Organization description: '
Privilege required ``` {"owner":"PLATFORM","targetDomain":"FIELD","type":"CREATE","targetId":"*"} ```
' operationId: createFields parameters: - name: organizationId in: path required: true schema: type: string requestBody: content: application/json: schema: type: array items: $ref: '#/components/schemas/SourceFieldModel' required: true responses: '204': description: No Content x-pretty-name: createFields x-required-privilege: owner: PLATFORM targetDomain: FIELD type: CREATE targetId: '*' x-required-privileges: - owner: PLATFORM targetDomain: FIELD type: CREATE targetId: '*' x-ui-operation-id: /rest/organizations/paramId/sources/fields/batch/create_post /rest/sourceconfiguration/salesforce/objects/{objectName}: get: tags: - Salesforce Source Configuration summary: Get the Information for a Given Object operationId: getObject parameters: - name: objectName in: path required: true schema: type: string - name: accessToken in: query required: false schema: type: string default: '' - name: idUrl in: query required: false schema: type: string default: '' - name: refreshToken in: query required: false schema: type: string default: '' - name: refreshTokenGuid in: query required: false schema: type: string default: '' - name: schemaVersion in: query required: false schema: type: string default: EXPRESS enum: - CLOUDV1 - LEGACY - EXPRESS - name: sandbox in: query required: false schema: type: boolean default: false responses: '200': description: OK content: '*/*': schema: $ref: '#/components/schemas/SalesforceObject' x-pretty-name: getObject x-ui-operation-id: /rest/sourceconfiguration/salesforce/objects/paramId_get /rest/sourceconfiguration/salesforce/objects/{objectName}/{relationshipName}: get: tags: - Salesforce Source Configuration summary: Get the Information for a Given Object Relationship operationId: getRelationship parameters: - name: objectName in: path required: true schema: type: string - name: relationshipName in: path required: true schema: type: string - name: accessToken in: query required: false schema: type: string default: '' - name: idUrl in: query required: false schema: type: string default: '' - name: refreshToken in: query required: false schema: type: string default: '' - name: refreshTokenGuid in: query required: false schema: type: string default: '' - name: schemaVersion in: query required: false schema: type: string default: EXPRESS enum: - CLOUDV1 - LEGACY - EXPRESS - name: sandbox in: query required: false schema: type: boolean default: false responses: '200': description: OK content: '*/*': schema: $ref: '#/components/schemas/SalesforceRelationship' x-pretty-name: getRelationship x-ui-operation-id: /rest/sourceconfiguration/salesforce/objects/paramId/paramId_get /rest/organizations/{organizationId}/sources/{sourceId}/metadata/status: get: tags: - Metadata summary: Get the Status of Metadata Reports for a Source description: '
Privilege required ``` {"owner":"PLATFORM","targetDomain":"SOURCE","type":"EDIT","targetId":"{sourceId}"} AND {"owner":"PLATFORM","targetDomain":"SOURCE_METADATA","type":"VIEW","targetId":"*"} ```
' operationId: getSourceMetadataStatus parameters: - name: organizationId in: path description: The unique identifier of the target [organization](https://docs.coveo.com/en/185/).
**Example:** `mycoveocloudv2organizationg8tp8wu3` required: true schema: type: string - name: sourceId in: path description: The unique identifier of the target [source](https://docs.coveo.com/en/246/).
**Example:** `mycoveocloudv2organizationg8tp8wu3-gravodalyysjsu34camnvxm2d2y` required: true schema: type: string responses: '200': description: OK content: '*/*': schema: $ref: '#/components/schemas/SourceMetadataStatusModel' x-pretty-name: getSourceMetadataStatus x-required-privilege: owner: PLATFORM targetDomain: SOURCE type: EDIT targetId: '{sourceId}' x-required-privileges: - owner: PLATFORM targetDomain: SOURCE type: EDIT targetId: '{sourceId}' - owner: PLATFORM targetDomain: SOURCE_METADATA type: VIEW targetId: '*' x-ui-operation-id: /rest/organizations/paramId/sources/paramId/metadata/status_get /rest/organizations/{organizationId}/sources/{sourceId}/light: get: tags: - Sources summary: Get a Single Source description: '
Privilege required ``` {"owner":"PLATFORM","targetDomain":"SOURCE","type":"VIEW","targetId":"*"} ```
' operationId: getLightSource parameters: - name: organizationId in: path required: true schema: type: string - name: sourceId in: path required: true schema: type: string responses: '200': description: OK content: '*/*': schema: $ref: '#/components/schemas/LightSourceModel' x-pretty-name: getLightSource x-required-privilege: owner: PLATFORM targetDomain: SOURCE type: VIEW targetId: '*' x-required-privileges: - owner: PLATFORM targetDomain: SOURCE type: VIEW targetId: '*' x-ui-operation-id: /rest/organizations/paramId/sources/paramId/light_get /rest/organizations/{organizationId}/sources/{sourceId}/itemTypes: get: tags: - Source Item Types summary: List Item Types description: 'Lists all available [item](https://docs.coveo.com/en/210/) types in a [source](https://docs.coveo.com/en/246/).
**Required privilege:** Sources - View

Privilege required ``` {"owner":"PLATFORM","targetDomain":"SOURCE","type":"VIEW","targetId":"*"} ```
' operationId: getSourceItemTypes parameters: - name: organizationId in: path description: The unique identifier of the target [organization](https://docs.coveo.com/en/185/).
**Example:** `mycoveocloudv2organizationg8tp8wu3` required: true schema: type: string - name: sourceId in: path description: The unique identifier of the target [source](https://docs.coveo.com/en/246/).
**Example:** `mycoveocloudv2organizationg8tp8wu3-gravodalyysjsu34camnvxm2d2y` required: true schema: type: string responses: '200': description: OK content: '*/*': schema: uniqueItems: true type: array items: type: string x-pretty-name: getSourceItemTypes x-required-privilege: owner: PLATFORM targetDomain: SOURCE type: VIEW targetId: '*' x-required-privileges: - owner: PLATFORM targetDomain: SOURCE type: VIEW targetId: '*' x-ui-operation-id: /rest/organizations/paramId/sources/paramId/itemTypes_get /rest/organizations/{organizationId}/sources/{sourceId}/configuration/snapshot: get: tags: - Sources summary: Get the Snapshot of the Source Configuration at the Provided Activity. description: '
Privilege required ``` {"owner":"PLATFORM","targetDomain":"SOURCE","type":"EDIT","targetId":"{sourceId}"} ```
' operationId: getSourceSnapshot parameters: - name: organizationId in: path description: The unique identifier of the target [organization](https://docs.coveo.com/en/185/).
**Example:** `mycoveocloudv2organizationg8tp8wu3` required: true schema: type: string - name: sourceId in: path description: The unique identifier of the target [source](https://docs.coveo.com/en/246/).
**Example:** `mycoveocloudv2organizationg8tp8wu3-gravodalyysjsu34camnvxm2d2y` required: true schema: type: string - name: activityId in: query required: true schema: type: string responses: '200': description: OK content: '*/*': schema: $ref: '#/components/schemas/SourceConfigSnapshotModel' x-pretty-name: getSourceSnapshot x-required-privilege: owner: PLATFORM targetDomain: SOURCE type: EDIT targetId: '{sourceId}' x-required-privileges: - owner: PLATFORM targetDomain: SOURCE type: EDIT targetId: '{sourceId}' x-ui-operation-id: /rest/organizations/paramId/sources/paramId/configuration/snapshot_get /rest/organizations/{organizationId}/sources/{sourceId}/configuration/salesforce/objects/{objectName}: get: tags: - Sources summary: Get an Object Fields for a Given Source. description: '
Privilege required ``` {"owner":"PLATFORM","targetDomain":"SOURCE","type":"VIEW","targetId":"*"} ```
' operationId: getSalesforceObjectForSource parameters: - name: organizationId in: path required: true schema: type: string - name: sourceId in: path required: true schema: type: string - name: objectName in: path required: true schema: type: string - name: relationships in: query required: false schema: type: string default: '' responses: '200': description: OK content: '*/*': schema: $ref: '#/components/schemas/SalesforceObject' x-pretty-name: getSalesforceObjectForSource x-required-privilege: owner: PLATFORM targetDomain: SOURCE type: VIEW targetId: '*' x-required-privileges: - owner: PLATFORM targetDomain: SOURCE type: VIEW targetId: '*' x-ui-operation-id: /rest/organizations/paramId/sources/paramId/configuration/salesforce/objects/paramId_get /rest/organizations/{organizationId}/sources/{sourceId}/configuration/salesforce/objects/{objectName}/{relationshipName}: get: tags: - Sources summary: Get a Relationship for a Given Source and Object. description: '
Privilege required ``` {"owner":"PLATFORM","targetDomain":"SOURCE","type":"VIEW","targetId":"*"} ```
' operationId: getSalesforceRelationshipsForSource parameters: - name: organizationId in: path required: true schema: type: string - name: sourceId in: path required: true schema: type: string - name: objectName in: path required: true schema: type: string - name: relationshipName in: path required: true schema: type: string responses: '200': description: OK content: '*/*': schema: $ref: '#/components/schemas/SalesforceRelationship' x-pretty-name: getSalesforceRelationshipsForSource x-required-privilege: owner: PLATFORM targetDomain: SOURCE type: VIEW targetId: '*' x-required-privileges: - owner: PLATFORM targetDomain: SOURCE type: VIEW targetId: '*' x-ui-operation-id: /rest/organizations/paramId/sources/paramId/configuration/salesforce/objects/paramId/paramId_get /rest/organizations/{organizationId}/sources/{sourceId}/configuration/salesforce/objects/{objectName}/fields: get: tags: - Sources summary: Get an Object Fields for a Given Source. description: '
Privilege required ``` {"owner":"PLATFORM","targetDomain":"SOURCE","type":"VIEW","targetId":"*"} ```
' operationId: getSalesforceFieldsForSource parameters: - name: organizationId in: path required: true schema: type: string - name: sourceId in: path required: true schema: type: string - name: objectName in: path required: true schema: type: string responses: '200': description: OK content: '*/*': schema: type: array items: $ref: '#/components/schemas/SalesforceField' x-pretty-name: getSalesforceFieldsForSource x-required-privilege: owner: PLATFORM targetDomain: SOURCE type: VIEW targetId: '*' x-required-privileges: - owner: PLATFORM targetDomain: SOURCE type: VIEW targetId: '*' x-ui-operation-id: /rest/organizations/paramId/sources/paramId/configuration/salesforce/objects/paramId/fields_get /rest/organizations/{organizationId}/sources/raw/all: get: tags: - Sources summary: Get the Raw Configuration of All Sources description: '
Privilege required ``` {"owner":"PLATFORM","targetDomain":"SOURCE","type":"VIEW","targetId":"*"} ```
' operationId: getAllRawSources parameters: - name: organizationId in: path required: true schema: type: string - name: page in: query required: false schema: type: integer format: int32 default: 0 - name: pageSize in: query required: false schema: type: integer format: int32 default: 20 - name: includeMappings in: query required: false schema: type: boolean default: true responses: '200': description: OK content: '*/*': schema: type: array items: $ref: '#/components/schemas/RawSourceConfig' x-pretty-name: getAllRawSources x-required-privilege: owner: PLATFORM targetDomain: SOURCE type: VIEW targetId: '*' x-required-privileges: - owner: PLATFORM targetDomain: SOURCE type: VIEW targetId: '*' x-ui-operation-id: /rest/organizations/paramId/sources/raw/all_get /rest/organizations/{organizationId}/sources/pages: get: tags: - Sources summary: Get a Page Containing a Subset of Sources for an Organization. description: '
Privilege required ``` {"owner":"PLATFORM","targetDomain":"SOURCE","type":"VIEW","targetId":"*"} ```
' operationId: getSourcesAndPageInformations parameters: - name: organizationId in: path required: true schema: type: string - name: page in: query required: false schema: type: integer format: int32 default: 0 - name: perPage in: query required: false schema: type: integer format: int32 default: 100 - name: filter in: query description: Optional filter string. Must be at least 2 characters long to be applied. required: false schema: type: string - name: sortingType in: query required: false schema: type: string default: NAME enum: - TYPE - NAME - STATUS - CONTENT - LAST_MODIFIED_DATE - LAST_OPERATION - CONTENT_TOTAL_DOCUMENT_SIZE - STATUS_PRIORITY - name: sortingOrder in: query required: false schema: type: string default: ASC enum: - ASC - DESC - name: writeAccessOnly in: query required: false schema: type: boolean default: false - name: filterStatusType in: query required: false schema: type: string enum: - CREATING - REFRESHING - PAUSED - PAUSED_ON_ERROR - IDLE - ERROR - name: filterLastOperationType in: query required: false schema: type: string enum: - INCREMENTAL_REFRESH - FULL_REFRESH - REBUILD - name: filterLastOperationResultType in: query required: false schema: type: string enum: - SUCCESS - ERROR - ABORT - name: filterHostType in: query required: false schema: type: string enum: - CLOUD - CRAWLING_MODULE - PUSH - name: stringFilterType in: query required: false schema: type: string enum: - WILDCARD - EXACTMATCH responses: '200': description: OK content: '*/*': schema: $ref: '#/components/schemas/GetSourcesOutArgs' x-pretty-name: getSourcesAndPageInformations x-required-privilege: owner: PLATFORM targetDomain: SOURCE type: VIEW targetId: '*' x-required-privileges: - owner: PLATFORM targetDomain: SOURCE type: VIEW targetId: '*' x-ui-operation-id: /rest/organizations/paramId/sources/pages_get /rest/organizations/{organizationId}/sources/pages/project: get: tags: - Sources summary: Get a Page Containing a Subset of Sources Part of a Project Id. with the Total Number of Sources and the Total Number of Pages description: '
Privilege required ``` {"owner":"PLATFORM","targetDomain":"SOURCE","type":"VIEW","targetId":"*"} ```
' operationId: getSourcesAndPageInformationsProjectId parameters: - name: organizationId in: path required: true schema: type: string - name: page in: query required: false schema: type: integer format: int32 default: 0 - name: perPage in: query required: false schema: type: integer format: int32 default: 100 - name: filter in: query description: Optional filter string. Must be at least 2 characters long to be applied. required: false schema: type: string - name: projectId in: query required: false schema: type: string - name: sortingType in: query required: false schema: type: string default: NAME enum: - TYPE - NAME - STATUS - CONTENT - LAST_MODIFIED_DATE - LAST_OPERATION - CONTENT_TOTAL_DOCUMENT_SIZE - STATUS_PRIORITY - name: sortingOrder in: query required: false schema: type: string default: ASC enum: - ASC - DESC - name: writeAccessOnly in: query required: false schema: type: boolean default: false - name: filterStatusType in: query required: false schema: type: string enum: - CREATING - REFRESHING - PAUSED - PAUSED_ON_ERROR - IDLE - ERROR - name: filterLastOperationType in: query required: false schema: type: string enum: - INCREMENTAL_REFRESH - FULL_REFRESH - REBUILD - name: filterLastOperationResultType in: query required: false schema: type: string enum: - SUCCESS - ERROR - ABORT - name: filterHostType in: query required: false schema: type: string enum: - CLOUD - CRAWLING_MODULE - PUSH - name: stringFilterType in: query required: false schema: type: string enum: - WILDCARD - EXACTMATCH responses: '200': description: OK content: '*/*': schema: $ref: '#/components/schemas/GetSourcesOutArgs' x-pretty-name: getSourcesAndPageInformationsProjectId x-required-privilege: owner: PLATFORM targetDomain: SOURCE type: VIEW targetId: '*' x-required-privileges: - owner: PLATFORM targetDomain: SOURCE type: VIEW targetId: '*' x-ui-operation-id: /rest/organizations/paramId/sources/pages/project_get /rest/organizations/{organizationId}/sources/page/fields: get: tags: - Sources summary: Get a Page of Fields for an Organization description: '
Privilege required ``` {"owner":"PLATFORM","targetDomain":"FIELD","type":"VIEW","targetId":"*"} ```
' operationId: getFields_2 parameters: - name: organizationId in: path required: true schema: type: string - name: projectId in: query required: false schema: type: string - name: includeMappings in: query required: false schema: type: boolean default: true - name: type in: query required: false schema: type: string enum: - LONG - LONG_64 - DOUBLE - DATE - STRING - VECTOR - name: filter in: query description: Optional filter string. Must be at least 2 characters long to be applied. required: false schema: type: string - name: sortBy in: query required: false schema: type: string default: name - name: order in: query required: false schema: type: string default: ASC - name: page in: query required: false schema: type: integer format: int32 default: 0 - name: perPage in: query required: false schema: type: integer format: int32 default: 100 - name: origin in: query required: false schema: type: string default: ALL enum: - ALL - USER - SYSTEM responses: '200': description: OK content: '*/*': schema: $ref: '#/components/schemas/PageModelSourceFieldModel' x-pretty-name: getFields x-required-privilege: owner: PLATFORM targetDomain: FIELD type: VIEW targetId: '*' x-required-privileges: - owner: PLATFORM targetDomain: FIELD type: VIEW targetId: '*' x-ui-operation-id: /rest/organizations/paramId/sources/page/fields_get /rest/organizations/{organizationId}/sources/document/configuration/default: get: tags: - Sources summary: Get the Default Document Configuration description: '
Privilege required ``` {"owner":"PLATFORM","targetDomain":"SOURCE","type":"VIEW","targetId":"*"} ```
' operationId: getDefaultDocumentConfiguration parameters: - name: organizationId in: path required: true schema: type: string - name: defaultDocumentConfigurationType in: query required: false schema: type: string default: DEFAULT enum: - DEFAULT - PUSH responses: '200': description: OK content: '*/*': schema: $ref: '#/components/schemas/DocumentConfig' x-pretty-name: getDefaultDocumentConfiguration x-required-privilege: owner: PLATFORM targetDomain: SOURCE type: VIEW targetId: '*' x-required-privileges: - owner: PLATFORM targetDomain: SOURCE type: VIEW targetId: '*' x-ui-operation-id: /rest/organizations/paramId/sources/document/configuration/default_get /rest/organizations/{organizationId}/sources/fields/batch/delete: delete: tags: - Sources summary: Removes Fields from an Organization description: '
Privilege required ``` {"owner":"PLATFORM","targetDomain":"FIELD","type":"EDIT","targetId":"*"} ```
' operationId: removeFields parameters: - name: organizationId in: path required: true schema: type: string - name: fields in: query required: true schema: type: array items: type: string responses: '204': description: No Content x-pretty-name: removeFields x-required-privilege: owner: PLATFORM targetDomain: FIELD type: EDIT targetId: '*' x-required-privileges: - owner: PLATFORM targetDomain: FIELD type: EDIT targetId: '*' x-ui-operation-id: /rest/organizations/paramId/sources/fields/batch/delete_delete components: schemas: AmazonS3SourceModel: type: object allOf: - $ref: '#/components/schemas/SourceModel' - type: object properties: urls: type: array items: type: string accessKey: type: string secretKey: type: string hasSecretKey: type: boolean AuthenticationFailedConfiguration: type: object properties: method: type: string enum: - RedirectedToUrl - PageDoesNotContain - PageContains - CookieNotSet - UrlMatch - UrlDoesNotMatch values: type: array items: type: string BoxEnterprise2SourceModel: type: object allOf: - $ref: '#/components/schemas/SourceModel' - type: object properties: boxEnterpriseSettingsData: type: string hasBoxEnterpriseSettingsData: type: boolean usersToCrawl: type: string CatalogSourceModel: type: object allOf: - $ref: '#/components/schemas/SourceModel' CharsetDetectionHint: type: object properties: charset: type: string confidence: type: number format: double ConditionNode: type: object ConfigurationError: type: object properties: errorCode: type: string message: type: string Confluence2HostedSourceModel: type: object allOf: - $ref: '#/components/schemas/SourceModel' - type: object properties: username: type: string password: type: string hasPassword: type: boolean urls: type: array items: type: string indexAttachments: type: boolean indexComments: type: boolean indexOnlyGlobalSpaces: type: boolean indexOnlyPersonalSpaces: type: boolean indexArchivedSpaces: type: boolean indexCurrentSpaces: type: boolean useRequestParametersAuth: type: boolean alwaysSendBasicAuthenticationHeaders: type: boolean useKerberosAuthentication: type: boolean rootSpaceRegex: type: string filterSpaceRegex: type: string usePersonalAccessToken: type: boolean apiKey: type: string useApiKey: type: boolean Confluence2SourceModel: type: object allOf: - $ref: '#/components/schemas/SourceModel' - type: object properties: username: type: string password: type: string hasPassword: type: boolean urls: type: array items: type: string indexAttachments: type: boolean indexComments: type: boolean indexOnlyGlobalSpaces: type: boolean indexOnlyPersonalSpaces: type: boolean indexArchivedSpaces: type: boolean indexCurrentSpaces: type: boolean useRequestParametersAuth: type: boolean alwaysSendBasicAuthenticationHeaders: type: boolean useKerberosAuthentication: type: boolean rootSpaceRegex: type: string filterSpaceRegex: type: string useOAuth2Authentication: type: boolean crawlingAccount: type: string cloudId: type: string clientId: type: string hasOrganizationsApiKey: type: boolean organizationsApiKey: type: string atlassianOrganizationId: type: string useAtlassianOrganizationApi: type: boolean oauthRefreshTokenGuid: type: string oauthRefreshToken: type: string CustomLoginSequence: type: object properties: url: type: string pageContainsValue: type: string urlContainsValue: type: string name: type: string steps: type: array items: $ref: '#/components/schemas/FormAuthStep' CustomSourceModel: type: object allOf: - $ref: '#/components/schemas/SourceModel' DatabaseSourceModel: type: object allOf: - $ref: '#/components/schemas/SourceModel' - type: object properties: username: type: string password: type: string hasPassword: type: boolean activeDirectoryUsername: type: string activeDirectoryPassword: type: string hasActiveDirectoryPassword: type: boolean activeDirectoryEmailAttributes: type: array items: type: string activeDirectoryExpandTrustedDomains: type: boolean activeDirectoryExpandWellKnowns: type: boolean activeDirectoryTlsMode: type: string useActiveDirectoryPermissions: type: boolean hasExpandedSecurityProvider: type: boolean configFileContent: type: string connectionString: type: string driverType: type: string forceLastRefreshUTC: type: boolean itemType: type: string commandTimeout: type: integer format: int32 queryPageSize: type: integer format: int32 DetailedSecurityIdentityModel: type: object properties: name: type: string provider: type: string type: type: string infos: type: array items: $ref: '#/components/schemas/SecurityIdentityInfoModel' declaration: type: string state: type: string enum: - UNKNOWN - UP_TO_DATE - NOT_UPDATED - OUT_OF_DATE - IN_ERROR - DISABLED createdDate: type: string format: date-time lastEnabledDate: type: string format: date-time lastUpdateDate: type: string format: date-time lastSuccessfulUpdateDate: type: string format: date-time lastStoredDate: type: string format: date-time orderingID: type: integer format: int64 lastUpdateResult: type: string enum: - NONE - SUCCESS - ACCESS_DENIED - TIMED_OUT - ENTITY_IS_INVALID - ENTITY_IS_UNAVAILABLE - SECURITY_PROVIDER_IS_UNAVAILABLE - SECURITY_PROVIDER_IS_UNREACHABLE - SECURITY_PROVIDER_IS_NOT_READY - UNEXPECTED_ERROR lastUpdateErrorDetail: type: string DocumentConfig: type: object properties: indexUri: type: string indexLogicalId: type: string documentProcessorConfig: $ref: '#/components/schemas/DocumentProcessorConfig' preConversions: type: array items: $ref: '#/components/schemas/DocumentProcessor' postConversions: type: array items: $ref: '#/components/schemas/DocumentProcessor' parameters: type: object additionalProperties: type: string sourceConfigTag: type: string fieldConfigTag: type: string DocumentPermissionModel: type: object properties: lastUpdatedDate: type: string description: The date of the last permission model refresh in number of milliseconds since UNIX epoch.
**Example:** `1539703378000` format: date-time state: type: string description: 'The state of the item permission model.
**Allowed values:**
- `VALID`: Permission model updated. All identities in the permission model are valid and up to date.
- `PENDING`: Permission model not updated yet.
- `INCOMPLETE`: Permission model updated, but at least one allowed identity is not up to date, or at least one permission level (except level 0) contains at least one denied identity that was not successfully updated.
- `IN_ERROR`: Permission model updated. However, permission level 0 contains at least one denied identity that was not successfully updated.
- `WARNING`: The permission model has been updated, but at least one denied entity is out of date. The Denied effective permission list may therefore be incomplete. This issue requires immediate attention, as it can cause a security hole.
- `UNKNOWN`: The state of the permission model is unknown.
' enum: - UNKNOWN - VALID - PENDING - INCOMPLETE - IN_ERROR - WARNING permissionLevels: type: array description: The [permission levels](https://docs.coveo.com/en/225/). items: $ref: '#/components/schemas/PermissionLevelModel' permissionModelStateRootCauseModel: $ref: '#/components/schemas/PermissionModelStateRootCauseModel' description: The item [permission model](https://docs.coveo.com/en/225/).
See [Permission Details Tab](https://docs.coveo.com/en/1712/#permission-details-tab). DocumentProcessor: type: object properties: type: type: string parameters: $ref: '#/components/schemas/DocumentProcessorParameters' DocumentProcessorConfig: type: object properties: maxHTMLOutputSize: type: integer format: int32 maxTextOutputSize: type: integer format: int32 excelFloatingPointPrecision: type: integer format: int32 imageMinimumSize: type: integer format: int32 timeout: type: integer format: int32 indexExcelNumbers: type: boolean styleSheet: type: string languagesSettings: type: string maximumDocumentSize: type: integer format: int64 maximumNumberOfPermissions: type: integer format: int32 maximumMetaSize: type: integer format: int32 maximumTotalMetaSize: type: integer format: int32 maximumNumberOfMeta: type: integer format: int32 maximumIdentityNameSize: type: integer format: int32 maximumIdentityTotalSize: type: integer format: int32 memoryLimits: $ref: '#/components/schemas/MemoryLimits' pipelineStateTtl: type: integer format: int32 pipelineStateSizeLimit: type: integer format: int32 titleGrammaticalScoreWeight: type: number format: double titleLengthProbabilityWeight: type: number format: double titlePercentageOfCapsFirstLettersWeight: type: number format: double titlePositionScoreWeight: type: number format: double fieldMappingOrigin: type: string summarySize: type: integer format: int32 maximumNumberOfPagesToConvert: type: integer format: int32 generateHTML: type: boolean useClickableUriAsBasePath: type: boolean addRawTextDataStream: type: boolean beautifyDocuments: type: boolean indexMeta: type: boolean saveTextDataStream: type: boolean openResultWithQuickView: type: boolean summarizeDocument: type: boolean saveExcerptBlob: type: boolean excerptSource: type: string enum: - Document - Summary charsetDetectionHint: $ref: '#/components/schemas/CharsetDetectionHint' languageHints: type: array items: $ref: '#/components/schemas/LanguageHint' extensionSettings: $ref: '#/components/schemas/ExtensionSettings' generateMarkdown: type: boolean markdownTimeout: type: integer format: int32 sourceInformation: $ref: '#/components/schemas/SourceInformation' uniqueTermsPerDocument: type: integer format: int32 DocumentProcessorParameters: type: object properties: values: type: object additionalProperties: type: string deleteOnError: type: boolean condition: $ref: '#/components/schemas/ConditionNode' streams: type: array items: type: string name: type: string memoryLimit: type: integer format: int32 DropboxForBusinessSourceModel: type: object allOf: - $ref: '#/components/schemas/SourceModel' - type: object properties: teamName: type: string accessToken: type: string accessTokenGuid: type: string refreshToken: type: string refreshTokenGuid: type: string ExtensionSetting: type: object properties: customConverter: $ref: '#/components/schemas/DocumentProcessor' action: type: string enum: - Retrieve - Reference - Ignore actionOnError: type: string enum: - Reference - Ignore converter: type: string enum: - Detect - Skip - Html - IFilter - Wordperfect - Rtf - Excel - Word - Pdf - Powerpoint - PlainText - Msg - Mime - Image useContentType: type: boolean indexContainer: type: boolean fileTypeValue: type: string generateThumbnail: type: boolean useExternalHTMLGenerator: type: boolean convertDirectlyToHtml: type: boolean openResultWithQuickView: type: boolean summarizeDocument: type: boolean saveExcerptBlob: type: boolean excerptSource: type: string enum: - Document - Summary ExtensionSettingByExtension: type: object properties: extensions: type: array items: type: string extensionSetting: $ref: '#/components/schemas/ExtensionSetting' ExtensionSettings: type: object properties: noExtension: $ref: '#/components/schemas/ExtensionSetting' other: $ref: '#/components/schemas/ExtensionSetting' byExtensions: type: array items: $ref: '#/components/schemas/ExtensionSettingByExtension' byContentTypes: type: array items: $ref: '#/components/schemas/ExtensionSettingByExtension' FileSourceModel: type: object allOf: - $ref: '#/components/schemas/SourceModel' - type: object properties: username: type: string password: type: string hasPassword: type: boolean activeDirectoryUsername: type: string activeDirectoryPassword: type: string hasActiveDirectoryPassword: type: boolean activeDirectoryEmailAttributes: type: array items: type: string activeDirectoryExpandTrustedDomains: type: boolean activeDirectoryExpandWellKnowns: type: boolean activeDirectoryTlsMode: type: string useActiveDirectoryPermissions: type: boolean hasExpandedSecurityProvider: type: boolean expandBeforeFiltering: type: boolean expandMailArchives: type: boolean indexSharePermissions: type: boolean startingAddresses: type: array items: type: string FormAction: type: object properties: type: type: string value: type: string elementIdentifier: $ref: '#/components/schemas/FormElementIdentifier' waitDelayInMilliseconds: type: integer format: int32 FormAuthStep: type: object properties: url: type: string pageContainsValue: type: string urlContainsValue: type: string name: type: string waitDelayInMilliseconds: type: integer format: int32 actions: type: array items: $ref: '#/components/schemas/FormAction' FormAuthenticationConfig: type: object properties: actionMethod: type: string formContentType: type: string actionUrl: type: string addFoundInputs: type: boolean authenticationFailed: $ref: '#/components/schemas/AuthenticationFailedConfiguration' inputs: type: array items: $ref: '#/components/schemas/FormInput' formId: type: string formUrl: type: string enableJavaScript: type: boolean forceLogin: type: boolean javaScriptLoadingDelayInMilliseconds: type: integer format: int32 customLoginSequence: $ref: '#/components/schemas/CustomLoginSequence' postLoginSequence: $ref: '#/components/schemas/PostLoginSequence' getCookiesFromWebDriverInsteadOfCache: type: boolean FormElementIdentifier: type: object properties: identifier: type: string type: type: string findType: type: string FormInput: type: object properties: name: type: string value: type: string inputType: type: string enum: - Input - Username - Password GenericRestSourceModel: type: object allOf: - $ref: '#/components/schemas/SourceModel' - type: object properties: username: type: string password: type: string hasPassword: type: boolean restConfiguration: type: string restPermissionConfiguration: type: string clientId: type: string clientSecret: type: string refreshToken: type: string apiKey: type: string hasApiKey: type: boolean hasClientSecret: type: boolean hasRefreshToken: type: boolean providerType: type: string enum: - ACTIVE_DIRECTORY2 - BOX - CLAIMS - CLAIMS_TO_EMAIL - CONFLUENCE - CONFLUENCE2 - CUSTOM - DATABASE - DROPBOX_FOR_BUSINESS - EMAIL - EXPANDED - FILE - GOOGLE_DRIVE_DOMAIN_WIDE - GENERIC_REST - GRAPHQL - JIRA2 - JIVE - KHOROS_COMMUNITY - MICROSOFT_DYNAMICS - OFFICE365 - SALESFORCE - SERVICENOW - SHAREPOINT - SHAREPOINT_ONLINE - SITECORE - SLACK - ZENDESK GoogleDriveDomainWideSourceModel: type: object allOf: - $ref: '#/components/schemas/SourceModel' - type: object properties: googleAppsDomain: type: string serviceAccountEmail: type: string privateKeyFile: type: string usersToCrawl: type: string domainAdminEmail: type: string crawlTrashedItems: type: boolean crawlCustomProperties: type: boolean indexSharedDrives: type: boolean indexUserDrives: type: boolean crawlFolders: type: boolean mimeTypesToIgnore: type: string itemsModificationPeriod: $ref: '#/components/schemas/ItemsModificationPeriod' GraphQlSourceModel: type: object allOf: - $ref: '#/components/schemas/SourceModel' - type: object properties: username: type: string password: type: string hasPassword: type: boolean restConfiguration: type: string restPermissionConfiguration: type: string clientId: type: string clientSecret: type: string refreshToken: type: string apiKey: type: string hasApiKey: type: boolean hasClientSecret: type: boolean hasRefreshToken: type: boolean useGraphQl: type: boolean queries: type: string providerType: type: string enum: - ACTIVE_DIRECTORY2 - BOX - CLAIMS - CLAIMS_TO_EMAIL - CONFLUENCE - CONFLUENCE2 - CUSTOM - DATABASE - DROPBOX_FOR_BUSINESS - EMAIL - EXPANDED - FILE - GOOGLE_DRIVE_DOMAIN_WIDE - GENERIC_REST - GRAPHQL - JIRA2 - JIVE - KHOROS_COMMUNITY - MICROSOFT_DYNAMICS - OFFICE365 - SALESFORCE - SERVICENOW - SHAREPOINT - SHAREPOINT_ONLINE - SITECORE - SLACK - ZENDESK IdAndDisplayNameModel: type: object properties: id: type: string displayName: type: string ItemsModificationPeriod: type: object properties: Amount: type: integer format: int64 writeOnly: true TimeSpan: type: string writeOnly: true enum: - Day - Week - Month - Year amount: type: integer format: int64 timespan: type: string enum: - Day - Week - Month - Year Jira2HostedSourceModel: type: object allOf: - $ref: '#/components/schemas/SourceModel' - type: object properties: username: type: string password: type: string hasPassword: type: boolean urls: type: array items: type: string serverUrl: type: string indexAttachments: type: boolean indexComments: type: boolean indexWorkLogs: type: boolean usePersonalAccessToken: type: boolean supportCommentPermissions: type: boolean apiKey: type: string useApiKey: type: boolean Jira2SourceModel: type: object allOf: - $ref: '#/components/schemas/SourceModel' - type: object properties: username: type: string password: type: string hasPassword: type: boolean urls: type: array items: type: string serverUrl: type: string indexAttachments: type: boolean indexComments: type: boolean indexWorkLogs: type: boolean useOAuth2Authentication: type: boolean crawlingAccount: type: string cloudId: type: string clientId: type: string hasOrganizationsApiKey: type: boolean organizationsApiKey: type: string atlassianOrganizationId: type: string useAtlassianOrganizationApi: type: boolean oauthRefreshTokenGuid: type: string oauthRefreshToken: type: string JiveHostedSourceModel: type: object allOf: - $ref: '#/components/schemas/SourceModel' - type: object properties: username: type: string password: type: string hasPassword: type: boolean activeDirectoryUsername: type: string activeDirectoryPassword: type: string hasActiveDirectoryPassword: type: boolean activeDirectoryEmailAttributes: type: array items: type: string activeDirectoryExpandTrustedDomains: type: boolean activeDirectoryExpandWellKnowns: type: boolean activeDirectoryTlsMode: type: string useActiveDirectoryPermissions: type: boolean hasExpandedSecurityProvider: type: boolean instanceUrl: type: string startingSpaceUrl: type: string substitutionLocale: type: string substitutionTheme: type: string placesTitles: type: string ignoreItemsOfTypes: type: string localizedItemTypes: type: string indexSpaces: type: boolean indexProjects: type: boolean indexGroups: type: boolean indexSystemBlogs: type: boolean indexPeople: type: boolean indexPublishedOnly: type: boolean allowAnonymousAccess: type: boolean usersRegexMatch: type: string usersRegexReplacement: type: string metadataIndexers: type: string JiveSourceModel: type: object allOf: - $ref: '#/components/schemas/SourceModel' - type: object properties: username: type: string password: type: string hasPassword: type: boolean activeDirectoryUsername: type: string activeDirectoryPassword: type: string hasActiveDirectoryPassword: type: boolean activeDirectoryEmailAttributes: type: array items: type: string activeDirectoryExpandTrustedDomains: type: boolean activeDirectoryExpandWellKnowns: type: boolean activeDirectoryTlsMode: type: string useActiveDirectoryPermissions: type: boolean hasExpandedSecurityProvider: type: boolean instanceUrl: type: string startingSpaceUrl: type: string substitutionLocale: type: string substitutionTheme: type: string placesTitles: type: string ignoreItemsOfTypes: type: string localizedItemTypes: type: string indexSpaces: type: boolean indexProjects: type: boolean indexGroups: type: boolean indexSystemBlogs: type: boolean indexPeople: type: boolean indexPublishedOnly: type: boolean allowAnonymousAccess: type: boolean usersRegexMatch: type: string usersRegexReplacement: type: string metadataIndexers: type: string KhorosSourceModel: type: object allOf: - $ref: '#/components/schemas/SourceModel' - type: object properties: username: type: string password: type: string hasPassword: type: boolean urls: type: array items: type: string fetchMessageAttachments: type: boolean fetchUsers: type: boolean fetchMessageTags: type: boolean ignoreMessagesOlderThan: type: string restApiUrl: type: string usernameForRoleSync: type: string LanguageHint: type: object properties: language: type: string probability: type: number format: double MappingModel: type: object properties: id: type: string kind: type: string deprecated: true enum: - COMMON - MAPPING type: type: string fieldName: type: string extractionMethod: type: string content: type: string deprecated: true rules: type: array items: type: string fieldTypeHint: type: string enum: - LONG - LONG_64 - DOUBLE - DATE - STRING - VECTOR MemoryLimits: type: object properties: conversionLimit: type: integer format: int32 extensionLimit: type: integer format: int32 mappingLimit: type: integer format: int32 MetafieldConfiguration: type: object properties: namespace: type: string key: type: string name: type: string MicrosoftDynamicsCondition: type: object properties: attribute: type: string operator: type: string type: type: string enum: - STRING - NUMBER - DATE - BOOLEAN - UNARY values: type: array items: type: string MicrosoftDynamicsConditions: type: object properties: conditions: type: array items: $ref: '#/components/schemas/MicrosoftDynamicsCondition' MicrosoftDynamicsFetchXmlQueries: type: object properties: queries: type: array items: $ref: '#/components/schemas/MicrosoftDynamicsFetchXmlQuery' MicrosoftDynamicsFetchXmlQuery: type: object properties: id: type: string name: type: string queryXml: type: string MicrosoftDynamicsObject: type: object properties: attachment: type: string attributes: type: array items: type: string conditions: type: array items: $ref: '#/components/schemas/MicrosoftDynamicsConditions' name: type: string relations: type: array items: $ref: '#/components/schemas/MicrosoftDynamicsRelation' MicrosoftDynamicsRelation: type: object properties: alias: type: string attributes: type: array items: type: string fromAttribute: type: string toAttribute: type: string toEntity: type: string MicrosoftDynamicsSourceModel: type: object allOf: - $ref: '#/components/schemas/SourceModel' - type: object properties: username: type: string password: type: string hasPassword: type: boolean discoveryServiceUrl: type: string enableS2SAuthentication: type: boolean objectsToGet: type: array items: $ref: '#/components/schemas/MicrosoftDynamicsObject' genericObjectsToGet: type: string organizationUniqueName: type: string recordsPageSize: type: integer format: int32 writeOnly: true urls: type: array items: type: string fetchXmlQueries: $ref: '#/components/schemas/MicrosoftDynamicsFetchXmlQueries' oauthRefreshTokenGuid: type: string oauthResourceGuid: type: string oauthResource: type: string recordPageSize: type: integer format: int32 NextOperation: type: object properties: operationType: type: string enum: - REBUILD - FULL_REFRESH - INCREMENTAL_REFRESH - SECURITY_PROVIDER_REFRESH - SECURITY_PROVIDER_REFRESH_ENTITIES_IN_ERROR - SECURITY_PROVIDER_REFRESH_ENTITIES_NOT_UPDATED - SECURITY_CACHE_REFRESH - SECURITY_CACHE_REFRESH_ENTITIES_IN_ERROR timestamp: type: string format: date-time PermissionLevelModel: type: object properties: name: type: string permissionSets: type: array items: $ref: '#/components/schemas/PermissionSetModel' description: The [permission levels](https://docs.coveo.com/en/225/). PermissionModelStateRootCauseModel: type: object properties: entityState: type: string enum: - UNKNOWN - UP_TO_DATE - NOT_UPDATED - OUT_OF_DATE - IN_ERROR - DISABLED entityInformation: $ref: '#/components/schemas/DetailedSecurityIdentityModel' PermissionSetModel: type: object properties: anonymousAllowed: type: boolean name: type: string permissions: type: array items: $ref: '#/components/schemas/SinglePermissionModel' PostLoginSequence: type: object properties: url: type: string pageContainsValue: type: string urlContainsValue: type: string name: type: string steps: type: array items: $ref: '#/components/schemas/FormAuthStep' PushSourceModel: type: object allOf: - $ref: '#/components/schemas/SourceModel' RSSSourceModel: type: object allOf: - $ref: '#/components/schemas/SourceModel' - type: object properties: username: type: string password: type: string hasPassword: type: boolean urls: type: array items: type: string SAPSourceModel: type: object allOf: - $ref: '#/components/schemas/SourceModel' - type: object properties: username: type: string password: type: string hasPassword: type: boolean restConfiguration: type: string restPermissionConfiguration: type: string clientId: type: string clientSecret: type: string refreshToken: type: string apiKey: type: string hasApiKey: type: boolean hasClientSecret: type: boolean hasRefreshToken: type: boolean providerType: type: string enum: - ACTIVE_DIRECTORY2 - BOX - CLAIMS - CLAIMS_TO_EMAIL - CONFLUENCE - CONFLUENCE2 - CUSTOM - DATABASE - DROPBOX_FOR_BUSINESS - EMAIL - EXPANDED - FILE - GOOGLE_DRIVE_DOMAIN_WIDE - GENERIC_REST - GRAPHQL - JIRA2 - JIVE - KHOROS_COMMUNITY - MICROSOFT_DYNAMICS - OFFICE365 - SALESFORCE - SERVICENOW - SHAREPOINT - SHAREPOINT_ONLINE - SITECORE - SLACK - ZENDESK SalesforceCondition: type: object properties: fieldName: type: string operator: type: string enum: - EQUALS - NOT_EQUALS - LESS_THAN - LESS_OR_EQUAL_THAN - GREATER_THAN - GREATER_OR_EQUAL_THAN - LIKE - NOT_LIKE - INCLUDES - EXCLUDES - IN - NOT_IN value: type: string inConditionValues: type: array items: $ref: '#/components/schemas/SalesforceInConditionValue' SalesforceField: type: object properties: name: type: string label: type: string nestedLabel: type: string type: type: string indexed: type: boolean mandatory: type: boolean custom: type: boolean mappings: uniqueItems: true type: array items: $ref: '#/components/schemas/MappingModel' values: type: array items: type: string referenceTypes: type: array items: type: string relationshipName: type: string relationshipNameField: type: string relationshipParent: type: boolean relationshipPolymorphic: type: boolean SalesforceInConditionValue: type: object properties: type: type: string enum: - SOQL_STRING - SOQL_ID - SOQL_DATETIME - SOQL_BOOLEAN - SOQL_OTHER value: type: string SalesforceObject: type: object properties: type: type: string enum: - SERVICE_CLOUD - CHATTER - CONTENT - KNOWLEDGEBASE - CUSTOM name: type: string label: type: string indexed: type: boolean filesIndexed: type: boolean canHaveFiles: type: boolean custom: type: boolean hasCustomFiletype: type: boolean fields: type: array items: $ref: '#/components/schemas/SalesforceField' relationships: type: array items: $ref: '#/components/schemas/SalesforceRelationship' conditions: type: array items: $ref: '#/components/schemas/SalesforceCondition' searchable: type: boolean categories: type: array items: type: string enum: - SERVICE_CLOUD - EXPERIENCE_CLOUD - KNOWLEDGE - CUSTOM_OBJECT - STANDARD - CHATTER SalesforceRelationship: type: object properties: relationshipName: type: string relationshipType: type: string enum: - NON_POLYMORPHIC_PARENT - POLYMORPHIC_PARENT - CHILD referenceField: type: string referencesTo: type: array items: type: string fields: type: array items: $ref: '#/components/schemas/SalesforceField' conditions: type: array items: $ref: '#/components/schemas/SalesforceCondition' createRecord: type: boolean SalesforceSitesSourceModel: type: object allOf: - $ref: '#/components/schemas/SourceModel' - type: object properties: username: type: string password: type: string hasPassword: type: boolean alwaysTrustCertificates: type: boolean enableJavaScript: type: boolean indexJsonLdMetadata: type: boolean formAuthenticationConfig: $ref: '#/components/schemas/FormAuthenticationConfig' includeShadowDom: type: boolean javaScriptLoadingDelayInMilliseconds: type: integer format: int32 requestsTimeoutInSeconds: type: integer format: int32 scrapingMatchingStrategy: type: string scrapingConfiguration: type: string userAgent: type: string urls: type: array items: type: string indexExternalPages: type: boolean indexExternalPagesLinks: type: boolean respectRobotsDotTxt: type: boolean respectAnchorNoFollow: type: boolean respectMetaNoFollow: type: boolean respectNoIndexTag: type: boolean respectUrlCasing: type: boolean indexSubdomains: type: boolean maxAutoRedirects: type: integer format: int32 maxCrawlDepth: type: integer format: int32 maxPageSizeInBytes: type: integer format: int32 maxRequestsRetryCount: type: integer format: int32 minCrawlDelayInMilliseconds: type: integer format: int32 requestsRetryDelayInMilliseconds: type: integer format: int32 queryParamsToIgnore: type: array items: type: string salesforceOrg: type: string salesforceUser: type: string sandbox: type: boolean oauthRefreshTokenGuid: type: string oauthRefreshToken: type: string SalesforceSourceModel: type: object allOf: - $ref: '#/components/schemas/SourceModel' - type: object properties: sandbox: type: boolean salesforceOrg: type: string getoAuthRefreshToken: type: string getoAuthRefreshTokenGuid: type: string urls: type: array items: type: string salesforceUser: type: string salesforceUserId: type: string salesforceOrgName: type: string schemaVersion: type: string enum: - CLOUDV1 - LEGACY - EXPRESS getoAuthAccessToken: type: string idUrl: type: string instanceUrl: type: string serviceCloudAvailable: type: boolean knowledgeAvailable: type: boolean contentAvailable: type: boolean chatterAvailable: type: boolean cloudCrazeProductsAvailable: type: boolean cloudCrazeOrdersAvailable: type: boolean organizationId: type: string serviceCloudIndexed: type: boolean knowledgeIndexed: type: boolean contentIndexed: type: boolean chatterIndexed: type: boolean cloudCrazeProductsIndexed: type: boolean cloudCrazeOrdersIndexed: type: boolean objectsToGet: type: array items: $ref: '#/components/schemas/SalesforceObject' SecurityIdentityInfoModel: type: object properties: key: type: string value: type: string ServiceNowSourceModel: type: object allOf: - $ref: '#/components/schemas/SourceModel' - type: object properties: username: type: string password: type: string hasPassword: type: boolean instanceUrl: type: string clientId: type: string clientSecret: type: string clientSecretGuid: type: string passwordGuid: type: string objectsToGetConfiguration: type: string genericObjectsToGetConfiguration: type: string oauthRefreshTokenGuid: type: string oauthRefreshToken: type: string SharePointOnline2SourceModel: type: object allOf: - $ref: '#/components/schemas/SourceModel' - type: object properties: refreshToken: type: string refreshTokenGuid: type: string certificate: type: string certificatePassword: type: string hasCertificate: type: boolean hasCertificatePassword: type: boolean urls: type: array items: type: string tenantName: type: string crawlingAccount: type: string loadUserProfiles: type: boolean loadPersonalSites: type: boolean indexFolders: type: boolean indexDraftItems: type: boolean indexAllSiteCollections: type: boolean indexHubSites: type: boolean isOneDriveMode: type: boolean listTypesToIgnore: type: array items: type: string hubSitesToIndex: type: array items: type: string useSelectedSitesList: type: boolean tenantId: type: string clientId: type: string exclusionCondition: type: string itemsModificationPeriod: $ref: '#/components/schemas/ItemsModificationPeriod' excludeDisabledUserProfiles: type: boolean SharePointSourceModel: type: object allOf: - $ref: '#/components/schemas/SourceModel' - type: object properties: username: type: string password: type: string hasPassword: type: boolean activeDirectoryUsername: type: string activeDirectoryPassword: type: string hasActiveDirectoryPassword: type: boolean activeDirectoryEmailAttributes: type: array items: type: string activeDirectoryExpandTrustedDomains: type: boolean activeDirectoryExpandWellKnowns: type: boolean activeDirectoryTlsMode: type: string useActiveDirectoryPermissions: type: boolean hasExpandedSecurityProvider: type: boolean urls: type: array items: type: string crawlScope: type: string authenticationType: type: string loadUserProfiles: type: boolean loadPersonalSites: type: boolean indexListFolders: type: boolean adfsServerUrl: type: string sharePointTrustIdentifier: type: string oktaRealm: type: string oktaSignInUrl: type: string ignoreUnchangedSiteCollections: type: boolean reindexOnUpdateShallow: type: boolean useEnhancedIncrementalRefresh: type: boolean useCommonClaimsProvider: type: boolean ShopifySourceModel: type: object allOf: - $ref: '#/components/schemas/SourceModel' - type: object properties: shopId: type: string productFeedId: type: string fullSyncId: type: string accessToken: type: string shopDomain: type: string productMetafields: type: array items: $ref: '#/components/schemas/MetafieldConfiguration' variantMetafields: type: array items: $ref: '#/components/schemas/MetafieldConfiguration' fetchUnitCost: type: boolean SinglePermissionModel: type: object properties: allowed: type: boolean identityType: type: string enum: - USER - GROUP - VIRTUAL_GROUP - UNKNOWN identity: type: string securityProvider: type: string additionalInfo: type: object additionalProperties: type: string lastUpdateDate: type: string format: date-time lastUpdateResult: type: string enum: - NONE - SUCCESS - ACCESS_DENIED - TIMED_OUT - ENTITY_IS_INVALID - ENTITY_IS_UNAVAILABLE - SECURITY_PROVIDER_IS_UNAVAILABLE - SECURITY_PROVIDER_IS_UNREACHABLE - SECURITY_PROVIDER_IS_NOT_READY - UNEXPECTED_ERROR lastUpdateErrorDetail: type: string state: type: string enum: - UNKNOWN - UP_TO_DATE - NOT_UPDATED - OUT_OF_DATE - IN_ERROR - DISABLED SitecoreSourceModel: type: object allOf: - $ref: '#/components/schemas/SourceModel' SitemapSourceModel: type: object allOf: - $ref: '#/components/schemas/SourceModel' - type: object properties: username: type: string password: type: string hasPassword: type: boolean alwaysTrustCertificates: type: boolean enableJavaScript: type: boolean indexJsonLdMetadata: type: boolean formAuthenticationConfig: $ref: '#/components/schemas/FormAuthenticationConfig' includeShadowDom: type: boolean javaScriptLoadingDelayInMilliseconds: type: integer format: int32 requestsTimeoutInSeconds: type: integer format: int32 scrapingMatchingStrategy: type: string scrapingConfiguration: type: string userAgent: type: string urls: type: array items: type: string requestsIntervalInMs: type: integer format: int32 SlackSourceModel: type: object allOf: - $ref: '#/components/schemas/SourceModel' - type: object properties: username: type: string password: type: string hasPassword: type: boolean accessToken: type: string maskedAccessToken: type: string accessTokenWorkspace: type: string accessTokenGuid: type: string exportDataUrl: type: string oldestMessageInDays: type: integer format: int32 oldestMessageTimestampInSeconds: type: integer format: int64 indexChannels: type: boolean indexPrivateChannels: type: boolean includeDeletedAndDisabledUsers: type: boolean indexFilesAndAttachments: type: boolean indexUsers: type: boolean ignoreBotMessages: type: boolean channelsToGet: type: string SourceExtensionModel: type: object properties: actionOnError: type: string description: 'The action to carry out when the [extension](https://docs.coveo.com/en/206/) returns an error.
See [Action on error](https://docs.coveo.com/en/1943/#actionOnError).
**Allowed values:**
- `REJECT_DOCUMENT`: The item is rejected (i.e., it is not indexed).
- `SKIP_EXTENSION`: The item continues to be processed in the indexing pipeline, as if the extension had never been applied.

**Default:** `SKIP_EXTENSION`
' enum: - REJECT_DOCUMENT - SKIP_EXTENSION condition: type: string description: The condition the [item](https://docs.coveo.com/en/210/) must meet for the [extension](https://docs.coveo.com/en/206/) to apply to it.
See [Indexing Pipeline Extension Condition Syntax Reference](https://docs.coveo.com/en/64/).
**Example:** `%[ytlikecount] OR %[ytdislikecount]`
**Default:** `""` extensionId: type: string description: The unique identifier of the [extension](https://docs.coveo.com/en/206/) to apply.
**Example:** `mycoveocloudv2organizationg8tp8wu3-vwlyqfbtjkotxqkmrxqjcbcpoy` itemType: type: string description: The type of item to apply the [extension](https://docs.coveo.com/en/206/) to, in the case of an extension only applying to a specific item type.
**Note:** Typically matches the key of the extension configuration.
**Example:** `Video` parameters: type: object additionalProperties: type: string description: Additional parameters to pass to the [extension](https://docs.coveo.com/en/206/).
See [Pass parameters](https://docs.coveo.com/en/1943/#Parameters).
**Example:** `{"myparam":38}`
**Default:** `{}` description: Additional parameters to pass to the [extension](https://docs.coveo.com/en/206/).
See [Pass parameters](https://docs.coveo.com/en/1943/#Parameters).
**Example:** `{"myparam":38}`
**Default:** `{}` versionId: type: string description: The unique identifier of the [extension](https://docs.coveo.com/en/206/) version to execute.
See [Execute a specific extension version](https://docs.coveo.com/en/1943/#Version).
**Example**:`hdJSDb4hTkdnsCynNtF.d657FgLSDydcj`
By default, the latest extension version is used. description: An [extension](https://docs.coveo.com/en/206/) configuration. SourceInformation: type: object properties: sourceStatus: $ref: '#/components/schemas/SourceStatus' lastOperation: $ref: '#/components/schemas/SourceLastOperation' nextOperation: $ref: '#/components/schemas/NextOperation' rebuildRequired: type: boolean rebuildRequiredReasons: type: array items: type: string enum: - SOURCE_CONFIGURATION_UPDATED - FIELD_CONFIGURATION_UPDATED numberOfDocuments: type: integer format: int64 deprecated: true documentsTotalSize: type: integer format: int64 lastRefreshEndDate: type: string format: date-time lastRebuildEndDate: type: string format: date-time lastFullRefreshEndDate: type: string format: date-time lastIncrementalRefreshEndDate: type: string format: date-time SourceLastOperation: type: object properties: id: type: string operationType: type: string enum: - REBUILD - FULL_REFRESH - INCREMENTAL_REFRESH - SECURITY_PROVIDER_REFRESH - SECURITY_PROVIDER_REFRESH_ENTITIES_IN_ERROR - SECURITY_PROVIDER_REFRESH_ENTITIES_NOT_UPDATED - SECURITY_CACHE_REFRESH - SECURITY_CACHE_REFRESH_ENTITIES_IN_ERROR timestamp: type: string format: date-time result: type: string errorCode: type: string initialBuild: type: boolean numberOfDocuments: type: integer format: int64 numberOfAddedDocuments: type: integer format: int64 numberOfFilteredDocuments: type: integer format: int64 numberOfRemovedDocuments: type: integer format: int64 numberOfUnchangedDocuments: type: integer format: int64 numberOfUpdatedDocuments: type: integer format: int64 startedDate: type: string format: date-time SourceModel: type: object properties: groupsThatCanEdit: uniqueItems: true type: array items: $ref: '#/components/schemas/IdAndDisplayNameModel' apiKeysThatCanEdit: uniqueItems: true type: array items: $ref: '#/components/schemas/IdAndDisplayNameModel' projectIds: type: array items: type: string sourceType: type: string enum: - AMAZONS3 - BOX_ENTERPRISE2 - CATALOG - CONFLUENCE2 - CONFLUENCE2_HOSTED - CUSTOM - DATABASE - DROPBOX_FOR_BUSINESS - FILE - GENERIC_REST - GOOGLE_DRIVE_DOMAIN_WIDE - GRAPHQL - JIRA2 - JIRA2_HOSTED - JIVE - JIVE_HOSTED - LITHIUM - KHOROS - MICROSOFT_DYNAMICS - PUSH - RSS - SALESFORCE - SALESFORCE_SITES - SAP - SERVICENOW - SHAREPOINT - SHAREPOINT_ONLINE2 - SHOPIFY - SITECORE - SITEMAP - SLACK - WEB2 - YOUTUBE - ZENDESK - ADOBE_EXPERIENCE_MANAGER - BOX - BOX_ENTERPRISE - CONFLUENCE - DROPBOX - GMAIL - GMAIL_DOMAIN_WIDE - SHAREPOINT_ONLINE id: type: string name: type: string owner: type: string lastModifier: type: string lastModifiedDate: type: string format: date-time createdDate: type: string format: date-time sourceVisibility: type: string enum: - PRIVATE - SECURED - SHARED customParameters: type: object additionalProperties: type: string mappings: type: array items: $ref: '#/components/schemas/MappingModel' documentConfig: $ref: '#/components/schemas/DocumentConfig' information: $ref: '#/components/schemas/SourceInformation' configurationError: $ref: '#/components/schemas/ConfigurationError' pushEnabled: type: boolean onPremisesEnabled: type: boolean streamEnabled: type: boolean logicalIndex: type: string crawlingModuleId: type: string pendingCrawlingModuleId: type: string securityProviderReferences: uniqueItems: true type: array items: type: string preConversionExtensions: type: array items: $ref: '#/components/schemas/SourceExtensionModel' postConversionExtensions: type: array items: $ref: '#/components/schemas/SourceExtensionModel' permissions: $ref: '#/components/schemas/DocumentPermissionModel' urlFilters: type: array items: $ref: '#/components/schemas/UrlFilter' ocrFileTypes: type: array items: type: string resourceId: type: string discriminator: propertyName: sourceType SourceStatus: type: object properties: type: type: string enum: - CREATING - DISABLED - REFRESHING - PAUSED - PAUSED_ON_ERROR - IDLE - ERROR - PUSH_READY refreshType: type: string enum: - REBUILD - FULL_REFRESH - INCREMENTAL_REFRESH - SECURITY_PROVIDER_REFRESH - SECURITY_PROVIDER_REFRESH_ENTITIES_IN_ERROR - SECURITY_PROVIDER_REFRESH_ENTITIES_NOT_UPDATED - SECURITY_CACHE_REFRESH - SECURITY_CACHE_REFRESH_ENTITIES_IN_ERROR numberOfProcessedDocuments: type: integer format: int64 timestamp: type: string format: date-time pausedOnErrorCode: type: string allowedOperations: type: array items: type: string enum: - APPLY - ARCHIVE - ARCHIVE_WARNING - BACKUP - CHANGE_ONLINE - CHANGE_READ_ONLY - COMMIT - CONFIG_CHANGE - CONFIG_CREATE - CREATE - DECLINE - DELETE - DISABLE - DUPLICATE - ENABLE - ENABLE_DISABLED_ENTITIES - EXPORT - FULL_REFRESH - HORIZONTAL_SCALING - IDLE - IMPORT - INCREMENTAL_REFRESH - LIMIT_ALMOST_REACHED - LIMIT_EXCEEDED - LIMIT_REACHED - LOG_REQUEST - METADATA_REPORT - MODEL_BUILD - MODEL_REFRESH - ORG_PROVISIONING_CHECK - PAUSE - PAUSE_ON_ERROR - REBUILD - REFRESH - REFRESH_CANCEL - REFRESH_ENTITIES_IN_ERROR - REFRESH_ENTITIES_NOT_UPDATED - REFRESH_ENTITY - REMEDIATE - RESIZE - RESTORE - RESUME - ROTATE - SCHEDULE_CHANGE - SCHEDULE_CREATE - SCHEDULE_DELETE - SEARCH_CERTIFICATE_UPDATE - SEARCH_INCIDENT - SEND_RESOURCE_SNAPSHOT - START - STOP - SYNCHRONIZE - TEST - UPDATE - UPGRADE - UPGRADE_REVERT - VALIDATE - VERTICAL_SCALING extendedCurrentStatus: type: string enum: - CREATING - DISABLED - STARTING_REFRESH - REFRESHING - PAUSING - PAUSED - RESUMING - CANCELING - PAUSED_ON_ERROR - IDLE - ERROR - PUSH_READY - DELETING numberOfAddedDocuments: type: integer format: int64 numberOfFilteredDocuments: type: integer format: int64 numberOfRemovedDocuments: type: integer format: int64 numberOfUnchangedDocuments: type: integer format: int64 numberOfUpdatedDocuments: type: integer format: int64 statusMessage: type: string activityId: type: string createdDate: type: string format: date-time initialBuild: type: boolean numberOfDocuments: type: integer format: int64 deprecated: true UrlFilter: type: object properties: filter: type: string includeFilter: type: boolean filterType: type: string enum: - WILDCARD - REGEX Web2SourceModel: type: object allOf: - $ref: '#/components/schemas/SourceModel' - type: object properties: username: type: string password: type: string hasPassword: type: boolean alwaysTrustCertificates: type: boolean enableJavaScript: type: boolean indexJsonLdMetadata: type: boolean formAuthenticationConfig: $ref: '#/components/schemas/FormAuthenticationConfig' includeShadowDom: type: boolean javaScriptLoadingDelayInMilliseconds: type: integer format: int32 requestsTimeoutInSeconds: type: integer format: int32 scrapingMatchingStrategy: type: string scrapingConfiguration: type: string userAgent: type: string urls: type: array items: type: string indexExternalPages: type: boolean indexExternalPagesLinks: type: boolean respectRobotsDotTxt: type: boolean respectAnchorNoFollow: type: boolean respectMetaNoFollow: type: boolean respectNoIndexTag: type: boolean respectUrlCasing: type: boolean indexSubdomains: type: boolean maxAutoRedirects: type: integer format: int32 maxCrawlDepth: type: integer format: int32 maxPageSizeInBytes: type: integer format: int32 maxRequestsRetryCount: type: integer format: int32 minCrawlDelayInMilliseconds: type: integer format: int32 requestsRetryDelayInMilliseconds: type: integer format: int32 queryParamsToIgnore: type: array items: type: string YouTubeSourceModel: type: object allOf: - $ref: '#/components/schemas/SourceModel' - type: object properties: urls: type: array items: type: string indexPlaylists: type: boolean ZendeskSourceModel: type: object allOf: - $ref: '#/components/schemas/SourceModel' - type: object properties: accessToken: type: string accessTokenGuid: type: string refreshToken: type: string refreshTokenGuid: type: string indexAdministrationEntities: type: boolean indexArticles: type: boolean indexArticleTranslations: type: boolean indexComments: type: boolean indexTickets: type: boolean indexAttachments: type: boolean indexAgentsAndAdministratorsPermissionsOnly: type: boolean indexSpecificOrganizationsPermissions: type: string urls: type: array items: type: string indexArchivedTickets: type: boolean indexDeletedTickets: type: boolean zendeskLocale: type: string indexTicketsByOrganization: type: string indexTicketsByTags: type: string crawlingAccount: type: string HourMinutePair: type: object properties: hour: type: integer format: int32 minute: type: integer format: int32 ScheduleFrequency: type: object properties: type: type: string enum: - MINUTELY - HOURLY - DAILY - WEEKLY - MONTHLY value: type: integer format: int32 hourMinute: $ref: '#/components/schemas/HourMinutePair' monthDay: type: integer format: int32 weekDays: type: array items: type: string enum: - MONDAY - TUESDAY - WEDNESDAY - THURSDAY - FRIDAY - SATURDAY - SUNDAY seed: type: integer format: int32 ScheduleModel: type: object properties: id: type: string refreshType: type: string enum: - REBUILD - FULL_REFRESH - INCREMENTAL_REFRESH - SECURITY_PROVIDER_REFRESH - SECURITY_PROVIDER_REFRESH_ENTITIES_IN_ERROR - SECURITY_PROVIDER_REFRESH_ENTITIES_NOT_UPDATED - SECURITY_CACHE_REFRESH - SECURITY_CACHE_REFRESH_ENTITIES_IN_ERROR scheduleType: type: string enum: - SECURITY_CACHE - SECURITY_PROVIDER - SOURCE enabled: type: boolean frequency: $ref: '#/components/schemas/ScheduleFrequency' organizationId: type: string resourceId: type: string lastExecution: type: string format: date-time AddressPattern: type: object properties: expression: type: string patternType: type: string enum: - Wildcard - RegEx allowed: type: boolean CascadingSecurityProvider: type: object properties: id: type: string name: type: string type: type: string deprecated: true enum: - ACTIVE_DIRECTORY2 - BOX - CLAIMS - CLAIMS_TO_EMAIL - CONFLUENCE - CONFLUENCE2 - CUSTOM - DATABASE - DROPBOX_FOR_BUSINESS - EMAIL - EXPANDED - FILE - GOOGLE_DRIVE_DOMAIN_WIDE - GENERIC_REST - GRAPHQL - JIRA2 - JIVE - KHOROS_COMMUNITY - MICROSOFT_DYNAMICS - OFFICE365 - SALESFORCE - SERVICENOW - SHAREPOINT - SHAREPOINT_ONLINE - SITECORE - SLACK - ZENDESK typeName: type: string DataFile: type: object properties: sensitive: type: boolean data: type: string ExtendedConfig: type: object properties: documentConsumerURI: type: string indexIdentifier: type: string dbConnectionString: type: string reportingServiceUri: type: string sourceInformation: $ref: '#/components/schemas/SourceInformation' sourceSecurityOption: type: string enum: - Retrieve - Specified - Merge startingAddresses: type: array items: type: string addressPatterns: type: array items: $ref: '#/components/schemas/AddressPattern' permissions: type: array items: $ref: '#/components/schemas/PermissionLevel' parameters: type: object additionalProperties: $ref: '#/components/schemas/Parameter' securityProviders: type: object additionalProperties: $ref: '#/components/schemas/SecurityProvider' userIdentities: type: object additionalProperties: $ref: '#/components/schemas/UserIdentity' dataFiles: type: object additionalProperties: $ref: '#/components/schemas/DataFile' caseSensitivePatterns: type: boolean documentConfig: $ref: '#/components/schemas/DocumentConfig' extendedDataFiles: type: object additionalProperties: $ref: '#/components/schemas/ExtendedDataFile' ExtendedDataFile: type: object properties: sensitive: type: boolean data: type: string extendedData: type: object Parameter: type: object properties: sensitive: type: boolean value: type: string ParameterModel: type: object properties: value: type: string sensitive: type: boolean Permission: type: object properties: identityType: type: string enum: - Unknown - User - Group - VirtualGroup securityProvider: type: string identity: type: string additionalInfo: type: object additionalProperties: type: string PermissionLevel: type: object properties: permissionSets: type: array items: $ref: '#/components/schemas/PermissionSet' name: type: string PermissionSet: type: object properties: allowAnonymous: type: boolean allowedPermissions: type: array items: $ref: '#/components/schemas/Permission' deniedPermissions: type: array items: $ref: '#/components/schemas/Permission' name: type: string RawSourceConfig: type: object properties: groupsThatCanEdit: uniqueItems: true type: array items: $ref: '#/components/schemas/IdAndDisplayNameModel' apiKeysThatCanEdit: uniqueItems: true type: array items: $ref: '#/components/schemas/IdAndDisplayNameModel' id: type: string name: type: string owner: type: string lastModifier: type: string lastModifiedDate: type: string format: date-time createdDate: type: string format: date-time sourceType: type: string enum: - AMAZONS3 - BOX_ENTERPRISE2 - CATALOG - CONFLUENCE2 - CONFLUENCE2_HOSTED - CUSTOM - DATABASE - DROPBOX_FOR_BUSINESS - FILE - GENERIC_REST - GOOGLE_DRIVE_DOMAIN_WIDE - GRAPHQL - JIRA2 - JIRA2_HOSTED - JIVE - JIVE_HOSTED - LITHIUM - KHOROS - MICROSOFT_DYNAMICS - PUSH - RSS - SALESFORCE - SALESFORCE_SITES - SAP - SERVICENOW - SHAREPOINT - SHAREPOINT_ONLINE2 - SHOPIFY - SITECORE - SITEMAP - SLACK - WEB2 - YOUTUBE - ZENDESK - ADOBE_EXPERIENCE_MANAGER - BOX - BOX_ENTERPRISE - CONFLUENCE - DROPBOX - GMAIL - GMAIL_DOMAIN_WIDE - SHAREPOINT_ONLINE crawlerInstanceType: type: string additionalInfos: type: object additionalProperties: type: object configuration: $ref: '#/components/schemas/ExtendedConfig' preConversionExtensions: type: array items: $ref: '#/components/schemas/SourceExtensionModel' postConversionExtensions: type: array items: $ref: '#/components/schemas/SourceExtensionModel' mappings: type: array items: $ref: '#/components/schemas/MappingModel' securityProviders: type: array items: $ref: '#/components/schemas/SecurityProviderModel' securityProviderReferences: uniqueItems: true type: array items: type: string additionalComments: type: string crawlingModuleId: type: string fromRaw: type: boolean pushEnabled: type: boolean onPremisesEnabled: type: boolean streamEnabled: type: boolean logicalIndex: type: string performFieldMappingUsingAllOrigins: type: boolean resourceId: type: string SecurityProvider: type: object properties: name: type: string typeName: type: string SecurityProviderModel: type: object properties: id: type: string name: type: string displayName: type: string organizationId: type: string type: type: string enum: - ACTIVE_DIRECTORY2 - BOX - CLAIMS - CLAIMS_TO_EMAIL - CONFLUENCE - CONFLUENCE2 - CUSTOM - DATABASE - DROPBOX_FOR_BUSINESS - EMAIL - EXPANDED - FILE - GOOGLE_DRIVE_DOMAIN_WIDE - GENERIC_REST - GRAPHQL - JIRA2 - JIVE - KHOROS_COMMUNITY - MICROSOFT_DYNAMICS - OFFICE365 - SALESFORCE - SERVICENOW - SHAREPOINT - SHAREPOINT_ONLINE - SITECORE - SLACK - ZENDESK nodeTypeName: type: string sourceTypeName: type: string nodeRequired: type: boolean onPremisesEnabled: type: boolean projectIds: type: array items: type: string crawlingModuleId: type: string caseSensitive: type: boolean userIdentities: type: object additionalProperties: $ref: '#/components/schemas/UserIdentityModel' parameters: type: object additionalProperties: $ref: '#/components/schemas/ParameterModel' cascadingSecurityProviders: type: object additionalProperties: $ref: '#/components/schemas/CascadingSecurityProvider' referencedBy: type: array items: $ref: '#/components/schemas/SecurityProviderReferenceModel' instanceId: type: string SecurityProviderReferenceModel: type: object properties: type: type: string enum: - SOURCE - SECURITY_PROVIDER id: type: string attributes: type: object UserIdentity: type: object properties: name: type: string userName: type: string password: type: string UserIdentityModel: type: object properties: name: type: string username: type: string password: type: string PermissionModel: type: object properties: permissionLevels: type: array items: $ref: '#/components/schemas/PermissionLevel' SourcePermissionsUpdateModel: type: object properties: permissionBehavior: type: string enum: - UseCrawler - Override - Merge permissions: $ref: '#/components/schemas/PermissionModel' CommonMappingSettingsModel: type: object properties: rules: type: array description: The [mapping](https://docs.coveo.com/en/217/) rules.
See [Mapping Rule Syntax Reference](https://docs.coveo.com/en/1839/). items: $ref: '#/components/schemas/RuleModel' description: A JSON describing the common [mappings](https://docs.coveo.com/en/217/) to update. MappingsConfigurationModel: type: object properties: common: $ref: '#/components/schemas/CommonMappingSettingsModel' types: type: array description: The specific [mappings](https://docs.coveo.com/en/217/) (i.e., the mappings that apply only to specified [item](https://docs.coveo.com/en/210/) types). items: $ref: '#/components/schemas/TypedMappingSettingsModel' description: A JSON describing the [mapping](https://docs.coveo.com/en/217/) configuration to add or update. RuleModel: type: object properties: field: type: string description: The name of the target [field](https://docs.coveo.com/en/200/) to populate with the first non-null value yielded by a mapping rule statement from the `content` array.
**Example:** `rating` content: type: array description: The mapping rule statements.
**Example:** `["%[internal_rating]"]`
See [Mapping Rule Syntax Reference](https://docs.coveo.com/en/1839/). items: type: string description: The mapping rule statements.
**Example:** `["%[internal_rating]"]`
See [Mapping Rule Syntax Reference](https://docs.coveo.com/en/1839/). id: type: string description: The unique identifier of the mapping rule.
**Example:** `q5dpywnbpb3ul7xpyodh3e2j7i` description: 'A [mapping](https://docs.coveo.com/en/217/) rule. See [Mapping Definition Examples](https://docs.coveo.com/en/66/).' TypedMappingSettingsModel: type: object properties: rules: type: array description: The [mapping](https://docs.coveo.com/en/217/) rules.
See [Mapping Rule Syntax Reference](https://docs.coveo.com/en/1839/). items: $ref: '#/components/schemas/RuleModel' type: type: string description: The type of [item](https://docs.coveo.com/en/210/) for which the mapping applies.
**Example:** `Video` id: type: string description: The unique identifier of the mapping.
**Note:** Typically matches the `type` value.
**Example:** `Video` description: A specific [mapping](https://docs.coveo.com/en/217/) (i.e., a mapping that applies only to a specified [item](https://docs.coveo.com/en/210/) type). BaseRuleModel: type: object properties: field: type: string description: The name of the target [field](https://docs.coveo.com/en/200/) to populate with the first non-null value yielded by a mapping rule statement from the `content` array.
**Example:** `rating` content: type: array description: The mapping rule statements.
**Example:** `["%[internal_rating]"]`
See [Mapping Rule Syntax Reference](https://docs.coveo.com/en/1839/). items: type: string description: The mapping rule statements.
**Example:** `["%[internal_rating]"]`
See [Mapping Rule Syntax Reference](https://docs.coveo.com/en/1839/). description: The common [mapping](https://docs.coveo.com/en/217/) rule to create. BaseTypedMappingSettingsModelBaseRuleModel: type: object properties: rules: type: array description: The [mapping](https://docs.coveo.com/en/217/) rules.
See [Mapping Rule Syntax Reference](https://docs.coveo.com/en/1839/). items: $ref: '#/components/schemas/BaseRuleModel' type: type: string description: The type of [item](https://docs.coveo.com/en/210/) for which the mapping applies.
**Example:** `Video` description: A JSON describing the specific [mapping](https://docs.coveo.com/en/217/) to create. SourceExtensionsMap: type: object properties: common: $ref: '#/components/schemas/SourceExtensionsModel' items: type: object additionalProperties: $ref: '#/components/schemas/SourceExtensionsModel' description: 'The [extension](https://docs.coveo.com/en/206/) configurations that apply to specific [item](https://docs.coveo.com/en/210/) types. The key is the item type, and the value object describes the extension configurations.
**Example:** `{"Video":{"postConversionExtensions":[{"extensionId": "mycoveocloudv2organizationg8tp8wu3-vwlyqfbtjkotxqkmrxqjcbcpoy"}]}}`' description: The [extension](https://docs.coveo.com/en/206/) configurations to set on the target [source](https://docs.coveo.com/en/246/). SourceExtensionsModel: type: object properties: preConversionExtensions: type: array description: The postconversion [extension](https://docs.coveo.com/en/206/) configurations.
See [Preconversion Versus Postconversion](https://docs.coveo.com/en/1556/#PreVsPost). items: $ref: '#/components/schemas/SourceExtensionModel' postConversionExtensions: type: array description: The preconversion [extension](https://docs.coveo.com/en/206/) configurations.
See [Preconversion Versus Postconversion](https://docs.coveo.com/en/1556/#PreVsPost). items: $ref: '#/components/schemas/SourceExtensionModel' description: A set of [extension](https://docs.coveo.com/en/206/) configurations. FieldMappingModel: type: object properties: sourceId: type: string sourceName: type: string mappings: type: array items: $ref: '#/components/schemas/MappingModel' LightSourceModel: type: object properties: id: type: string name: type: string sourceType: type: string enum: - AMAZONS3 - BOX_ENTERPRISE2 - CATALOG - CONFLUENCE2 - CONFLUENCE2_HOSTED - CUSTOM - DATABASE - DROPBOX_FOR_BUSINESS - FILE - GENERIC_REST - GOOGLE_DRIVE_DOMAIN_WIDE - GRAPHQL - JIRA2 - JIRA2_HOSTED - JIVE - JIVE_HOSTED - LITHIUM - KHOROS - MICROSOFT_DYNAMICS - PUSH - RSS - SALESFORCE - SALESFORCE_SITES - SAP - SERVICENOW - SHAREPOINT - SHAREPOINT_ONLINE2 - SHOPIFY - SITECORE - SITEMAP - SLACK - WEB2 - YOUTUBE - ZENDESK - ADOBE_EXPERIENCE_MANAGER - BOX - BOX_ENTERPRISE - CONFLUENCE - DROPBOX - GMAIL - GMAIL_DOMAIN_WIDE - SHAREPOINT_ONLINE crawlerInstanceType: type: string pushEnabled: type: boolean onPremisesEnabled: type: boolean streamEnabled: type: boolean SourceFieldModel: type: object properties: name: type: string description: The name of the [field](https://docs.coveo.com/en/200/), also referred to as the field identifier, or `fieldId`.
**Note:** Must match `^([a-z][a-z0-9_]{0,254})$`
**Example:** `date` example: date description: type: string description: A description of the [field](https://docs.coveo.com/en/200/).
**Example:** `The date of creation of a given item` label: type: string description: A displayable label for the [field](https://docs.coveo.com/en/200/) when used by the facet generator. automaticFacetsCandidate: type: boolean description: Whether this [field](https://docs.coveo.com/en/200/) is to be considered by the facet generator feature.
**Default:** `false`. example: false default: false automaticFacetsCandidateTags: type: array description: Optional list of tags that specify which properties/contexts this field should be an AFG candidate for. An empty or null list means the field is an AFG candidate for all properties (org-wide). Tag names must be 1-64 characters and contain only alphanumeric characters (a-z, A-Z, 0-9), dots (.), hyphens (-), or underscores (_).
**Example:** `["store1", "us.retail", "brand-name_123"]` items: type: string description: Optional list of tags that specify which properties/contexts this field should be an AFG candidate for. An empty or null list means the field is an AFG candidate for all properties (org-wide). Tag names must be 1-64 characters and contain only alphanumeric characters (a-z, A-Z, 0-9), dots (.), hyphens (-), or underscores (_).
**Example:** `["store1", "us.retail", "brand-name_123"]` type: type: string description: The data type of the [field](https://docs.coveo.com/en/200/).
See [Field Types](https://docs.coveo.com/en/1833/#field-type).
**Allowed values:**
- `DATE`
- `LONG`
- `LONG_64`
- `DOUBLE`
- `STRING`
example: STRING enum: - LONG - LONG_64 - DOUBLE - DATE - STRING - VECTOR includeInQuery: type: boolean description: Whether this [field](https://docs.coveo.com/en/200/) can be referred to in [Coveo Cloud query syntax](https://docs.coveo.com/en/1552/) expressions (for example, `@myfield=myvalue`).
Coveo Atomic and Headless often rely on the fact that most fields can be referred to in query expressions.Therefore, explicitly setting this option to `false` is not recommended, unless you know for sure that this field is only used to return information on query results.An example where it would make sense to set to `false` would be a field that contains large blobs of data that you want to display in query results, but never want to search on.
**Default:** `true` example: true default: true includeInResults: type: boolean description: Whether the [field](https://docs.coveo.com/en/200/) can be included in the `raw` property of [query](https://docs.coveo.com/en/231/) results.
The Search API lets you explicitly specify which fields you want to include in or exclude from the `raw` property of each result at query time.
Moreover, the [index](https://docs.coveo.com/en/204/) can include a given field in the `raw` property of a query result only if this field has a non-null value for this particular result.
Therefore, explicitly setting this option to `false` on a field isn't recommended, unless you want to override this behavior and ensure that this field can never be included in the `raw` property of any query result.
**Default:** `true` example: true default: true keyValue: type: boolean description: Whether the field is a [dictionary field](https://docs.coveo.com/en/2036/), which contains mappings of keys to values instead of a single value.
**Default:** `false` example: false default: false multilingual: type: boolean description: Whether the [field](https://docs.coveo.com/en/200/) contains a mapping of languages to values instead of a single value.
**Note:** Applicable to field type `STRING` only. This option requires the `keyValue` option to be enabled.
**Default:** `false` example: false default: false keepAccentsDisplayValueFacet: type: boolean description: Whether [field](https://docs.coveo.com/en/200/) values with differing accents should be considered distinct facet values (e.g., `quebec` vs `québec`).
**Note:** Applicable to field type `STRING` only.
**Default:** `false` example: false default: false keepDistinctDisplayValueFacet: type: boolean description: Whether [field](https://docs.coveo.com/en/200/) values with differing accents, ligatures, or casing should be considered distinct facet values.
This parameter encompasses the behavior of **keepAccentsDisplayValueFacet** but adds differentiation for ligatures (e.g., `ß` vs `ss`) and case sensitivity (e.g., `Québec` vs `québec`).
**Note:** Applicable to field type `STRING` only.
**Default:** `false` example: false default: false mergeWithLexicon: type: boolean description: Whether the field is [free text searchable](https://docs.coveo.com/en/1833#free-text-search).
**Note:** Applicable to field type `STRING` only.
**Default:** `false` example: false default: false smartDateFacet: type: boolean description: It is heavily recommended to set this option to `false` unless you know for sure you need it.

Whether to transform date and time string values into semicolon separated number of days/weeks/months/quarters/years since January 1st, 1900.
**Note:** Applicable to [field](https://docs.coveo.com/en/200/) type `DATE` only.
If you set this option to `true` on a `DATE` type field, the field itself will be populated by the number of milliseconds since Unix epoch corresponding to the parsed date and time string, as usual.
However, the index will also automatically create a new field, and populate it with the smart date data.
**Default:** `false`

Example:
You create the `mydate` field in your [index](https://docs.coveo.com/en/204/) and set the `smartDateFacet` option to `true` on that field. The index processes a source item whose `mydate` metadata value is `2017-11-20T19:58:55.126Z`. The `mydate` metadata is mapped to the `mydate` field in that source.
The index populates the `mydate` field with the corresponding number of milliseconds since Unix epoch (that is, `1511207935000`). It also creates a `mydatesmartfacet` field and populates it with the smart date data (that is, `D43057;W6151;M1414;Q471;Y117`). example: false default: false facet: type: boolean description: Whether [Group By](https://docs.coveo.com/en/203/) operations and [Facet](https://docs.coveo.com/en/198/) requests can be performed on the [field](https://docs.coveo.com/en/200/).
This option can't be set to `false` on a non-`STRING` type field.
**Default:**
- `false` for `STRING` type fields.
- `true` for all other types of fields. example: false multiValueFacet: type: boolean description: Whether the [field](https://docs.coveo.com/en/200/) contains multiple values (see also the `multiValueFacetTokenizers` property).
**Note:** Applicable to field type `STRING` only.
**Default:** `false` example: false default: false hierarchicalFacet: type: boolean description: Whether the [field](https://docs.coveo.com/en/200/) contains multiple values that form a hierarchy (see also the `multiValueFacetTokenizers` property).
**Note:** Applicable to field type `STRING` only.
**Default:** `false` example: false default: false sort: type: boolean description: Whether [query](https://docs.coveo.com/en/231/) results can be sorted based on the value of the [field](https://docs.coveo.com/en/200/).Having lots of sortable `STRING` type fields in a Coveo organization can have an adverse effect on its [index](https://docs.coveo.com/en/204/) size and performance.
This option can't be set to `false` on a non-`STRING` type field.
**Default:**
- `false` for `STRING` type fields.
- `true` for all other types of fields. example: false ranking: type: boolean description: Whether to use the [field](https://docs.coveo.com/en/200/) in result ranking calculation only.
**Notes:**
- Has a significant impact on query performance.
- Applicable to field type `STRING`

**Default:** `false` example: false default: false stemming: type: boolean description: Whether to allow [stemming](https://docs.coveo.com/en/1576/) on [field](https://docs.coveo.com/en/200/) [queries](https://docs.coveo.com/en/231/).
**Notes:**
- applicable to `STRING` type fields only.
- Has a significant impact on query performance.

**Default:** `false` example: false default: false multiValueFacetTokenizers: type: string description: The character to use as a value separator, if the [field](https://docs.coveo.com/en/200/) contains multiple values (see also the `multiValueFacet` property).
**Example:** `;` example: ; useCacheForNestedQuery: type: boolean description: Whether to keep the data required to perform [nested queries](https://docs.coveo.com/en/220) in memory. Setting this option to `true` on a [field](https://docs.coveo.com/en/200/) also speeds query performance for expressions that compare the value of this field using [regex, wildcard, phonetic match, or fuzzy match query operators](https://docs.coveo.com/en/1552).
**Note:** only applicable to fields which are faceted or multi-value faceted.
**Default:** `false` example: false default: false useCacheForSort: type: boolean description: Whether to keep the entire [field](https://docs.coveo.com/en/200/) in memory for fast sorting.
**Default:** `false`
This option can't be set to true on a `STRING` type field, unless the `sort` option is also `true` for that field. example: false default: false useCacheForNumericQuery: type: boolean description: Whether to keep the data required to execute operations on numeric and date [fields](https://docs.coveo.com/en/200/) in memory.
**Note:** Cannot be enabled on `STRING` type fields.
**Default:** `false` example: false default: false useCacheForComputedFacet: type: boolean description: Whether to keep computed field data in memory.
**Note:** Cannot be enabled on `STRING` type fields.
**Default:** `false` example: false default: false dateFormat: type: string description: A regex indicating the date format, for some `date` type fields.
**Example:** `%Y/%m/%d@%H:%M:%S%G` example: '%Y/%m/%d@%H:%M:%S%G' system: type: boolean description: Whether the [field](https://docs.coveo.com/en/200/) is a standard Coveo field.
**Note:** `system` option can not be set to `true`.
**Default:** `false` example: false projectIds: type: array description: List of Project IDs a [field](https://docs.coveo.com/en/200/) can be associated with.
**Note:** This is an optional list of `STRING`
**Default:** `null` items: type: string description: List of Project IDs a [field](https://docs.coveo.com/en/200/) can be associated with.
**Note:** This is an optional list of `STRING`
**Default:** `null` mappings: type: array items: $ref: '#/components/schemas/FieldMappingModel' sources: type: array items: $ref: '#/components/schemas/LightSourceModel' description: A [field](https://docs.coveo.com/en/200/). BatchOperationProgressModelTypedMappingSettingsModel: type: object properties: batchOperationId: type: string status: type: string enum: - IN_PROGRESS - COMPLETED batchOperationResourcesStatus: type: array items: $ref: '#/components/schemas/BatchOperationResourceStatusModelTypedMappingSettingsModel' BatchOperationResourceStatusModelTypedMappingSettingsModel: type: object properties: resourceModel: $ref: '#/components/schemas/TypedMappingSettingsModel' operationResult: type: string enum: - SUCCESS - ERROR errorDetails: type: string successful: type: boolean GetSourcesOutArgs: type: object properties: sourceModels: type: array items: oneOf: - $ref: '#/components/schemas/SourceModel' - $ref: '#/components/schemas/AmazonS3SourceModel' - $ref: '#/components/schemas/BoxEnterprise2SourceModel' - $ref: '#/components/schemas/CatalogSourceModel' - $ref: '#/components/schemas/Confluence2HostedSourceModel' - $ref: '#/components/schemas/Confluence2SourceModel' - $ref: '#/components/schemas/CustomSourceModel' - $ref: '#/components/schemas/DatabaseSourceModel' - $ref: '#/components/schemas/DropboxForBusinessSourceModel' - $ref: '#/components/schemas/FileSourceModel' - $ref: '#/components/schemas/GenericRestSourceModel' - $ref: '#/components/schemas/GoogleDriveDomainWideSourceModel' - $ref: '#/components/schemas/GraphQlSourceModel' - $ref: '#/components/schemas/Jira2HostedSourceModel' - $ref: '#/components/schemas/Jira2SourceModel' - $ref: '#/components/schemas/JiveHostedSourceModel' - $ref: '#/components/schemas/JiveSourceModel' - $ref: '#/components/schemas/KhorosSourceModel' - $ref: '#/components/schemas/MicrosoftDynamicsSourceModel' - $ref: '#/components/schemas/PushSourceModel' - $ref: '#/components/schemas/RSSSourceModel' - $ref: '#/components/schemas/SAPSourceModel' - $ref: '#/components/schemas/SalesforceSitesSourceModel' - $ref: '#/components/schemas/SalesforceSourceModel' - $ref: '#/components/schemas/ServiceNowSourceModel' - $ref: '#/components/schemas/SharePointOnline2SourceModel' - $ref: '#/components/schemas/SharePointSourceModel' - $ref: '#/components/schemas/ShopifySourceModel' - $ref: '#/components/schemas/SitecoreSourceModel' - $ref: '#/components/schemas/SitemapSourceModel' - $ref: '#/components/schemas/SlackSourceModel' - $ref: '#/components/schemas/Web2SourceModel' - $ref: '#/components/schemas/YouTubeSourceModel' - $ref: '#/components/schemas/ZendeskSourceModel' totalEntries: type: integer format: int64 totalPages: type: integer format: int32 MetadataReportPageModel: type: object properties: items: type: array items: $ref: '#/components/schemas/SourceMetadataModel' creationDate: type: string format: date-time expirationDate: type: string format: date-time sampledDocumentCount: type: integer format: int32 documentErrorCount: type: integer format: int32 totalPages: type: integer format: int32 totalEntries: type: integer format: int64 MetadataValueModel: type: object properties: metadataValue: type: object count: type: integer format: int32 SourceMetadataModel: type: object properties: key: type: string values: type: array items: $ref: '#/components/schemas/MetadataValueModel' count: type: integer format: int32 origin: type: string isMapped: type: boolean deprecated: true indexedBy: type: string enum: - NONE - FIELD - MAPPING SourceMetadataStatusModel: type: object properties: sampleAvailable: type: boolean reportGenerationInProgress: type: boolean reportAvailable: type: boolean Config: type: object properties: documentConsumerURI: type: string indexIdentifier: type: string dbConnectionString: type: string reportingServiceUri: type: string sourceInformation: $ref: '#/components/schemas/SourceInformation' sourceSecurityOption: type: string enum: - Retrieve - Specified - Merge startingAddresses: type: array items: type: string addressPatterns: type: array items: $ref: '#/components/schemas/AddressPattern' permissions: type: array items: $ref: '#/components/schemas/PermissionLevel' parameters: type: object additionalProperties: $ref: '#/components/schemas/Parameter' securityProviders: type: object additionalProperties: $ref: '#/components/schemas/SecurityProvider' userIdentities: type: object additionalProperties: $ref: '#/components/schemas/UserIdentity' dataFiles: type: object additionalProperties: $ref: '#/components/schemas/DataFile' caseSensitivePatterns: type: boolean documentConfig: $ref: '#/components/schemas/DocumentConfig' SourceConfigSnapshotMappingModel: type: object properties: id: type: string sourceId: type: string type: type: string fieldName: type: string rules: type: array items: type: string SourceConfigSnapshotModel: type: object properties: configuration: $ref: '#/components/schemas/Config' mappings: type: array items: $ref: '#/components/schemas/SourceConfigSnapshotMappingModel' PageModelSourceFieldModel: type: object properties: items: type: array items: $ref: '#/components/schemas/SourceFieldModel' totalPages: type: integer format: int32 totalEntries: type: integer format: int64 securitySchemes: oauth2: type: oauth2 flows: authorizationCode: authorizationUrl: https://platform.cloud.coveo.com/oauth/authorize tokenUrl: https://platform.cloud.coveo.com/oauth/token scopes: full: required