Files
openclaw-workspace/skills/api-gateway/references/dropbox.md
2026-04-11 09:45:12 -05:00

3.1 KiB

Dropbox Routing Reference

App name: dropbox Base URL proxied: api.dropboxapi.com

API Path Pattern

/dropbox/2/{endpoint}

Important: All Dropbox API v2 endpoints use HTTP POST with JSON request bodies.

Common Endpoints

Users

Get Current Account

POST /dropbox/2/users/get_current_account
Content-Type: application/json

null

Get Space Usage

POST /dropbox/2/users/get_space_usage
Content-Type: application/json

null

Files

List Folder

POST /dropbox/2/files/list_folder
Content-Type: application/json

{
  "path": ""
}

Use empty string "" for root folder.

Continue Listing

POST /dropbox/2/files/list_folder/continue
Content-Type: application/json

{
  "cursor": "..."
}

Get Metadata

POST /dropbox/2/files/get_metadata
Content-Type: application/json

{
  "path": "/document.pdf"
}

Create Folder

POST /dropbox/2/files/create_folder_v2
Content-Type: application/json

{
  "path": "/New Folder",
  "autorename": false
}

Copy

POST /dropbox/2/files/copy_v2
Content-Type: application/json

{
  "from_path": "/source/file.pdf",
  "to_path": "/destination/file.pdf"
}

Move

POST /dropbox/2/files/move_v2
Content-Type: application/json

{
  "from_path": "/old/file.pdf",
  "to_path": "/new/file.pdf"
}

Delete

POST /dropbox/2/files/delete_v2
Content-Type: application/json

{
  "path": "/file-to-delete.pdf"
}
POST /dropbox/2/files/get_temporary_link
Content-Type: application/json

{
  "path": "/document.pdf"
}

Search Files

POST /dropbox/2/files/search_v2
Content-Type: application/json

{
  "query": "document"
}

Revisions

List Revisions

POST /dropbox/2/files/list_revisions
Content-Type: application/json

{
  "path": "/document.pdf"
}

Tags

Get Tags

POST /dropbox/2/files/tags/get
Content-Type: application/json

{
  "paths": ["/document.pdf"]
}

Add Tag

POST /dropbox/2/files/tags/add
Content-Type: application/json

{
  "path": "/document.pdf",
  "tag_text": "important"
}

Remove Tag

POST /dropbox/2/files/tags/remove
Content-Type: application/json

{
  "path": "/document.pdf",
  "tag_text": "important"
}

Pagination

Dropbox uses cursor-based pagination:

POST /dropbox/2/files/list_folder
# Response includes "cursor" and "has_more": true/false

POST /dropbox/2/files/list_folder/continue
# Use cursor from previous response

Notes

  • All endpoints use POST method
  • Request bodies are JSON
  • Use empty string "" for root folder path
  • Paths are case-insensitive but case-preserving
  • Tag text must match pattern [\w]+ (alphanumeric and underscores)
  • Temporary links expire after 4 hours

Resources