{"openapi":"3.1.0","info":{"title":"Alasco Esg (BYOK) API","version":"0.1.0","description":"Alasco Esg (BYOK) lets an AI assistant read your own Alasco Esg data through the Alasco Esg API with a key you supply (Alasco API key). Read-only: 5 tools (list_buildings, list_building_utility_meters, get_building_analysis_result, list_building_custom_data, get_file_metadata). The BYOK key travels with each request, is used for that one call only and is never stored, logged or cached; it is only...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-alasco-esg.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-alasco-esg/docs"},"termsOfService":"https://connectorbay.com/byok-alasco-esg/terms"},"servers":[{"url":"https://byok-alasco-esg.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-alasco-esg/docs"},"security":[{"upstreamKey":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."},"upstreamKey":{"type":"apiKey","in":"header","name":"X-Upstream-Key","description":"Your own key for the service this connector wraps (bring your own key). Used for that one call only; never stored, logged or cached."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/list_buildings":{"post":{"operationId":"list_buildings","summary":"List the buildings of your Alasco ESG account with name, external ids, gross internal and external area and, on request,","description":"List the buildings of your Alasco ESG account with name, external ids, gross internal and external area and, on request, building and energy certificates. Uses cursor paging through links.next. Use for \"Which buildings are in Alasco ESG\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"include":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Comma-separated extras to include: building_certificates and or energy_certificates.","title":"Include"}},"title":"list_buildingsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_building_utility_meters":{"post":{"operationId":"list_building_utility_meters","summary":"List the utility meters of one building with category (electricity, gas, heat, water), sub category, units, serial numbe","description":"List the utility meters of one building with category (electricity, gas, heat, water), sub category, units, serial number, heating and cooling system, procurement and activation dates. Use for \"Which utility meters does Alasco building 5f3a1c2e have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"building_uuid":{"description":"Alasco building id (uuid), from list_buildings.","maxLength":200,"title":"Building Uuid","type":"string"}},"required":["building_uuid"],"title":"list_building_utility_metersArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_building_analysis_result":{"post":{"operationId":"get_building_analysis_result","summary":"Get the yearly ESG analysis result of one building: total consumption, energy and CO2 intensity, scope 1, 2 and 3 emissi","description":"Get the yearly ESG analysis result of one building: total consumption, energy and CO2 intensity, scope 1, 2 and 3 emissions, total emissions, energy generated and self-supply rate. Use for \"What are the emissions and energy intensity of Alasco building 5f3a1c2e\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"building_uuid":{"description":"Alasco building id (uuid), from list_buildings.","maxLength":200,"title":"Building Uuid","type":"string"}},"required":["building_uuid"],"title":"get_building_analysis_resultArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_building_custom_data":{"post":{"operationId":"list_building_custom_data","summary":"List the custom data groups of one building (company-defined fields such as year of construction or heating type) with t","description":"List the custom data groups of one building (company-defined fields such as year of construction or heating type) with their field values. Use for \"Which custom data fields are set on Alasco building 5f3a1c2e\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"building_uuid":{"description":"Alasco building id (uuid), from list_buildings.","maxLength":200,"title":"Building Uuid","type":"string"}},"required":["building_uuid"],"title":"list_building_custom_dataArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_file_metadata":{"post":{"operationId":"get_file_metadata","summary":"List the document metadata (certificates and reports, without downloads) for one external file id: file id, name, docume","description":"List the document metadata (certificates and reports, without downloads) for one external file id: file id, name, document type, source, buildings, issue date and validity. Use for \"Which Alasco document has external id CERT-2025-01\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"external_id":{"description":"External id of the file.","maxLength":100,"title":"External Id","type":"string"}},"required":["external_id"],"title":"get_file_metadataArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}