Folders

>>>

GET /api/v4/folders
List of media_folders

Request headers ↑

Only registered user can perform this action
  Authentication - string - required
    Example of Authentication header : "Bearer TOKEN_FETCHED_FROM_SERVER_DURING_REGISTRATION"

Success response body ↑

{
  "my_folders": 54,
  "shared_folders": null,
  "stock_folders": 49,
  "content_request": 1
}
>>>

GET /api/v4/folders/:id
Show media_folder

Request headers ↑

Only registered user can perform this action
  Authentication - string - required
    Example of Authentication header : "Bearer TOKEN_FETCHED_FROM_SERVER_DURING_REGISTRATION"

Success response body ↑

{
  "id": 1,
  "name": "Stock folder",
  "elements_count": 0,
  "ancestors": [],
  "folders": [
    {
      "id": 2,
      "name": "Folder in folder",
      "children_exist": false,
      "user": {
        "id": 11,
        "email": "kruchina.vadim+2@gmail.com",
        "first_name": null,
        "last_name": "Stone",
        "avatar_image": null
      }
    },
    ...
  ],
  "user": {
    "id": 11,
    "email": "kruchina.vadim+2@gmail.com",
    "first_name": null,
    "last_name": "Stone",
    "avatar_image": null
  }
}

Params

Param name Description
id
required

ID of media folder

Validations:

  • Must be a Integer
sort_by
optional

Validations:

  • Must be one of: created_at, name.
sort_to
optional

Validations:

  • Must be one of: asc, desc.
>>>

POST /api/v4/folders
Create media_folder

Request headers ↑

Only registered user can perform this action
  Authentication - string - required
    Example of Authentication header : "Bearer TOKEN_FETCHED_FROM_SERVER_DURING_REGISTRATION"

Request body example ↑

{
  "folder": {
    "name": "Postman folder"
    "ancestry": "64"
  }
}

Success response body ↑

{
  "id": 65,
  "name": "Postman folder"
}

Params

Param name Description
folder
required

Validations:

  • Must be a Hash
folder[name]
required

Name of media folder

Validations:

  • Must be a String
folder[ancestry]
optional

ID of parrent folder

Validations:

  • Must be a String
>>>

PUT /api/v4/folders/:id
Update media_folder

Request headers ↑

Only registered user can perform this action
  Authentication - string - required
    Example of Authentication header : "Bearer TOKEN_FETCHED_FROM_SERVER_DURING_REGISTRATION"

Request body example ↑

{
  "folder": {
    "name": "Updated Postman folder"
  }
}

Success response body ↑

{
  "id": 65,
  "name": "Updated Postman folder"
}

Params

Param name Description
id
required

ID of media folder

Validations:

  • Must be a Integer
folder
required

Validations:

  • Must be a Hash
folder[name]
required

Name of media folder

Validations:

  • Must be a String
folder[ancestry]
required

ID of parrent folder

Validations:

  • Must be a String