{"$schema":"https://agents-json.org/schema/v1","name":"Saeroon API Agent","description":"AI agent for interacting with Saeroon Platform - hosting, payments, community features","version":"1.0.0","baseUrl":"https://api.saeroon.com","authentication":{"type":"bearer","headerName":"Authorization","tokenPrefix":"Bearer","obtainTokenEndpoint":"/api/v1/auth/login","refreshTokenEndpoint":"/api/v1/auth/refresh"},"rateLimits":{"requestsPerMinute":100,"retryAfterHeader":"Retry-After"},"errorHandling":{"format":"application/problem+json","typeField":"type","titleField":"title","statusField":"status","detailField":"detail"},"actions":[{"id":"auth.login","category":"auth","name":"Login","description":"Authenticate user with email and password to obtain JWT token","method":"POST","path":"/api/v1/auth/login","requiresAuth":false,"parameters":[{"name":"email","type":"string","required":true,"in":"body","description":"User email address","enum":null},{"name":"password","type":"string","required":true,"in":"body","description":"User password","enum":null}],"responseSchema":{"accessToken":"string","refreshToken":"string","userId":"string"},"exampleRequest":{"email":"user@example.com","password":"password123"}},{"id":"auth.refresh","category":"auth","name":"Refresh Token","description":"Refresh expired access token using refresh token","method":"POST","path":"/api/v1/auth/refresh","requiresAuth":false,"parameters":[{"name":"refreshToken","type":"string","required":true,"in":"body","description":null,"enum":null}],"responseSchema":null,"exampleRequest":null},{"id":"auth.me","category":"auth","name":"Get Current User","description":"Get information about the currently authenticated user","method":"GET","path":"/api/v1/users/me","requiresAuth":true,"parameters":null,"responseSchema":null,"exampleRequest":null},{"id":"hosting.sites.list","category":"hosting","name":"List Sites","description":"Get all hosting sites owned by the authenticated user","method":"GET","path":"/api/v1/hosting/sites","requiresAuth":true,"parameters":[{"name":"page","type":"integer","required":false,"in":"query","description":"Page number (default: 1)","enum":null},{"name":"pageSize","type":"integer","required":false,"in":"query","description":"Items per page (default: 20)","enum":null},{"name":"status","type":"string","required":false,"in":"query","description":null,"enum":["Draft","Published","Archived"]}],"responseSchema":null,"exampleRequest":null},{"id":"hosting.sites.create","category":"hosting","name":"Create Site","description":"Create a new hosting site. Use siteType to choose between blank, template-based, shop, or booking site.","method":"POST","path":"/api/v1/hosting/sites","requiresAuth":true,"parameters":[{"name":"name","type":"string","required":true,"in":"body","description":"Display name for the site","enum":null},{"name":"slug","type":"string","required":true,"in":"body","description":"URL slug (lowercase, hyphens allowed)","enum":null},{"name":"siteType","type":"string","required":true,"in":"body","description":null,"enum":["Blank","Template","Shop","Booking"]},{"name":"templateId","type":"string","required":false,"in":"body","description":"Template ID (required if siteType is Template)","enum":null}],"responseSchema":null,"exampleRequest":{"name":"My Shop","slug":"my-shop","siteType":"Shop"}},{"id":"hosting.sites.get","category":"hosting","name":"Get Site","description":"Get detailed information about a specific site","method":"GET","path":"/api/v1/hosting/sites/{id}","requiresAuth":true,"parameters":[{"name":"id","type":"string","required":true,"in":"path","description":"Site UUID","enum":null}],"responseSchema":null,"exampleRequest":null},{"id":"hosting.sites.update","category":"hosting","name":"Update Site","description":"Update site information (name, settings)","method":"PUT","path":"/api/v1/hosting/sites/{id}","requiresAuth":true,"parameters":[{"name":"id","type":"string","required":true,"in":"path","description":null,"enum":null},{"name":"name","type":"string","required":false,"in":"body","description":null,"enum":null},{"name":"settings","type":"object","required":false,"in":"body","description":null,"enum":null}],"responseSchema":null,"exampleRequest":null},{"id":"hosting.sites.delete","category":"hosting","name":"Delete Site","description":"Permanently delete a site and all its data","method":"DELETE","path":"/api/v1/hosting/sites/{id}","requiresAuth":true,"parameters":[{"name":"id","type":"string","required":true,"in":"path","description":null,"enum":null}],"responseSchema":null,"exampleRequest":null},{"id":"hosting.sites.publish","category":"hosting","name":"Publish Site","description":"Publish a draft site to make it publicly accessible","method":"POST","path":"/api/v1/hosting/sites/{id}/publish","requiresAuth":true,"parameters":[{"name":"id","type":"string","required":true,"in":"path","description":null,"enum":null}],"responseSchema":null,"exampleRequest":null},{"id":"hosting.templates.list","category":"hosting","name":"List Templates","description":"Get available site templates","method":"GET","path":"/api/v1/hosting/templates","requiresAuth":false,"parameters":[{"name":"tier","type":"integer","required":false,"in":"query","description":"Template tier (0-4)","enum":null},{"name":"category","type":"string","required":false,"in":"query","description":null,"enum":null}],"responseSchema":null,"exampleRequest":null},{"id":"moajack.communities.list","category":"moajack","name":"List Communities","description":"Get list of communities","method":"GET","path":"/api/v1/moajack/communities","requiresAuth":false,"parameters":null,"responseSchema":null,"exampleRequest":null},{"id":"moajack.communities.create","category":"moajack","name":"Create Community","description":"Create a new fan community","method":"POST","path":"/api/v1/moajack/communities","requiresAuth":true,"parameters":[{"name":"name","type":"string","required":true,"in":"body","description":null,"enum":null},{"name":"description","type":"string","required":false,"in":"body","description":null,"enum":null},{"name":"isPublic","type":"boolean","required":false,"in":"body","description":null,"enum":null}],"responseSchema":null,"exampleRequest":null},{"id":"moajack.posts.create","category":"moajack","name":"Create Post","description":"Create a new post in a community board","method":"POST","path":"/api/v1/moajack/boards/{boardId}/posts","requiresAuth":true,"parameters":[{"name":"boardId","type":"string","required":true,"in":"path","description":null,"enum":null},{"name":"title","type":"string","required":true,"in":"body","description":null,"enum":null},{"name":"content","type":"string","required":true,"in":"body","description":null,"enum":null}],"responseSchema":null,"exampleRequest":null},{"id":"payments.toss.confirm","category":"payments","name":"Confirm Toss Payment","description":"Confirm a TossPayments transaction","method":"POST","path":"/api/v1/toss-payments/confirm","requiresAuth":true,"parameters":[{"name":"paymentKey","type":"string","required":true,"in":"body","description":null,"enum":null},{"name":"orderId","type":"string","required":true,"in":"body","description":null,"enum":null},{"name":"amount","type":"integer","required":true,"in":"body","description":null,"enum":null}],"responseSchema":null,"exampleRequest":null},{"id":"payments.subscriptions.me","category":"payments","name":"Get My Subscription","description":"Get current user's subscription status","method":"GET","path":"/api/v1/subscriptions/me","requiresAuth":true,"parameters":null,"responseSchema":null,"exampleRequest":null},{"id":"readme.roots.list","category":"readme","name":"List Root Pages","description":"Get all root pages for the authenticated user","method":"GET","path":"/api/v1/roots","requiresAuth":true,"parameters":null,"responseSchema":null,"exampleRequest":null},{"id":"readme.roots.create","category":"readme","name":"Create Root Page","description":"Create a new creator profile page","method":"POST","path":"/api/v1/roots","requiresAuth":true,"parameters":[{"name":"username","type":"string","required":true,"in":"body","description":null,"enum":null},{"name":"displayName","type":"string","required":true,"in":"body","description":null,"enum":null},{"name":"bio","type":"string","required":false,"in":"body","description":null,"enum":null}],"responseSchema":null,"exampleRequest":null},{"id":"readme.blocks.create","category":"readme","name":"Create Block","description":"Add a content block to a root page","method":"POST","path":"/api/v1/roots/{rootId}/blocks","requiresAuth":true,"parameters":[{"name":"rootId","type":"string","required":true,"in":"path","description":null,"enum":null},{"name":"type","type":"string","required":true,"in":"body","description":null,"enum":["link","text","image","video","social","divider"]},{"name":"title","type":"string","required":false,"in":"body","description":null,"enum":null},{"name":"url","type":"string","required":false,"in":"body","description":null,"enum":null},{"name":"order","type":"integer","required":false,"in":"body","description":null,"enum":null}],"responseSchema":null,"exampleRequest":null}],"categories":[{"id":"auth","name":"Authentication","description":"Login, register, token management"},{"id":"hosting","name":"Hosting","description":"Sites, templates, domains, shop, booking"},{"id":"moajack","name":"Community","description":"Communities, posts, polls, events"},{"id":"payments","name":"Payments","description":"Toss, PayPal, subscriptions, earnings"},{"id":"readme","name":"Creator Profile","description":"Root pages, blocks, themes"}]}