List Dataset Files

GET /datasets

Query Parameters

---

userContext[<key>] string | number Required

User context parameters used to scope and filter files. The context defines the ownership and isolation boundary for dataset files—commonly used for multi-tenant scenarios.
For example: ?userContext[userId]=123 will return only files that belong to that specific user.
Files are isolated by their user context, meaning you can only retrieve files that match the exact context parameters provided.

---

Request

Node.js

import Inconvo from "@inconvoai/node";

const inconvo = new Inconvo({
  apiKey: process.env.INCONVO_API_KEY
});

const files = await inconvo.datasets.list({
  userContext: {
    userId: 123
  }
});

console.log(files);

Response

{
  "files": [
    "sales_report_q4.csv",
    "customer_data.json"
  ]
}

curl -X GET "https://app.inconvo.ai/api/v1/datasets?userContext[userId]=123" \
  -H "Authorization: Bearer $INCONVO_API_KEY"

Response

{
  "files": [
    "sales_report_q4.csv",
    "customer_data.json"
  ]
}