Response [200 Ok]

Uri /api/v2/folder/user/US-ASEAN/Business-Missions/2020/2020HealthLifeSciencesIndustryMissiontoVietnam?_responseLevel=Public
UriDescription A folder or legacy (sub)category by UrlPath
EndpointType Folder
Locator Folder
LocatorType Object

Folder [1 of 1] - 2020 Health & Life Sciences Industry Mission to Vietnam
/api/v2/folder/user/US-ASEAN/Business-Missions/2020/2020HealthLifeSciencesIndustryMissiontoVietnam

Uri /api/v2/folder/user/US-ASEAN/Business-Missions/2020/2020HealthLifeSciencesIndustryMissiontoVietnam
UriDescription A folder or legacy (sub)category by UrlPath
ResponseLevel Public
DateAdded 2020-03-09T13:49:24+00:00
DateModified 2020-03-09T14:26:52+00:00
Description empty string
IsEmpty false
Keywords empty string
Name 2020 Health & Life Sciences Industry Mission to Vietnam
NodeID fg9kTp
PasswordHint empty string
SecurityType None
SortDirection Descending
SortMethod DateModified
UrlName 2020HealthLifeSciencesIndustryMissiontoVietnam
UrlPath /Business-Missions/2020/2020HealthLifeSciencesIndustryMissiontoVietnam
WebUri https://photos.usasean.org/Business-Missions/2020/2020HealthLifeSciencesIndustryMissiontoVietnam

Uris

FolderByID
/api/v2/folder/id/fg9kTp

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

HighlightImage
/api/v2/highlight/node/fg9kTp

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

Node
/api/v2/node/fg9kTp

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

ParentFolders
/api/v2/folder/user/US-ASEAN/Business-Missions/2020!parents

Uri /api/v2/folder/user/US-ASEAN/Business-Missions/2020!parents
UriDescription The sequence of parent folders, from the given folder to the root
EndpointType ParentFolders
Locator Folder
LocatorType Objects

User
/api/v2/user/US-ASEAN

Uri /api/v2/user/US-ASEAN
UriDescription User By Nickname
EndpointType User
Locator User
LocatorType Object

Timing

Total

cycles 1
objects 0
time 0.03453

Config

{
    "expand_method": "ref",
    "shorturis": false
}

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 datetimeiso8601
DateModified datetimeiso8601
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/US-ASEAN/Business-Missions/2020/2020HealthLifeSciencesIndustryMissiontoVietnam?_responseLevel=Public"
    },
    "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": 1
            },
            {
                "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": 1
            },
            {
                "Name": "WorldSearchable",
                "Type": "Select",
                "OPTIONS": [
                    "No",
                    "HomeOnly",
                    "Yes",
                    "Inherit from User"
                ],
                "MIN_COUNT": 1,
                "MAX_COUNT": 1
            },
            {
                "Name": "HighlightImageUri",
                "Type": "Uri",
                "MAX_LENGTH": "INFINITY",
                "Locator": [
                    "Image"
                ]
            },
            {
                "Name": "DateAdded",
                "Type": "DateTimeISO8601"
            },
            {
                "Name": "DateModified",
                "Type": "DateTimeISO8601"
            },
            {
                "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": "US-ASEAN",
                "param_validator": {}
            },
            {
                "type": "multipleparam",
                "param_name": "folder",
                "param_value": [
                    "Business-Missions",
                    "2020",
                    "2020HealthLifeSciencesIndustryMissiontoVietnam"
                ],
                "param_validator": {}
            }
        ],
        "Deprecated": {
            "Alternative": "/api/v2/node/:nodeid"
        }
    },
    "Response": {
        "Uri": "/api/v2/folder/user/US-ASEAN/Business-Missions/2020/2020HealthLifeSciencesIndustryMissiontoVietnam?_responseLevel=Public",
        "Locator": "Folder",
        "LocatorType": "Object",
        "Folder": {
            "Name": "2020 Health & Life Sciences Industry Mission to Vietnam",
            "UrlName": "2020HealthLifeSciencesIndustryMissiontoVietnam",
            "SecurityType": "None",
            "SortMethod": "DateModified",
            "SortDirection": "Descending",
            "Description": "",
            "Keywords": "",
            "PasswordHint": "",
            "DateAdded": "2020-03-09T13:49:24+00:00",
            "DateModified": "2020-03-09T14:26:52+00:00",
            "UrlPath": "/Business-Missions/2020/2020HealthLifeSciencesIndustryMissiontoVietnam",
            "NodeID": "fg9kTp",
            "IsEmpty": false,
            "Uri": "/api/v2/folder/user/US-ASEAN/Business-Missions/2020/2020HealthLifeSciencesIndustryMissiontoVietnam",
            "WebUri": "https://photos.usasean.org/Business-Missions/2020/2020HealthLifeSciencesIndustryMissiontoVietnam",
            "UriDescription": "A folder or legacy (sub)category by UrlPath",
            "Uris": {
                "FolderByID": {
                    "Uri": "/api/v2/folder/id/fg9kTp",
                    "Locator": "Folder",
                    "LocatorType": "Object",
                    "UriDescription": "Get folder by its ID",
                    "EndpointType": "FolderByID"
                },
                "Node": {
                    "Uri": "/api/v2/node/fg9kTp",
                    "Locator": "Node",
                    "LocatorType": "Object",
                    "UriDescription": "Node with the given id.",
                    "EndpointType": "Node"
                },
                "User": {
                    "Uri": "/api/v2/user/US-ASEAN",
                    "Locator": "User",
                    "LocatorType": "Object",
                    "UriDescription": "User By Nickname",
                    "EndpointType": "User"
                },
                "ParentFolders": {
                    "Uri": "/api/v2/folder/user/US-ASEAN/Business-Missions/2020!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/US-ASEAN/Business-Missions/2020/2020HealthLifeSciencesIndustryMissiontoVietnam!parent",
                    "Locator": "Folder",
                    "LocatorType": "Object",
                    "UriDescription": "Parent folder",
                    "EndpointType": "ParentFolder"
                },
                "HighlightImage": {
                    "Uri": "/api/v2/highlight/node/fg9kTp",
                    "Locator": "Image",
                    "LocatorType": "Object",
                    "UriDescription": "Highlight image for a folder, album, or page",
                    "EndpointType": "HighlightImage"
                },
                "FolderHighlightImage": {
                    "Uri": "/api/v2/folder/user/US-ASEAN/Business-Missions/2020/2020HealthLifeSciencesIndustryMissiontoVietnam!highlightimage",
                    "Locator": "Image",
                    "LocatorType": "Object",
                    "UriDescription": "Highlight image for folder",
                    "EndpointType": "FolderHighlightImage"
                },
                "Folders": {
                    "Uri": "/api/v2/folder/user/US-ASEAN/Business-Missions/2020/2020HealthLifeSciencesIndustryMissiontoVietnam!folders",
                    "Locator": "Folder",
                    "LocatorType": "Objects",
                    "UriDescription": "Folders inside of the folder",
                    "EndpointType": "Folders"
                },
                "FolderList": {
                    "Uri": "/api/v2/folder/user/US-ASEAN/Business-Missions/2020/2020HealthLifeSciencesIndustryMissiontoVietnam!folderlist",
                    "Locator": "FolderList",
                    "LocatorType": "List",
                    "UriDescription": "Recursive list of all of the user's folders",
                    "EndpointType": "FolderList"
                },
                "FolderAlbums": {
                    "Uri": "/api/v2/folder/user/US-ASEAN/Business-Missions/2020/2020HealthLifeSciencesIndustryMissiontoVietnam!albums",
                    "Locator": "Album",
                    "LocatorType": "Objects",
                    "UriDescription": "Albums inside of the folder",
                    "EndpointType": "FolderAlbums"
                },
                "AlbumList": {
                    "Uri": "/api/v2/folder/user/US-ASEAN/Business-Missions/2020/2020HealthLifeSciencesIndustryMissiontoVietnam!albumlist",
                    "Locator": "AlbumList",
                    "LocatorType": "List",
                    "UriDescription": "List of user's albums",
                    "EndpointType": "AlbumList"
                },
                "FolderSearch": {
                    "Uri": "/api/v2/folder/user/US-ASEAN/Business-Missions/2020/2020HealthLifeSciencesIndustryMissiontoVietnam!search",
                    "Locator": "FolderByID",
                    "LocatorType": "Objects",
                    "UriDescription": "Search for folders",
                    "EndpointType": "FolderSearch"
                },
                "FolderPages": {
                    "Uri": "/api/v2/folder/user/US-ASEAN/Business-Missions/2020/2020HealthLifeSciencesIndustryMissiontoVietnam!pages",
                    "Locator": "Page",
                    "LocatorType": "Objects",
                    "UriDescription": "Pages inside of the folder",
                    "EndpointType": "FolderPages"
                },
                "Size": {
                    "Uri": "/api/v2/folder/user/US-ASEAN/Business-Missions/2020/2020HealthLifeSciencesIndustryMissiontoVietnam!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.03453,
                "cycles": 1,
                "objects": 0
            }
        }
    },
    "Code": 200,
    "Message": "Ok"
}