Dapr

Dapr Metadata API

Sidecar metadata operations.

GitHub OpenAPI

Operations 2

GET /v1.0/metadata Dapr Get Metadata #
PUT /v1.0/metadata/{key} Dapr Set Metadata #

Documentation

📖
Documentation
https://docs.dapr.io/reference/api/state_api/
📖
Documentation
https://docs.dapr.io/reference/api/pubsub_api/
📖
Documentation
https://docs.dapr.io/reference/api/service_invocation_api/
📖
Documentation
https://docs.dapr.io/reference/api/bindings_api/
📖
Documentation
https://docs.dapr.io/reference/api/secrets_api/
📖
Documentation
https://docs.dapr.io/reference/api/actors_api/
📖
Documentation
https://docs.dapr.io/reference/api/workflow_api/
📖
Documentation
https://docs.dapr.io/reference/api/configuration_api/
📖
Documentation
https://docs.dapr.io/reference/api/distributed_lock_api/
📖
Documentation
https://docs.dapr.io/reference/api/cryptography_api/
📖
Documentation
https://docs.dapr.io/reference/api/jobs_api/
📖
Documentation
https://docs.dapr.io/reference/api/health_api/
📖
Documentation
https://docs.dapr.io/reference/api/metadata_api/

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/dapr/refs/heads/main/openapi/dapr-metadata-api-openapi.yml
⚙
AsyncAPI
https://raw.githubusercontent.com/api-evangelist/dapr/refs/heads/main/asyncapi/dapr-pubsub-asyncapi.yml

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/dapr/refs/heads/main/json-schema/state-item.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/dapr/refs/heads/main/json-schema/cloud-event.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/dapr/refs/heads/main/json-schema/binding.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/dapr/refs/heads/main/json-schema/secret.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/dapr/refs/heads/main/json-schema/actor.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/dapr/refs/heads/main/json-schema/workflow.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/dapr/refs/heads/main/json-schema/configuration-item.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/dapr/refs/heads/main/json-schema/job.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/dapr/refs/heads/main/json-schema/metadata.json

Other Resources

🔗
Reference
https://docs.dapr.io/developing-applications/building-blocks/state-management/
🔗
Client Libraries
https://docs.dapr.io/sdks/
🔗
Reference
https://docs.dapr.io/developing-applications/building-blocks/pubsub/
🔗
Reference
https://docs.dapr.io/developing-applications/building-blocks/service-invocation/
🔗
Reference
https://docs.dapr.io/developing-applications/building-blocks/bindings/
🔗
Reference
https://docs.dapr.io/developing-applications/building-blocks/secrets/
🔗
Reference
https://docs.dapr.io/developing-applications/building-blocks/actors/
🔗
Reference
https://docs.dapr.io/developing-applications/building-blocks/workflow/
🔗
Reference
https://docs.dapr.io/developing-applications/building-blocks/configuration/
🔗
Reference
https://docs.dapr.io/developing-applications/building-blocks/distributed-lock/
🔗
Reference
https://docs.dapr.io/developing-applications/building-blocks/cryptography/
🔗
Reference
https://docs.dapr.io/developing-applications/building-blocks/jobs/
🔗
Reference
https://docs.dapr.io/operations/observability/healthchecks/
🔗
Reference
https://docs.dapr.io/operations/observability/

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/dapr-metadata-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

dapr-metadata-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Dapr Actors Metadata API
  description: The Dapr Actors API provides virtual actor capabilities for distributed applications, including actor method invocation, state management, timers, and reminders. Actors provide a single-threaded programming model with guaranteed message ordering.
  version: 1.0.0
  contact:
    name: Dapr
    url: https://dapr.io
  license:
    name: Apache 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0
servers:
- url: http://localhost:3500
  description: Dapr Sidecar
tags:
- name: Metadata
  description: Sidecar metadata operations.
paths:
  /v1.0/metadata:
    get:
      summary: Dapr Get Metadata
      description: Returns information about the Dapr sidecar, including app connection details, registered components, subscriptions, and HTTP endpoints.
      operationId: getMetadata
      tags:
      - Metadata
      responses:
        '200':
          description: Metadata retrieved successfully.
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                    description: The application ID.
                  runtimeVersion:
                    type: string
                    description: The Dapr runtime version.
                  enabledFeatures:
                    type: array
                    items:
                      type: string
                    description: List of enabled features.
                  actors:
                    type: array
                    items:
                      type: object
                      properties:
                        type:
                          type: string
                        count:
                          type: integer
                    description: Registered actor types and counts.
                  components:
                    type: array
                    items:
                      type: object
                      properties:
                        name:
                          type: string
                        type:
                          type: string
                        version:
                          type: string
                        capabilities:
                          type: array
                          items:
                            type: string
                    description: Registered components.
                  subscriptions:
                    type: array
                    items:
                      type: object
                      properties:
                        pubsubname:
                          type: string
                        topic:
                          type: string
                        rules:
                          type: array
                          items:
                            type: object
                        deadLetterTopic:
                          type: string
                    description: Active subscriptions.
                  httpEndpoints:
                    type: array
                    items:
                      type: object
                      properties:
                        name:
                          type: string
                    description: Registered HTTP endpoints.
                  appConnectionProperties:
                    type: object
                    properties:
                      port:
                        type: integer
                      protocol:
                        type: string
                      channelAddress:
                        type: string
                      maxConcurrency:
                        type: integer
                      health:
                        type: object
                        properties:
                          healthCheckPath:
                            type: string
                          healthProbeInterval:
                            type: string
                          healthProbeTimeout:
                            type: string
                          healthThreshold:
                            type: integer
                    description: App connection properties.
                  extended:
                    type: object
                    additionalProperties:
                      type: string
                    description: Custom extended metadata attributes.
        '500':
          description: Failed to get metadata.
  /v1.0/metadata/{key}:
    put:
      summary: Dapr Set Metadata
      description: Sets a custom metadata attribute on the Dapr sidecar.
      operationId: setMetadata
      tags:
      - Metadata
      parameters:
      - name: key
        in: path
        required: true
        description: The metadata attribute key to set.
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: string
              description: The value to set for the metadata attribute.
      responses:
        '204':
          description: Metadata set successfully.
        '500':
          description: Failed to set metadata.
externalDocs:
  description: Dapr Actors API Reference
  url: https://docs.dapr.io/reference/api/actors_api/