FruxonDocs
SystemStorage

Lists the workspace's stored files.

Tenant-wide file listing for storage management: newest first by default, or any field in Fruxon.Model.Storage.StoredFileSorting via `?orderBy=` (AIP-132, e.g. `orderBy=sizeBytes desc` or `orderBy=displayName`). 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

Authorization

Bearer
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.

orderBy?

Sort clause: displayName, sizeBytes, or createdAt, each optionally followed by asc / desc. Defaults to createdAt desc.

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.

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
}
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "property1": null,
  "property2": null
}
Empty
Empty
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "property1": null,
  "property2": null
}

Gets the current status of a long-running operation.

Returns the current lifecycle state of an async job (ingestion, refresh, deletion, etc). Clients should poll this endpoint until `status` reaches a terminal state (`DONE` or `FAILED`); intermediate states are `PENDING` and `RUNNING`. On success, `resourceName` points to the affected resource and `metadata` may carry provider-specific progress info — treat any progress signal as advisory and not strictly monotonic. On failure, `error` contains a human-readable reason. The operation id is the same value returned in the `name` field of the resource that started the job. Polling intervals of 1–5 seconds are reasonable; do not poll faster than once per second.

Lists the files tracked under a session.

Returns the files owned by the session, newest first, each with a public download URL. Files are retained with the session and remain listable even after the conversation history is summarized.