{"openapi":"3.1.0","info":{"title":"VitaminLabs Public API","version":"1.0.0","description":"Read-only public API exposing the VitaminLabs agent catalogue, client case studies, and company information. No authentication required.","contact":{"name":"VitaminLabs","email":"team@vitaminlabs.co","url":"https://www.vitaminlabs.co/developers"},"license":{"name":"Proprietary"}},"servers":[{"url":"https://www.vitaminlabs.co","description":"Production"}],"paths":{"/api/v1":{"get":{"operationId":"getApiIndex","summary":"API index and endpoint discovery","tags":["Meta"],"responses":{"200":{"description":"API metadata and endpoint map"}}}},"/api/v1/agents":{"get":{"operationId":"listAgents","summary":"List all AI agents in the VitaminLabs catalogue","tags":["Agents"],"responses":{"200":{"description":"A list of agents","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentList"}}}}}}},"/api/v1/agents/{id}":{"get":{"operationId":"getAgent","summary":"Get a single agent by id","tags":["Agents"],"parameters":[{"name":"id","in":"path","required":true,"description":"Agent id, e.g. A-01","schema":{"type":"string"}}],"responses":{"200":{"description":"The agent","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Agent"}}}},"404":{"description":"Agent not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/cases":{"get":{"operationId":"listCases","summary":"List client case studies","tags":["Cases"],"responses":{"200":{"description":"A list of case studies","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CaseList"}}}}}}},"/api/v1/cases/{slug}":{"get":{"operationId":"getCase","summary":"Get a single case study by slug","tags":["Cases"],"parameters":[{"name":"slug","in":"path","required":true,"description":"Case study slug, e.g. aiblox","schema":{"type":"string"}}],"responses":{"200":{"description":"The case study","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CaseStudy"}}}},"404":{"description":"Case study not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/company":{"get":{"operationId":"getCompany","summary":"Get company information and engagement tiers","tags":["Company"],"responses":{"200":{"description":"Company information","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Company"}}}}}}}},"components":{"schemas":{"AgentCategory":{"type":"string","enum":["Intelligence","Content","Analysis","Outreach"]},"Agent":{"type":"object","required":["id","name","description","category"],"properties":{"id":{"type":"string","example":"A-01"},"name":{"type":"string","example":"Competitor Watch"},"description":{"type":"string"},"category":{"$ref":"#/components/schemas/AgentCategory"}}},"AgentList":{"type":"object","properties":{"object":{"type":"string","example":"list"},"count":{"type":"integer"},"categories":{"type":"array","items":{"$ref":"#/components/schemas/AgentCategory"}},"data":{"type":"array","items":{"$ref":"#/components/schemas/Agent"}}}},"CaseAgent":{"type":"object","required":["name","description","category"],"properties":{"name":{"type":"string"},"description":{"type":"string"},"category":{"$ref":"#/components/schemas/AgentCategory"}}},"CaseWorkflow":{"type":"object","required":["name","summary","leadTime","agents"],"properties":{"name":{"type":"string"},"summary":{"type":"string"},"leadTime":{"type":"string"},"agents":{"type":"array","items":{"$ref":"#/components/schemas/CaseAgent"}}}},"CaseStudy":{"type":"object","required":["slug","client","eyebrow","description","collaborationModel","stats","workflows"],"properties":{"slug":{"type":"string","example":"aiblox"},"client":{"type":"string"},"eyebrow":{"type":"string"},"description":{"type":"string"},"collaborationModel":{"type":"string"},"stats":{"type":"object","properties":{"operators":{"type":"string"},"agents":{"type":"string"}}},"stillBuilding":{"type":"boolean"},"workflows":{"type":"array","items":{"$ref":"#/components/schemas/CaseWorkflow"}}}},"CaseList":{"type":"object","properties":{"object":{"type":"string","example":"list"},"count":{"type":"integer"},"data":{"type":"array","items":{"$ref":"#/components/schemas/CaseStudy"}}}},"EngagementTier":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string"},"category":{"type":"string"}}},"Company":{"type":"object","properties":{"name":{"type":"string"},"legalName":{"type":"string"},"url":{"type":"string","format":"uri"},"tagline":{"type":"string"},"description":{"type":"string"},"email":{"type":"string","format":"email"},"bookingUrl":{"type":"string","format":"uri"},"sameAs":{"type":"array","items":{"type":"string","format":"uri"}},"founders":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"jobTitle":{"type":"string"},"url":{"type":"string","format":"uri"}}}},"engagementTiers":{"type":"array","items":{"$ref":"#/components/schemas/EngagementTier"}}}},"Error":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}