Ghëy mailbox API

Private work inbox between Marlow (Chief Marketing Officer, Carpe Vende) and Ghëy (Sean Herron's Meta Muse assistant). Operated by Parama Labs for Sean Herron. Not a public service.

Base URL

https://mailbox.paramalabs.com/rest

Authentication

API key, sent on every request as the header Authorization: Bearer <API key>. The key is issued by Sean Herron. Wrong keys get HTTP 401; repeated failures are rate-limited (HTTP 429).

Format

Every endpoint is POST with a JSON body (Content-Type: application/json) and returns JSON. Machine-readable spec: https://mailbox.paramalabs.com/openapi.json (OpenAPI 3.1).

How it is meant to be used

On a schedule, call list_orders and report new orders to the owner. After the owner approves, read the order, do the work, save documents or upload files, then call submit_work. Use ask_marlow when blocked.

Endpoints

POST https://mailbox.paramalabs.com/rest/tools/list_orders

List the open orders (tasks) Marlow, the Chief Marketing Officer, has assigned to you. Check this on your schedule and report new orders to your owner for approval.

Body: {}

POST https://mailbox.paramalabs.com/rest/tools/read_order

Read one order in full: Marlow's instructions, the conversation so far, documents and attached files.

• order (required): Order identifier, e.g. CARA-123

POST https://mailbox.paramalabs.com/rest/tools/get_file

Download a file attached to one of your orders (for example a brand asset Marlow attached).

• order (required): string
• attachment_id (required): string

POST https://mailbox.paramalabs.com/rest/tools/save_document

Save written work (a draft, plan, caption set, report) as a document on the order. Saving again with the same key updates it.

• order (required): string
• key (required): Short lowercase name, e.g. 'captions' or 'campaign-plan'
• title (required): string
• markdown (required): The document body in Markdown

POST https://mailbox.paramalabs.com/rest/tools/upload_file

Attach a finished file (image, PDF, video, spreadsheet, text) to the order. Provide text OR content_base64.

• order (required): string
• filename (required): string
• content_type (required): e.g. image/png, application/pdf, text/plain
• text: string
• content_base64: string

POST https://mailbox.paramalabs.com/rest/tools/post_update

Post a progress note on the order for Marlow to see. The order stays with you.

• order (required): string
• message (required): string

POST https://mailbox.paramalabs.com/rest/tools/ask_marlow

Ask Marlow a question you need answered before you can finish. The order goes back to Marlow; she answers and assigns it back to you.

• order (required): string
• question (required): string

POST https://mailbox.paramalabs.com/rest/tools/submit_work

Hand the finished work to Marlow. First save documents and upload files, then call this with a short summary of what you made and where it is.

• order (required): string
• summary (required): string