> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pragmatiks.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Resource Health

> Get health status of a resource by provider, resource type, and name.

Proxies the health check to the provider runtime that manages this resource.
The provider calls the resource's health() method and returns the result.

Returns:
    ResourceHealth with status (healthy, unhealthy, degraded) and optional details.

Raises:
    HTTPException: 404 if health check not available, 504 on timeout, 502 on provider error.



## OpenAPI

````yaml https://api.pragmatiks.io/openapi.json get /projects/{project_id}/resources/health
openapi: 3.1.0
info:
  title: Pragma API
  version: 0.1.0
servers: []
security: []
paths:
  /projects/{project_id}/resources/health:
    get:
      tags:
        - resources
      summary: Get Resource Health
      description: >-
        Get health status of a resource by provider, resource type, and name.


        Proxies the health check to the provider runtime that manages this
        resource.

        The provider calls the resource's health() method and returns the
        result.


        Returns:
            ResourceHealth with status (healthy, unhealthy, degraded) and optional details.

        Raises:
            HTTPException: 404 if health check not available, 504 on timeout, 502 on provider error.
      operationId: resources-get_resource_health
      parameters:
        - name: project_id
          in: path
          required: true
          schema:
            type: string
            title: Project Id
        - name: provider
          in: query
          required: true
          schema:
            type: string
            description: Provider name
            title: Provider
          description: Provider name
        - name: resource
          in: query
          required: true
          schema:
            type: string
            description: Resource type
            title: Resource
          description: Resource type
        - name: name
          in: query
          required: true
          schema:
            type: string
            description: Resource name
            title: Name
          description: Resource name
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResourceHealth'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    ResourceHealth:
      properties:
        status:
          type: string
          title: Status
        message:
          anyOf:
            - type: string
            - type: 'null'
          title: Message
        details:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Details
      type: object
      required:
        - status
      title: ResourceHealth
      description: |-
        Health status of a resource reported by its provider.

        Attributes:
            status: Health state (healthy, unhealthy, degraded).
            message: Optional human-readable description.
            details: Optional provider-specific health check details.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError

````