openapi: 3.1.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/