Bold360 and BoldChat Developer Center

getFolder

Returns full detail for a specified folder.

Input parameter

Parameter Type Required Description
FolderID numeric - ID code Yes The identifier of the folder to retrieve.

Request format

curl "https://api.boldchat.com/aid/$accountID/data/rest/json/v1/getFolder?auth=$authHash&FolderID=$FolderID"

Return values

Parameters are provided in alphabetic order. See Sample code for probable output.

Parameter Type Description
Status codes - set values "Success" when the call completes; "Error" when the call fails.
Data text - heading JSON array heading that precedes report data output.
DeletedBy string (max) The name of the agent who deleted the item. <None> or null value indicates that the <resource> was not deleted.
AccountID numeric - ID code Bold360 product account.
Updated date - ISO / UTC Date and time when the <event/record> was most recently modified.
FolderID numeric The ID of the folder.
ParentFolderID numeric - ID code The system-assigned ID of the folder's parent.
Name string(30) The name of the folder as defined in the system.
Created date - ISO/UTC Date and time when the target resource was created.
FolderFlags code - set values The following flags can be applied on folders:
  • 0 - NONE
  • 1 - DISABLE_NEW
  • 2 - DISABLE_RENAME
  • 4 - DISABLE_DELETE
  • 8 - INVISIBLE_PRE_416 - CALL
Deleted date - ISO / UTC Date and time when the item was deleted. The value is null if the item was not deleted.
FolderType integer Related data item type:
  • 2 - Contacts
  • 3 - Tickets
  • 4 - Email
  • 5 - Chats
  • 6 - Visits
  • 7 - Reports
  • 8 - Canned messages for chats
  • 9 - Canned messages for emails
  • 10 - Brandings
  • 11 - Contact user categories
  • 12 - Chat button definitions
  • 13 - Invitation definitions
  • 14 - Chat window definitions
  • 15 - Departments
  • 16 - Email accounts
  • 17 - Agents
  • 18 - Contact user statuses
  • 19 - Website definitions
  • 20 - Chat user categories
  • 21 - Chat user statuses
  • 22 - Email user categories
  • 23 - Email user statuses
  • 24 - Ticket user categories
  • 25 - Ticket user statuses
  • 26 - Customer user categories
  • 27 - Customer user statuses
  • 28 - Permission groups
  • 29 - Chat invitation template variants
  • 30 - Contact custom fields 1
  • 31 - Contact custom fields 2
  • 32 - Chat custom fields 1
  • 33 - Chat custom fields 2
  • 34 - Email custom fields 1
  • 35 - Email custom fields 2
  • 36 - Ticket custom fields 1
  • 37 - Ticket custom fields 2
  • 38 - Customer referrers
  • 39 - Customer entry locations
  • 40 - Conversion codes
  • 41 - Conversions
  • 42 - Call user categories
  • 43 - Call user statuses
  • 44 - Call custom fields 1
  • 45 - Call custom fields 2
  • 48 - Call button definitions
  • 49 - Call window definitions
  • 50 - Calls
  • 51 - Call invitation template variants
  • 55 - External CRMs
  • 57 - Active Assists
  • 58 - Latitude and longitude coordinates
  • 59 - Co-browse bookmarks
  • 60 - Scheduled reports
  • 61 - Email redirects
  • 62 - XMPP clients
  • 65 - Knowledge Bases
  • 66 - Discussions
  • 67 - Languages
  • 73 - SMS
  • 74 - Text receiver
  • 75 - Canned messages for text messages
  • 76 - Text user categories
  • 77 - Text user statuses
  • 78 - Text custom fields 1
  • 79 - Text custom fields 2
  • 80 - Floating chat button definitions
  • 81 - Floating call button definitions
  • 82 - Twitter
  • 83 - Twitter accounts

Sample code

{
    "Status": "success",
    "Data": {
        "DeletedBy": null,
        "AccountID": "447307236667849894",
        "Updated": "2019-09-25T13:57:07.833Z",
        "FolderID": "445200405554148981",
        "ParentFolderID": null,
        "Name": "Tweets",
        "Created": "2019-09-25T13:57:07.833Z",
        "FolderFlags": "7",
        "Deleted": null,
        "FolderType": 82
}