FruxonDocs
SystemStorage

Lists the workspace's stored files.

Tenant-wide file listing for storage management: newest first by default, largest first with `orderBySize=true`. Supports substring search on display name / file id and filtering by lifecycle status, owning session, or owning agent. Each row carries a fresh (signed, when signing is configured) download URL.

GET
/v1/tenants/{tenant}/storage
AuthorizationBearer <token>

JWT Authorization header using the Bearer scheme. Enter 'Bearer' [space] and then your token.

In: header

Path Parameters

tenant*string

The tenant identifier

Query Parameters

PageSize?integer

The maximum number of items to return per page

Formatint32
PageToken.Skip?integer
Formatint32
PageToken.Cursor?string

Opaque cursor token from an external system (e.g. RAG API). When set, M:Fruxon.Common.Collections.PageToken.AsString returns this value directly instead of encoding Fruxon.Common.Collections.PageToken.Skip.

q?string

Substring to search for in the display name or file id.

status?string

Restrict to a lifecycle status.

Value in"UNSPECIFIED" | "TEMPORARY" | "RETAINED"
sessionId?string

Restrict to files owned by a session.

agentId?string

Restrict to files owned by an agent.

orderBySize?boolean

When true, order by size (largest first) instead of newest first.

Defaultfalse
networkId?string

Restrict to one Application's files.

Formatuuid
unattributed?boolean

When true, return only files that belong to no Application. Omitting both this and networkId means "every Application plus the unattributed remainder".

Defaultfalse

Response Body

curl -X GET "https://api.fruxon.com/v1/tenants/string/storage"
{
  "items": [
    {
      "fileId": "string",
      "displayName": "string",
      "contentType": "string",
      "sizeBytes": 0,
      "status": "TEMPORARY",
      "visibility": "PRIVATE",
      "sessionId": "string",
      "agentId": "string",
      "networkId": "00000000-0000-0000-0000-000000000000",
      "createdBy": "string",
      "createdAt": 0,
      "downloadUrl": "string",
      "promptLink": "string"
    }
  ],
  "nextPageToken": "string",
  "totalCount": 0
}
Empty
Empty
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "property1": null,
  "property2": null
}