id: dropbox
name: Dropbox
version: 1.0.0
description: "Dropbox (API v2) — evidence and file handling: search files, get file/folder metadata, list a folder, and create a shared link. Bearer-token authentication; stdlib-only, no extra Python dependencies."
changelog: "1.0.0 — Initial release: search, get metadata, list folder, create shared link."
category: productivity

# Per-instance configuration. Auth header 'Authorization: Bearer <access_token>'.
config_schema:
  properties:
    access_token:
      type: string
      description: "Dropbox access token"
      x-soar-sensitive: true
  required:
    - access_token

commands:
  - id: search
    name: dropbox-search
    description: "Search files and folders by keyword."
    risk: read
    inputs_schema:
      properties:
        query: { type: string, description: "Search query" }
        max_results: { type: number, description: "Max results (default 20)" }
      required: [query]
    outputs_schema: { properties: {} }
  - id: get_metadata
    name: dropbox-get-metadata
    description: "Get metadata for a file or folder by path."
    risk: read
    inputs_schema:
      properties:
        path: { type: string, description: "Path (e.g. /Evidence/report.pdf)" }
      required: [path]
    outputs_schema: { properties: {} }
  - id: list_folder
    name: dropbox-list-folder
    description: "List the contents of a folder."
    risk: read
    inputs_schema:
      properties:
        path: { type: string, description: "Folder path ('' or '/' for root)" }
      required: []
    outputs_schema: { properties: {} }
  - id: create_shared_link
    name: dropbox-create-shared-link
    description: "Create a shared link for a file or folder."
    inputs_schema:
      properties:
        path: { type: string, description: "Path to share" }
      required: [path]
    outputs_schema: { properties: {} }

  - id: test_connection
    name: dropbox-test-connection
    description: "Verify the access token (used by the Test button)."
    risk: read
    inputs_schema:
      properties: {}
      required: []
    outputs_schema: { properties: {} }