onepost

Manage Czech ISDS data box messages, attachments, and concepts through the ONEPOST API.

2|1|Updated Mar 30, 2026
One-click install
npx skills add https://github.com/atlasgroupcz/codexis-marketplace --skill onepost-atlasgroupcz
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: onepost
Source: https://github.com/atlasgroupcz/codexis-marketplace/tree/main/plugins/onepost/skills/onepost
Command: npx skills add https://github.com/atlasgroupcz/codexis-marketplace --skill onepost-atlasgroupcz

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Working with Czech datové schránky (ISDS data boxes) normally requires manual portal logins to check messages, download attachments, and send submissions. This Skill lets you perform all of those operations directly through the ONEPOST API using the onepost-cli command-line client. ## Core Features & Use Cases - Mailbox and Message Access: List mailboxes and folders, browse folder messages, search messages by keyword, and read full message details including attachment counts. - Attachment Handling: List and download message attachments to local files, and upload files for outgoing messages. - Concepts and Sending: Create, update, and send message concepts (drafts), and receive new ISDS messages, with READ_WRITE API keys. - Use Case: Ask the assistant to find unread messages from the tax office in your data box, download their attachments, and then prepare a reply concept with a PDF attachment ready to send. ## Quick Start Configure your ONEPOST API key with onepost-cli settings set, then ask the assistant to show the unread messages in your data box.

Frequently Asked Questions about onepost

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I read messages from a Czech datová schránka via API?▼

Use the ONEPOST API through onepost-cli: list mailboxes with onepost-cli mailboxes, find folders with onepost-cli folders, then list messages with onepost-cli folder-messages or search with onepost-cli search. A configured ONEPOST API key is required first.

How do I download attachments from ISDS data box messages?▼

Check the message's attachmentCount field, list attachments with onepost-cli attachments <MESSAGE_ID>, then download each file with onepost-cli download-attachment <ATTACHMENT_ID> --output <PATH>. The message command accepts either the ISDS number or the internal UUID.

Can I send data box messages through the ONEPOST API?▼

Yes, sending requires a READ_WRITE API key and MESSAGES_SEND permission in ONEPOST. Upload attachments, create a draft with onepost-cli concept save, then send it with onepost-cli concept send. A LOW_CREDIT result means the send cannot complete until credit is resolved.

What is the difference between isdsMessageId and id in ONEPOST?▼

isdsMessageId is the digits-only ISDS number users see in the data box, while id is an internal ONEPOST UUID returned by search and message commands. The onepost-cli message command accepts either form and returns both identifiers.

Why does onepost-cli return a 401 or 403 error?▼

HTTP 401 means the API key is invalid, deleted, or wrong; regenerate it in ONEPOST and run onepost-cli settings set. HTTP 403 means a READ key was used for a write operation or the key lacks permission to the resource.