Get Detailed Information About a Source

This is for:

In this article

Sample Request

Retrieving information about a specific source can be useful in many scenarios. You could want to inspect a source mappings, its current number of items, its total size, its pre- and post- conversion indexing pipeline extension scripts, etc.

Use the Get a single source operation to get detailed information about an individual source in a Coveo organization.

You can also perform this action from the Coveo Administration Console (see Manage sources).

When you want to monitor the current number of items in a source to validate the indexing status of pushed items, you should generally use the Get all sources operation instead.

This lighter process allows you to retrieve the exact same information, the only difference being that the body of a successful response is an array where each element contains information about an individual source in the target Coveo organization, if not already done. This implies that you need to parse the response in order to retrieve the information that applies to the Push source you’re monitoring. Doing so is typically much faster than using the Get a single source operation to retrieve the pre-filtered information, though.

Request template

GET https://platform.cloud.coveo.com/rest/organizations/<MyOrganizationId>/sources/<MySourceId> HTTP/1.1
 
Content-Type: application/json
Accept: application/json
Authorization: Bearer <MyAccessToken>

In the request path:

Replace <MyOrganizationId> with the actual ID of the target Coveo organization (see Retrieve the organization ID).
Replace <MySourceId> with the actual ID of the target source.

In the Authorization HTTP header:

Replace <MyAccessToken> with an access token that grants the Sources - View privilege in the target Coveo organization (see Get your Coveo access token, Create an API key, and Get the privileges of an access token).

The body of a successful response (200 OK) contains information about the target source.

Sample Request

Getting information about a specific source

GET https://platform.cloud.coveo.com/rest/organizations/mycoveocloudv2organizationg8tp8wu3/sources/mycoveocloudv2organizationg8tp8wu3-rp5rxzbdz753uhndklv2ztkfgy HTTP/1.1
 
Content-Type: application/json
Accept: application/json
Authorization: Bearer **********-****-****-****-************

Successful response - 200 OK

{
  "sourceType": "PUSH",
  "id": "mycoveocloudv2organizationg8tp8wu3-rp5rxzbdz753uhndklv2ztkfgy",
  "name": "My Secured Push Source",
  "owner": "asmith@example.com",
  "sourceVisibility": "SECURED",
  "mappings": [
    {
      "id": "utezfdw7a26punr3fvf5a5kpze",
      "kind": "COMMON",
      "fieldName": "mypushsourceauthor",
      "extractionMethod": "METADATA",
      "content": "%[author]"
    },
    [ ... ]
  ],
  "information": {
    "sourceStatus": {
      "type": "PUSH_READY",
      "numberOfDocuments": 0,
      "allowedOperations": [
        "DELETE"
      ]
    },
    "numberOfDocuments": 2,
    "documentsTotalSize": 101353
  },
  "pushEnabled": true,
  "onPremisesEnabled": false,
  "securityProviderReferences": [
    "My Secured Push Source Security Identity Provider"
  ],
  "preConversionExtensions": [
    {
      "actionOnError": "SKIP_EXTENSION",
      "condition": "%[filetype] == 'video'",
      "extensionId": "mycoveocloudv2organizationg8tp8wu3-vfwwdfkmvv3aqnkrpt6vircldm",
      "parameters": {}
      "versionId": ""
    },
    [ ... ]
  ],
  "postConversionExtensions": [
    [ ... ]
  ],
  "urlFilters": [
    {
      "filter": "*",
      "includeFilter": true,
      "filterType": "WILDCARD"
    },
    [ ... ]
  ]