{"components":{"schemas":{"Error":{"properties":{"error":{"type":"string"}},"type":"object"}},"securitySchemes":{"ApiKeyBearer":{"description":"Use `Authorization: Bearer pixu_live_...`.","scheme":"bearer","type":"http"},"ApiKeyHeader":{"description":"Use a Pixu API key created in Settings > API Keys.","in":"header","name":"X-API-Key","type":"apiKey"},"JwtBearer":{"description":"Dashboard session JWTs are accepted for first-party clients.","scheme":"bearer","type":"http"}}},"info":{"description":"Authenticated API for Pixu mailboxes, conversations, compose, agent chat, knowledge, rules, webhooks, and analytics.","title":"Pixu Agentic Mail API","version":"v1"},"openapi":"3.1.0","paths":{"/":{"get":{"responses":{"200":{"description":"Authenticated API metadata"},"401":{"description":"Missing or invalid credentials"}},"summary":"API index"}},"/analytics/overview":{"get":{"responses":{"200":{"description":"Analytics overview"}},"summary":"Read analytics overview"}},"/approvals":{"get":{"responses":{"200":{"description":"Pending approval queue"}},"summary":"List pending agent draft approvals"}},"/billing/inr-plans":{"get":{"responses":{"200":{"description":"INR billing plans"}},"summary":"Read INR plan metadata, GST billing posture, and Indian payment modes"}},"/capabilities":{"get":{"responses":{"200":{"description":"Authenticated API and MCP capabilities"},"401":{"description":"Missing or invalid credentials"}},"summary":"API capabilities and MCP tool metadata"}},"/chat":{"post":{"responses":{"200":{"description":"Agent response"}},"summary":"Run agentic chat command"}},"/compose/send":{"post":{"responses":{"201":{"description":"Message queued or sent"}},"summary":"Send a new email"}},"/conversations":{"get":{"parameters":[{"in":"query","name":"mailbox","schema":{"format":"uuid","type":"string"}},{"in":"query","name":"status","schema":{"type":"string"}},{"in":"query","name":"page","schema":{"minimum":1,"type":"integer"}},{"in":"query","name":"per_page","schema":{"maximum":100,"minimum":1,"type":"integer"}}],"responses":{"200":{"description":"Conversation page"}},"summary":"List conversations"}},"/conversations/{id}":{"get":{"responses":{"200":{"description":"Conversation"}},"summary":"Get conversation"}},"/conversations/{id}/messages":{"get":{"responses":{"200":{"description":"Messages"}},"summary":"List conversation messages"}},"/conversations/{id}/reply":{"post":{"responses":{"201":{"description":"Reply queued or sent"}},"summary":"Reply to a conversation"}},"/india/data-residency":{"get":{"responses":{"200":{"description":"Data residency policy"}},"summary":"Read tenant data residency policy"},"patch":{"responses":{"200":{"description":"Updated data residency policy"}},"summary":"Update and optionally lock tenant data residency policy"}},"/india/digilocker/request":{"post":{"responses":{"200":{"description":"DigiLocker request status"}},"summary":"Create an audited DigiLocker consent request"}},"/india/esign/request":{"post":{"responses":{"200":{"description":"E-sign request status"}},"summary":"Create an audited e-sign provider request"}},"/india/gst/invoice":{"post":{"responses":{"200":{"description":"GST invoice handoff result"}},"summary":"Record a GST invoice handoff and validate GSTIN participants"}},"/india/gstin/validate":{"post":{"responses":{"200":{"description":"GSTIN validation result"}},"summary":"Validate and parse a GSTIN"}},"/india/mca/company/lookup":{"post":{"responses":{"200":{"description":"MCA lookup request status"}},"summary":"Create an audited MCA company lookup request"}},"/india/ondc/registry/lookup":{"post":{"responses":{"200":{"description":"ONDC request status"}},"summary":"Create an audited ONDC registry lookup request"}},"/india/stack/status":{"get":{"responses":{"200":{"description":"India Stack status"}},"summary":"Read India Stack readiness, provider credential state, residency, INR billing, and audit status"}},"/india/upi/link":{"post":{"responses":{"200":{"description":"UPI URI payload"}},"summary":"Generate a UPI intent payment link"}},"/knowledge":{"get":{"responses":{"200":{"description":"Knowledge sources"}},"summary":"List knowledge sources"},"post":{"responses":{"201":{"description":"Article created"}},"summary":"Create knowledge article"}},"/knowledge/search":{"post":{"responses":{"200":{"description":"Search results"}},"summary":"Search tenant knowledge base"}},"/ledger":{"get":{"responses":{"200":{"description":"Ledger object list"}},"summary":"List Universal Ledger objects"},"post":{"responses":{"201":{"description":"Ledger object created"}},"summary":"Create Universal Ledger object"}},"/ledger/{id}":{"delete":{"responses":{"204":{"description":"Ledger object archived"}},"summary":"Archive Universal Ledger object"},"get":{"responses":{"200":{"description":"Ledger object detail"}},"summary":"Get Universal Ledger object with event history"},"patch":{"responses":{"200":{"description":"Ledger object updated"}},"summary":"Update Universal Ledger object"}},"/mailboxes":{"get":{"responses":{"200":{"description":"Mailbox list"}},"summary":"List mailboxes"},"post":{"responses":{"201":{"description":"Mailbox created"}},"summary":"Create mailbox"}},"/mailboxes/{id}":{"delete":{"responses":{"204":{"description":"Mailbox deleted"}},"summary":"Delete mailbox"},"get":{"responses":{"200":{"description":"Mailbox"}},"summary":"Get mailbox"},"patch":{"responses":{"200":{"description":"Mailbox updated"}},"summary":"Update mailbox"}},"/mcp":{"post":{"responses":{"200":{"description":"MCP JSON-RPC response"}},"summary":"JSON-RPC MCP endpoint for external agent clients"}},"/rules":{"get":{"responses":{"200":{"description":"Rules"}},"summary":"List rules"},"post":{"responses":{"201":{"description":"Rule created"}},"summary":"Create rule"}},"/templates":{"get":{"responses":{"200":{"description":"Templates"}},"summary":"List templates"},"post":{"responses":{"201":{"description":"Template created"}},"summary":"Create template"}},"/webhooks":{"get":{"responses":{"200":{"description":"Webhook endpoints"}},"summary":"List webhooks"},"post":{"responses":{"201":{"description":"Webhook endpoint created"}},"summary":"Create webhook"}}},"security":[{"ApiKeyBearer":[]},{"ApiKeyHeader":[]},{"JwtBearer":[]}],"servers":[{"description":"Production","url":"https://pixu.in/api/v1"}],"x-pixu-agentic-primitives":["approvals","ledger","knowledge","secure_send","india_gstin","india_upi","india_ondc","india_digilocker","india_mca","india_esign","data_residency","inr_billing","mcp"],"x-pixu-positioning":"Agentic operations workspace for mail, structured business memory, human approvals, India-native actions, and MCP automation.","x-pixu-scopes":["api.meta","mail.read","mail.send","mail.write","mailboxes.manage","agent.run","analytics.read","reports.read","rules.manage","templates.manage","knowledge.manage","ledger.manage","webhooks.manage","domains.manage","departments.manage","storage.read","suppressions.manage","brand.manage","admin.manage"]}