Skip to main content
POST
/
providers
/
{provider}
/
folders
Create provider folder
curl --request POST \
  --url https://api.veryfront.com/providers/{provider}/folders \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "project_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "parent_id": "<string>",
  "name": "<string>"
}
'
{
  "id": "<string>",
  "name": "<string>",
  "path": "<string>",
  "mime_type": "<string>",
  "size": 123,
  "is_folder": true,
  "modified_at": "<string>",
  "thumbnail": "<string>"
}

Authorizations

​
Authorization
string
header
required

Use a JWT bearer token or a Veryfront API key in the Authorization header.

Path Parameters

​
provider
string
required

External storage provider identifier, such as onedrive, sharepoint, or google_drive.

Body

application/json
​
project_id
string<uuid>
required

Project ID used for provider write authorization.

​
parent_id
string
required

Provider folder ID where the folder should be created.

​
name
string
required

Folder name to create in the provider.

Response

Created folder

​
id
string
required

Provider-specific file or folder ID.

​
name
string
required

File or folder name.

​
path
string
required

Provider path for the file or folder.

​
mime_type
string
required

MIME type or folder for folders.

​
size
number
required

File size in bytes. Folders may report 0.

​
is_folder
boolean
required

Whether this item is a folder.

​
modified_at
string
required

Provider modified timestamp.

​
thumbnail
string

Optional provider thumbnail URL.