Backend

Files

Uploads from you, the agent, and the customer app live in the project. File fields point at ids.

MCP

  • files.upload accepts base64, max 10MB. Returns { id, url, name, mime, size }.
  • files.list returns metadata and URLs, no bytes.
  • files.delete removes a file by id.

Put the id in a file field. Use the url in frontends. The URL is not a public dump: the caller must be allowed to read that file or a public record that points at it.

REST

  • GET /v1/<projectId>/files lists metadata and URLs.
  • POST /v1/<projectId>/files accepts multipart field file, or JSON { name, mime, base64 }.
  • GET /v1/<projectId>/files/:id returns the bytes when the caller may read that file.
  • DELETE /v1/<projectId>/files/:id removes it.

Project logo

In Settings you can upload a logo or keep a generated Avvvatars mark. The same image appears in the project switcher and the project list.