Response [200 Ok]

Uri /api/v2/folder/user/michaelmileyphotography/Travel
UriDescription A folder or legacy (sub)category by UrlPath
EndpointType Folder
Locator Folder
LocatorType Object

Folder [1 of 1] - Travel
/api/v2/folder/user/michaelmileyphotography/Travel

Uri /api/v2/folder/user/michaelmileyphotography/Travel
UriDescription A folder or legacy (sub)category by UrlPath
ResponseLevel Public
DateAdded 2015-02-09T20:24:39+00:00
DateModified 2015-02-20T14:19:46+00:00
Description Wedding, portrait & commercial photographer in Carlow & Leinster area
IsEmpty false
Keywords carlow photographer; carlow photographers; leinster photographer; photographer; photographers; wedding photographer; wedding photographers; portrait; newborn; family photographer; callout; baby photographer; carlow area; leinster area; photography
Name Travel
NodeID 9m8rz
PasswordHint empty string
SecurityType None
SortDirection Descending
SortMethod DateModified
UrlName Travel
UrlPath /Travel
WebUri http://www.michaelmileyphotography.ie/Travel

Uris

AlbumList
/api/v2/folder/user/michaelmileyphotography/Travel!albumlist

Uri /api/v2/folder/user/michaelmileyphotography/Travel!albumlist
UriDescription List of user's albums
EndpointType AlbumList
Locator AlbumList
LocatorType List

FolderAlbums
/api/v2/folder/user/michaelmileyphotography/Travel!albums

Uri /api/v2/folder/user/michaelmileyphotography/Travel!albums
UriDescription Albums inside of the folder
EndpointType FolderAlbums
Locator Album
LocatorType Objects

FolderByID
/api/v2/folder/id/9m8rz

Uri /api/v2/folder/id/9m8rz
UriDescription Get folder by its ID
EndpointType FolderByID
Locator Folder
LocatorType Object

FolderHighlightImage
/api/v2/folder/user/michaelmileyphotography/Travel!highlightimage

Uri /api/v2/folder/user/michaelmileyphotography/Travel!highlightimage
UriDescription Highlight image for folder
EndpointType FolderHighlightImage
Locator Image
LocatorType Object

FolderList
/api/v2/folder/user/michaelmileyphotography/Travel!folderlist

Uri /api/v2/folder/user/michaelmileyphotography/Travel!folderlist
UriDescription Recursive list of all of the user's folders
EndpointType FolderList
Locator FolderList
LocatorType List

FolderPages
/api/v2/folder/user/michaelmileyphotography/Travel!pages

Uri /api/v2/folder/user/michaelmileyphotography/Travel!pages
UriDescription Pages inside of the folder
EndpointType FolderPages
Locator Page
LocatorType Objects

Folders
/api/v2/folder/user/michaelmileyphotography/Travel!folders

Uri /api/v2/folder/user/michaelmileyphotography/Travel!folders
UriDescription Folders inside of the folder
EndpointType Folders
Locator Folder
LocatorType Objects

HighlightImage
/api/v2/highlight/node/9m8rz

Uri /api/v2/highlight/node/9m8rz
UriDescription Highlight image for a folder, album, or page
EndpointType HighlightImage
Locator Image
LocatorType Object

Node
/api/v2/node/9m8rz

Uri /api/v2/node/9m8rz
UriDescription Node with the given id.
EndpointType Node
Locator Node
LocatorType Object

ParentFolder
/api/v2/folder/user/michaelmileyphotography/Travel!parent

Uri /api/v2/folder/user/michaelmileyphotography/Travel!parent
UriDescription Parent folder
EndpointType ParentFolder
Locator Folder
LocatorType Object

ParentFolders
/api/v2/folder/user/michaelmileyphotography!parents

Uri /api/v2/folder/user/michaelmileyphotography!parents
UriDescription The sequence of parent folders, from the given folder to the root
EndpointType ParentFolders
Locator Folder
LocatorType Objects

Size
/api/v2/folder/user/michaelmileyphotography/Travel!size

Uri /api/v2/folder/user/michaelmileyphotography/Travel!size
UriDescription Size of folder
EndpointType Size
Locator Size
LocatorType Object

User
/api/v2/user/michaelmileyphotography

Uri /api/v2/user/michaelmileyphotography
UriDescription User By Nickname
EndpointType User
Locator User
LocatorType Object

Timing

Total

cycles 1
objects 0
time 0.01853

Options

Path

  • /api
  • /v2
  • /folder
  • /user
  • /
  • /

Notes

  • FolderHighlightImage is deprecated, use HighlightImage instead

Methods

OPTIONS

Permissions
  • Read

GET

Permissions
  • Read

PATCH

Permissions
  • Modify

DELETE

Permissions
  • Modify

Parameters

GET

Output Fields

DateAdded unixtimestamp
DateModified unixtimestamp
Description text
HighlightImageUri uri
IsEmpty boolean Whether this folder contains any albums, folders, or pages.
Keywords text
Name text
NodeID text
Password text
PasswordHint text
Privacy select
  • Public
  • Unlisted
  • Private
SecurityType select
  • None
  • Password
  • GrantAccess
SmugSearchable select
  • No
  • Local
  • LocalUser
  • Yes
  • Inherit from User
SortDirection select
  • Ascending
  • Descending
SortMethod select
  • SortIndex
  • Name
  • DateAdded
  • DateModified
UrlName text
UrlPath text
WorldSearchable select
  • No
  • HomeOnly
  • Yes
  • Inherit from User

JSON

{
    "Request": {
        "Version": "v2",
        "Method": "GET",
        "Uri": "/api/v2/folder/user/michaelmileyphotography/Travel"
    },
    "Options": {
        "MethodDetails": {
            "OPTIONS": {
                "Permissions": [
                    "Read"
                ]
            },
            "GET": {
                "Permissions": [
                    "Read"
                ]
            },
            "PATCH": {
                "Permissions": [
                    "Modify"
                ]
            },
            "DELETE": {
                "Permissions": [
                    "Modify"
                ]
            }
        },
        "Methods": [
            "OPTIONS",
            "GET"
        ],
        "ParameterDescription": {
            "Varchar": "Variable length text from MIN_CHARS to MAX_CHARS (MAX_CHARS = INFINITY meaning arbitrary length)"
        },
        "Parameters": {
            "GET": [
                {
                    "Name": "FolderID",
                    "Required": false,
                    "ReadOnly": false,
                    "Default": "",
                    "Type": "Varchar",
                    "MIN_CHARS": 5,
                    "MAX_CHARS": "INFINITY"
                }
            ]
        },
        "MediaTypes": [
            "application/json",
            "application/vnd.php.serialized",
            "application/x-msgpack",
            "text/html",
            "text/csv"
        ],
        "Output": [
            {
                "Name": "Name",
                "Type": "Varchar",
                "MIN_CHARS": 1,
                "MAX_CHARS": 254
            },
            {
                "Name": "UrlName",
                "Type": "Varchar",
                "MIN_CHARS": 1,
                "MAX_CHARS": 32
            },
            {
                "Name": "SecurityType",
                "Type": "Select",
                "OPTIONS": [
                    "None",
                    "Password",
                    "GrantAccess"
                ],
                "MIN_COUNT": 1,
                "MAX_COUNT": "ALL"
            },
            {
                "Name": "SortMethod",
                "Type": "Select",
                "OPTIONS": [
                    "SortIndex",
                    "Name",
                    "DateAdded",
                    "DateModified"
                ],
                "MIN_COUNT": 1,
                "MAX_COUNT": 1
            },
            {
                "Name": "SortDirection",
                "Type": "Select",
                "OPTIONS": [
                    "Ascending",
                    "Descending"
                ],
                "MIN_COUNT": 1,
                "MAX_COUNT": 1
            },
            {
                "Name": "Description",
                "Type": "Text",
                "MIN_CHARS": 0,
                "MAX_CHARS": 65535
            },
            {
                "Name": "Keywords",
                "Type": "Varchar",
                "MIN_CHARS": 0,
                "MAX_CHARS": 255
            },
            {
                "Name": "Password",
                "Type": "Varchar",
                "MIN_CHARS": 0,
                "MAX_CHARS": 50
            },
            {
                "Name": "PasswordHint",
                "Type": "Varchar",
                "MIN_CHARS": 0,
                "MAX_CHARS": 255
            },
            {
                "Name": "Privacy",
                "Type": "Select",
                "OPTIONS": [
                    "Public",
                    "Unlisted",
                    "Private"
                ],
                "MIN_COUNT": 1,
                "MAX_COUNT": 1
            },
            {
                "Name": "SmugSearchable",
                "Type": "Select",
                "OPTIONS": [
                    "No",
                    "Local",
                    "LocalUser",
                    "Yes",
                    "Inherit from User"
                ],
                "MIN_COUNT": 1,
                "MAX_COUNT": "ALL"
            },
            {
                "Name": "WorldSearchable",
                "Type": "Select",
                "OPTIONS": [
                    "No",
                    "HomeOnly",
                    "Yes",
                    "Inherit from User"
                ],
                "MIN_COUNT": 1,
                "MAX_COUNT": "ALL"
            },
            {
                "Name": "HighlightImageUri",
                "Type": "Uri",
                "MAX_LENGTH": "INFINITY",
                "Locator": [
                    "Image"
                ]
            },
            {
                "Name": "DateAdded",
                "Type": "UnixTimestamp"
            },
            {
                "Name": "DateModified",
                "Type": "UnixTimestamp"
            },
            {
                "Name": "UrlPath",
                "Type": "Varchar",
                "MIN_CHARS": 0,
                "MAX_CHARS": "INFINITY"
            },
            {
                "Name": "NodeID",
                "Type": "Varchar",
                "MIN_CHARS": 1,
                "MAX_CHARS": "INFINITY"
            },
            {
                "Name": "IsEmpty",
                "Description": "Whether this folder contains any albums, folders, or pages.",
                "Type": "Boolean"
            }
        ],
        "Notes": [
            "FolderHighlightImage is deprecated, use HighlightImage instead"
        ],
        "ResponseLevels": [
            "Full",
            "Public",
            "Password",
            "GrantAccess"
        ],
        "Path": [
            {
                "type": "path",
                "text": "api"
            },
            {
                "type": "path",
                "text": "v2"
            },
            {
                "type": "path",
                "text": "folder"
            },
            {
                "type": "path",
                "text": "user"
            },
            {
                "type": "singleparam",
                "param_name": "nickname",
                "param_value": "michaelmileyphotography"
            },
            {
                "type": "multipleparam",
                "param_name": "folder",
                "param_value": [
                    "Travel"
                ]
            }
        ],
        "Deprecated": {
            "Alternative": "/api/v2/node/:nodeid"
        }
    },
    "Response": {
        "Uri": "/api/v2/folder/user/michaelmileyphotography/Travel",
        "Locator": "Folder",
        "LocatorType": "Object",
        "Folder": {
            "Name": "Travel",
            "UrlName": "Travel",
            "SecurityType": "None",
            "SortMethod": "DateModified",
            "SortDirection": "Descending",
            "Description": "Wedding, portrait \u0026 commercial photographer in Carlow \u0026 Leinster area",
            "Keywords": "carlow photographer; carlow photographers; leinster photographer; photographer; photographers; wedding photographer; wedding photographers; portrait; newborn; family photographer; callout; baby photographer; carlow area; leinster area; photography",
            "PasswordHint": "",
            "DateAdded": "2015-02-09T20:24:39+00:00",
            "DateModified": "2015-02-20T14:19:46+00:00",
            "UrlPath": "/Travel",
            "NodeID": "9m8rz",
            "IsEmpty": false,
            "Uri": "/api/v2/folder/user/michaelmileyphotography/Travel",
            "WebUri": "http://www.michaelmileyphotography.ie/Travel",
            "UriDescription": "A folder or legacy (sub)category by UrlPath",
            "Uris": {
                "FolderByID": {
                    "Uri": "/api/v2/folder/id/9m8rz",
                    "Locator": "Folder",
                    "LocatorType": "Object",
                    "UriDescription": "Get folder by its ID",
                    "EndpointType": "FolderByID"
                },
                "Node": {
                    "Uri": "/api/v2/node/9m8rz",
                    "Locator": "Node",
                    "LocatorType": "Object",
                    "UriDescription": "Node with the given id.",
                    "EndpointType": "Node"
                },
                "User": {
                    "Uri": "/api/v2/user/michaelmileyphotography",
                    "Locator": "User",
                    "LocatorType": "Object",
                    "UriDescription": "User By Nickname",
                    "EndpointType": "User"
                },
                "ParentFolders": {
                    "Uri": "/api/v2/folder/user/michaelmileyphotography!parents",
                    "Locator": "Folder",
                    "LocatorType": "Objects",
                    "UriDescription": "The sequence of parent folders, from the given folder to the root",
                    "EndpointType": "ParentFolders"
                },
                "ParentFolder": {
                    "Uri": "/api/v2/folder/user/michaelmileyphotography/Travel!parent",
                    "Locator": "Folder",
                    "LocatorType": "Object",
                    "UriDescription": "Parent folder",
                    "EndpointType": "ParentFolder"
                },
                "HighlightImage": {
                    "Uri": "/api/v2/highlight/node/9m8rz",
                    "Locator": "Image",
                    "LocatorType": "Object",
                    "UriDescription": "Highlight image for a folder, album, or page",
                    "EndpointType": "HighlightImage"
                },
                "FolderHighlightImage": {
                    "Uri": "/api/v2/folder/user/michaelmileyphotography/Travel!highlightimage",
                    "Locator": "Image",
                    "LocatorType": "Object",
                    "UriDescription": "Highlight image for folder",
                    "EndpointType": "FolderHighlightImage"
                },
                "Folders": {
                    "Uri": "/api/v2/folder/user/michaelmileyphotography/Travel!folders",
                    "Locator": "Folder",
                    "LocatorType": "Objects",
                    "UriDescription": "Folders inside of the folder",
                    "EndpointType": "Folders"
                },
                "FolderList": {
                    "Uri": "/api/v2/folder/user/michaelmileyphotography/Travel!folderlist",
                    "Locator": "FolderList",
                    "LocatorType": "List",
                    "UriDescription": "Recursive list of all of the user's folders",
                    "EndpointType": "FolderList"
                },
                "FolderAlbums": {
                    "Uri": "/api/v2/folder/user/michaelmileyphotography/Travel!albums",
                    "Locator": "Album",
                    "LocatorType": "Objects",
                    "UriDescription": "Albums inside of the folder",
                    "EndpointType": "FolderAlbums"
                },
                "AlbumList": {
                    "Uri": "/api/v2/folder/user/michaelmileyphotography/Travel!albumlist",
                    "Locator": "AlbumList",
                    "LocatorType": "List",
                    "UriDescription": "List of user's albums",
                    "EndpointType": "AlbumList"
                },
                "FolderPages": {
                    "Uri": "/api/v2/folder/user/michaelmileyphotography/Travel!pages",
                    "Locator": "Page",
                    "LocatorType": "Objects",
                    "UriDescription": "Pages inside of the folder",
                    "EndpointType": "FolderPages"
                },
                "Size": {
                    "Uri": "/api/v2/folder/user/michaelmileyphotography/Travel!size",
                    "Locator": "Size",
                    "LocatorType": "Object",
                    "UriDescription": "Size of folder",
                    "EndpointType": "Size"
                }
            },
            "ResponseLevel": "Public"
        },
        "UriDescription": "A folder or legacy (sub)category by UrlPath",
        "EndpointType": "Folder",
        "Timing": {
            "Total": {
                "time": 0.01853,
                "cycles": 1,
                "objects": 0
            }
        }
    },
    "Code": 200,
    "Message": "Ok"
}