Create external folder

createExternalFolder(input: ExternalStorageFolderInput!): ExternalStorageFile!

Requires project.integrations.connect.

Arguments

ArgumentTypeRequired
inputExternalStorageFolderInput!Yes

Input fields

input

ExternalStorageFolderInput

FieldTypeRequiredDescription
providerString!YesStorage provider accessed through the caller's own personal connection. A human caller is required; agent, run, and service-account credentials are refused.
projectReferenceStringNoProject ID or slug. Requires project.integrations.connect through the caller's own personal provider connection.
folderIdStringNoParent folder item ID or root.
parentIdStringNo
nameString!Yes
idempotencyKeyStringNo1-128 characters without whitespace. A retry with the same key and input within 24 hours returns the first folder.

Response

Returns ExternalStorageFile!. Open the type for its fields and nested types.

FieldTypeDescription
idID!
providerString!Provider that stores the item: onedrive, sharepoint or drive.
nameString!
pathString!
mimeTypeString!
sizeBytesFloat!
kindString!
parentIdStringProvider ID of the parent folder, or null.

All fields of ExternalStorageFile.

Types marked with ! cannot be null. Lists use [Type] notation. The type index lists all published input and response types.

Example

graphql
mutation CreateExternalFolder($input: ExternalStorageFolderInput!) {
  createExternalFolder(input: $input) {
    id
    name
    etag
    kind
    mimeType
  }
}
json
{
  "input": {
    "provider": "drive",
    "projectReference": "example-project",
    "name": "example"
  }
}