Repositories

The repositories API (proteus.repositories) lets you manage repositories (knowledge sources) and their files over REST.

Create a repository

const repo = await proteus.repositories.create({
  name: 'Docs',
  orgId: '<orgId>',
  // description: 'Product documentation',
});
console.log('repository id', repo.id);

Get a repository

const repo = await proteus.repositories.getById('<repositoryId>');

List a repository's files

const files = await proteus.repositories.getFiles('<repositoryId>');
files.forEach((file) => console.log(file.fileName, file.url));

Attach a repository to a chat or agent so agents can cite its files when replying. See the Management API repositories reference for the full lifecycle (uploads, data providers, etc.).

Messages Components