Mobilerun Mailbox Messages API
The Mailbox Messages API from Mobilerun — 2 operation(s) for mailbox messages.
The Mailbox Messages API from Mobilerun — 2 operation(s) for mailbox messages.
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-mailbox-messages-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 Mailbox Messages API
version: v1
contact:
name: Droidrun
email: support@droidrun.ai
description: 'Operations tagged Mailbox Messages 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: Mailbox Messages
x-group: Connectivity
paths:
/mailboxes/{mailboxId}/messages:
get:
tags:
- Mailbox Messages
summary: List mailbox messages
operationId: listMailboxMessages
description: Lists mailbox messages with cursor pagination and optional time, sender, and OTP filters.
responses:
'200':
description: Messages retrieved
content:
application/json:
schema:
$ref: '#/components/schemas/MailboxMessageList'
'400':
description: The mailbox backend rejected the request
content:
application/json:
schema:
$ref: '#/components/schemas/MailboxErrorResponse'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorEnvelope'
'404':
description: Not Found
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorEnvelope'
'409':
description: Gmail connection is pending, expired, removed, or the message is too large
content:
application/json:
schema:
$ref: '#/components/schemas/MailboxErrorBody'
'429':
description: Mailbox backend rate limited
content:
application/json:
schema:
$ref: '#/components/schemas/MailboxErrorResponse'
'500':
description: Internal Server Error
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorEnvelope'
'502':
description: Mailbox backend unavailable
content:
application/json:
schema:
$ref: '#/components/schemas/MailboxErrorResponse'
'503':
description: Mailboxes disabled
content:
application/json:
schema:
$ref: '#/components/schemas/MailboxErrorBody'
parameters:
- schema:
type: string
format: uuid
required: true
name: mailboxId
in: path
- schema:
type: integer
minimum: 1
maximum: 100
default: 20
required: false
name: limit
in: query
- schema:
type: string
required: false
name: cursor
in: query
- schema:
type: string
format: date-time
required: false
name: after
in: query
- schema:
type: string
required: false
name: sender
in: query
- schema:
type: string
enum:
- 'true'
- 'false'
required: false
name: hasOtp
in: query
servers:
- url: https://api.mobilerun.ai
description: Droidrun Cloud API
/mailboxes/{mailboxId}/messages/{messageId}:
get:
tags:
- Mailbox Messages
summary: Get a mailbox message
operationId: getMailboxMessage
responses:
'200':
description: Message retrieved
content:
application/json:
schema:
type: object
properties:
data:
$ref: '#/components/schemas/MailboxMessage'
required:
- data
'400':
description: The mailbox backend rejected the request
content:
application/json:
schema:
$ref: '#/components/schemas/MailboxErrorResponse'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorEnvelope'
'404':
description: Not Found
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorEnvelope'
'409':
description: Gmail connection is pending, expired, removed, or the message is too large
content:
application/json:
schema:
$ref: '#/components/schemas/MailboxErrorBody'
'429':
description: Mailbox backend rate limited
content:
application/json:
schema:
$ref: '#/components/schemas/MailboxErrorResponse'
'500':
description: Internal Server Error
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorEnvelope'
'502':
description: Mailbox backend unavailable
content:
application/json:
schema:
$ref: '#/components/schemas/MailboxErrorResponse'
'503':
description: Mailboxes disabled
content:
application/json:
schema:
$ref: '#/components/schemas/MailboxErrorBody'
parameters:
- schema:
type: string
format: uuid
required: true
name: mailboxId
in: path
- schema:
type: string
minLength: 1
required: true
name: messageId
in: path
- schema:
type: string
enum:
- 'true'
- 'false'
description: Return the raw HTML part as htmlBody (untrusted; render isolated).
required: false
description: Return the raw HTML part as htmlBody (untrusted; render isolated).
name: includeHtml
in: query
servers:
- url: https://api.mobilerun.ai
description: Droidrun Cloud API
components:
schemas:
MailboxErrorBody:
type: object
properties:
code:
$ref: '#/components/schemas/MailboxErrorReason'
message:
type: string
required:
- code
- message
ApiErrorEnvelope:
type: object
properties:
code:
type: string
message:
type: string
details: {}
traceId:
type: string
retryAfterSeconds:
type: number
required:
- code
- message
MailboxMessageList:
type: object
properties:
items:
type: array
items:
$ref: '#/components/schemas/MailboxMessageSummary'
nextCursor:
type:
- string
- 'null'
required:
- items
- nextCursor
MailboxMessageSummary:
type: object
properties:
id:
type: string
mailboxId:
type: string
format: uuid
fromAddress:
type:
- string
- 'null'
subject:
type:
- string
- 'null'
preview:
type:
- string
- 'null'
hasOtp:
type: boolean
receivedAt:
type: string
format: date-time
required:
- id
- mailboxId
- fromAddress
- subject
- preview
- hasOtp
- receivedAt
MailboxAttachmentMeta:
type: object
properties:
name:
type:
- string
- 'null'
contentType:
type:
- string
- 'null'
size:
type: integer
minimum: 0
required:
- name
- contentType
- size
MailboxErrorReason:
type: string
enum:
- mailboxes_disabled
- otp_extraction_disabled
- idempotency_conflict
- invalid_idempotency_key
- idempotency_key_required
- idempotency_key_reused
- invalid_local_part
- local_part_reserved
- local_part_taken
- mailbox_vanity_disabled
- allocated_mailbox_limit_reached
- awaiting_payment_limit_reached
- vanity_awaiting_payment_limit_reached
- daily_allocation_limit_reached
- billing_not_configured
- included_capacity_unavailable
- mailbox_not_active
- uncancel_not_allowed
- backend_rate_limited
- backend_rejected
- backend_unavailable
- integration_forbidden
- provider_error
- assistant_checkout_return_unavailable
- custom_domains_disabled
- domain_not_disableable
- invalid_domain
- domain_reserved
- domain_unavailable
- domain_not_active
- domain_limit_reached
- domain_verification_expired
- domain_claim_superseded
- dns_check_rate_limited
- gmail_already_connected
- connection_pending
- connection_expired
- connection_removed
- message_too_large
- external_cancel_not_allowed
description: Stable, machine-readable error reason. Values are frozen and never renamed; new values may be added, so treat unknown values as a generic failure of the same HTTP status.
MailboxErrorResponse:
anyOf:
- $ref: '#/components/schemas/MailboxErrorBody'
- $ref: '#/components/schemas/MailboxApiErrorEnvelope'
MailboxApiErrorEnvelope:
type: object
properties:
code:
$ref: '#/components/schemas/MailboxErrorReason'
message:
type: string
traceId:
type: string
retryAfterSeconds:
type: number
required:
- code
- message
MailboxMessage:
type: object
properties:
id:
type: string
mailboxId:
type: string
format: uuid
fromAddress:
type:
- string
- 'null'
fromName:
type:
- string
- 'null'
subject:
type:
- string
- 'null'
textBody:
type:
- string
- 'null'
htmlBody:
type:
- string
- 'null'
description: 'Raw HTML part as received. Present only with includeHtml=true; null when the mail has no HTML part or it exceeds 1 MiB (UTF-8 bytes). Untrusted content: render only in an isolated sandboxed frame, never inline.'
hasOtp:
type: boolean
attachmentCount:
type: integer
minimum: 0
attachments:
type: array
items:
$ref: '#/components/schemas/MailboxAttachmentMeta'
receivedAt:
type: string
format: date-time
required:
- id
- mailboxId
- fromAddress
- fromName
- subject
- textBody
- hasOtp
- attachmentCount
- attachments
- receivedAt
securitySchemes:
bearerAuth:
type: http
scheme: bearer
bearerFormat: Opaque
description: Bearer token via Authorization header
x-refined-from:
- openapi.json
- mobilerun-ai-openapi.json
x-provenance:
method: harvested
publisher: Mobilerun
source: https://api.mobilerun.ai/v1/openapi.json
note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
stamped by stamp-openapi-provenance.py (roadmap#793)