Creeaza folder

Creeaza un folder nou în cadrul folderului partajat.

Endpoint

POST /api/v1/shares/{token}/items

Parametri

Parametri URL

Parametru	Tip	Obligatoriu	Descriere
token	string	yes	-

Parametri body

Parametru	Tip	Obligatoriu	Descriere
name	string	yes	Numele noului folder.
parent_id	uuid	no	ID-ul folderului părinte. Dacă nu este setat, folderul va fi creat în directorul principal al folderului partajat.

Exemplu de cerere

cURL

curl --location --request POST 'https://files.ro/api/v1/shares/{token}/items' \
--header 'Content-Type: application/json' \
--data-raw '{
  "name": "New Folder"
}'

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": "Access Denied"
}

422 Unprocessable Entity

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