Opkey File Management API

openapi: 3.2.0
info:
  title: pCloudy Device Cloud File Management API
  version: v2
  summary: Public REST API for the pCloudy real-device cloud, an Opkey product.
  description: The pCloudy REST API is the machine-readable surface of the pCloudy real-device testing cloud operated by Opkey (Smart Software Testing Solutions Inc.).
  contact:
    name: Opkey
    url: https://www.opkey.com/
  x-generated-by: API Evangelist enrichment pipeline
  x-source: https://content.pcloudy.com/apidocs/
servers:
- url: https://{cloud}.pcloudy.com
  description: pCloudy cloud instance
  variables:
    cloud:
      default: device
      enum:
      - device
      - demo
      - aus
      description: pCloudy cloud host prefix; the docs refer to this as <Cloud URL>.
security:
- accessToken: []
tags:
- name: File Management
paths:
  /api/v2/filesinfo:
    post:
      operationId: filesInfo
      summary: Files_Info(V2)
      tags:
      - File Management
      description: Returns the list of files and apps available in the account's pCloudy drive, with optional filtering (for example by type such as appdata). Used to discover uploaded builds and data files and obtain their identifiers for install, push, or download operations.
      parameters:
      - name: token
        in: header
        required: true
        description: API access token (from /api/access).
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - filter
              properties:
                filter:
                  type: string
                  description: File filter (e.g., "appdata").
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
              example:
                traceId: Rfla3glk3eu5W5100twP
                requestId: va0bsZkBC5g046aW862E
                statusCode: 200
                status: success
                message: Retrieved files list successfully
                data:
                - Files: []
        '401':
          description: Unauthorized - missing or invalid access token
      security:
      - accessToken: []
  /api/v2/upload:
    post:
      operationId: uploadApplication
      summary: Upload Application
      tags:
      - File Management
      description: Uploads an application binary (APK/IPA) to the pCloudy drive so it can later be installed on devices. Used to upload the apps under test. User can directly connect the device and install the apps uploaded before.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - None
              properties:
                None:
                  type: string
                  description: Authentication is via the Authorization header (Basic username:apiKey).
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
              example:
                result:
                  code: 200
                  msg: success
        '401':
          description: Unauthorized - missing or invalid access token
      security:
      - accessToken: []
components:
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic
      description: HTTP Basic with your pCloudy email as the username and your API access key as the password. Used only by GET /api/access to mint an access token.
    accessToken:
      type: apiKey
      in: header
      name: token
      description: Access token returned by GET /api/access. Newer /api/v2/* operations send it as a `token` header; several legacy /api/* operations send the same token as a `token` field in the JSON request body.
externalDocs:
  description: pCloudy API Reference
  url: https://content.pcloudy.com/apidocs/