File Explorer

13 Endpunkte. Basis-URL: https://xapi.ambertech.cloud/api/v1

Get organization file storage usage (owner only)#

GET/file-explorer/organization-storageToken

Returns File Explorer storage consumption by space, uploader, and largest files for the active organization.

Antworten

200File usage statistics returned
403Only organization owners can view tenant file usage

Beispiel (cURL)

curl -X GET "https://xapi.ambertech.cloud/api/v1/file-explorer/organization-storage" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

POST /spaces/{spaceId}/file-explorer/files#

POST/spaces/{spaceId}/file-explorer/filesToken

Parameter

Name	Ort	Typ	Beschreibung
`spaceId`Pflicht	Pfad	`string`	–

Request-Body`multipart/form-dataUploadFileDto`

Name	Typ	Beschreibung
`space_id`Pflicht	`string`	–
`parent_id`	`string`	Parent folder ID. Omit for root.
`comment`	`string`	Version comment

Antworten

201Erstellt

Beispiel (cURL)

curl -X POST "https://xapi.ambertech.cloud/api/v1/spaces/{spaceId}/file-explorer/files" \
  -H "Authorization: Bearer $XISUITE_TOKEN" \
  -F "file=@./datei.pdf"

GET /spaces/{spaceId}/file-explorer/files/{id}/preview-url#

GET/spaces/{spaceId}/file-explorer/files/{id}/preview-urlToken

Parameter

Name	Ort	Typ	Beschreibung
`spaceId`Pflicht	Pfad	`string`	–
`id`Pflicht	Pfad	`string`	–

Antworten

200OK

Beispiel (cURL)

curl -X GET "https://xapi.ambertech.cloud/api/v1/spaces/{spaceId}/file-explorer/files/{id}/preview-url" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

Start a direct-to-storage upload#

POST/spaces/{spaceId}/file-explorer/files/upload-initToken

Parameter

Name	Ort	Typ	Beschreibung
`spaceId`Pflicht	Pfad	`string`	–

Request-Body`application/jsonInitUploadDto`

Name	Typ	Beschreibung
`name`Pflicht	`string`	File name, as it will appear in the tree
`size`Pflicht	`number`	Declared size in bytes; verified on completion
`parent_id`	`string`	Parent folder ID. Omit for root.
`mime_type`	`string`	MIME type reported by the client
`comment`	`string`	Version comment

Antworten

201Signed upload URL issued
409A file with this name already exists
413Storage quota exceeded

Beispiel (cURL)

curl -X POST "https://xapi.ambertech.cloud/api/v1/spaces/{spaceId}/file-explorer/files/upload-init" \
  -H "Authorization: Bearer $XISUITE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"…","size":0}'

POST /spaces/{spaceId}/file-explorer/folders#

POST/spaces/{spaceId}/file-explorer/foldersToken

Parameter

Name	Ort	Typ	Beschreibung
`spaceId`Pflicht	Pfad	`string`	–

Request-Body`application/jsonCreateFolderDto`

Name	Typ	Beschreibung
`space_id`Pflicht	`string`	–
`parent_id`	`string`	Parent folder ID. Omit for root.
`name`Pflicht	`string`	–
`description`	`string`	–

Antworten

201Erstellt

Beispiel (cURL)

curl -X POST "https://xapi.ambertech.cloud/api/v1/spaces/{spaceId}/file-explorer/folders" \
  -H "Authorization: Bearer $XISUITE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"space_id":"…","name":"…"}'

GET /spaces/{spaceId}/file-explorer/labels#

GET/spaces/{spaceId}/file-explorer/labelsToken

Parameter

Name	Ort	Typ	Beschreibung
`spaceId`Pflicht	Pfad	`string`	–

Antworten

200OK

Beispiel (cURL)

curl -X GET "https://xapi.ambertech.cloud/api/v1/spaces/{spaceId}/file-explorer/labels" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

POST /spaces/{spaceId}/file-explorer/labels#

POST/spaces/{spaceId}/file-explorer/labelsToken

Parameter

Name	Ort	Typ	Beschreibung
`spaceId`Pflicht	Pfad	`string`	–

Request-Body`application/jsonCreateLabelDto`

Name	Typ	Beschreibung
`space_id`Pflicht	`string`	–
`name`Pflicht	`string`	–
`color`	`string`	Standard: `"#6366f1"`

Antworten

201Erstellt

Beispiel (cURL)

curl -X POST "https://xapi.ambertech.cloud/api/v1/spaces/{spaceId}/file-explorer/labels" \
  -H "Authorization: Bearer $XISUITE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"space_id":"…","name":"…"}'

GET /spaces/{spaceId}/file-explorer/nodes#

GET/spaces/{spaceId}/file-explorer/nodesToken

Parameter

Name	Ort	Typ	Beschreibung
`spaceId`Pflicht	Pfad	`string`	–
`view`	Query	`string`	Werte: `allstarredrecentshared-with-meshared-from-metrash`
`space_id`	Query	`string`	–
`parent_id`	Query	`string`	Parent folder ID. Omit for root.
`folder_id`	Query	`string`	Folder ID whose ENTIRE SUBTREE (any depth) is listed. Distinct from parent_id, which is direct children only.
`label_ids`	Query	`string[]`	Label IDs (repeat the param or pass one comma-separated value). Matches nodes carrying ANY of them.
`type`	Query	`string`	Werte: `filefolder`
`search`	Query	`string`	–
`starred`	Query	`boolean`	Return only starred nodes for current user

Antworten

200OK

Beispiel (cURL)

curl -X GET "https://xapi.ambertech.cloud/api/v1/spaces/{spaceId}/file-explorer/nodes" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

PATCH /spaces/{spaceId}/file-explorer/nodes/{id}#

PATCH/spaces/{spaceId}/file-explorer/nodes/{id}Token

Parameter

Name	Ort	Typ	Beschreibung
`spaceId`Pflicht	Pfad	`string`	–
`id`Pflicht	Pfad	`string`	–

Request-Body`application/jsonUpdateNodeDto`

Name	Typ	Beschreibung
`name`	`string`	–
`description`	`string`	–

Antworten

200OK

Beispiel (cURL)

curl -X PATCH "https://xapi.ambertech.cloud/api/v1/spaces/{spaceId}/file-explorer/nodes/{id}" \
  -H "Authorization: Bearer $XISUITE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"…","description":"…"}'

DELETE /spaces/{spaceId}/file-explorer/nodes/{id}#

DELETE/spaces/{spaceId}/file-explorer/nodes/{id}Token

Parameter

Name	Ort	Typ	Beschreibung
`spaceId`Pflicht	Pfad	`string`	–
`id`Pflicht	Pfad	`string`	–

Antworten

200OK

Beispiel (cURL)

curl -X DELETE "https://xapi.ambertech.cloud/api/v1/spaces/{spaceId}/file-explorer/nodes/{id}" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

GET /spaces/{spaceId}/file-explorer/nodes/{id}/breadcrumbs#

GET/spaces/{spaceId}/file-explorer/nodes/{id}/breadcrumbsToken

Parameter

Name	Ort	Typ	Beschreibung
`spaceId`Pflicht	Pfad	`string`	–
`id`Pflicht	Pfad	`string`	–

Antworten

200OK

Beispiel (cURL)

curl -X GET "https://xapi.ambertech.cloud/api/v1/spaces/{spaceId}/file-explorer/nodes/{id}/breadcrumbs" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

GET /spaces/{spaceId}/file-explorer/reminders#

GET/spaces/{spaceId}/file-explorer/remindersToken

Parameter

Name	Ort	Typ	Beschreibung
`spaceId`Pflicht	Pfad	`string`	–

Antworten

200OK

Beispiel (cURL)

curl -X GET "https://xapi.ambertech.cloud/api/v1/spaces/{spaceId}/file-explorer/reminders" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

GET /spaces/{spaceId}/file-explorer/storage#

GET/spaces/{spaceId}/file-explorer/storageToken

Parameter

Name	Ort	Typ	Beschreibung
`spaceId`Pflicht	Pfad	`string`	–

Antworten

200OK

Beispiel (cURL)

curl -X GET "https://xapi.ambertech.cloud/api/v1/spaces/{spaceId}/file-explorer/storage" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

File Explorer

Get organization file storage usage (owner only)#

Antworten

POST /spaces/{spaceId}/file-explorer/files#

Parameter

Request-Bodymultipart/form-dataUploadFileDto

Antworten

GET /spaces/{spaceId}/file-explorer/files/{id}/preview-url#

Parameter

Antworten

Start a direct-to-storage upload#

Parameter

Request-Bodyapplication/jsonInitUploadDto

Antworten

POST /spaces/{spaceId}/file-explorer/folders#

Parameter

Request-Bodyapplication/jsonCreateFolderDto

Antworten

GET /spaces/{spaceId}/file-explorer/labels#

Parameter

Antworten

POST /spaces/{spaceId}/file-explorer/labels#

Parameter

Request-Bodyapplication/jsonCreateLabelDto

Antworten

GET /spaces/{spaceId}/file-explorer/nodes#

Parameter

Antworten

PATCH /spaces/{spaceId}/file-explorer/nodes/{id}#

Parameter

Request-Bodyapplication/jsonUpdateNodeDto

Antworten

DELETE /spaces/{spaceId}/file-explorer/nodes/{id}#

Parameter

Antworten

GET /spaces/{spaceId}/file-explorer/nodes/{id}/breadcrumbs#

Parameter

Antworten

GET /spaces/{spaceId}/file-explorer/reminders#

Parameter

Antworten

GET /spaces/{spaceId}/file-explorer/storage#

Parameter

Antworten

Request-Body`multipart/form-dataUploadFileDto`

Request-Body`application/jsonInitUploadDto`

Request-Body`application/jsonCreateFolderDto`

Request-Body`application/jsonCreateLabelDto`

Request-Body`application/jsonUpdateNodeDto`