Dapr

Dapr Configuration API

Configuration management operations.

GitHub OpenAPI

Operations 3

GET /v1.0/configuration/{storename} Dapr Get Configuration #
GET /v1.0/configuration/{storename}/subscribe Dapr Subscribe to Configuration #
GET /v1.0/configuration/{storename}/{subscriptionId}/unsubscribe Dapr Unsubscribe from Configuration #

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-configuration-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-configuration-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-configuration-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Dapr Configuration API
  description: The Dapr Configuration API enables applications to retrieve and subscribe to configuration items from supported configuration stores. Applications can retrieve specific configuration items at startup or subscribe to receive updates when configuration changes occur.
  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: Configuration
  description: Configuration management operations.
paths:
  /v1.0/configuration/{storename}:
    get:
      summary: Dapr Get Configuration
      description: Retrieves configuration items from the specified configuration store. If no keys are specified, all configuration items are returned.
      operationId: getConfiguration
      tags:
      - Configuration
      parameters:
      - name: storename
        in: path
        required: true
        description: The name of the configuration store.
        schema:
          type: string
      - name: key
        in: query
        description: The key(s) of the configuration items to retrieve. Can be specified multiple times.
        schema:
          type: array
          items:
            type: string
        style: form
        explode: true
      responses:
        '200':
          description: Configuration items retrieved successfully.
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  type: object
                  properties:
                    value:
                      type: string
                    version:
                      type: string
                    metadata:
                      type: object
                      additionalProperties:
                        type: string
        '400':
          description: Configuration store not found or misconfigured.
        '500':
          description: Failed to get configuration.
  /v1.0/configuration/{storename}/subscribe:
    get:
      summary: Dapr Subscribe to Configuration
      description: Subscribes to configuration changes from the specified store. Returns a subscription ID that can be used to unsubscribe later.
      operationId: subscribeConfiguration
      tags:
      - Configuration
      parameters:
      - name: storename
        in: path
        required: true
        description: The name of the configuration store.
        schema:
          type: string
      - name: key
        in: query
        description: The key(s) to subscribe to. If empty, subscribes to all keys.
        schema:
          type: array
          items:
            type: string
        style: form
        explode: true
      responses:
        '200':
          description: Subscription created successfully.
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                    description: The subscription ID.
        '400':
          description: Configuration store not found.
        '500':
          description: Failed to subscribe.
  /v1.0/configuration/{storename}/{subscriptionId}/unsubscribe:
    get:
      summary: Dapr Unsubscribe from Configuration
      description: Unsubscribes from configuration changes using a subscription ID.
      operationId: unsubscribeConfiguration
      tags:
      - Configuration
      parameters:
      - name: storename
        in: path
        required: true
        description: The name of the configuration store.
        schema:
          type: string
      - name: subscriptionId
        in: path
        required: true
        description: The subscription ID to unsubscribe.
        schema:
          type: string
      responses:
        '200':
          description: Unsubscribed successfully.
          content:
            application/json:
              schema:
                type: object
                properties:
                  ok:
                    type: boolean
        '400':
          description: Subscription not found.
        '500':
          description: Failed to unsubscribe.
externalDocs:
  description: Dapr Configuration API Reference
  url: https://docs.dapr.io/reference/api/configuration_api/