List Sources By ID

Retrieve specific sources by their IDs.

Use this endpoint to fetch one or more sources by providing their unique identifiers. This is useful when you need detailed information about specific documents or content you’ve previously uploaded.

Provide the source IDs in the request body along with your tenant information to get the exact sources you need.

Hit the Try it button to try this API now in our playground. It’s the best way to check the full request and response in one place, customize your parameters, and generate ready-to-use code snippets.

Examples

API Request

curl --request POST \
  --url https://api.usecortex.ai/list/sources_by_id \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "tenant_id": "tenant_1234",
  "source_ids": [],
  "sub_tenant_id": "sub_tenant_4567"
}'

Overview

Retrieve specific sources by their IDs. Use this API to fetch one or more sources by providing their unique identifiers. This is useful when you need detailed information about specific documents or content you’ve previously uploaded.

Example Request

{
  "tenant_id": "tenant_456",
  "sub_tenant_id": "subtenant_123",
  "source_ids": ["doc_123", "doc_456"]
}

Example Response

{
  "sources": [
    {
      "id": "CortexDoccf0f1ccee4864c679bad5678bb1c515a1757402245",
      "title": "ai-2027.pdf",
      "type": "file",
      "timestamp": "1757402409.7277222",
      "description": "### **AI Futures** **Project** # **AI** **2027** ### **AI Futures** ### **Project** ## **`Daniel Kokotajlo`** **`Scott Alexander`** **`Thomas Larsen`** **`Eli Lifland`** **`Romeo Dean`** ``` Originally published on April 3rd 2025 on AI-2027.com ``` ``` Design by Lightcone Infrastructure ``` ## **AI 2027** We predict that the impact of superhuman AI",
      "document_metadata": {},
      "tenant_metadata": {}
    }
  ],
  "success": true,
  "message": "Successfully fetched sources"
}

Error Responses

All endpoints return consistent error responses following the standard format. For detailed error information, see our Error Responses documentation.

Authorizations

Authorization · string · header · required

Body

application/json

tenant_id · string · required

Example:

source_ids · string[] · required

Example:

sub_tenant_id · string · default: ""

Example:

Response

200

application/json

sources · Sources · array · required

Show child attributes

success · boolean · default: true

Example:

message · string · default: Sources retrieved successfully