For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Scout DocsAccess Scout
API & SDK
API & SDK
  • Endpoints
      • POSTUpload files to Drive.
      • GETDownload a file from Drive.
LogoLogo
Scout DocsAccess Scout
EndpointsDrive

Upload files to Drive.

POST
https://api.scoutos.com/drive/upload
POST
/drive/upload
$curl -X POST https://api.scoutos.com/drive/upload \
>     -H "Authorization: Bearer <token>" \
>     -H "Content-Type: multipart/form-data" \
>     -F "files[]"=@project_proposal.pdf \
>     -F "files[]"=@team_photo.jpg
1{
2  "data": [
3    {
4      "url": "https://drive.example.com/files/12345/download",
5      "name": "project_proposal.pdf",
6      "id": "file-12345",
7      "path": "/documents/project_proposal.pdf"
8    },
9    {
10      "url": "https://drive.example.com/files/67890/download",
11      "name": "team_photo.jpg",
12      "id": "file-67890",
13      "path": "/images/team_photo.jpg"
14    }
15  ]
16}
Upload one or more files to Drive. - `files`: the file uploads (multipart) - `metadata`: a JSON string containing a list of per-file metadata dicts, positionally aligned with `files`. Each dict may contain: - `path` — fully qualified destination path (takes precedence) - `folder` — destination folder - `name` — destination filename Resolution logic for each file at index i: - If path is provided, use it as the fully qualified path - Else if folder and name are provided, combine as {folder}/{name} - Else if folder is provided, combine as {folder}/{upload_filename} - Else if name is provided, use /{name} (root) - Else fall back to None (domain default behavior)
Was this page helpful?
Previous

Download a file from Drive.

Next
Built with

Upload one or more files to Drive.

  • files: the file uploads (multipart)
  • metadata: a JSON string containing a list of per-file metadata dicts, positionally aligned with files. Each dict may contain:
    • path — fully qualified destination path (takes precedence)
    • folder — destination folder
    • name — destination filename

Resolution logic for each file at index i:

  • If path is provided, use it as the fully qualified path
  • Else if folder and name are provided, combine as {folder}/{name}
  • Else if folder is provided, combine as {folder}/{upload_filename}
  • Else if name is provided, use /{name} (root)
  • Else fall back to None (domain default behavior)

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects a multipart form with multiple files.
filesfilesRequired
metadatastring or nullOptional

Response

Successful Response
datalist of objects

Errors

422
Unprocessable Entity Error