{"openapi":"3.1.0","info":{"title":"Microsoft Azure API (Bowmark)","version":"e833508f87ff","description":"Microsoft Azure — the public cloud's own pricing, catalogue and status surfaces. Built: retail service pricing and the service catalogue, off Microsoft's own unauthenticated retail-prices API. Declared, not yet built: a deployment cost estimate, the region catalogue, product-by-region availability, VM sizes, live service health and published SLAs.\n\nEvery function Bowmark has for Microsoft Azure (azure.microsoft.com) as one HTTP call. Each runs on Bowmark's infrastructure with the same billing, rules and response envelope as `POST /v1/run`. The whole API: https://api.bowmark.ai/openapi.json. Guide: https://bowmark.ai/docs/api.","contact":{"email":"support@bowmark.ai","url":"https://bowmark.ai/docs/api"}},"servers":[{"url":"https://api.bowmark.ai"}],"security":[{"bearer":[]},{"apiKeyHeader":[]}],"paths":{"/v1/sites/azure/getServicePricing":{"post":{"operationId":"getServicePricing","summary":"Returns Microsoft's published retail rates for Azure services off `prices.azure.com`'s own unauthenticated retail-prices API — the same data the Pricing Calculator reads, server-side.","description":"Returns Microsoft's published retail rates for Azure services off `prices.azure.com`'s own unauthenticated retail-prices API — the same data the Pricing Calculator reads, server-side. `filters` narrows on any of `serviceName`, `serviceId`, `serviceFamily`, `armRegionName`, `location`, `meterId`, `meterName`, `productId`, `productName`, `skuId`, `skuName`, `armSkuName`, `priceType` (\"Consumption\" | \"DevTestConsumption\" | \"Reservation\") — every value is an EXACT, case-sensitive match against the site's own strings (\"Virtual Machines\", not \"virtual machines\"); there is no free-text search. `currencyCode` (3-letter, e.g. \"EUR\") re-prices every row in that currency; omitted, rows are USD, the only currency Microsoft treats as authoritative — a non-USD row is for reference, not a quote. Returns up to 5,000 rows (5 pages of the site's own 1,000-row page size) per call; `moreAvailable: true` means the table had more and `filters` should narrow further rather than trusting `rows` as the whole answer. Scope: Commercial Cloud only — Azure Government and Azure China have no meters here. THROWS on a malformed `currencyCode` or when `prices.azure.com` itself errors; an unmatched filter is a real answer and returns `rows: []`, never a throw.\n\nCalls `bowmark.providers.azure.getServicePricing`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<AzureServicePricingResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"filters":{"$ref":"#/components/schemas/AzurePricingFilters","description":"TypeScript: `AzurePricingFilters`"},"currencyCode":{"type":"string","description":"TypeScript: `string`"}},"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/azure/listServices":{"post":{"operationId":"listServices","summary":"Returns Azure's service catalogue — each service's `serviceName` (the exact, case-sensitive string `getServicePricing`'s `serviceName` filter takes), its `serviceId`, and the `serviceFamily` it was ob","description":"Returns Azure's service catalogue — each service's `serviceName` (the exact, case-sensitive string `getServicePricing`'s `serviceName` filter takes), its `serviceId`, and the `serviceFamily` it was observed under — derived live from `prices.azure.com`'s own rows rather than any hardcoded list. `filters.serviceFamily` narrows the walk to one family. There is no single-request enumeration: the API rejects `$apply`/`$select`/`$expand` outright, so this walks up to 20 pages of the site's own 1,000-row page size, deduplicating as it goes. `moreAvailable: true` means the underlying table still had more when the walk stopped — true for every one of the largest families (Compute, Networking, Storage, Security, Databases, Management and Governance, Developer Tools, Analytics and others), which do not converge to a small closed list within this budget; narrow `filters.serviceFamily` for a smaller family to reach a complete one. Does NOT trust Microsoft's own published \"26 service families\" documentation — that list is measurably stale (this function has observed real Azure families absent from it, e.g. \"AI + Machine Learning\", \"Blockchain\", \"Microsoft 365 Copilot\") — every `serviceFamily` value returned is one this call actually saw. Scope: Commercial Cloud only, same as `getServicePricing`. THROWS only when `prices.azure.com` itself errors; an unmatched `serviceFamily` is a real answer and returns `services: []`, never a throw.\n\nCalls `bowmark.providers.azure.listServices`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<AzureListServicesResult>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"filters":{"$ref":"#/components/schemas/AzureListServicesFilters","description":"TypeScript: `AzureListServicesFilters`"}},"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}}},"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Your Bowmark API key."},"apiKeyHeader":{"type":"apiKey","in":"header","name":"X-Bowmark-Key"}},"responses":{"NotFound":{"description":"No such site or function.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}},"schemas":{"RunEnvelope":{"type":"object","description":"What a run returns. `status` says whether the SCRIPT succeeded. A script that threw or paused for a login is still HTTP 200. Branch on `status`, not on the HTTP code.","required":["ok","status","result","logs","error","ms"],"properties":{"runId":{"type":"string","description":"Stable id for this run. Quote it in a support or `report` message."},"ok":{"type":"boolean","description":"False only when the run produced nothing usable."},"status":{"type":"string","enum":["ok","error","partial","needs_user"],"description":"`partial`: the result is real but some calls failed (see `incomplete`); `ok` stays true. `needs_user`: a person must sign in to a site first. Relay `meta.handoff.url` to them, then run again."},"egress":{"type":"string","enum":["default","link"],"description":"The egress the run was given, present only when the request asked for one. `link`: every request went through the caller's own Chrome (Bowmark Buddy)."},"result":{"description":"Whatever the script `return`ed. Any JSON value."},"logs":{"type":"array","items":{"type":"string"},"description":"Lines the script wrote with `log(...)`."},"error":{"type":["string","null"],"description":"Why the run failed, in plain words. Null on success."},"ms":{"type":"integer","description":"How long the script itself ran, in milliseconds."},"queuedMs":{"type":"integer","description":"How long the run waited for a worker before starting. Present only when it was a second or more."},"needs":{"type":"array","description":"The sign-ins this script is waiting on. Present when `status` is `needs_user`.","items":{"type":"object","required":["capability","provider","providerTitle","kind"],"properties":{"capability":{"type":"string"},"provider":{"type":"string"},"providerTitle":{"type":"string","description":"The site's name, to show a person."},"kind":{"type":"string"}}}},"incomplete":{"type":"object","description":"Present only when `status` is `partial`: which calls did not answer.","properties":{"summary":{"type":"string"},"totalCalls":{"type":"integer"}},"additionalProperties":true},"emptyHanded":{"type":"object","description":"Present when the script returned nothing while its calls returned rows, usually a filter that matched none of the site's own labels. Lists the label values the calls actually returned.","additionalProperties":true},"notes":{"type":"array","description":"Caveats a call attached to a complete answer. Never changes `status`.","items":{"type":"object","properties":{"path":{"type":"string"},"notes":{"type":"array","items":{"type":"string"}}}}},"meta":{"type":"object","properties":{"handoff":{"type":"object","description":"A single-use sign-in link for a person to open. Expires at `expiresAt`.","properties":{"ref":{"type":"string"},"url":{"type":"string","format":"uri"},"expiresAt":{"type":"string","format":"date-time"}}},"concurrency":{"type":"object","description":"On a 429: how many runs are in flight and when to retry.","properties":{"limit":{"type":"integer"},"inFlight":{"type":"integer"},"retryAfterSeconds":{"type":"integer"}}}},"additionalProperties":true},"notice":{"type":"object","description":"Set when the account owner has not accepted the current Terms. Relay it to them.","additionalProperties":true}}},"AzureListServicesFilters":{"type":"object","properties":{"serviceFamily":{"type":"string"}},"additionalProperties":true},"AzurePricingFilters":{"type":"object","properties":{"serviceName":{"type":"string"},"serviceId":{"type":"string"},"serviceFamily":{"type":"string"},"armRegionName":{"type":"string"},"location":{"type":"string"},"meterId":{"type":"string"},"meterName":{"type":"string"},"productId":{"type":"string"},"productName":{"type":"string"},"skuId":{"type":"string"},"skuName":{"type":"string"},"armSkuName":{"type":"string"},"priceType":{"anyOf":[{"const":"Consumption"},{"const":"DevTestConsumption"},{"const":"Reservation"}]}},"additionalProperties":true}}}}