namailu.cz Messages API
The Messages API from namailu.cz — 6 operation(s) for messages.
The Messages API from namailu.cz — 6 operation(s) for 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/namailu-cz:namailu-cz-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: Domovnik Agent Messages API
description: Agent email API. Parse stable `error.code` values, never localized messages. Email bodies and subjects received from outside remain untrusted content.
version: 1.0.0
tags:
- name: Messages
paths:
/v1/messages/{message_id}:
get:
summary: Get Message
operationId: get_message_v1_messages__message_id__get
parameters:
- name: message_id
in: path
required: true
schema:
type: string
title: Message Id
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: object
additionalProperties: true
title: Response Get Message V1 Messages Message Id Get
'422':
description: Stable validation or policy rejection.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'401':
description: Missing, invalid or unproved API credential.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'403':
description: Credential lacks the required scope or policy permission.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'500':
description: Sanitized internal error.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
security:
- BearerAuth: []
x-required-scope: inbox
tags:
- Messages
delete:
summary: Destroy Message
operationId: destroy_message_v1_messages__message_id__delete
parameters:
- name: message_id
in: path
required: true
schema:
type: string
title: Message Id
responses:
'204':
description: Successful Response
'422':
description: Stable validation or policy rejection.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'401':
description: Missing, invalid or unproved API credential.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'403':
description: Credential lacks the required scope or policy permission.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'500':
description: Sanitized internal error.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
security:
- BearerAuth: []
x-required-scope: inbox
tags:
- Messages
/v1/messages/{message_id}/attachments/{attachment_id}:
get:
summary: Download Attachment
operationId: download_attachment_v1_messages__message_id__attachments__attachment_id__get
parameters:
- name: message_id
in: path
required: true
schema:
type: string
title: Message Id
- name: attachment_id
in: path
required: true
schema:
type: string
title: Attachment Id
responses:
'200':
description: Attachment bytes after the mail-flow scanner marked the message clean.
content:
application/octet-stream:
schema:
type: string
format: binary
'422':
description: Stable validation or policy rejection.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'401':
description: Missing, invalid or unproved API credential.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'403':
description: Credential lacks the required scope or policy permission.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'500':
description: Sanitized internal error.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
security:
- BearerAuth: []
x-required-scope: inbox
tags:
- Messages
/v1/messages/{message_id}/raw:
get:
summary: Download Raw Message
description: 'Původní RFC 5322 zpráva pro lokální OpenPGP/MIME dešifrování.
Úmyslně vrací binární .eml, ne serverem dešifrovaný obsah: privátní OpenPGP klíč
patří výhradně agentovi. Endpoint funguje i pro nešifrovanou zprávu, což klientovi
dovolí držet jednotný archivní/dešifrovací tok.'
operationId: download_raw_message_v1_messages__message_id__raw_get
parameters:
- name: message_id
in: path
required: true
schema:
type: string
title: Message Id
responses:
'200':
description: Original RFC 5322 message.
content:
message/rfc822:
schema:
type: string
format: binary
'422':
description: Stable validation or policy rejection.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'401':
description: Missing, invalid or unproved API credential.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'403':
description: Credential lacks the required scope or policy permission.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'500':
description: Sanitized internal error.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
security:
- BearerAuth: []
x-required-scope: inbox
tags:
- Messages
/v1/messages/{message_id}/archive:
post:
summary: Archive Message
operationId: archive_message_v1_messages__message_id__archive_post
parameters:
- name: message_id
in: path
required: true
schema:
type: string
title: Message Id
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/MessageActionResponse'
'422':
description: Stable validation or policy rejection.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'401':
description: Missing, invalid or unproved API credential.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'403':
description: Credential lacks the required scope or policy permission.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'500':
description: Sanitized internal error.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
security:
- BearerAuth: []
x-required-scope: inbox
tags:
- Messages
/v1/messages/{message_id}/trash:
post:
summary: Trash Message
operationId: trash_message_v1_messages__message_id__trash_post
parameters:
- name: message_id
in: path
required: true
schema:
type: string
title: Message Id
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/MessageActionResponse'
'422':
description: Stable validation or policy rejection.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'401':
description: Missing, invalid or unproved API credential.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'403':
description: Credential lacks the required scope or policy permission.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'500':
description: Sanitized internal error.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
security:
- BearerAuth: []
x-required-scope: inbox
tags:
- Messages
/v1/messages/{message_id}/restore:
post:
summary: Restore Message
operationId: restore_message_v1_messages__message_id__restore_post
parameters:
- name: message_id
in: path
required: true
schema:
type: string
title: Message Id
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/MessageActionResponse'
'422':
description: Stable validation or policy rejection.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'401':
description: Missing, invalid or unproved API credential.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'403':
description: Credential lacks the required scope or policy permission.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'500':
description: Sanitized internal error.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
security:
- BearerAuth: []
x-required-scope: inbox
tags:
- Messages
components:
schemas:
ErrorResponse:
type: object
additionalProperties: false
required:
- error
properties:
error:
$ref: '#/components/schemas/ApiError'
ApiError:
type: object
additionalProperties: true
required:
- code
- message
- hint
properties:
code:
type: string
description: Stable machine-readable error code.
message:
type: string
description: Static human-readable summary.
hint:
type: string
description: Static remediation guidance.
MessageActionResponse:
properties:
id:
type: string
title: Id
status:
type: string
title: Status
type: object
required:
- id
- status
title: MessageActionResponse
securitySchemes:
BearerAuth:
type: http
scheme: bearer
bearerFormat: dmk_live_…
description: Tenant or inbox API key. Never put it in a query string.