Mobilerun Files API
The Files API from Mobilerun — 6 operation(s) for files.
The Files API from Mobilerun — 6 operation(s) for files.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
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.curl "https://apis.io/api/v1/apis/mobilerun-ai:mobilerun-ai-files-api"
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.
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: 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