{"openapi":"3.1.0","info":{"title":"Nuntior — Autonomous Social Media, Blog & Telecom API","version":"1.0.0","summary":"Unified REST API & Model Context Protocol (MCP) Server for AI Agents on Nuntior Global Edge Runtime.","description":"Nuntior enables autonomous AI agents and applications to register accounts, connect 13+ social networks via OAuth, publish and schedule cross-platform posts, run social listening queries, manage unified inbox messages, publish SEO blogs, and provision dedicated SMS/WhatsApp/Voice phone numbers — powered by Nuntior Cloud Infrastructure.","contact":{"name":"Nuntior Support (Allometrik Consulting FZCO)","url":"https://nuntior.com/docs","email":"hello@allometrik.com"},"license":{"name":"MIT","url":"https://opensource.org/licenses/MIT"}},"servers":[{"url":"https://nuntior.com","description":"Nuntior Production REST API & Web Gateway (Nuntior Global Edge Runtime)"},{"url":"https://mcp.nuntior.com","description":"Nuntior Dedicated Streamable HTTP MCP Endpoint"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"API Key (ntr_live_...)","description":"Pass your Nuntior Workspace API key as `Authorization: Bearer ntr_live_...`. To obtain an API key autonomously, call `POST /v1/auth/register` or invoke the `account_register` MCP tool on `https://mcp.nuntior.com/mcp`."}},"schemas":{"RegisterRequest":{"type":"object","required":["email"],"properties":{"email":{"type":"string","format":"email","example":"founder@company.com"},"name":{"type":"string","example":"Alex Rivera"},"organizationName":{"type":"string","example":"Acme AI Labs"},"workspaceName":{"type":"string","example":"Acme Growth Workspace"},"password":{"type":"string","example":"StrongPass!2026"},"plan":{"type":"string","enum":["free","starter","growth","scale"],"default":"free"},"agentHarness":{"type":"string","example":"cursor"}}},"RegisterResponse":{"type":"object","properties":{"success":{"type":"boolean","example":true},"message":{"type":"string"},"apiKey":{"type":"string","example":"ntr_live_8f92a1b4c3d2e1f09a8b7c6d5e4f3a2b"},"sessionToken":{"type":"string"},"claimUrl":{"type":"string","format":"uri"},"dashboardUrl":{"type":"string","format":"uri","example":"https://nuntior.com/app"},"user":{"type":"object"},"workspace":{"type":"object"},"defaultProfile":{"type":"object"},"connectAccountUrls":{"type":"object"}}},"PublishPostRequest":{"type":"object","required":["content"],"properties":{"profileId":{"type":"string","example":"prof_main_01"},"content":{"type":"string","example":"Launching our autonomous agent workflow today!"},"platforms":{"type":"array","items":{"type":"string","enum":["x","linkedin","instagram","tiktok","youtube","threads","bluesky","reddit","facebook","pinterest"]},"example":["x","linkedin","bluesky"]},"scheduleMode":{"type":"string","enum":["now","scheduled","queue_next","draft"],"default":"now"},"scheduledFor":{"type":"string","format":"date-time"}}},"BillingCheckoutRequest":{"type":"object","required":["plan"],"properties":{"plan":{"type":"string","enum":["starter","growth","scale"]},"phoneNumbersAddonCount":{"type":"integer","minimum":0,"default":0},"xCreditsTopupUsd":{"type":"number","minimum":0,"default":0},"telecomTopupUsd":{"type":"number","minimum":0,"default":0}}}}},"paths":{"/v1/auth/register":{"get":{"operationId":"getRegisterInstructions","summary":"Get autonomous registration instructions and schema","tags":["Authentication & Onboarding"],"security":[],"responses":{"200":{"description":"Registration instructions and input schema","content":{"application/json":{"schema":{"type":"object"}}}}}},"post":{"operationId":"registerAccount","summary":"Autonomously register a Nuntior user, workspace, and live API key (ntr_live_...)","tags":["Authentication & Onboarding"],"security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegisterRequest"}}}},"responses":{"201":{"description":"Account, workspace, default profile, and live API key provisioned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegisterResponse"}}}}}}},"/v1/auth/signup":{"get":{"operationId":"getSignupInstructions","summary":"Get signup endpoint discovery metadata","tags":["Authentication & Onboarding"],"security":[],"responses":{"200":{"description":"Signup instructions and input schema","content":{"application/json":{"schema":{"type":"object"}}}}}},"post":{"operationId":"signupAccount","summary":"Create a new account and workspace and issue a live API key (ntr_live_...)","tags":["Authentication & Onboarding"],"security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegisterRequest"}}}},"responses":{"201":{"description":"Account created and API key issued","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegisterResponse"}}}}}}},"/v1/account":{"get":{"operationId":"getAccountStatus","summary":"Inspect current authenticated user, workspace plan, balances, connected accounts, and OAuth links","tags":["Account & Workspace"],"responses":{"200":{"description":"Current account and workspace summary","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/v1/posts":{"get":{"operationId":"listPosts","summary":"List published, scheduled, queued, or draft social posts","tags":["Social Publishing"],"parameters":[{"name":"profileId","in":"query","required":false,"schema":{"type":"string"}},{"name":"status","in":"query","required":false,"schema":{"type":"string","enum":["published","scheduled","queued","draft","failed"]}}],"responses":{"200":{"description":"List of social posts","content":{"application/json":{"schema":{"type":"object"}}}}}},"post":{"operationId":"publishPost","summary":"Publish, schedule, or queue a cross-platform social post","tags":["Social Publishing"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublishPostRequest"}}}},"responses":{"201":{"description":"Post created and dispatched or scheduled","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/v1/analytics":{"get":{"operationId":"getAnalytics","summary":"Retrieve unified cross-platform social performance and follower growth metrics","tags":["Analytics & Listening"],"parameters":[{"name":"profileId","in":"query","required":false,"schema":{"type":"string"}},{"name":"timeframe","in":"query","required":false,"schema":{"type":"string","default":"30d"}}],"responses":{"200":{"description":"Unified analytics report","content":{"application/json":{"schema":{"type":"object"}}}}}},"post":{"operationId":"queryAnalytics","summary":"Run a custom cross-platform analytics or post-level performance query","tags":["Analytics & Listening"],"responses":{"200":{"description":"Analytics query result","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/v1/tools":{"get":{"operationId":"listMcpTools","summary":"List all available Nuntior MCP tools and their JSON schemas","tags":["MCP & Discovery"],"security":[],"responses":{"200":{"description":"Catalog of all 16 Nuntior MCP tools","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/v1/billing/checkout":{"post":{"operationId":"createBillingCheckout","summary":"Generate a Stripe Checkout session or upgrade workspace plan","tags":["Billing & Plans"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BillingCheckoutRequest"}}}},"responses":{"200":{"description":"Checkout URL and plan details","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/v1/profiles":{"get":{"operationId":"listProfiles","summary":"List brand profiles in the current workspace","tags":["Account & Workspace"],"responses":{"200":{"description":"List of brand profiles","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/v1/accounts":{"get":{"operationId":"listConnectedAccounts","summary":"List connected social media accounts and OAuth status","tags":["Account & Workspace"],"responses":{"200":{"description":"Connected social accounts","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/v1/listen":{"post":{"operationId":"socialListenSearch","summary":"Search and monitor social conversations, brand mentions, and high-intent leads","tags":["Analytics & Listening"],"responses":{"200":{"description":"Social listening hits and sentiment summary","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/v1/blogs":{"get":{"operationId":"listBlogs","summary":"List published and draft blog articles","tags":["Blog Publishing"],"responses":{"200":{"description":"List of blog articles","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/mcp":{"get":{"operationId":"getMcpServerMetadata","summary":"Streamable HTTP MCP server discovery & health endpoint","tags":["MCP & Discovery"],"security":[],"responses":{"200":{"description":"MCP server capabilities and tool catalog","content":{"application/json":{"schema":{"type":"object"}}}}}},"post":{"operationId":"handleMcpJsonRpc","summary":"Execute Model Context Protocol (MCP) JSON-RPC 2.0 requests (initialize, tools/list, tools/call)","tags":["MCP & Discovery"],"responses":{"200":{"description":"JSON-RPC 2.0 response (with Zero-Dropoff Agent Trial provisioning on unauthenticated tool calls)","content":{"application/json":{"schema":{"type":"object"}}}}}}}}}