Create external file - Veryfront

createExternalFile(projectReference: String!, provider: ExternalFileProvider!, input: CreateExternalFileInput!): ExternalStorageFile!

Requires project.integrations.connect.

Arguments

Argument	Type	Required	Description
`projectReference`	`String!`	Yes	Project ID or slug. Requires project.integrations.connect through the caller’s own personal provider connection.
`provider`	`ExternalFileProvider!`	Yes	Storage provider accessed through the caller’s own personal connection. A human caller is required; agent, run, and service-account credentials are refused.
`input`	`CreateExternalFileInput!`	Yes

Input fields

input

CreateExternalFileInput

Field	Type	Required	Description
`folderId`	`String!`	Yes	Parent folder item ID or root.
`name`	`String!`	Yes	Creates a new file without replacing an existing one. OneDrive and SharePoint return conflict for an existing name; Google Drive creates a new item with the same name. File name, 1-255 characters without a slash.
`content`	`String!`	Yes	File content, at most 10,000,000 characters as sent.
`contentEncoding`	`ExternalFileContentEncoding`	No	utf8 (default) or base64.
`mimeType`	`String`	No	MIME type; derived from the name when omitted.
`idempotencyKey`	`String`	No	1-128 characters without whitespace. A retry with the same key and input within 24 hours returns the first file instead of creating another.

Response

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

Field	Type	Description
`id`	`ID!`
`provider`	`String!`	Provider that stores the item: onedrive, sharepoint or drive.
`name`	`String!`
`path`	`String!`
`mimeType`	`String!`
`sizeBytes`	`Float!`
`kind`	`String!`
`parentId`	`String`	Provider 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

mutation CreateExternalFile($projectReference: String!, $provider: ExternalFileProvider!, $input: CreateExternalFileInput!) {
  createExternalFile(projectReference: $projectReference, provider: $provider, input: $input) {
    id
    name
    etag
    kind
    mimeType
  }
}

{
  "projectReference": "example-project",
  "provider": "drive",
  "input": {
    "folderId": "root",
    "name": "notes.txt",
    "content": "hello",
    "contentEncoding": "utf8"
  }
}