{"openapi":"3.1.0","info":{"title":"pinksheep public site data API","version":"1.1.0","description":"Read-only public data for pinksheep.ai including site structure, machine-readable endpoints, pricing, templates, integrations, and shared agents."},"servers":[{"url":"https://www.pinksheep.ai"}],"tags":[{"name":"site","description":"Public site structure and content map"},{"name":"pricing","description":"Public plan, credit, and add-on data"},{"name":"templates","description":"Public template catalog data"},{"name":"integrations","description":"Public integration catalog and detail data"},{"name":"suggestions","description":"Public AI agent idea generation"},{"name":"agents","description":"Public shared agent catalog"}],"paths":{"/api/public/site":{"get":{"tags":["site"],"summary":"Get public site structure","operationId":"getPublicSite","responses":{"200":{"description":"Public site structure payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicSiteResponse"}}}}}}},"/api/public/pricing":{"get":{"tags":["pricing"],"summary":"Get public pricing data","operationId":"getPublicPricing","responses":{"200":{"description":"Public pricing payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicPricingResponse"}}}}}}},"/api/public/templates":{"get":{"tags":["templates"],"summary":"Get public template catalog","operationId":"getPublicTemplates","responses":{"200":{"description":"Public template payload","content":{"application/json":{"schema":{"type":"object","properties":{"templates":{"type":"array","items":{"$ref":"#/components/schemas/PublicTemplate"}}},"required":["templates"]}}}}}}},"/api/public/integrations":{"get":{"tags":["integrations"],"summary":"Get public integration catalog","operationId":"getPublicIntegrations","responses":{"200":{"description":"Public integration payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicIntegrationsResponse"}}}}}}},"/api/public/integrations/{slug}":{"get":{"tags":["integrations"],"summary":"Get a specific public integration","operationId":"getPublicIntegration","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"},"description":"Integration slug"}],"responses":{"200":{"description":"Public integration record","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicIntegrationDetail"}}}},"404":{"description":"Integration not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/public/agent-suggestions":{"post":{"tags":["suggestions"],"summary":"Generate public AI agent suggestions","operationId":"createPublicAgentSuggestions","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicAgentSuggestionRequest"}}}},"responses":{"200":{"description":"Generated agent suggestions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicAgentSuggestionResponse"}}}},"400":{"description":"Invalid request input","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/public/agents":{"get":{"tags":["agents"],"summary":"List public shared agents","operationId":"listPublicAgents","parameters":[{"name":"app","in":"query","schema":{"type":"string"},"description":"Filter by connected app slug"},{"name":"limit","in":"query","schema":{"type":"integer","default":20},"description":"Results per page"},{"name":"offset","in":"query","schema":{"type":"integer","default":0},"description":"Pagination offset"}],"responses":{"200":{"description":"Array of shared agent summaries","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/SharedAgentSummary"}}}}}}}},"/api/public/agents/{uuid}":{"get":{"tags":["agents"],"summary":"Get a specific shared agent","operationId":"getPublicAgent","parameters":[{"name":"uuid","in":"path","required":true,"schema":{"type":"string"},"description":"Shareable agent UUID"}],"responses":{"200":{"description":"Full shared agent data including generated content","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SharedAgent"}}}},"404":{"description":"Agent not found or not shared","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}},"components":{"schemas":{"ErrorResponse":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]},"PublicPage":{"type":"object","properties":{"path":{"type":"string"},"title":{"type":"string"},"summary":{"type":"string"},"section":{"type":"string"}},"required":["path","title","summary","section"]},"PublicEndpoint":{"type":"object","properties":{"path":{"type":"string"},"title":{"type":"string"},"summary":{"type":"string"},"url":{"type":"string","format":"uri"}},"required":["path","title","summary","url"]},"PublicTemplate":{"type":"object","properties":{"slug":{"type":"string"},"path":{"type":"string"},"name":{"type":"string"},"category":{"type":"string"},"tagline":{"type":"string"},"estimatedRunCostUsd":{"type":"number"},"approvalsRequired":{"type":"integer"},"tools":{"type":"array","items":{"type":"string"}}},"required":["slug","path","name","category","tagline","estimatedRunCostUsd","approvalsRequired","tools"]},"IntegrationResource":{"type":"object","properties":{"href":{"type":"string"},"title":{"type":"string"},"description":{"type":"string"},"tag":{"type":"string"}},"required":["href","title","description","tag"]},"PublicIntegration":{"type":"object","properties":{"slug":{"type":"string"},"path":{"type":"string"},"name":{"type":"string"},"category":{"type":"string"},"templateCount":{"type":"integer"},"summary":{"type":"string"}},"required":["slug","path","name","category","templateCount","summary"]},"PublicIntegrationDetail":{"allOf":[{"$ref":"#/components/schemas/PublicIntegration"},{"type":"object","properties":{"answer":{"type":"string"},"relatedResources":{"type":"array","items":{"$ref":"#/components/schemas/IntegrationResource"}}},"required":["answer","relatedResources"]}]},"PublicSiteResponse":{"type":"object","properties":{"site":{"type":"object","properties":{"name":{"type":"string"},"url":{"type":"string","format":"uri"},"appUrl":{"type":"string","format":"uri"},"description":{"type":"string"}},"required":["name","url","appUrl","description"]},"machineReadable":{"type":"array","items":{"$ref":"#/components/schemas/PublicEndpoint"}},"api":{"type":"array","items":{"$ref":"#/components/schemas/PublicEndpoint"}},"sections":{"type":"object","properties":{"core":{"type":"array","items":{"$ref":"#/components/schemas/PublicPage"}},"solutions":{"type":"array","items":{"$ref":"#/components/schemas/PublicPage"}},"compare":{"type":"array","items":{"$ref":"#/components/schemas/PublicPage"}},"guides":{"type":"array","items":{"$ref":"#/components/schemas/PublicPage"}},"company":{"type":"array","items":{"$ref":"#/components/schemas/PublicPage"}},"for":{"type":"array","items":{"$ref":"#/components/schemas/PublicPage"}},"templates":{"type":"array","items":{"$ref":"#/components/schemas/PublicPage"}},"integrations":{"type":"array","items":{"$ref":"#/components/schemas/PublicPage"}},"agents":{"type":"array","items":{"$ref":"#/components/schemas/PublicPage"}}},"required":["core","solutions","compare","guides","company","for","templates","integrations","agents"]},"featured":{"type":"object","properties":{"templates":{"type":"array","items":{"$ref":"#/components/schemas/PublicTemplate"}},"integrations":{"type":"array","items":{"$ref":"#/components/schemas/PublicIntegration"}}},"required":["templates","integrations"]}},"required":["site","machineReadable","api","sections","featured"]},"PublicPricingResponse":{"type":"object","additionalProperties":true},"PublicIntegrationsResponse":{"type":"object","properties":{"featured":{"type":"array","items":{"$ref":"#/components/schemas/PublicIntegration"}},"categories":{"type":"array","items":{"type":"string"}},"records":{"type":"array","items":{"$ref":"#/components/schemas/PublicIntegrationDetail"}}},"required":["featured","categories","records"]},"ConnectedApp":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"logo_url":{"type":"string"},"category":{"type":"string"},"link":{"type":"string"}},"required":["slug","name","description","logo_url","category","link"]},"ToolkitSummary":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"categories":{"type":"array","items":{"type":"string"}},"source":{"type":"string"}},"required":["slug","name","description","categories","source"]},"SuggestionLink":{"type":"object","properties":{"href":{"type":"string"},"label":{"type":"string"},"kind":{"type":"string"}},"required":["href","label","kind"]},"AgentSuggestion":{"type":"object","properties":{"id":{"type":"string"},"family":{"type":"string"},"title":{"type":"string"},"whatItDoes":{"type":"string"},"whyItFits":{"type":"string"},"requiredTools":{"type":"array","items":{"type":"string"}},"approvalProfile":{"type":"string"},"starterPrompt":{"type":"string"},"relatedLinks":{"type":"array","items":{"$ref":"#/components/schemas/SuggestionLink"}},"score":{"type":"number"},"source":{"type":"string"}},"required":["id","family","title","whatItDoes","whyItFits","requiredTools","approvalProfile","starterPrompt","relatedLinks","score","source"]},"PublicAgentSuggestionRequest":{"type":"object","properties":{"prompt":{"type":"string"},"selectedToolSlugs":{"type":"array","items":{"type":"string"}},"maxSuggestions":{"type":"integer","minimum":3,"maximum":5}},"required":["prompt"]},"PublicAgentSuggestionResponse":{"type":"object","properties":{"suggestions":{"type":"array","items":{"$ref":"#/components/schemas/AgentSuggestion"}},"selectedToolkits":{"type":"array","items":{"$ref":"#/components/schemas/ToolkitSummary"}},"impliedToolkits":{"type":"array","items":{"$ref":"#/components/schemas/ToolkitSummary"}},"resolvedToolkits":{"type":"array","items":{"$ref":"#/components/schemas/ToolkitSummary"}},"promptThemes":{"type":"array","items":{"type":"string"}},"llmRefined":{"type":"boolean"},"fallbackUsed":{"type":"boolean"},"catalogSource":{"type":"string"},"catalogDegraded":{"type":"boolean"},"catalogDegradedReason":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["suggestions","selectedToolkits","impliedToolkits","resolvedToolkits","promptThemes","llmRefined","fallbackUsed","catalogSource","catalogDegraded","catalogDegradedReason"]},"FaqItem":{"type":"object","properties":{"q":{"type":"string"},"a":{"type":"string"}},"required":["q","a"]},"UseCase":{"type":"object","properties":{"title":{"type":"string"},"description":{"type":"string"}},"required":["title","description"]},"HowItWorksStep":{"type":"object","properties":{"step":{"type":"integer"},"title":{"type":"string"},"description":{"type":"string"}},"required":["step","title","description"]},"ShareContent":{"type":"object","properties":{"page_title":{"type":"string"},"meta_description":{"type":"string"},"h1":{"type":"string"},"h1_sub":{"type":"string"},"direct_answer":{"type":"string"},"what_it_does":{"type":"string"},"how_it_works_steps":{"type":"array","items":{"$ref":"#/components/schemas/HowItWorksStep"}},"why_it_matters":{"type":"string"},"use_cases":{"type":"array","items":{"$ref":"#/components/schemas/UseCase"}},"managing_on_pinksheep":{"type":"string"},"faq":{"type":"array","items":{"$ref":"#/components/schemas/FaqItem"}},"seo_keywords":{"type":"array","items":{"type":"string"}},"read_time":{"type":"string"},"connected_apps":{"type":"array","items":{"$ref":"#/components/schemas/ConnectedApp"}}},"required":["page_title","meta_description","h1","h1_sub","direct_answer","what_it_does","how_it_works_steps","why_it_matters","use_cases","managing_on_pinksheep","faq","seo_keywords","read_time","connected_apps"]},"SharedAgentSummary":{"type":"object","properties":{"uuid":{"type":"string"},"agent_name":{"type":"string"},"description":{"type":"string"},"connected_apps":{"type":"array","items":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"},"logo_url":{"type":"string"}},"required":["slug","name","logo_url"]}},"clone_count":{"type":"integer"},"created_at":{"type":"string"}},"required":["uuid","agent_name","description","connected_apps","clone_count","created_at"]},"SharedAgent":{"type":"object","properties":{"uuid":{"type":"string"},"agent_name":{"type":"string"},"content":{"$ref":"#/components/schemas/ShareContent"},"created_at":{"type":"string"},"clone_count":{"type":"integer"},"creator_name":{"type":"string"}},"required":["uuid","agent_name","content","created_at","clone_count"]}}}}