{ "openapi": "3.1.0", "info": { "title": "Spiritual Side of Leadership public API", "version": "1.0.0", "summary": "Read-only access to free Spiritual Side of Leadership content.", "description": "What SSOL is, the SuperHuman Framework, emailed Daily Drip devotions, free articles, and public membership prices. No auth, no writes, no member data. The same data is available as MCP tools at /api/mcp.", "contact": { "name": "Spiritual Side of Leadership", "url": "https://www.spiritualsideofleadership.com/contact" } }, "servers": [ { "url": "https://www.spiritualsideofleadership.com/api/v1" } ], "externalDocs": { "description": "For AI Agents", "url": "https://www.spiritualsideofleadership.com/agents" }, "paths": { "/about": { "get": { "operationId": "getAbout", "summary": "What SSOL is, and its founder", "responses": { "200": { "description": "About SSOL", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/About" } } } }, "429": { "description": "Rate limited (60 requests per minute per IP).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "Content source temporarily unavailable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/framework": { "get": { "operationId": "getFramework", "summary": "The SuperHuman Framework", "responses": { "200": { "description": "The framework", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Framework" } } } }, "429": { "description": "Rate limited (60 requests per minute per IP).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "Content source temporarily unavailable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/membership": { "get": { "operationId": "getMembership", "summary": "Public membership tiers and prices", "responses": { "200": { "description": "Membership tiers", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Membership" } } } }, "429": { "description": "Rate limited (60 requests per minute per IP).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "Content source temporarily unavailable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/articles": { "get": { "operationId": "listArticles", "summary": "Published articles, newest first", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 50, "default": 10 } }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0, "maximum": 1000, "default": 0 } } ], "responses": { "200": { "description": "A page of articles", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ArticleList" } } } }, "429": { "description": "Rate limited (60 requests per minute per IP).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "Content source temporarily unavailable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/articles/{slug}": { "get": { "operationId": "getArticle", "summary": "One published article, with its full text", "parameters": [ { "name": "slug", "in": "path", "required": true, "schema": { "type": "string" }, "description": "The slug from the matching list endpoint." } ], "responses": { "200": { "description": "The article", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Article" } } } }, "404": { "description": "No published item with that slug.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limited (60 requests per minute per IP).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "Content source temporarily unavailable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/devotions": { "get": { "operationId": "listDevotions", "summary": "Emailed Daily Drip devotions, newest first", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 50, "default": 10 } } ], "responses": { "200": { "description": "A page of devotions", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DevotionList" } } } }, "429": { "description": "Rate limited (60 requests per minute per IP).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "Content source temporarily unavailable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/devotions/{slug}": { "get": { "operationId": "getDevotion", "summary": "One emailed Daily Drip devotion", "parameters": [ { "name": "slug", "in": "path", "required": true, "schema": { "type": "string" }, "description": "The slug from the matching list endpoint." } ], "responses": { "200": { "description": "The devotion", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Devotion" } } } }, "404": { "description": "No published item with that slug.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limited (60 requests per minute per IP).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "Content source temporarily unavailable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } } }, "components": { "schemas": { "Error": { "type": "object", "required": [ "error" ], "properties": { "error": { "type": "object", "required": [ "code", "message" ], "properties": { "code": { "type": "string" }, "message": { "type": "string" } } } } }, "About": { "type": "object", "required": [ "name", "url", "summary", "founder" ], "properties": { "name": { "type": "string" }, "alternate_name": { "type": "string" }, "url": { "type": "string", "format": "uri" }, "slogan": { "type": "string" }, "summary": { "type": "string" }, "founded": { "type": "string" }, "founder": { "type": "object", "properties": { "name": { "type": "string" }, "id": { "type": "string", "format": "uri" }, "url": { "type": "string", "format": "uri" }, "title": { "type": "string" }, "profile_url": { "type": "string", "format": "uri" }, "roles": { "type": "array", "items": { "type": "string" } } } }, "location": { "type": "object", "properties": { "locality": { "type": "string" }, "region": { "type": "string" }, "country": { "type": "string" } } }, "links": { "type": "object", "additionalProperties": { "type": "string", "format": "uri" } } } }, "FrameworkEntry": { "type": "object", "required": [ "name", "slug", "url" ], "properties": { "name": { "type": "string" }, "slug": { "type": "string" }, "summary": { "type": [ "string", "null" ] }, "url": { "type": "string", "format": "uri" }, "markdown_url": { "type": "string", "format": "uri" } } }, "Framework": { "type": "object", "required": [ "name", "cornerstones", "h_pillars", "leadership_gaps" ], "properties": { "name": { "type": "string" }, "tagline": { "type": "string" }, "summary": { "type": "string" }, "url": { "type": "string", "format": "uri" }, "cornerstones": { "type": "array", "items": { "$ref": "#/components/schemas/FrameworkEntry" } }, "h_pillars": { "type": "array", "items": { "$ref": "#/components/schemas/FrameworkEntry" } }, "leadership_gaps": { "type": "array", "items": { "$ref": "#/components/schemas/FrameworkEntry" } }, "assessment_url": { "type": "string", "format": "uri" } } }, "Membership": { "type": "object", "required": [ "currency", "tiers" ], "properties": { "currency": { "type": "string" }, "free": { "type": "array", "items": { "type": "string" } }, "tiers": { "type": "array", "items": { "type": "object", "required": [ "id", "name", "monthly_price", "annual_price" ], "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "tagline": { "type": "string" }, "monthly_price": { "type": "number" }, "annual_price": { "type": "number" }, "includes_heading": { "type": "string" }, "features": { "type": "array", "items": { "type": "string" } }, "terms": { "type": "string" } } } }, "annual_note": { "type": "string" }, "membership_url": { "type": "string", "format": "uri" }, "group_memberships_url": { "type": "string", "format": "uri" } } }, "ArticleSummary": { "type": "object", "required": [ "title", "slug", "url" ], "properties": { "title": { "type": "string" }, "slug": { "type": "string" }, "excerpt": { "type": [ "string", "null" ] }, "published_at": { "type": [ "string", "null" ] }, "category": { "type": [ "string", "null" ] }, "url": { "type": "string", "format": "uri" }, "markdown_url": { "type": "string", "format": "uri" } } }, "ArticleList": { "type": "object", "required": [ "articles" ], "properties": { "articles": { "type": "array", "items": { "$ref": "#/components/schemas/ArticleSummary" } } } }, "Article": { "allOf": [ { "$ref": "#/components/schemas/ArticleSummary" }, { "type": "object", "properties": { "author": { "type": "string" }, "updated_at": { "type": [ "string", "null" ] }, "scripture": { "type": [ "object", "null" ], "properties": { "reference": { "type": "string" }, "text": { "type": [ "string", "null" ] } } }, "body_text": { "type": "string" } } } ] }, "DevotionSummary": { "type": "object", "required": [ "title", "slug", "date", "url" ], "properties": { "title": { "type": "string" }, "slug": { "type": "string" }, "date": { "type": "string" }, "scripture_reference": { "type": "string" }, "url": { "type": "string", "format": "uri" } } }, "DevotionList": { "type": "object", "required": [ "devotions" ], "properties": { "devotions": { "type": "array", "items": { "$ref": "#/components/schemas/DevotionSummary" } } } }, "Devotion": { "allOf": [ { "$ref": "#/components/schemas/DevotionSummary" }, { "type": "object", "properties": { "author": { "type": "string" }, "scripture": { "type": "object", "properties": { "reference": { "type": "string" }, "text": { "type": [ "string", "null" ] }, "translation": { "type": [ "string", "null" ] } } }, "body": { "type": "string" }, "practice": { "type": [ "string", "null" ] }, "question": { "type": [ "string", "null" ] }, "prayer": { "type": [ "string", "null" ] } } } ] } } } }