Attachments

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

List centralized attachments for an entity#

GET/attachmentsToken

Parameter

Name	Ort	Typ	Beschreibung
`entityType`Pflicht	Query	`string`	Werte: `taskprocesswiki_pageasset_itemspace_gdpr_recordsupport_requestasset_objectchat_message`
`entityId`Pflicht	Query	`string`	–
`spaceId`	Query	`string`	Accepted for legacy frontend compatibility only. The backend resolves the trusted space from the parent entity.

Antworten

200OK

Beispiel (cURL)

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

Upload or version a centralized attachment#

POST/attachmentsToken

Request-Body`multipart/form-dataUploadAttachmentDto`

Name	Typ	Beschreibung
`entity_type`Pflicht	`string`	Werte: `taskprocesswiki_pageasset_itemspace_gdpr_recordsupport_requestasset_objectchat_message`
`entity_id`Pflicht	`string`	–
`space_id`	`string`	Accepted for legacy frontend compatibility only. The backend resolves the trusted space from the parent entity.
`comment`	`string`	–

Antworten

201Erstellt

Beispiel (cURL)

curl -X POST "https://xapi.ambertech.cloud/api/v1/attachments" \
  -H "Authorization: Bearer $XISUITE_TOKEN" \
  -F "file=@./datei.pdf"

Get an attachment with version history#

GET/attachments/{id}Token

Parameter

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

Antworten

200OK

Beispiel (cURL)

curl -X GET "https://xapi.ambertech.cloud/api/v1/attachments/{id}" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

Delete an attachment and all versions#

DELETE/attachments/{id}Token

Parameter

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

Antworten

200OK

Beispiel (cURL)

curl -X DELETE "https://xapi.ambertech.cloud/api/v1/attachments/{id}" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

Check in an attachment#

POST/attachments/{id}/checkinToken

Parameter

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

Antworten

200OK

Beispiel (cURL)

curl -X POST "https://xapi.ambertech.cloud/api/v1/attachments/{id}/checkin" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

Check out an attachment#

POST/attachments/{id}/checkoutToken

Parameter

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

Request-Body`application/jsonCheckoutAttachmentDto`

Name	Typ	Beschreibung
`note`	`object`	–

Antworten

200OK

Beispiel (cURL)

curl -X POST "https://xapi.ambertech.cloud/api/v1/attachments/{id}/checkout" \
  -H "Authorization: Bearer $XISUITE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"note":{}}'

Message the current checkout owner#

POST/attachments/{id}/checkout-messageToken

Parameter

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

Request-Body`application/jsonCheckoutMessageDto`

Name	Typ	Beschreibung
`message`Pflicht	`string`	–

Antworten

200OK

Beispiel (cURL)

curl -X POST "https://xapi.ambertech.cloud/api/v1/attachments/{id}/checkout-message" \
  -H "Authorization: Bearer $XISUITE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"message":"…"}'

Redirect to a short-lived signed download URL#

GET/attachments/{id}/downloadToken

Parameter

Name	Ort	Typ	Beschreibung
`id`Pflicht	Pfad	`string`	–
`inline`	Query	`string`	Werte: `1`
`v`	Query	`number`	–

Antworten

200OK

Beispiel (cURL)

curl -X GET "https://xapi.ambertech.cloud/api/v1/attachments/{id}/download" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

List File Explorer links for an entity#

GET/attachments/file-linksToken

Parameter

Name	Ort	Typ	Beschreibung
`entityType`Pflicht	Query	`string`	Werte: `taskprocesswiki_pageasset_itemspace_gdpr_recordsupport_requestasset_objectchat_message`
`entityId`Pflicht	Query	`string`	–
`spaceId`	Query	`string`	Accepted for legacy frontend compatibility only. The backend resolves the trusted space from the parent entity.

Antworten

200OK

Beispiel (cURL)

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

Link a File Explorer item to an entity#

POST/attachments/file-linksToken

Request-Body`application/jsonCreateEntityFileLinkDto`

Name	Typ	Beschreibung
`entity_type`Pflicht	`string`	Werte: `taskprocesswiki_pageasset_itemspace_gdpr_recordsupport_requestasset_objectchat_message`
`entity_id`Pflicht	`string`	–
`node_id`Pflicht	`string`	–

Antworten

201Erstellt

Beispiel (cURL)

curl -X POST "https://xapi.ambertech.cloud/api/v1/attachments/file-links" \
  -H "Authorization: Bearer $XISUITE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"entity_type":"task","entity_id":"…","node_id":"…"}'

Remove a File Explorer link from an entity#

DELETE/attachments/file-links/{id}Token

Parameter

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

Antworten

200OK

Beispiel (cURL)

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

Attachments

List centralized attachments for an entity#

Parameter

Antworten

Upload or version a centralized attachment#

Request-Bodymultipart/form-dataUploadAttachmentDto

Antworten

Get an attachment with version history#

Parameter

Antworten

Delete an attachment and all versions#

Parameter

Antworten

Check in an attachment#

Parameter

Antworten

Check out an attachment#

Parameter

Request-Bodyapplication/jsonCheckoutAttachmentDto

Antworten

Message the current checkout owner#

Parameter

Request-Bodyapplication/jsonCheckoutMessageDto

Antworten

Redirect to a short-lived signed download URL#

Parameter

Antworten

List File Explorer links for an entity#

Parameter

Antworten

Link a File Explorer item to an entity#

Request-Bodyapplication/jsonCreateEntityFileLinkDto

Antworten

Remove a File Explorer link from an entity#

Parameter

Antworten

Request-Body`multipart/form-dataUploadAttachmentDto`

Request-Body`application/jsonCheckoutAttachmentDto`

Request-Body`application/jsonCheckoutMessageDto`

Request-Body`application/jsonCreateEntityFileLinkDto`