action hetzner_get_certificates {
  label: "Get all Certificates"
  description: "Returns all Certificate objects."
  provider: hetzner
  method: GET
  path: "/certificates"
  encoding: json
  input: {
    type: "object"
    properties: {
      label_selector: {
        type: "string"
      }
      name: {
        type: "string"
      }
      sort: {
        type: "string"
        enum: ["id", "id:asc", "id:desc", "name", "name:asc", "name:desc", "created", "created:asc", "created:desc"]
      }
      type: {
        type: "string"
        enum: ["uploaded", "managed"]
      }
    }
    additionalProperties: false
  }
  output: {
    type: "object"
    required: ["certificates"]
    properties: {
      certificates: {
        type: "array"
        items: {
          type: "object"
          required: ["id", "name", "labels", "certificate", "created", "not_valid_before", "not_valid_after", "domain_names", "fingerprint", "used_by"]
          properties: {
            certificate: {
              type: "string"
              description: "Certificate and chain in PEM format, in order so that each record directly certifies the one preceding"
            }
            created: {
              type: "string"
              description: "Point in time when the Resource was created (in ISO-8601 format)"
            }
            domain_names: {
              type: "array"
              description: "Domains and subdomains covered by the Certificate"
              items: {
                type: "string"
              }
            }
            fingerprint: {
              type: "string"
              description: "SHA256 fingerprint of the Certificate"
            }
            id: {
              type: "integer"
              description: "ID of the Resource"
            }
            labels: {
              type: "object"
              description: "User-defined labels (key-value pairs)"
            }
            name: {
              type: "string"
              description: "Name of the Resource. Must be unique per Project."
            }
            not_valid_after: {
              type: "string"
              description: "Point in time when the Certificate stops being valid (in ISO-8601 format)"
            }
            not_valid_before: {
              type: "string"
              description: "Point in time when the Certificate becomes valid (in ISO-8601 format)"
            }
            status: {
              type: "object"
              description: "Current status of a type `managed` Certificate, always *null* for type `uploaded` Certificates"
              properties: {
                error: {
                  type: "object"
                  description: "If issuance or renewal reports `failed`, this property contains information about what happened"
                  properties: {
                    code: {
                      type: "string"
                    }
                    message: {
                      type: "string"
                    }
                  }
                }
                issuance: {
                  type: "string"
                  description: "Status of the issuance process of the Certificate"
                  enum: ["pending", "completed", "failed"]
                }
                renewal: {
                  type: "string"
                  description: "Status of the renewal process of the Certificate."
                  enum: ["scheduled", "pending", "failed", "unavailable"]
                }
              }
            }
            type: {
              type: "string"
              description: "Type of the Certificate"
              enum: ["uploaded", "managed"]
            }
            used_by: {
              type: "array"
              description: "Resources currently using the Certificate"
              items: {
                type: "object"
                required: ["id", "type"]
                properties: {
                  id: {
                    type: "integer"
                    description: "ID of resource referenced"
                  }
                  type: {
                    type: "string"
                    description: "Type of resource referenced"
                  }
                }
              }
            }
          }
        }
      }
      meta: {
        type: "object"
        required: ["pagination"]
        properties: {
          pagination: {
            type: "object"
            required: ["last_page", "next_page", "page", "per_page", "previous_page", "total_entries"]
            properties: {
              last_page: {
                type: "number"
                description: "ID of the last page available. Can be null if the current page is the last one."
              }
              next_page: {
                type: "number"
                description: "ID of the next page. Can be null if the current page is the last one."
              }
              page: {
                type: "number"
                description: "Current page number"
              }
              per_page: {
                type: "number"
                description: "Maximum number of items shown per page in the response"
              }
              previous_page: {
                type: "number"
                description: "ID of the previous page. Can be null if the current page is the first one."
              }
              total_entries: {
                type: "number"
                description: "The total number of entries that exist in the database for this query. Nullable if unknown."
              }
            }
          }
        }
      }
    }
  }
}