v1

latestOpenAPI 3.0.32026-08-061810496.7 KB

Secure spaces & folders

Create secure space or folder

post/api/1/folders

Request body

namestring required

Must not be greater than 255 characters.

secured_spaceboolean nullable

scope'private' | 'public' nullable

parentinteger nullable

parent_urlstring nullable

copy_permissions_from_parentboolean nullable

templateinteger nullable

copy-contentsinteger nullable

emailsstring[] required

Must be a valid email address.

messagestring nullable

priorityinteger nullable

show_previewboolean nullable

Example request

{
  "name": "b",
  "scope": "public",
  "parent": 16,
  "template": 16,
  "copy-contents": 16,
  "emails": [
    "zbailey@example.net"
  ],
  "priority": 16,
  "show_preview": true
}

Response

IDinteger

@typestring

@idstring

Accessstring

Linkstring

OriginalLinkstring

URLstring

created_atstring

deleted_atstring nullable

expires_atstring nullable

updated_atstring

Scopestring

Namestring

SecuredSpaceboolean

MessagesModeinteger

CreateFolderPolicystring nullable

Example response

{
  "ID": 369240,
  "@type": "Folder",
  "@id": "folder_369240",
  "Access": "private",
  "Link": "/vf/hvHTzgCeCO/eFVS94QgqJOx7dCY",
  "OriginalLink": "/vf/hvHTzgCeCO/eFVS94QgqJOx7dCY",
  "URL": "hvHTzgCeCO/eFVS94QgqJOx7dCY",
  "created_at": "2026-06-29T18:54:47.000000Z",
  "deleted_at": null,
  "expires_at": null,
  "updated_at": "2026-06-29T18:54:47.000000Z",
  "creator": {
    "ID": 28146,
    "@type": "User",
    "Title": null,
    "Name": "Lafayette Considine",
    "FirstName": "Lafayette",
    "LastName": "Considine",
    "Avatar": "https://alex-macbook.tail9fea4c.ts.net/images/avatar_male.png",
    "Scope": "external",
    "HasContact": false
  },
  "Scope": "external",
  "Name": "Bailey Ltd",
  "SecuredSpace": false,
  "MessagesMode": 0,
  "CreateFolderPolicy": null
}