{"openapi":"3.0.0","info":{"title":"SitesB (The Hive Platform) API","version":"1.0.0","description":"Production registry, discovery layer, and execution proxy for machine-readable Bees and standardized Honey structures."},"servers":[{"url":"/api","description":"Hive core endpoint router"}],"paths":{"/bees":{"get":{"summary":"Discover Bees","description":"Returns an array of all active, discoverable machine-readable capabilities (Bees) hosted by the Hive.","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"bees":{"type":"array","items":{"$ref":"#/components/schemas/Bee"}}}}}}}}}},"/bees/{id}":{"get":{"summary":"Get Bee Details","description":"Retrieves complete metadata, description, pricing details, and JSON input/output schemas for a specific Bee.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"Unique string identifier of the Bee capability."}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Bee"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}}}}},"/bees/{id}/execute":{"post":{"summary":"Execute Bee","description":"Dispatches the necessary structured input parameters to run the specified Bee capability and returns a standardized Honey response envelope.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"Unique string identifier of the Bee to execute."},{"name":"X-Hive-Wallet-Token","in":"header","required":false,"schema":{"type":"string"},"description":"A secure verification token or simulation ledger key for pay-per-use Bees. Triggers a 402 if missing on paid capabilities."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"responses":{"200":{"description":"Execution complete, standard Honey response delivered.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Honey"}}}},"400":{"description":"Bad Request - Invalid or incomplete parameters relative to the input schema."},"402":{"description":"Payment Required - Micro-commerce credit required to proceed.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"},"transactionDetails":{"type":"object","properties":{"beeId":{"type":"string"},"cost":{"type":"number"},"currency":{"type":"string"},"requiredHeader":{"type":"string"}}}}}}}},"404":{"description":"Not Found"},"500":{"description":"Internal Server Error"}}}}},"components":{"schemas":{"Bee":{"type":"object","required":["id","name","description","category","endpoint","inputSchema","outputSchema","status"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"category":{"type":"string"},"endpoint":{"type":"string"},"inputSchema":{"type":"object"},"outputSchema":{"type":"object"},"pricing":{"type":"object","required":["type"],"properties":{"type":{"type":"string","enum":["free","pay-per-use","subscription"]},"costPerCall":{"type":"number"},"currency":{"type":"string"}}},"status":{"type":"string","enum":["active","inactive","deprecated"]},"lastUpdated":{"type":"string","format":"date-time"}}},"Honey":{"type":"object","required":["beeId","timestamp","result"],"properties":{"beeId":{"type":"string"},"timestamp":{"type":"string","format":"date-time"},"result":{"type":"object"},"confidence":{"type":"number"},"freshness":{"type":"number"}}}}}}