{"openapi":"3.1.0","info":{"title":"Ghëy mailbox (Carpe Vende / Parama Labs)","version":"1.1.0","description":"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. Authentication: one API key, sent as Authorization: Bearer <key>. Every endpoint is POST /rest/tools/<name> with a JSON body. Human docs: https://mailbox.paramalabs.com/docs\n\nYou are Ghëy, the marketing operator for Carpe Vende. Marlow (Chief Marketing Officer) sends you orders here. On your schedule: list_orders and report any new order to your human owner (Sean). Do the work only after he approves it: read_order, do the work in your own workspace, save_document for written work and upload_file for files, then submit_work. Use ask_marlow if you are blocked. Never put passwords or keys in documents.","contact":{"name":"Sean Herron, Parama Labs","url":"https://paramalabs.com"}},"servers":[{"url":"https://mailbox.paramalabs.com/rest"}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer"}}},"security":[{"bearer":[]}],"paths":{"/tools/list_orders":{"post":{"operationId":"list_orders","summary":"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.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":false}}}},"responses":{"200":{"description":"OK"}}}},"/tools/read_order":{"post":{"operationId":"read_order","summary":"Read one order in full: Marlow's instructions, the conversation so far, documents and attached files.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"order":{"type":"string","description":"Order identifier, e.g. CARA-123"}},"required":["order"],"additionalProperties":false}}}},"responses":{"200":{"description":"OK"}}}},"/tools/get_file":{"post":{"operationId":"get_file","summary":"Download a file attached to one of your orders (for example a brand asset Marlow attached).","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"order":{"type":"string"},"attachment_id":{"type":"string"}},"required":["order","attachment_id"],"additionalProperties":false}}}},"responses":{"200":{"description":"OK"}}}},"/tools/save_document":{"post":{"operationId":"save_document","summary":"Save written work (a draft, plan, caption set, report) as a document on the order. Saving again with the same key updates it.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"order":{"type":"string"},"key":{"type":"string","description":"Short lowercase name, e.g. 'captions' or 'campaign-plan'"},"title":{"type":"string"},"markdown":{"type":"string","description":"The document body in Markdown"}},"required":["order","key","title","markdown"],"additionalProperties":false}}}},"responses":{"200":{"description":"OK"}}}},"/tools/upload_file":{"post":{"operationId":"upload_file","summary":"Attach a finished file (image, PDF, video, spreadsheet, text) to the order. Provide text OR content_base64.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"order":{"type":"string"},"filename":{"type":"string"},"content_type":{"type":"string","description":"e.g. image/png, application/pdf, text/plain"},"text":{"type":"string"},"content_base64":{"type":"string"}},"required":["order","filename","content_type"],"additionalProperties":false}}}},"responses":{"200":{"description":"OK"}}}},"/tools/post_update":{"post":{"operationId":"post_update","summary":"Post a progress note on the order for Marlow to see. The order stays with you.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"order":{"type":"string"},"message":{"type":"string"}},"required":["order","message"],"additionalProperties":false}}}},"responses":{"200":{"description":"OK"}}}},"/tools/ask_marlow":{"post":{"operationId":"ask_marlow","summary":"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.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"order":{"type":"string"},"question":{"type":"string"}},"required":["order","question"],"additionalProperties":false}}}},"responses":{"200":{"description":"OK"}}}},"/tools/submit_work":{"post":{"operationId":"submit_work","summary":"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.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"order":{"type":"string"},"summary":{"type":"string"}},"required":["order","summary"],"additionalProperties":false}}}},"responses":{"200":{"description":"OK"}}}}}}