Appearance
Convenience Endpoints
Helper endpoints for summarized lists and decoded file details.
GET /v1/user-collections
Returns your vector stores with files: [] (empty placeholder array). Use file listing endpoints to fetch details on demand.
ts
const res = await fetch("https://agents.missionsquad.ai/v1/user-collections", {
headers: { "x-api-key": process.env.MSQ_API_KEY! }
});
const data = await res.json();
console.log(data);Example response:
json
{
"data": [
{
"id": "vs_123abc456def",
"object": "vector_store",
"created_at": 1681612345678,
"name": "Research Papers",
"bytes": 1024000,
"file_counts": {
"in_progress": 0,
"completed": 5,
"failed": 0,
"cancelled": 0,
"total": 5
},
"files": []
}
]
}GET /v1/vector_stores/:id/file-details
Returns detailed file info for the vector store with decoded filenames and user‑relative paths.
ts
const res = await fetch("https://agents.missionsquad.ai/v1/vector_stores/vs_123abc456def/file-details", {
headers: { "x-api-key": process.env.MSQ_API_KEY! }
});
const data = await res.json();
console.log(data);Example response:
json
{
"success": true,
"vectorStoreId": "vs_123abc456def",
"files": [
{
"id": "file_abc123",
"bytes": 512000,
"created_at": 1681612345678,
"filename": "research_paper_1.pdf",
"path": "docs/research_paper_1.pdf"
},
{
"id": "file_def456",
"bytes": 256000,
"created_at": 1681612345679,
"filename": "research_paper_2.pdf",
"path": "docs/research_paper_2.pdf"
}
]
}