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

# Per-instance configuration. Auth header 'Authorization: Bearer <access_token>'.
config_schema:
  properties:
    access_token:
      type: string
      description: "Box access token (developer token or OAuth2/JWT-issued token)"
      x-soar-sensitive: true
  required:
    - access_token

commands:
  - id: search
    name: box-search
    description: "Search for files and folders by keyword."
    risk: read
    inputs_schema:
      properties:
        query: { type: string, description: "Search query" }
        limit: { type: number, description: "Max results (default 30)" }
      required: [query]
    outputs_schema: { properties: {} }
  - id: get_file_info
    name: box-get-file-info
    description: "Get a file's metadata."
    risk: read
    inputs_schema:
      properties:
        file_id: { type: string, description: "File ID" }
      required: [file_id]
    outputs_schema: { properties: {} }
  - id: get_folder_info
    name: box-get-folder-info
    description: "Get a folder's metadata."
    risk: read
    inputs_schema:
      properties:
        folder_id: { type: string, description: "Folder ID (0 = root)" }
      required: [folder_id]
    outputs_schema: { properties: {} }
  - id: list_folder_items
    name: box-list-folder-items
    description: "List the items inside a folder."
    risk: read
    inputs_schema:
      properties:
        folder_id: { type: string, description: "Folder ID (0 = root)" }
        limit: { type: number, description: "Max items (default 100)" }
      required: [folder_id]
    outputs_schema: { properties: {} }
  - id: create_shared_link
    name: box-create-shared-link
    description: "Create a shared link for a file."
    inputs_schema:
      properties:
        file_id: { type: string, description: "File ID" }
        access: { type: string, description: "open, company, or collaborators (default company)" }
      required: [file_id]
    outputs_schema: { properties: {} }

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