picsart_drive
ActiveTool of Picsart GenAI
Single entry point for the authenticated user's Picsart Drive. Pass `action`: - `list`: browse a folder. `folderUid` omitted = Drive root; set it to descend. Folders are returned first; files are paginated (`page`, `pageSize`<=128, optional `sort`, optional `type` filter). Set `flat: true` to list every file across all folders (folders are omitted in flat mode). - `create_folder`: requires `name`; `folderUid` = parent (omit for root). Optional `description`. - `upload`: save a file. Provide EITHER `file` (chat attachment) OR `url`+`name` (an HTTPS URL or an inline `data:` URI — data URIs are pushed to the Picsart CDN first). `folderUid` = destination, `type` = resource kind. `result.url` is the CDN-hosted URL of the saved file, ready to pass to `picsart_generate` reference params like `imageUrls`. - `move`: requires `itemUids`; `targetFolderUid` = destination (omit = root). - `delete`: requires `itemUids`; soft-deletes to trash unless `permanent` is true. - `update`: requires `itemUid` + `attributes`; sets custom key/value attributes on a file (e.g. `{ coverUrl }`). Every action returns the current folder listing (folders, files, page math) so the widget can render. Requires Authorization: Bearer <picsart_token> (per-user Drive content).
Parameters schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"action"
],
"properties": {
"url": {
"type": "string",
"format": "uri"
},
"file": {
"type": "object",
"required": [
"download_url",
"file_id"
],
"properties": {
"file_id": {
"type": "string"
},
"file_name": {
"type": "string"
},
"mime_type": {
"type": "string"
},
"download_url": {
"type": "string",
"format": "uri"
}
},
"additionalProperties": false
},
"flat": {
"type": "boolean",
"description": "List action: when true, returns every file across the whole Drive (all folders) instead of just the items directly inside `folderUid`. Folders are not returned in flat mode."
},
"name": {
"type": "string"
},
"page": {
"type": "integer",
"exclusiveMinimum": 0
},
"sort": {
"type": "object",
"required": [
"by",
"order"
],
"properties": {
"by": {
"enum": [
"CREATED",
"UPDATED",
"ALPHABETICAL"
],
"type": "string"
},
"order": {
"enum": [
"ASC",
"DESC"
],
"type": "string"
}
},
"additionalProperties": false
},
"type": {
"enum": [
"image",
"video",
"audio"
],
"type": "string"
},
"action": {
"enum": [
"list",
"create_folder",
"upload",
"move",
"delete",
"update"
],
"type": "string"
},
"itemUid": {
"type": "string",
"description": "Update action: uid of the file whose attributes to set."
},
"itemUids": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 200
},
"pageSize": {
"type": "integer",
"maximum": 128,
"exclusiveMinimum": 0
},
"folderUid": {
"type": "string"
},
"permanent": {
"type": "boolean",
"description": "Delete action: true permanently purges; false/omitted moves to trash (recoverable)."
},
"attributes": {
"type": "object",
"description": "Update action: custom key/value attributes to set on the file (e.g. `{ coverUrl }`).",
"additionalProperties": {
"type": "string"
}
},
"description": {
"type": "string"
},
"targetFolderUid": {
"type": "string"
}
},
"additionalProperties": false
}No endpoints wrapped at confidence ≥ 0.70.
Parent server
Picsart GenAI
1/7 registries