Actualizează folder de echipă

Actualizează membrii folderului de echipă sau invita membri noi.

Endpoint

PATCH /api/v1/teams/folders/{folder_id}

Parametri

Parametri URL

Parametru	Tip	Obligatoriu	Descriere
folder_id	string	yes	-

Parametri body

Parametru	Tip	Obligatoriu	Descriere
invitations	array	yes	Lista invitaților curenți. Dacă vrei să inviți un membru nou, include-l în lista de invitații. Dacă vrei să ștergi o invitație, șterge membrul din lista de invitații. Backend-ul sincronizează lista.
members	array	yes	Lista membrilor actuali. Dacă elimini un membru din listă, acesta va fi eliminat din membrii folderului de echipă. Backend-ul sincronizează lista.
invitations.*.email	string	yes	Adresa de email a utilizatorului
invitations.*.permission	string	yes	Permisiunea pentru utilizator. Poate fi can-edit sau can-view.
invitations.*.type	string	yes	Tipul obiectului, valoarea invitation este obligatorie.
members.*.id	uuid	yes	Adresa de email a utilizatorului
members.*.permission	string	yes	Permisiunea pentru utilizator. Poate fi can-edit sau can-view.

Exemplu de cerere

cURL

curl --location --request PATCH 'https://files.ro/api/v1/teams/folders/{folder_id}' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {token}' \
--data-raw '{
  "invitations": [
    {
      "email": "jane@doe.com",
      "permission": "can-view",
      "type": "invitation"
    },
    {
      "email": "pepe@doe.com",
      "permission": "can-view",
      "type": "invitation"
    }
  ],
  "members": [
    {
      "permission": "can-edit",
      "id": "{user_id}"
    }
  ]
}'

Răspuns

201 Created

{
  "data": {
    "id": "folder_123",
    "type": "folder",
    "attributes": {
      "name": "Projects",
      "color": "#00BC7E",
      "emoji": null,
      "filesize": 12345678,
      "isTeamFolder": false,
      "items": 12,
      "trashed_items": 0,
      "created_at": "01. Jan. 2024",
      "updated_at": "02. Jan. 2024",
      "deleted_at": null
    },
    "relationships": {
      "shared": {
        "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"
          }
        }
      },
      "parent": {
        "data": {
          "type": "folder",
          "id": "folder_root",
          "attributes": {
            "name": "Root"
          }
        }
      },
      "user": {
        "data": {
          "type": "user",
          "id": "user_123",
          "attributes": {
            "name": "Jane Doe",
            "avatar": "https://files.ro/storage/avatars/jane.png",
            "color": "#00BC7E"
          }
        }
      }
    }
  }
}

403 Forbidden

{
  "type": "error",
  "message": "You exceed your members limit."
}

403 Forbidden

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

401 Unauthorized

{
  "type": "error",
  "message": "You are not authorized"
}

422 Unprocessable Entity

{
  "message": "The given data was invalid.",
  "errors": {
    "field": [
      "The field is required."
    ]
  }
}