Microsoft Bicep

Microsoft Bicep is a domain-specific language (DSL) that uses declarative syntax to deploy Azure resources. It provides a transparent abstraction over ARM templates and offers a more concise syntax, improved type safety, and better support for modularity and code reuse.

Microsoft Bicep publishes 3 APIs on the APIs.io network: Deployments API, Template Spec Versions API, and Template Specs API. Tagged areas include ArmTemplates, Azure, Cloud, Deployment, and DevOps.

The Microsoft Bicep catalog on APIs.io includes 1 JSON-LD context and 1 Spectral governance ruleset.

Microsoft Bicep’s developer surface includes authentication, engineering blog, support, release notes, and 14 more developer resources.

🌐 Visit website 📡 Source on GitHub

35.0/100 thin ▬ flat Agent 36/100 agent ready Full breakdown ↓
scored 2026-08-20 · rubric v0.12.0

AccessFreemiumSelf serve⚡ Free to try

5 APIs

ArmTemplatesAzureCloudDeploymentDevOpsInfrastructure as Code

Kin Score

Kin Score How this is scored →
scored 2026-08-20 · rubric v0.12.0

Composite quality — 35.0/100 · thin

Contract Quality 14.7 / 25

Developer Ergonomics 3.8 / 20

Access Clarity 3.2 / 20

Operational Transparency 4.8 / 13

Contract Governance 1.2 / 12

Discoverability 7.4 / 10

Agent readiness — 36/100 · agent ready

Machine-Readable Contract 18 / 18

Agentic Access Contract 10 / 10

Documented Reversibility 0 / 6

MCP Server 0 / 12

Machine-Readable Auth 10 / 10

Idempotency 0 / 9

Stable Error Semantics 8 / 8

Request/Response Examples 0 / 7

Rate-Limit Signaling 7 / 7

Typed Event Surface 0 / 6

Agent Skills 0 / 5

Well-Known Catalog 0 / 4

Consent & Bot Identity 0 / 3

A2A Agent Card 0 / 8

Dry-Run / Simulate Mode 0 / 4

Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/microsoft-bicep: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 5

Individual APIs this provider publishes, each with its own machine-readable definition.

Rate Limits 1

Documented rate limits and quota policies.

Microsoft Bicep Rate Limits

6 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals for API financial operations.

JSON Schema 2

Standalone JSON Schema definitions for this provider's data models.

Scopes 1

OAuth scopes governing access to this provider's APIs.

Microsoft Bicep Scopes

1 scope · implicit

1 scopes

SCOPES

Documentation 3

Reference material describing how the API behaves

Contributing Guide

Contributing Guide

JSONSchema

JSONSchema

JSONSchema

JSONSchema

Agent Surfaces 1

MCP servers, agent skills, and machine-readable catalogs

AgenticAccess

AgenticAccess

Design & Contract 1

Pagination, idempotency, versioning, errors, and events

JSONLD

JSONLD

Build 3

SDKs, sample code, and the tooling you integrate with

CodeOfConduct

CodeOfConduct

GitHubOrganization

GitHubOrganization

Bicep Examples

Bicep Examples

Access & Security 5

Authentication, authorization, and security posture

SecurityPolicy

SecurityPolicy

VulnerabilityDisclosure

VulnerabilityDisclosure

DomainSecurity

DomainSecurity

Authentication

Authentication

OAuthScopes

OAuthScopes

Learn 1

Tutorials, courses, talks, and written guidance

Learning Resources

Learning Resources

Operate 2

Status, limits, changes, and where to get help

Support

Support

ReleaseNotes

ReleaseNotes

Commercial 1

Pricing, plans, and the legal terms of use

License

License

Company 1

The organization behind the API

Blog

Blog

Source (apis.yml)

name: Microsoft Bicep
description: Microsoft Bicep is a domain-specific language (DSL) that uses declarative syntax to deploy Azure resources. It
  provides a transparent abstraction over ARM templates and offers a more concise syntax, improved type safety, and better
  support for modularity and code reuse.
accessModel:
  pricing: freemium
  onboarding: self-serve
  trial: false
  try_now: true
  public: false
  label: Freemium · Self-serve signup
  confidence: high
  source:
  - plans
  - authentication
  generated: '2026-07-22'
  method: derived
image: https://docs.microsoft.com/en-us/azure/azure-resource-manager/bicep/media/bicep-logo.png
url: https://github.com/Azure/bicep
created: '2024-01-15'
modified: '2026-05-19'
specificationVersion: '0.23'
tags:
- ArmTemplates
- Azure
- Cloud
- Deployment
- DevOps
- Infrastructure as Code
tags_raw:
- ARM Templates
- Azure
- Cloud
- Deployment
- DevOps
- Infrastructure as Code
apis:
- name: Bicep CLI
  description: Command-line interface for compiling and deploying Bicep files.
  image: https://docs.microsoft.com/en-us/azure/azure-resource-manager/bicep/media/bicep-logo.png
  baseURL: https://github.com/Azure/bicep
  humanURL: https://docs.microsoft.com/en-us/azure/azure-resource-manager/bicep/
  properties:
  - type: Documentation
    url: https://docs.microsoft.com/en-us/azure/azure-resource-manager/bicep/
  - type: GitHubRepository
    url: https://github.com/Azure/bicep
  - type: Installation Guide
    url: https://docs.microsoft.com/en-us/azure/azure-resource-manager/bicep/install
  - type: Bicep Playground
    url: https://bicepdemo.z22.web.core.windows.net/
  contact:
  - type: GitHubIssues
    url: https://github.com/Azure/bicep/issues
  - type: Twitter
    url: https://twitter.com/Azure
- name: Bicep Language Server
  description: Language server implementation for Bicep providing IntelliSense and validation.
  baseURL: https://github.com/Azure/bicep
  humanURL: https://github.com/Azure/bicep/tree/main/src/Bicep.LangServer
  properties:
  - type: Documentation
    url: https://github.com/Azure/bicep/blob/main/docs/contributing/language-server.md
  - type: GitHubRepository
    url: https://github.com/Azure/bicep/tree/main/src/Bicep.LangServer
  - type: VS Code Extension
    url: https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-bicep
- aid: microsoft-bicep:microsoft-bicep-deployments-api
  name: Microsoft Bicep Deployments API
  description: Create, validate, and manage ARM/Bicep template deployments
  humanURL: https://docs.microsoft.com/en-us/azure/azure-resource-manager/bicep/
  baseURL: https://github.com/Azure/bicep
  tags:
  - Deployment
  tags_raw:
  - Deployments
  properties:
  - type: OpenAPI
    url: openapi/microsoft-bicep-deployments-api-openapi.yml
  - type: Documentation
    url: https://learn.microsoft.com/en-us/rest/api/resources/deployments
  - type: Authentication
    url: https://learn.microsoft.com/en-us/azure/azure-resource-manager/management/authenticate-multi-tenant
  - type: Documentation
    url: https://learn.microsoft.com/en-us/rest/api/resources/template-specs
- aid: microsoft-bicep:microsoft-bicep-template-spec-versions-api
  name: Microsoft Bicep Template Spec Versions API
  description: Manage versions of Template Spec resources
  humanURL: https://docs.microsoft.com/en-us/azure/azure-resource-manager/bicep/
  baseURL: https://github.com/Azure/bicep
  tags:
  - Template Spec Versions
  properties:
  - type: OpenAPI
    url: openapi/microsoft-bicep-template-spec-versions-api-openapi.yml
  - type: Documentation
    url: https://learn.microsoft.com/en-us/rest/api/resources/deployments
  - type: Authentication
    url: https://learn.microsoft.com/en-us/azure/azure-resource-manager/management/authenticate-multi-tenant
  - type: Documentation
    url: https://learn.microsoft.com/en-us/rest/api/resources/template-specs
- aid: microsoft-bicep:microsoft-bicep-template-specs-api
  name: Microsoft Bicep Template Specs API
  description: Manage Template Spec resources for reusable Bicep templates
  humanURL: https://docs.microsoft.com/en-us/azure/azure-resource-manager/bicep/
  baseURL: https://github.com/Azure/bicep
  tags:
  - Template Specs
  properties:
  - type: OpenAPI
    url: openapi/microsoft-bicep-template-specs-api-openapi.yml
  - type: Documentation
    url: https://learn.microsoft.com/en-us/rest/api/resources/deployments
  - type: Authentication
    url: https://learn.microsoft.com/en-us/azure/azure-resource-manager/management/authenticate-multi-tenant
  - type: Documentation
    url: https://learn.microsoft.com/en-us/rest/api/resources/template-specs
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com
common:
- type: SecurityPolicy
  url: https://github.com/Azure/bicep/blob/main/SECURITY.md
- type: CodeOfConduct
  url: https://github.com/Azure/bicep/blob/main/CODE_OF_CONDUCT.md
- type: AgenticAccess
  url: agentic-access/microsoft-bicep-agentic-access.yml
- type: VulnerabilityDisclosure
  url: security/microsoft-bicep-vulnerability-disclosure.yml
- type: DomainSecurity
  url: security/microsoft-bicep-domain-security.yml
- type: Authentication
  url: authentication/microsoft-bicep-authentication.yml
- type: OAuthScopes
  url: scopes/microsoft-bicep-scopes.yml
- type: GitHubOrganization
  url: https://github.com/Azure
- type: Blog
  url: https://devblogs.microsoft.com/azure-sdk/
- type: Support
  url: https://docs.microsoft.com/en-us/answers/topics/azure-bicep.html
- type: Learning Resources
  url: https://docs.microsoft.com/en-us/azure/azure-resource-manager/bicep/learn-bicep
- type: Bicep Examples
  url: https://github.com/Azure/bicep/tree/main/docs/examples
- type: ReleaseNotes
  url: https://github.com/Azure/bicep/releases
- type: Contributing Guide
  url: https://github.com/Azure/bicep/blob/main/CONTRIBUTING.md
- type: License
  url: https://github.com/Azure/bicep/blob/main/LICENSE
- type: JSONLD
  url: json-ld/microsoft-bicep-context.jsonld
- type: JSONSchema
  url: json-schema/microsoft-bicep-deployment-schema.json
- type: JSONSchema
  url: json-schema/microsoft-bicep-template-spec-schema.json
include:
- name: Azure Resource Manager APIs
  url: https://management.azure.com
- name: Azure Template Specs
  url: https://docs.microsoft.com/en-us/azure/azure-resource-manager/templates/template-specs
- name: Azure Container Registry (for Bicep modules)
  url: https://azure.microsoft.com/en-us/services/container-registry/