Content APIs

Back to API List

Get Content By ID

This API returns the requested content.

Field	Value
Method	GET
Endpoint	<host_url>/api/public/bot/:botId/content/contentId
Content-Type	application/json
Authorization	auth: <JWT Token>
API Scope	Document Management

Query Parameters

Parameter	Description	Mandatory
Bot ID	Provide your application ID here.	Yes
ContentID	Unique ID of the content to retrieve. Returned as doc_id in the advancedSearch API response. Also visible in the Chunk Browser as docId or in the JSON view of ingested content as _id.	Yes

Sample Response

{
  "_id": "fc-26d474d1-2aa7-50cf-984d-e719a4884792",
  "searchIndexId": "sidx-cdd15c7a-47d5-5839-80ee-e4f418489f70",
  "streamId": "st-7561b874-2114-5b8f-8086-ea69007b5f53",
  "createdBy": "u-4d04030a-93f3-5cba-a07b-1a5b20a7e9a9",
  "createdOn": "2024-03-06T12:08:39.719Z",
  "lMod": "2024-11-18T07:33:35.000Z",
  "extractionType": "jira",
  "extractionSourceId": "fs-5c651c22-eb9f-5bb7-ad51-84de1df15639",
  "jobId": "fj-fecfb47b-eea8-5419-aadb-ad8552c0a7e5",
  "_source": {
    "meta_data": {
      "assignee": "John",
      "projectId": "10000",
      "issueType": "Task",
      "projectName": "Searchassist_Test",
      "issueStatus": "To Do",
      "comments": " Continue Working on it.. Give the Latest Update ",
      "reporter": "Jacob",
      "ticketId": "ST-2"
    },
    "sys_racl": ["10000"],
    "sys_content_type": "jira",
    "sys_source_name": "Jira COnnector",
    "sourceType": "jira",
    "raw_data": "...",
    "base_url": "",
    "title": "Debugging Request",
    "content": "Debugging Request...",
    "url": "https://myprojectjira.atlassian.net/browse/xx-2",
    "type": "Task",
    "comments": " Please Update the status."
  },
  "connectorId": "fcon-c13cc009-be5f-50d8-b903-941f88f7b3b7",
  "externalSourceId": "sidx-cdd15c7a-47d5-5839-80ee-e4f418489f70_ST-2",
  "updatedOn": "2024-09-09T10:32:27.394Z",
  "__v": 0
}

---

Delete Content

This API deletes specific content from the SearchAI application. Deleting content also deletes the corresponding chunks.

Field	Value
Method	DELETE
Endpoint	<host_url>/api/public/bot/:botId/content
Content-Type	application/json
Authorization	auth: <JWT Token>
API Scope	Document Management

Query Parameters

Parameter	Description	Mandatory
Bot ID	Provide your application ID here.	Yes

Request Parameters

Parameter	Description	Mandatory
docIDs	Array of record identifiers to delete. The ID is available as doc_id and starts with "d-". Use this field for structured data/chunks.	Yes

Sample Request

{
  "docIds": [
    "fc-dafe0d2b-cb65-5f74-8f42-e0d4855e20ee",
    "fc-dafe0d2b-cb65-5f74-8f42-e0d4855e20edd"
  ]
}

Response Parameters

Parameter	Description
deletedCount	Count of records deleted successfully.

---

Get Content by Condition

This API fetches specific content from the SearchAI application based on a given condition.

Field	Value
Method	POST
Endpoint	<host_url>/api/public/bot/:botId/content-by-cond
Content-Type	application/json
Authorization	auth: <JWT Token>
API Scope	Document Management

Query Parameters

Parameter	Description	Mandatory
Bot ID	Provide your application ID here.	Yes

Request Parameters

Parameter	Description	Mandatory
query	Contains fields on which filters are applied. Multiple fields are combined with a logical AND. For example, {"sys_content_type": "file"} returns all file-type content. Adding "title": "my file" narrows results to files with that exact title.	Yes
nextCursor	Used for cursor-based pagination. Omit on first request. Pass the cursor from the previous response to get the next page. A null value indicates the end of results.	No

Sample Request

{
  "query": {
    "title": "title of the file",
    "sys_content_type": "file"
  }
}

Sample Response

{
  "data": [
    {
      "_id": "fc-d19666d5-234b-587c-a197-40efa2ec9d3d",
      "searchIndexId": "sidx-d8d728ad-1ddd-57f0-aa98-895efa328898",
      "streamId": "st-86b7aeda-c010-504d-ac5e-f01df1407ec6",
      "createdBy": "u-1e066081-f25d-5b7b-99d5-1b873ea50b09",
      "lModBy": "u-1e066081-f25d-5b7b-99d5-1b873ea50b09",
      "createdOn": "2025-11-04T05:37:21.694Z",
      "lMod": "2025-11-04T05:37:21.000Z",
      "extractionType": "file",
      "extractionSourceId": "fs-9a3feb4e-d97f-5bfc-84cd-c999f62dc6fa",
      "jobId": "fj-75b384de-e38c-5b85-b152-6d45aa5a042d",
      "_meta": {
        "state": "approved",
        "isDeleted": false,
        "contentSource": "file",
        "size": 1322647,
        "updateAvailable": false,
        "recordsCount": 4,
        "file_url": "https://host/api/getMediaStream/findly/f-c65e029e-e553-59bd-83e2-0b230ba88deb.pdf?..."
      },
      "_source": {
        "file_title": "Company.ai_Conversational_AI_Solutions_Brief.pdf",
        "sys_racl": ["*"],
        "sys_content_type": "file",
        "sys_source_name": "Default Directory",
        "type": "application/pdf",
        "sys_file_type": "pdf"
      },
      "__v": 0
    }
  ],
  "nextCursor": null,
  "prevCursor": "fc-d19666d5-234b-587c-a197-40efa2ec9d3d"
}