{"openapi":"3.1.0","info":{"title":"Maker.co Website Improvement Agent API","version":"1.0.0","description":"Public discovery for Maker.co, an AI website-improvement platform. The API exposes public pages, articles, prompts, markdown resources, and Payload-authenticated CMS access for existing users. Payment protocols are not advertised because Maker.co does not expose agent-native checkout or payable API routes."},"servers":[{"url":"https://www.maker.co"}],"paths":{"/api/agent/status":{"get":{"operationId":"getAgentStatus","summary":"Check public agent API status","responses":{"200":{"description":"Agent API status"}}}},"/api/agent/search":{"get":{"operationId":"searchPublicContent","summary":"Search public Maker.co website-improvement pages, articles, and prompts","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":120},"description":"Search query."}],"responses":{"200":{"description":"Public search results"}}}},"/api/oauth/token":{"post":{"operationId":"exchangePayloadCredentialsForBearerToken","summary":"Exchange existing Payload user credentials for a bearer token","description":"Supports the OAuth password grant for existing Maker.co Payload users. This does not provide OpenID Connect identity claims or authorization-code login.","requestBody":{"required":true,"content":{"application/x-www-form-urlencoded":{"schema":{"type":"object","properties":{"grant_type":{"type":"string","const":"password"},"username":{"type":"string","format":"email"},"password":{"type":"string","format":"password"},"scope":{"type":"string"}},"required":["grant_type","username","password"]}},"application/json":{"schema":{"type":"object","properties":{"grant_type":{"type":"string","const":"password"},"username":{"type":"string","format":"email"},"email":{"type":"string","format":"email"},"password":{"type":"string","format":"password"},"scope":{"type":"string"}},"required":["grant_type","password"]}}}},"responses":{"200":{"description":"Bearer token response compatible with OAuth 2.0 token clients"},"400":{"description":"Invalid credentials, unsupported grant type, or unsupported scope"}}}},"/api/pages":{"get":{"operationId":"listPages","summary":"List public published Maker.co pages through the Payload REST API","responses":{"200":{"description":"Published Maker.co page documents visible to public readers"}}}},"/api/posts":{"get":{"operationId":"listPosts","summary":"List public published Maker.co articles through the Payload REST API","responses":{"200":{"description":"Published Maker.co article documents visible to public readers"}}}},"/api/prompts":{"get":{"operationId":"listPrompts","summary":"List public Maker prompt and inspiration documents through the Payload REST API","responses":{"200":{"description":"Public prompt documents"}}}},"/api/graphql":{"post":{"operationId":"queryPayloadGraphQL","summary":"Query public Maker.co Payload GraphQL content","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"variables":{"type":"object","additionalProperties":true}},"required":["query"]}}}},"responses":{"200":{"description":"GraphQL result"}}}},"/markdown":{"get":{"operationId":"getMarkdownForPath","summary":"Return a markdown representation for a public page path","parameters":[{"name":"path","in":"query","required":true,"schema":{"type":"string"},"description":"Public page path, including an optional query string such as /search?q=page."}],"responses":{"200":{"description":"Markdown representation"},"404":{"description":"No public page exists for the requested path"}}}},"/llms.txt":{"get":{"operationId":"getLlmsTxt","summary":"Return the curated markdown index of Maker.co public resources for agents","responses":{"200":{"description":"Markdown index of core Maker pages and discovery resources"}}}},"/llms-full.txt":{"get":{"operationId":"getLlmsFullTxt","summary":"Return the bulk markdown context for Maker.co published pages and posts","responses":{"200":{"description":"Bulk markdown context generated from published Maker content"}}}},"/.well-known/oauth-authorization-server":{"get":{"operationId":"getOAuthAuthorizationServerMetadata","summary":"Return OAuth 2.0 authorization server metadata","responses":{"200":{"description":"OAuth 2.0 authorization server metadata"}}}},"/.well-known/oauth-protected-resource":{"get":{"operationId":"getOAuthProtectedResourceMetadata","summary":"Return OAuth protected resource metadata","responses":{"200":{"description":"OAuth protected resource metadata"}}}},"/.well-known/http-message-signatures-directory":{"get":{"operationId":"getWebBotAuthDirectory","summary":"Return Maker.co Web Bot Auth HTTP Message Signatures key directory","description":"Publishes the public Ed25519 key set used by Maker.co outbound bot or agent requests when Web Bot Auth request signing is enabled.","responses":{"200":{"description":"HTTP Message Signatures directory JWKS","content":{"application/http-message-signatures-directory+json":{"schema":{"type":"object","properties":{"keys":{"type":"array","items":{"type":"object"}}},"required":["keys"]}}}},"503":{"description":"Web Bot Auth signing key is not configured."}}}}},"components":{"securitySchemes":{"PayloadBearer":{"type":"http","scheme":"bearer","bearerFormat":"Payload JWT","description":"Bearer token issued by /api/oauth/token for existing Payload user credentials."}}}}