{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://www.monocrawl.com/schemas/utility/endpoint.json","title":"utility/endpoint data fields","description":"Required core structure for successful data, with optional source fields. Additional fields are allowed. This is not a completeness guarantee.","type":"object","properties":{"id":{"type":["string","null"],"description":"id"},"platform":{"type":["string","null"],"description":"platform"},"endpoint":{"type":["string","null"],"description":"endpoint"},"name":{"type":["string","null"],"description":"name"},"description":{"type":["string","null"],"description":"description"},"credit_cost":{"type":["number","null"]},"params":{"type":["array","null"],"items":{"type":["object","null"],"properties":{"name":{"type":["string","null"],"description":"name"},"doc":{"type":["string","null"],"description":"doc"},"required":{"type":["boolean","null"]},"example":{"description":"Operation-specific JSON value; inspect the status and requested operation before reading it."}},"additionalProperties":true}},"recommended_params":{"type":["array","null"],"items":{"type":["object","null"],"properties":{"name":{"type":["string","null"],"description":"name"},"reason":{"type":["string","null"],"description":"reason"},"cost_note":{"type":["string","null"],"description":"cost note"},"description":{"type":["string","null"],"description":"description"},"example":{"description":"Operation-specific JSON value; inspect the status and requested operation before reading it."},"allowed_values":{"type":["array","null"],"items":{"description":"Operation-specific JSON value; inspect the status and requested operation before reading it."}}},"additionalProperties":true}},"related_endpoints":{"type":["array","null"],"items":{"type":["object","null"],"properties":{"id":{"type":["string","null"],"description":"id"},"name":{"type":["string","null"],"description":"name"},"reason":{"type":["string","null"],"description":"reason"},"method":{"type":["string","null"],"description":"method"},"documentation":{"type":["string","null"],"description":"documentation"},"credit_cost":{"type":["number","null"]},"production_available":{"type":["boolean","null"]}},"additionalProperties":true}},"live_proven":{"type":["boolean","null"],"description":"live proven"},"production_available":{"type":["boolean","null"],"description":"production available"},"response_schema":{"type":["string","null"]},"examples":{"description":"Operation-specific JSON value; inspect the status and requested operation before reading it."}},"additionalProperties":true,"allOf":[{"anyOf":[{"required":["id"],"properties":{"id":{"type":["string"],"description":"id","minLength":1}}},{"required":["endpoint"],"properties":{"endpoint":{"type":["string"],"description":"endpoint","minLength":1}}},{"required":["name"],"properties":{"name":{"type":["string"],"description":"name","minLength":1}}},{"required":["description"],"properties":{"description":{"type":["string"],"description":"description","minLength":1}}},{"required":["credit_cost"],"properties":{"credit_cost":{"type":["number"]}}},{"required":["params"],"properties":{"params":{"type":["array"],"items":{"type":["object","null"],"properties":{"name":{"type":["string","null"],"description":"name"},"doc":{"type":["string","null"],"description":"doc"},"required":{"type":["boolean","null"]},"example":{"description":"Operation-specific JSON value; inspect the status and requested operation before reading it."}},"additionalProperties":true}}}},{"required":["recommended_params"],"properties":{"recommended_params":{"type":["array"],"items":{"type":["object","null"],"properties":{"name":{"type":["string","null"],"description":"name"},"reason":{"type":["string","null"],"description":"reason"},"cost_note":{"type":["string","null"],"description":"cost note"},"description":{"type":["string","null"],"description":"description"},"example":{"description":"Operation-specific JSON value; inspect the status and requested operation before reading it."},"allowed_values":{"type":["array","null"],"items":{"description":"Operation-specific JSON value; inspect the status and requested operation before reading it."}}},"additionalProperties":true}}}},{"required":["related_endpoints"],"properties":{"related_endpoints":{"type":["array"],"items":{"type":["object","null"],"properties":{"id":{"type":["string","null"],"description":"id"},"name":{"type":["string","null"],"description":"name"},"reason":{"type":["string","null"],"description":"reason"},"method":{"type":["string","null"],"description":"method"},"documentation":{"type":["string","null"],"description":"documentation"},"credit_cost":{"type":["number","null"]},"production_available":{"type":["boolean","null"]}},"additionalProperties":true}}}},{"required":["live_proven"],"properties":{"live_proven":{"type":["boolean"],"description":"live proven"}}},{"required":["production_available"],"properties":{"production_available":{"type":["boolean"],"description":"production available"}}},{"required":["response_schema"],"properties":{"response_schema":{"type":["string"],"minLength":1}}},{"required":["examples"],"properties":{"examples":{"description":"Operation-specific JSON value; inspect the status and requested operation before reading it."}}}]}],"x-contract-version":"2026-09-22","x-validation-scope":"Required success payload structure; optional fields and source completeness remain separate.","examples":[{"id":null,"platform":null,"endpoint":null,"name":null,"description":null,"credit_cost":0,"params":[],"recommended_params":[],"related_endpoints":[],"live_proven":false,"production_available":false,"response_schema":null,"examples":null}]}