Actualizează partajarea

Actualizează fișierul sau folderul partajat public.

Endpoint

PATCH /api/v1/share/{token}

Parametri

Parametri URL

Parametru	Tip	Obligatoriu	Descriere
token	string	yes	-

Parametri body

Parametru	Tip	Obligatoriu	Descriere
protected	boolean	-	Determină dacă folderul este partajat public sau protejat privat cu parolă.
password	string	obligatoriu când ispassword:yes	Parola care protejează conținutul din folder.
permission	string	obligatoriu când este folder	Permisiunile de editare pentru folder. Tipuri permise: editor sau visitor.
expiration	integer	-	Timpul în ore după care linkul expiră automat.

Exemplu de cerere

cURL

curl --location --request PATCH 'https://files.ro/api/v1/share/{token}' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {token}' \
--data-raw '{
  "protected": true,
  "password": "test",
  "permission": "editor",
  "expiration": 1
}'

Răspuns

200 OK

{
  "data": {
    "id": "share_123",
    "type": "shared",
    "attributes": {
      "permission": "editor",
      "protected": false,
      "item_id": "item_123",
      "expire_in": 24,
      "token": "share_token",
      "link": "https://files.ro/share/share_token",
      "type": "folder"
    }
  }
}

422 Unprocessable Entity

{
  "type": "error",
  "message": "The permission field for folder is required."
}

403 Forbidden

{
  "message": "This action is unauthorized."
}