• General
  • My Apps
  • SDKs
  • Protocols
  • Structures
  • Methods
  • Errors
Log in Register Log out
  • General

  • My Apps

  • SDKs
    • C
    • Java
    • Javascript
    • Php
    • Swift

  • Protocols
    • HTTP JSON Protocol
      • Authentication
      • Single Connection
      • Uploading Files
    • Binary Protocol
      • Sending Binary Request
      • Sending Files
      • Receiving Binary Response
      • Receiving Files Data

  • Structures
    • Datetime
    • Event
    • Filenames
    • Metadata
    • Share
    • Tree

  • Methods
    • Intro
      • Global Parameters
      • Authentication
    • General
      • getdigest
      • userinfo
      • supportedlanguages
      • setlanguage
      • feedback
      • currentserver
      • diff
      • getfilehistory
      • getip
      • getapiserver
    • Folder
      • createfolder
      • createfolderifnotexists
      • listfolder
      • renamefolder
      • deletefolder
      • deletefolderrecursive
      • copyfolder
    • File
      • uploadfile
      • uploadprogress
      • downloadfile
      • downloadfileasync
      • copyfile
      • checksumfile
      • deletefile
      • renamefile
      • stat
    • Auth
      • sendverificationemail
      • verifyemail
      • changepassword
      • lostpassword
      • resetpassword
      • register
      • invite
      • userinvites
      • logout
      • listtokens
      • deletetoken
      • sendchangemail
      • changemail
      • senddeactivatemail
      • deactivateuser
    • Streaming
      • getfilelink
      • getvideolink
      • getvideolinks
      • getaudiolink
      • gethlslink
      • gettextfile
    • Archiving
      • getzip
      • getziplink
      • savezip
      • extractarchive
      • extractarchiveprogress
      • savezipprogress
    • Sharing
      • sharefolder
      • listshares
      • sharerequestinfo
      • cancelsharerequest
      • acceptshare
      • declineshare
      • removeshare
      • changeshare
    • Public Links
      • getfilepublink
      • getfolderpublink
      • gettreepublink
      • showpublink
      • getpublinkdownload
      • copypubfile
      • listpublinks
      • listplshort
      • deletepublink
      • changepublink
      • getpubthumb
      • getpubthumblink
      • getpubthumbslinks
      • savepubthumb
      • getpubzip
      • getpubziplink
      • savepubzip
      • getpubvideolinks
      • getpubaudiolink
      • getpubtextfile
      • getcollectionpublink
    • Thumbnails
      • getthumblink
      • getthumbslinks
      • getthumb
      • savethumb
    • Upload Links
      • createuploadlink
      • listuploadlinks
      • deleteuploadlink
      • changeuploadlink
      • showuploadlink
      • uploadtolink
      • uploadlinkprogress
      • copytolink
    • Revisions
      • listrevisions
      • revertrevision
    • Newsletter
      • newsletter_subscribe
      • newsletter_check
      • newsletter_verifyemail
      • newsletter_unsubscribe
      • newsletter_unsibscribemail
    • Trash
      • trash_list
      • trash_restorepath
      • trash_restore
      • trash_clear
    • Collection
      • collection_list
      • collection_details
      • collection_create
      • collection_rename
      • collection_delete
      • collection_linkfiles
      • collection_unlinkfiles
      • collection_move
    • OAuth 2.0
      • authorize
      • oauth2_token
    • Transfer
      • uploadtransfer
      • uploadtransferprogress

  • Errors

Collection

Collections are linked lists of files. The order of the lists is defined. This structure is appropriate for:

  • galleries - collections of images
  • playlists - collections of songs
  • videos
  • documents

Every user has collections that are generated by the server. They are useful for client-side purposes - the client stores his own statistics for these collections and then fills them with this files based on this data.

Please, do not modify or delete system collections.

The collections have the following structure:

FieldDescription
idint number of the collection
namestring name of the collection
createddatetime when the playlist was created
modifieddatetime when the playlist was modified for last time
typestring what type of files could be kept in this list
isminebool is the playlist owned from the current user
systembool if true, then the playlist was genereated by the server.
subtypeint If the collection was generated by the server, this indicates the exact collection type.

Audio collections
  • 1 - Recently Added
  • 2 - Recently Listened
  • 3 - Most Listened
contentsarray list with the metadata of the files in the collection. These fileds are added:
  • added datetime when the item was added to the playlist.
  • position int the position of the item in the collection.

If the collection is shows its contens as pages, then these fields are added:

FieldDescription
pageint the number of the current page. Starts from 1.
pagesizeint how many rows contains a single page. Default is 20.

Items from the collection are automatically unlinked, if the server cannot find these items.

This can occur, if the item was moved to trash or sharing of a folder was stopped.

The collection types are the following: For accessing the API methods:

CodeDescription
0generic collections - all type of files are allowed
1playlists - only audio files are allowed in this collections

Returned in results:

TypeDescription
genericcode=0
audiocode=1

Pages

  • collection_list
  • collection_details
  • collection_create
  • collection_rename
  • collection_delete
  • collection_linkfiles
  • collection_unlinkfiles
  • collection_move
2014 © pCloud. Terms and Conditions. Privacy Policy. Intellectual Property.
© pCloud. Terms and Conditions. Privacy Policy. Intellectual Property.
Reset Password
Check your e-mail for further instructions.
Reset