filestorage/folders

Create Folders

Changed on

Create Folders in any supported Filestorage software

post/filestorage/folders

Request

  • Base URL
    https://api.panora.dev
  • URL
    https://api.panora.dev/filestorage/folders
  • Auth
    API key in header x-api-key

Query parameters

remote_databoolean

Set to true to include data from the original Accounting software.

Headers

x-connection-tokenstring required

The connection token

Request body

namestring nullable required

The name of the folder

sizestring nullable required

The size of the folder

folder_urlstring nullable required

The url of the folder

descriptionstring required

The description of the folder

drive_idstring nullable required

The UUID of the drive tied to the folder

parent_folder_idstring nullable required

The UUID of the parent folder

shared_linkstring nullable required

The UUID of the shared link tied to the folder

permissionstring nullable required

The UUID of the permission tied to the folder

field_mappingsobject nullable

The custom field mappings of the object between the remote 3rd party & Panora

Example request

{
  "name": "school",
  "size": "2048",
  "folder_url": "https://example.com/school",
  "description": "All things school related",
  "drive_id": "801f9ede-c698-4e66-a7fc-48d19eebaa4f",
  "parent_folder_id": "801f9ede-c698-4e66-a7fc-48d19eebaa4f",
  "shared_link": "801f9ede-c698-4e66-a7fc-48d19eebaa4f",
  "permission": "801f9ede-c698-4e66-a7fc-48d19eebaa4f",
  "field_mappings": {
    "fav_dish": "broccoli",
    "fav_color": "red"
  }
}

Response

namestring nullable required

The name of the folder

sizestring nullable required

The size of the folder

folder_urlstring nullable required

The url of the folder

descriptionstring required

The description of the folder

drive_idstring nullable required

The UUID of the drive tied to the folder

parent_folder_idstring nullable required

The UUID of the parent folder

shared_linkstring nullable required

The UUID of the shared link tied to the folder

permissionstring nullable required

The UUID of the permission tied to the folder

field_mappingsobject nullable

The custom field mappings of the object between the remote 3rd party & Panora

idstring nullable

The UUID of the folder

remote_idstring nullable

The remote ID of the folder in the context of the 3rd Party

remote_dataobject nullable

The remote data of the folder in the context of the 3rd Party

created_atstring date-time nullable

The created date of the folder

modified_atstring date-time nullable

The modified date of the folder

Example response

{
  "name": "school",
  "size": "2048",
  "folder_url": "https://example.com/school",
  "description": "All things school related",
  "drive_id": "801f9ede-c698-4e66-a7fc-48d19eebaa4f",
  "parent_folder_id": "801f9ede-c698-4e66-a7fc-48d19eebaa4f",
  "shared_link": "801f9ede-c698-4e66-a7fc-48d19eebaa4f",
  "permission": "801f9ede-c698-4e66-a7fc-48d19eebaa4f",
  "field_mappings": {
    "fav_dish": "broccoli",
    "fav_color": "red"
  },
  "id": "801f9ede-c698-4e66-a7fc-48d19eebaa4f",
  "remote_id": "id_1",
  "remote_data": {
    "fav_dish": "broccoli",
    "fav_color": "red"
  },
  "created_at": "2024-10-01T12:00:00Z",
  "modified_at": "2024-10-01T12:00:00Z"
}

Changes

  • 3ce49f5aad53Revision changes
    • info

      the query request parameter remote_data became optional

  • ca213ae36b7fRevision changes
    • breaking

      the response property became nullable for the status

    • breaking

      the response property became nullable for the status

    • breaking

      the response property became nullable for the status

    • breaking

      the response property became nullable for the status

    • breaking

      the response property became nullable for the status

    • breaking

      the response property became nullable for the status

    • breaking

      the response property became nullable for the status

    • breaking

      the response property became nullable for the status

    • breaking

      the response property became nullable for the status

    • breaking

      the response property became nullable for the status

    • breaking

      the response property became nullable for the status

    • breaking

      the response property became nullable for the status

    • breaking

      the response property became nullable for the status

    • breaking

      the response property became optional for the status

    • breaking

      the response property became optional for the status

    • breaking

      the response property became optional for the status

    • breaking

      the response property became optional for the status

    • breaking

      the response's property type changed from object to string, and format from no format to date-time for status

    • breaking

      the response's property type changed from object to string, and format from no format to date-time for status

    • info

      the endpoint scheme security bearer was removed from the API

    • info

      the request property became nullable

    • info

      the request property became nullable

    • info

      the request property became nullable

    • info

      the request property became nullable

    • info

      the request property became nullable

    • info

      the request property became nullable

    • info

      the request property became nullable

    • info

      the request property became nullable

    • info

      the request property became optional