{"openapi":"3.1.0","info":{"title":"WinsPipe Help Articles","version":"1.0.0","description":"Read product help articles as Markdown. Mutations require an approved signed-in human; agent API keys are rejected."},"servers":[{"url":"https://winspipe.com"}],"paths":{"/api/v1/help":{"get":{"operationId":"listHelpCatalog","summary":"List help collections","responses":{"200":{"description":"Catalog"}}}},"/api/v1/help/articles":{"get":{"operationId":"listHelpArticles","summary":"List or search articles","parameters":[{"name":"collection","in":"query","schema":{"type":"string"}},{"name":"q","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Articles"}}},"post":{"operationId":"upsertHelpArticle","summary":"Create or update an article by slug","security":[{"humanSession":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HelpArticleInput"}}}},"responses":{"201":{"description":"Upserted article"}}}},"/api/v1/help/articles/{slug}":{"get":{"operationId":"getHelpArticle","summary":"Fetch one article. Send Accept: text/markdown for the body only.","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Article"}}},"patch":{"operationId":"updateHelpArticle","security":[{"humanSession":[]}],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HelpArticleInput"}}}},"responses":{"200":{"description":"Updated article"}}},"delete":{"operationId":"deleteHelpArticle","security":[{"humanSession":[]}],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Deleted"}}}}},"components":{"securitySchemes":{"humanSession":{"type":"apiKey","in":"cookie","name":"__session","description":"Clerk session for an approved human Help editor. Agent keys are rejected."}},"schemas":{"HelpArticleInput":{"type":"object","required":["collection","title","body"],"properties":{"collection":{"type":"string","enum":["apps","writing-editing","analytics","publish-schedule","voice","ideas-campaigns","accounts","plan-calendar","account-billing","common-issues","api-integrations","terms-privacy"]},"slug":{"type":"string","description":"lowercase-kebab-case. Generated from title when omitted."},"title":{"type":"string"},"summary":{"type":"string"},"body":{"type":"string","description":"Markdown"},"status":{"type":"string","enum":["draft","published"],"default":"published"}}}}}}