Mobilerun Files API

The Files API from Mobilerun — 6 operation(s) for files.

GitHub OpenAPI

Operations 7

POST /agents/files/upload-url Create upload URL #
POST /agents/files/{fileId}/confirm Confirm upload #
GET /agents/files/{fileId}/download Download file #
GET /agents/files List files #
PATCH /agents/files/{fileId} Update file #
DELETE /agents/files/{fileId} Delete file #
DELETE /agents/files/{fileId}/pending Cancel upload #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/mobilerun-ai:mobilerun-ai-files-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

mobilerun-ai-files-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Mobilerun Ai Files API
  version: v1
  contact:
    name: Droidrun
    email: support@droidrun.ai
  description: 'Operations tagged Files across 2 of this provider''s published API definitions: openapi.json, mobilerun-ai-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.mobilerun.ai
  description: Droidrun Cloud API
security:
- bearerAuth: []
tags:
- name: Files
paths:
  /agents/files/upload-url:
    post:
      tags:
      - Files
      summary: Create upload URL
      description: Mint a presigned PUT URL and a fileId for uploading a user file.
      operationId: filesUploadUrl
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                filename:
                  type: string
                  minLength: 1
                  maxLength: 255
                mimeType:
                  type: string
                  minLength: 1
                sizeBytes:
                  type: integer
                  exclusiveMinimum: 0
                zone:
                  type: string
                  enum:
                  - user
                  - skills
                chatSessionId:
                  type: string
                  format: uuid
              required:
              - filename
              - mimeType
              - sizeBytes
      responses:
        '200':
          description: Presigned PUT URL and fileId
          content:
            application/json:
              schema:
                type: object
                properties:
                  fileId:
                    type: string
                    format: uuid
                  putUrl:
                    type: string
                    format: uri
                  expiresAt:
                    type: string
                    format: date-time
                required:
                - fileId
                - putUrl
                - expiresAt
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorEnvelope'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorEnvelope'
        '402':
          description: Storage limit reached
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: string
                    enum:
                    - storage_limit_reached
                  message:
                    type: string
                  details:
                    type: object
                    properties:
                      reason:
                        type: string
                        enum:
                        - storage_limit
                      usedBytes:
                        type: number
                      quotaBytes:
                        type:
                        - number
                        - 'null'
                      requiredBytes:
                        type: number
                    required:
                    - reason
                    - usedBytes
                    - quotaBytes
                    - requiredBytes
                required:
                - code
                - message
                - details
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorEnvelope'
        '422':
          description: Error 422
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: string
                    enum:
                    - idempotency_key_reused
                  message:
                    type: string
                  traceId:
                    type: string
                  retryAfterSeconds:
                    type: number
                required:
                - code
                - message
        '429':
          description: Too many pending (unconfirmed) uploads
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: string
                    enum:
                    - pending_uploads_limit
                  message:
                    type: string
                required:
                - code
                - message
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorEnvelope'
        '503':
          description: Storage check temporarily unavailable
          headers:
            Retry-After:
              description: Seconds to wait before retrying. Always present on this response.
              schema:
                type: string
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: string
                    enum:
                    - storage_check_unavailable
                    - routines_unavailable
                  message:
                    type: string
                  retryAfterSeconds:
                    type: number
                    enum:
                    - 30
                required:
                - code
                - message
      parameters:
      - schema:
          type: string
          minLength: 1
          maxLength: 255
          pattern: ^[\x21-\x7E]{1,255}$
          description: 'Idempotency-Key: 1-255 printable ASCII characters. Same key with a different request body is a 422 idempotency_key_reused. A retryable in-flight duplicate is a 409 with Retry-After and x-should-retry: true; a terminal duplicate is a 409 with x-should-retry: false. A replay returns the current resource state with Idempotent-Replayed: true.'
          example: b3f6a9f0-6f1a-4e9a-9e7a-9c9b6b6a5a3f
        required: false
        description: 'Idempotency-Key: 1-255 printable ASCII characters. Same key with a different request body is a 422 idempotency_key_reused. A retryable in-flight duplicate is a 409 with Retry-After and x-should-retry: true; a terminal duplicate is a 409 with x-should-retry: false. A replay returns the current resource state with Idempotent-Replayed: true.'
        name: idempotency-key
        in: header
    servers:
    - url: https://api.mobilerun.ai
      description: Droidrun Cloud API
  /agents/files/{fileId}/confirm:
    post:
      tags:
      - Files
      summary: Confirm upload
      description: Confirm a file upload after validating the stored object with a server-side HEAD request.
      operationId: filesConfirm
      responses:
        '200':
          description: Upload confirmed and validated
          content:
            application/json:
              schema:
                type: object
                properties:
                  fileId:
                    type: string
                    format: uuid
                  filename:
                    type: string
                  displayName:
                    type:
                    - string
                    - 'null'
                  mimeType:
                    type: string
                  sizeBytes:
                    type: number
                  zone:
                    type: string
                    enum:
                    - user
                    - agent
                    - workflow
                    - skills
                  enabled:
                    type: boolean
                  createdAt:
                    type: string
                    format: date-time
                  createdBy:
                    type: string
                    enum:
                    - user
                    - agent
                    - workflow
                  agentId:
                    type: string
                    format: uuid
                  collectionStatus:
                    anyOf:
                    - type: object
                      properties:
                        version:
                          type: number
                          enum:
                          - 1
                        completeness:
                          type: string
                          enum:
                          - complete
                          - partial
                          - none
                          - unknown
                        coverage:
                          type: string
                          enum:
                          - exhaustive
                          - bounded
                          - unknown
                        endReached:
                          type: boolean
                        resumable:
                          type: boolean
                        records:
                          type: object
                          properties:
                            reported:
                              type: integer
                              minimum: 0
                            unit:
                              type: string
                          required:
                          - reported
                          - unit
                          additionalProperties: false
                      required:
                      - version
                      - completeness
                      - coverage
                      - endReached
                      - resumable
                      - records
                      additionalProperties: false
                    - type: object
                      properties:
                        version:
                          type: number
                          enum:
                          - 1
                        completeness:
                          type: string
                          enum:
                          - unknown
                        coverage:
                          type: string
                          enum:
                          - unknown
                        endReached:
                          type: boolean
                          enum:
                          - false
                        resumable:
                          type: boolean
                          enum:
                          - false
                      required:
                      - version
                      - completeness
                      - coverage
                      - endReached
                      - resumable
                      additionalProperties: false
                  state:
                    type: string
                    enum:
                    - ready
                  actualSizeBytes:
                    type: number
                required:
                - fileId
                - filename
                - displayName
                - mimeType
                - sizeBytes
                - zone
                - enabled
                - createdAt
                - createdBy
                - state
                - actualSizeBytes
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorEnvelope'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorEnvelope'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorEnvelope'
        '410':
          description: Upload reservation expired; request a new upload URL.
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: string
                    enum:
                    - expired
                  message:
                    type: string
                  details:
                    type: object
                    properties:
                      fileId:
                        type: string
                        format: uuid
                    required:
                    - fileId
                required:
                - code
                - message
                - details
        '422':
          description: The uploaded file is missing or does not match the size or type declared when the upload URL was requested.
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: string
                    enum:
                    - confirm_failed
                  message:
                    type: string
                  details:
                    type: object
                    properties:
                      fileId:
                        type: string
                        format: uuid
                      reason:
                        type: string
                        enum:
                        - missing
                        - size_mismatch
                        - mime_mismatch
                    required:
                    - fileId
                    - reason
                required:
                - code
                - message
                - details
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorEnvelope'
      parameters:
      - schema:
          type: string
          format: uuid
        required: true
        name: fileId
        in: path
    servers:
    - url: https://api.mobilerun.ai
      description: Droidrun Cloud API
  /agents/files/{fileId}/download:
    get:
      tags:
      - Files
      summary: Download file
      description: Redirects to a short-lived presigned download URL. Missing, non-ready, and files owned by another tenant all return the same 404 response.
      operationId: filesDownload
      responses:
        '302':
          description: Redirect to a short-lived presigned download URL
          headers:
            Location:
              schema:
                type: string
                format: uri
            Content-Disposition:
              schema:
                type: string
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorEnvelope'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorEnvelope'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorEnvelope'
      parameters:
      - schema:
          type: string
          format: uuid
        required: true
        name: fileId
        in: path
    servers:
    - url: https://api.mobilerun.ai
      description: Droidrun Cloud API
  /agents/files:
    get:
      tags:
      - Files
      summary: List files
      description: List the user's ready files, optionally filtered by zone.
      operationId: filesList
      responses:
        '200':
          description: User's ready files
          content:
            application/json:
              schema:
                type: object
                properties:
                  files:
                    type: array
                    items:
                      type: object
                      properties:
                        fileId:
                          type: string
                          format: uuid
                        filename:
                          type: string
                        displayName:
                          type:
                          - string
                          - 'null'
                        mimeType:
                          type: string
                        sizeBytes:
                          type: number
                        zone:
                          type: string
                          enum:
                          - user
                          - agent
                          - workflow
                          - skills
                        enabled:
                          type: boolean
                        createdAt:
                          type: string
                          format: date-time
                        createdBy:
                          type: string
                          enum:
                          - user
                          - agent
                          - workflow
                        agentId:
                          type: string
                          format: uuid
                        collectionStatus:
                          anyOf:
                          - type: object
                            properties:
                              version:
                                type: number
                                enum:
                                - 1
                              completeness:
                                type: string
                                enum:
                                - complete
                                - partial
                                - none
                                - unknown
                              coverage:
                                type: string
                                enum:
                                - exhaustive
                                - bounded
                                - unknown
                              endReached:
                                type: boolean
                              resumable:
                                type: boolean
                              records:
                                type: object
                                properties:
                                  reported:
                                    type: integer
                                    minimum: 0
                                  unit:
                                    type: string
                                required:
                                - reported
                                - unit
                                additionalProperties: false
                            required:
                            - version
                            - completeness
                            - coverage
                            - endReached
                            - resumable
                            - records
                            additionalProperties: false
                          - type: object
                            properties:
                              version:
                                type: number
                                enum:
                                - 1
                              completeness:
                                type: string
                                enum:
                                - unknown
                              coverage:
                                type: string
                                enum:
                                - unknown
                              endReached:
                                type: boolean
                                enum:
                                - false
                              resumable:
                                type: boolean
                                enum:
                                - false
                            required:
                            - version
                            - completeness
                            - coverage
                            - endReached
                            - resumable
                            additionalProperties: false
                      required:
                      - fileId
                      - filename
                      - displayName
                      - mimeType
                      - sizeBytes
                      - zone
                      - enabled
                      - createdAt
                      - createdBy
                  quota:
                    type: object
                    properties:
                      usedBytes:
                        type: integer
                        minimum: 0
                      includedBytes:
                        type:
                        - integer
                        - 'null'
                        minimum: 0
                      maxBytes:
                        type:
                        - integer
                        - 'null'
                        minimum: 0
                      overageAllowed:
                        type: boolean
                    required:
                    - usedBytes
                    - includedBytes
                    - maxBytes
                    - overageAllowed
                required:
                - files
                - quota
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorEnvelope'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorEnvelope'
        '503':
          description: Storage check temporarily unavailable
          headers:
            Retry-After:
              description: Seconds to wait before retrying. Always present on this response.
              schema:
                type: string
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: string
                    enum:
                    - storage_check_unavailable
                    - routines_unavailable
                  message:
                    type: string
                  retryAfterSeconds:
                    type: number
                    enum:
                    - 30
                required:
                - code
                - message
      parameters:
      - schema:
          type: string
          enum:
          - user
          - agent
          - workflow
          - skills
        required: false
        name: zone
        in: query
    servers:
    - url: https://api.mobilerun.ai
      description: Droidrun Cloud API
  /agents/files/{fileId}:
    patch:
      tags:
      - Files
      summary: Update file
      operationId: filesUpdate
      description: Partial update of `displayName` and/or `enabled`. Only files with `zone=skills` are mutable; other zones return 422 `unsupported_zone`.
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                displayName:
                  type:
                  - string
                  - 'null'
                  minLength: 1
                  maxLength: 255
                enabled:
                  type: boolean
      responses:
        '200':
          description: Updated file
          content:
            application/json:
              schema:
                type: object
                properties:
                  fileId:
                    type: string
                    format: uuid
                  filename:
                    type: string
                  displayName:
                    type:
                    - string
                    - 'null'
                  mimeType:
                    type: string
                  sizeBytes:
                    type: number
                  zone:
                    type: string
                    enum:
                    - user
                    - agent
                    - workflow
                    - skills
                  enabled:
                    type: boolean
                  createdAt:
                    type: string
                    format: date-time
                  createdBy:
                    type: string
                    enum:
                    - user
                    - agent
                    - workflow
                  agentId:
                    type: string
                    format: uuid
                  collectionStatus:
                    anyOf:
                    - type: object
                      properties:
                        version:
                          type: number
                          enum:
                          - 1
                        completeness:
                          type: string
                          enum:
                          - complete
                          - partial
                          - none
                          - unknown
                        coverage:
                          type: string
                          enum:
                          - exhaustive
                          - bounded
                          - unknown
                        endReached:
                          type: boolean
                        resumable:
                          type: boolean
                        records:
                          type: object
                          properties:
                            reported:
                              type: integer
                              minimum: 0
                            unit:
                              type: string
                          required:
                          - reported
                          - unit
                          additionalProperties: false
                      required:
                      - version
                      - completeness
                      - coverage
                      - endReached
                      - resumable
                      - records
                      additionalProperties: false
                    - type: object
                      properties:
                        version:
                          type: number
                          enum:
                          - 1
                        completeness:
                          type: string
                          enum:
                          - unknown
                        coverage:
                          type: string
                          enum:
                          - unknown
                        endReached:
                          type: boolean
                          enum:
                          - false
                        resumable:
                          type: boolean
                          enum:
                          - false
                      required:
                      - version
                      - completeness
                      - coverage
                      - endReached
                      - resumable
                      additionalProperties: false
                required:
                - fileId
                - filename
                - displayName
                - mimeType
                - sizeBytes
                - zone
                - enabled
                - createdAt
                - createdBy
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorEnvelope'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorEnvelope'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorEnvelope'
        '422':
          description: Zone is not mutable
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: string
                    enum:
                    - unsupported_zone
                  message:
                    type: string
                required:
                - code
                - message
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorEnvelope'
      parameters:
      - schema:
          type: string
          format: uuid
        required: true
        name: fileId
        in: path
    delete:
      tags:
      - Files
      summary: Delete file
      description: Hard-delete a file.
      operationId: filesDelete
      responses:
        '200':
          description: Deleted
          content:
            application/json:
              schema:
                type: object
                properties:
                  ok:
                    type: boolean
                    enum:
                    - true
                required:
                - ok
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorEnvelope'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorEnvelope'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorEnvelope'
      parameters:
      - schema:
          type: string
          format: uuid
        required: true
        name: fileId
        in: path
    servers:
    - url: https://api.mobilerun.ai
      description: Droidrun Cloud API
  /agents/files/{fileId}/pending:
    delete:
      tags:
      - Files
      summary: Cancel upload
      description: 'Soft-cancels an in-flight upload before confirm, transitioning it to expired and deleting the underlying object. Only acts on `pending` uploads — refuses to touch `ready` files, so confirmed files are never removed. Idempotent: `{ cancelled: false }` if the file exists but is no longer pending.'
      operationId: filesCancelPending
      responses:
        '200':
          description: Cancel result
          content:
            application/json:
              schema:
                type: object
                properties:
                  cancelled:
                    type: boolean
                required:
                - cancelled
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorEnvelope'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorEnvelope'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorEnvelope'
      parameters:
      - schema:
          type: string
          format: uuid
        required: true
        name: fileId
        in: path
    servers:
    - url: https://api.mobilerun.ai
      description: Droidrun Cloud API
components:
  schemas:
    ApiErrorEnvelope:
      type: object
      properties:
        code:
          type: string
        message:
          type: string
        details: {}
        traceId:
          type: string
        retryAfterSeconds:
          type: number
      required:
      - code
      - message
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: Opaque
      description: Bearer token via Authorization header
x-refined-from:
- openapi.json


# --- truncated at 32 KB (32 KB total) ---
# Full source: https://artifacts.apis.io/mobilerun-ai/openapi/mobilerun-ai-files-api-openapi.yml