Elastic Cloud API

{
  "swagger" : "2.0",
  "info" : {
    "version" : "1",
    "title" : "Elastic Cloud Enterprise API",
    "termsOfService" : ""
  },
  "host" : "{{hostname}}",
  "basePath" : "/api/v1",
  "tags" : [ {
    "name" : "Accounts"
  }, {
    "name" : "Authentication"
  }, {
    "name" : "BillingCostsAnalysis"
  }, {
    "name" : "Comments"
  }, {
    "name" : "DeploymentTemplates"
  }, {
    "name" : "Deployments"
  }, {
    "name" : "DeploymentsTrafficFilter"
  }, {
    "name" : "Extensions"
  }, {
    "name" : "IamService"
  }, {
    "name" : "Organizations"
  }, {
    "name" : "Platform"
  }, {
    "name" : "PlatformConfigurationInstances"
  }, {
    "name" : "PlatformConfigurationNetworking"
  }, {
    "name" : "PlatformConfigurationSecurity"
  }, {
    "name" : "PlatformConfigurationSnapshots"
  }, {
    "name" : "PlatformConfigurationTemplates"
  }, {
    "name" : "PlatformConfigurationTrustRelationships"
  }, {
    "name" : "PlatformInfrastructure"
  }, {
    "name" : "Stack"
  }, {
    "name" : "Telemetry"
  }, {
    "name" : "TrustedEnvironments"
  }, {
    "name" : "UserRoleAssignments"
  }, {
    "name" : "Users"
  } ],
  "schemes" : [ "https" ],
  "security" : [ {
    "basicAuth" : [ ]
  }, {
    "apiKey" : [ ]
  } ],
  "paths" : {
    "/account" : {
      "get" : {
        "tags" : [ "Accounts" ],
        "summary" : "Fetch current account information",
        "description" : "Fetch current account information.",
        "operationId" : "get-current-account",
        "produces" : [ "application/json" ],
        "parameters" : [ ],
        "responses" : {
          "200" : {
            "description" : "Account fetched successfully",
            "schema" : {
              "$ref" : "#/definitions/AccountResponse"
            }
          },
          "404" : {
            "description" : "Account not found. (code: `accounts.not_found`)",
            "headers" : {
              "x-cloud-error-codes" : {
                "type" : "string",
                "description" : "The error codes associated with the response",
                "enum" : [ "accounts.not_found" ]
              }
            },
            "schema" : {
              "$ref" : "#/definitions/BasicFailedReply"
            }
          }
        },
        "x-doc" : {
          "tag" : "Accounts"
        }
      },
      "put" : {
        "tags" : [ "Accounts" ],
        "summary" : "Updates the current account",
        "description" : "Updates the current account.",
        "operationId" : "update-current-account",
        "consumes" : [ "application/json" ],
        "produces" : [ "application/json" ],
        "parameters" : [ {
          "in" : "body",
          "name" : "body",
          "description" : "the current account",
          "required" : true,
          "schema" : {
            "$ref" : "#/definitions/AccountUpdateRequest"
          }
        } ],
        "responses" : {
          "200" : {
            "description" : "Account updated successfully",
            "schema" : {
              "$ref" : "#/definitions/AccountResponse"
            }
          },
          "404" : {
            "description" : "Account not found. (code: `accounts.not_found`)",
            "headers" : {
              "x-cloud-error-codes" : {
                "type" : "string",
                "description" : "The error codes associated with the response",
                "enum" : [ "accounts.not_found" ]
              }
            },
            "schema" : {
              "$ref" : "#/definitions/BasicFailedReply"
            }
          }
        },
        "x-doc" : {
          "tag" : "Accounts"
        }
      },
      "patch" : {
        "tags" : [ "Accounts" ],
        "summary" : "Updates the current account",
        "description" : "Updates the current account.",
        "operationId" : "patch-current-account",
        "consumes" : [ "application/json" ],
        "produces" : [ "application/json" ],
        "parameters" : [ {
          "in" : "body",
          "name" : "body",
          "description" : "All changes in the specified object are applied to the current account according to the JSON Merge Patch processing rules. Omitting existing fields causes the same values to be reapplied. Specifying a `null` value reverts the field to the default value, or removes the field when no default value exists.",
          "required" : true,
          "schema" : {
            "type" : "string"
          }
        } ],
        "responses" : {
          "200" : {
            "description" : "Account updated successfully",
            "schema" : {
              "$ref" : "#/definitions/AccountResponse"
            }
          },
          "404" : {
            "description" : "Account not found. (code: `accounts.not_found`)",
            "headers" : {
              "x-cloud-error-codes" : {
                "type" : "string",
                "description" : "The error codes associated with the response",
                "enum" : [ "accounts.not_found" ]
              }
            },
            "schema" : {
              "$ref" : "#/definitions/BasicFailedReply"
            }
          }
        },
        "x-doc" : {
          "tag" : "Accounts"
        }
      }
    },
    "/billing/costs/{organization_id}" : {
      "get" : {
        "tags" : [ "BillingCostsAnalysis" ],
        "summary" : "Get costs overview for the organization. Currently unavailable in self-hosted ECE.",
        "description" : "Retrieves an overview of the costs by organization ID.",
        "operationId" : "get-costs-overview",
        "produces" : [ "application/json" ],
        "parameters" : [ {
          "name" : "organization_id",
          "in" : "path",
          "description" : "Identifier for the organization",
          "required" : true,
          "type" : "string"
        }, {
          "name" : "from",
          "in" : "query",
          "description" : "A datetime for the beginning of the desired range for which to fetch costs. Defaults to start of current month.",
          "required" : false,
          "type" : "string"
        }, {
          "name" : "to",
          "in" : "query",
          "description" : "A datetime for the end of the desired range for which to fetch costs. Defaults to the current date.",
          "required" : false,
          "type" : "string"
        } ],
        "deprecated" : true,
        "responses" : {
          "200" : {
            "description" : "Top-level cost overview for the organization",
            "schema" : {
              "$ref" : "#/definitions/CostsOverview"
            }
          },
          "400" : {
            "description" : "The specified date range is invalid. (code: `costs.invalid_date_range`)",
            "headers" : {
              "x-cloud-error-codes" : {
                "type" : "string",
                "description" : "The error codes associated with the response",
                "enum" : [ "costs.invalid_date_range" ]
              }
            },
            "schema" : {
              "$ref" : "#/definitions/BasicFailedReply"
            }
          },
          "403" : {
            "description" : "The current user does not have access to the requested organization. (code: `organization.invalid_access`)",
            "headers" : {
              "x-cloud-error-codes" : {
                "type" : "string",
                "description" : "The error codes associated with the response",
                "enum" : [ "organization.invalid_access" ]
              }
            },
            "schema" : {
              "$ref" : "#/definitions/BasicFailedReply"
            }
          },
          "404" : {
            "description" : "Organization not found. (code: `organization.not_found`)",
            "headers" : {
              "x-cloud-error-codes" : {
                "type" : "string",
                "description" : "The error codes associated with the response",
                "enum" : [ "organization.not_found" ]
              }
            },
            "schema" : {
              "$ref" : "#/definitions/BasicFailedReply"
            }
          },
          "500" : {
            "description" : "An error occurred when fetching an overview of the costs for the organization. (code: `billing_service.failed_request`)",
            "headers" : {
              "x-cloud-error-codes" : {
                "type" : "string",
                "description" : "The error codes associated with the response",
                "enum" : [ "billing_service.failed_request" ]
              }
            },
            "schema" : {
              "$ref" : "#/definitions/BasicFailedReply"
            }
          }
        },
        "x-doc" : {
          "tag" : "Billing Costs Analysis"
        }
      }
    },
    "/billing/costs/{organization_id}/charts" : {
      "get" : {
        "tags" : [ "BillingCostsAnalysis" ],
        "summary" : "Get charts for the organization. Currently unavailable in self-hosted ECE.",
        "description" : "Retrieves the usage charts for the organization.",
        "operationId" : "get-costs-charts",
        "produces" : [ "application/json" ],
        "parameters" : [ {
          "name" : "organization_id",
          "in" : "path",
          "description" : "Identifier for the organization",
          "required" : true,
          "type" : "string"
        }, {
          "name" : "from",
          "in" : "query",
          "description" : "A datetime for the beginning of the desired range for which to fetch costs. Defaults to start of current month.",
          "required" : false,
          "type" : "string"
        }, {
          "name" : "to",
          "in" : "query",
          "description" : "A datetime for the end of the desired range for which to fetch costs. Defaults to the current date.",
          "required" : false,
          "type" : "string"
        }, {
          "name" : "bucketing_strategy",
          "in" : "query",
          "description" : "The desired bucketing strategy for the charts. Defaults to `daily`.",
          "required" : false,
          "type" : "string",
          "default" : "daily",
          "enum" : [ "daily", "monthly" ]
        } ],
        "deprecated" : true,
        "responses" : {
          "200" : {
            "description" : "The usage charts of an organization.",
            "schema" : {
              "$ref" : "#/definitions/ChartItems"
            }
          },
          "400" : {
            "description" : "The specified date range is invalid. (code: `costs.invalid_date_range`)",
            "headers" : {
              "x-cloud-error-codes" : {
                "type" : "string",
                "description" : "The error codes associated with the response",
                "enum" : [ "costs.invalid_date_range" ]
              }
            },
            "schema" : {
              "$ref" : "#/definitions/BasicFailedReply"
            }
          },
          "403" : {
            "description" : "The current user does not have access to the requested organization. (code: `organization.invalid_access`)",
            "headers" : {
              "x-cloud-error-codes" : {
                "type" : "string",
                "description" : "The error codes associated with the response",
                "enum" : [ "organization.invalid_access" ]
              }
            },
            "schema" : {
              "$ref" : "#/definitions/BasicFailedReply"
            }
          },
          "404" : {
            "description" : "Organization not found. (code: `organization.not_found`)",
            "headers" : {
              "x-cloud-error-codes" : {
                "type" : "string",
                "description" : "The error codes associated with the response",
                "enum" : [ "organization.not_found" ]
              }
            },
            "schema" : {
              "$ref" : "#/definitions/BasicFailedReply"
            }
          },
          "429" : {
            "description" : "Too many requests. (code: `billing_service.rate_limited`)",
            "headers" : {
              "x-cloud-error-codes" : {
                "type" : "string",
                "description" : "The error codes associated with the response",
                "enum" : [ "billing_service.rate_limited" ]
              }
            },
            "schema" : {
              "$ref" : "#/definitions/BasicFailedReply"
            }
          },
          "500" : {
            "description" : "Error fetching the itemized costs for the organization. (code: `billing_service.failed_request`)",
            "headers" : {
              "x-cloud-error-codes" : {
                "type" : "string",
                "description" : "The error codes associated with the response",
                "enum" : [ "billing_service.failed_request" ]
              }
            },
            "schema" : {
              "$ref" : "#/definitions/BasicFailedReply"
            }
          }
        },
        "x-doc" : {
          "tag" : "Billing Costs Analysis"
        }
      }
    },
    "/billing/costs/{organization_id}/deployments" : {
      "get" : {
        "tags" : [ "BillingCostsAnalysis" ],
        "summary" : "Get deployments costs for the organization. Currently unavailable in self-hosted ECE.",
        "description" : "Retrieves the costs associated with all deployments for the organization.",
        "operationId" : "get-costs-deployments",
        "produces" : [ "application/json" ],
        "parameters" : [ {
          "name" : "organization_id",
          "in" : "path",
          "description" : "Identifier for the organization",
          "required" : true,
          "type" : "string"
        }, {
          "name" : "from",
          "in" : "query",
          "description" : "A datetime for the beginning of the desired range for which to fetch activity. Defaults to start of current month.",
          "required" : false,
          "type" : "string"
        }, {
          "name" : "to",
          "in" : "query",
          "description" : "A datetime for the end of the desired range for which to fetch activity. Defaults to the current date.",
          "required" : false,
          "type" : "string"
        }, {
          "name" : "Accept",
          "in" : "header",
          "description" : "Accept header containing the content preference.",
          "required" : false,
          "type" : "string"
        } ],
        "deprecated" : true,
        "responses" : {
          "200" : {
            "description" : "The costs associated to a set of products",
            "schema" : {
              "$ref" : "#/definitions/DeploymentsCosts"
            }
          },
          "400" : {
            "description" : "Invalid date range specified. (code: `costs.invalid_date_range`)",
            "headers" : {
              "x-cloud-error-codes" : {
                "type" : "string",
                "description" : "The error codes associated with the response",
                "enum" : [ "costs.invalid_date_range" ]
              }
            },
            "schema" : {
              "$ref" : "#/definitions/BasicFailedReply"
            }
          },
          "403" : {
            "description" : "The current user does not have access to the requested organization. (code: `organization.invalid_access`)",
            "headers" : {
              "x-cloud-error-codes" : {
                "type" : "string",
                "description" : "The error codes associated with the response",
                "enum" : [ "organization.invalid_access" ]
              }
            },
            "schema" : {
              "$ref" : "#/definitions/BasicFailedReply"
            }
          },
          "404" : {
            "description" : "Organization not found. (code: `organization.not_found`)",
            "headers" : {
              "x-cloud-error-codes" : {
                "type" : "string",
                "description" : "The error codes associated with the response",
                "enum" : [ "organization.not_found" ]
              }
            },
            "schema" : {
              "$ref" : "#/definitions/BasicFailedReply"
            }
          },
          "500" : {
            "description" : "An error occurred when fetching the costs associated with all deployments for the organization. (code: `billing_service.failed_request`)",
            "headers" : {
              "x-cloud-error-codes" : {
                "type" : "string",
                "description" : "The error codes associated with the response",
                "enum" : [ "billing_service.failed_request" ]
              }
            },
            "schema" : {
              "$ref" : "#/definitions/BasicFailedReply"
            }
          }
        },
        "x-doc" : {
          "tag" : "Billing Costs Analysis"
        }
      }
    },
    "/billing/costs/{organization_id}/deployments/{deployment_id}/charts" : {
      "get" : {
        "tags" : [ "BillingCostsAnalysis" ],
        "summary" : "Get charts by deployment. Currently unavailable in self-hosted ECE.",
        "description" : "Retrieves the usage charts for the given  deployment.",
        "operationId" : "get-costs-charts-by-deployment",
        "produces" : [ "application/json" ],
        "parameters" : [ {
          "name" : "organization_id",
          "in" : "path",
          "description" : "Identifier for the organization",
          "required" : true,
          "type" : "string"
        }, {
          "name" : "deployment_id",
          "in" : "path",
          "description" : "Id of a Deployment",
          "required" : true,
          "type" : "string"
        }, {
          "name" : "from",
          "in" : "query",
          "description" : "A datetime for the beginning of the desired range for which to fetch costs. Defaults to start of current month.",
          "required" : false,
          "type" : "string"
        }, {
          "name" : "to",
          "in" : "query",
          "description" : "A datetime for the end of the desired range for which to fetch costs. Defaults to the current date.",
          "required" : false,
          "type" : "string"
        }, {
          "name" : "bucketing_strategy",
          "in" : "query",
          "description" : "The desired bucketing strategy for the charts. Defaults to `daily`.",
          "required" : false,
          "type" : "string",
          "default" : "daily",
          "enum" : [ "daily", "monthly" ]
        } ],
        "deprecated" : true,
        "responses" : {
          "200" : {
            "description" : "The usage charts of a deployment.",
            "schema" : {
              "$ref" : "#/definitions/ChartItems"
            }
          },
          "400" : {
            "description" : "The specified date range is invalid. (code: `costs.invalid_date_range`)",
            "headers" : {
              "x-cloud-error-codes" : {
                "type" : "string",
                "description" : "The error codes associated with the response",
                "enum" : [ "costs.invalid_date_range" ]
              }
            },
            "schema" : {
              "$ref" : "#/definitions/BasicFailedReply"
            }
          },
          "403" : {
            "description" : "The current user does not have access to the requested organization. (code: `organization.invalid_access`)",
            "headers" : {
              "x-cloud-error-codes" : {
                "type" : "string",
                "description" : "The error codes associated with the response",
                "enum" : [ "organization.invalid_access" ]
              }
            },
            "schema" : {
              "$ref" : "#/definitions/BasicFailedReply"
            }
          },
          "404" : {
            "description" : "Organization not found. (code: `organization.not_found`)",
            "headers" : {
              "x-cloud-error-codes" : {
                "type" : "string",
                "description" : "The error codes associated with the response",
                "enum" : [ "organization.not_found" ]
              }
            },
            "schema" : {
              "$ref" : "#/definitions/BasicFailedReply"
            }
          },
          "429" : {
            "description" : "Too many requests. (code: `billing_service.rate_limited`)",
            "headers" : {
              "x-cloud-error-codes" : {
                "type" : "string",
                "description" : "The error codes associated with the response",
                "enum" : [ "billing_service.rate_limited" ]
              }
            },
            "schema" : {
              "$ref" : "#/definitions/BasicFailedReply"
            }
          },
          "500" : {
            "description" : "Error fetching the itemized costs for the organization. (code: `billing_service.failed_request`)",
            "headers" : {
              "x-cloud-error-codes" : {
                "type" : "string",
                "description" : "The error codes associated with the response",
                "enum" : [ "billing_service.failed_request" ]
              }
            },
            "schema" : {
              "$ref" : "#/definitions/BasicFailedReply"
            }
          }
        },
        "x-doc" : {
          "tag" : "Billing Costs Analysis"
        }
      }
    },
    "/billing/costs/{organization_id}/deployments/{deployment_id}/items" : {
      "get" : {
        "tags" : [ "BillingCostsAnalysis" ],
        "summary" : "Get itemized costs by deployments. Currently unavailable in self-hosted ECE.",
        "description" : "Retrieves the itemized costs for the given deployment.",
        "operationId" : "get-costs-items-by-deployment",
        "produces" : [ "application/json" ],
        "parameters" : [ {
          "name" : "organization_id",
          "in" : "path",
          "description" : "Identifier for the organization",
          "required" : true,
          "type" : "string"
        }, {
          "name" : "deployment_id",
          "in" : "path",
          "description" : "Id of a Deployment",
          "required" : true,
          "type" : "string"
        }, {
          "name" : "from",
          "in" : "query",
          "description" : "A datetime for the beginning of the desired range for which to fetch costs. Defaults to start of current month.",
          "required" : false,
          "type" : "string"
        }, {
          "name" : "to",
          "in" : "query",
          "description" : "A datetime for the end of the desired range for which to fetch costs. Defaults to the current date.",
          "required" : false,
          "type" : "string"
        }, {
          "name" : "Accept",
          "in" : "header",
          "description" : "Determines the response body format. Can be either application/json or text/csv.",
          "required" : false,
          "type" : "string"
        } ],
        "deprecated" : true,
        "responses" : {
          "200" : {
            "description" : "The costs associated to a set items billed for a single deployment.",
            "schema" : {
              "$ref" : "#/definitions/ItemsCosts"
            }
          },
          "400" : {
            "description" : "The specified date range is invalid. (code: `costs.invalid_date_range`)",
            "headers" : {
              "x-cloud-error-codes" : {
                "type" : "string",
                "description" : "The error codes associated with the response",
                "enum" : [ "costs.invalid_date_range" ]
              }
            },
            "schema" : {
              "$ref" : "#/definitions/BasicFailedReply"
            }
          },
          "403" : {
            "description" : "The current user does not have access to the requested organization. (code: `organization.invalid_access`)",
            "headers" : {
              "x-cloud-error-codes" : {
                "type" : "string",
                "description" : "The error codes associated with the response",
                "enum" : [ "organization.invalid_access" ]
              }
            },
            "schema" : {
              "$ref" : "#/definitions/BasicFailedReply"
            }
          },
          "404" : {
            "description" : "* The organization was not found. (code: `organization.not_found`)\n* The Elasticsearch cluster was not found. (code: `billing_service.es_cluster_id_not_found`)",
            "headers" : {
              "x-cloud-error-codes" : {
                "type" : "string",
                "description" : "The error codes associated with the response",
                "enum" : [ "organization.not_found", "billing_service.es_cluster_id_not_found" ]
              }
            },
            "schema" : {
              "$ref" : "#/definitions/BasicFailedReply"
            }
          },
          "500" : {
            "description" : "An error occurred when fetching the itemized costs for the given deployment of the organization. (code: `billing_service.failed_request`)",
            "headers" : {
              "x-cloud-error-codes" : {
                "type" : "string",
                "description" : "The error codes associated with the response",
                "enum" : [ "billing_service.failed_request" ]
              }
            },
            "schema" : {
              "$ref" : "#/definitions/BasicFailedReply"
            }
          }
        },
        "x-doc" : {
          "tag" : "Billing Costs Analysis"
        }
      }
    },
    "/billing/costs/{organization_id}/items" : {
      "get" : {
        "tags" : [ "BillingCostsAnalysis" ],
        "summary" : "Get itemized costs for the organization. Currently unavailable in self-hosted ECE.",
        "description" : "Retrieves the itemized costs for the organization.",
        "operationId" : "get-costs-items",
        "produces" : [ "application/json" ],
        "parameters" : [ {
          "name" : "organization_id",
          "in" : "path",
          "description" : "Identifier for the organization",
          "required" : true,
          "type" : "string"
        }, {
          "name" : "from",
          "in" : "query",
          "description" : "A datetime for the beginning of the desired range for which to fetch costs. Defaults to start of current month.",
          "required" : false,
          "type" : "string"
        }, {
          "name" : "to",
          "in" : "query",
          "description" : "A datetime for the end of the desired range for which to fetch costs. Defaults to the current date.",
          "required" : false,
          "type" : "string"
        } ],
        "deprecated" : true,
        "responses" : {
          "200" : {
            "description" : "The costs associated to a set of items",
            "schema" : {
              "$ref" : "#/definitions/ItemsCosts"
            }
          },
          "400" : {
            "description" : "The specified date range is invalid. (code: `costs.invalid_date_range`)",
            "headers" : {
              "x-cloud-error-codes" : {
                "type" : "string",
                "description" : "The error codes associated with the response",
                "enum" : [ "costs.invalid_date_range" ]
              }
            },
            "schema" : {
              "$ref" : "#/definitions/BasicFailedReply"
            }
          },
          "403" : {
            "description" : "The current user does not have access to the requested organization. (code: `organization.invalid_access`)",
            "headers" : {
              "x-cloud-error-codes" : {
                "type" : "string",
                "description" : "The error codes associated with the response",
                "enum" : [ "organization.invalid_access" ]
              }
            },
            "schema" : {
              "$ref" : "#/definitions/BasicFailedReply"
            }
          },
          "404" : {
            "description" : "Organization not found. (code: `organization.not_found`)",
            "headers" : {
              "x-cloud-error-codes" : {
                "type" : "string",
                "description" : "The error codes associated with the response",
                "enum" : [ "organization.not_found" ]
              }
            },
            "schema" : {
              "$ref" : "#/definitions/BasicFailedReply"
            }
          },
          "500" : {
            "description" : "Error fetching the itemized costs for the organization. (code: `billing_service.failed_request`)",
            "headers" : {
              "x-cloud-error-codes" : {
                "type" : "string",
                "description" : "The error codes associated with the response",
                "enum" : [ "billing_service.failed_request" ]
              }
            },
            "schema" : {
              "$ref" : "#/definitions/BasicFailedReply"
            }
          }
        },
        "x-doc" : {
          "tag" : "Billing Costs Analysis"
        }
      }
    },
    "/comments/{resource_type}/{resource_id}" : {
      "get" : {
        "tags" : [ "Comments" ],
        "summary" : "List Comments",
        "description" : "Retrieves all the comments for a given Resource, in reverse modified time order.",
        "operationId" : "list-comment",
        "produces" : [ "application/json" ],
        "parameters" : [ {
          "name" : "resource_type",
          "in" : "path",
          "description" : "The kind of Resource that a Comment belongs to. Should be one of [elasticsearch, kibana, apm, appsearch, enterprise_search, integrations_server, allocator, constructor, runner, proxy].",
          "required" : true,
          "type" : "string"
        }, {
          "name" : "resource_id",
          "in" : "path",
          "description" : "Id of the Resource that a Comment belongs to.",
          "required" : true,
          "type" : "string"
        } ],
        "responses" : {
          "200" : {
            "description" : "The Comments",
            "schema" : {
              "$ref" : "#/definitions/CommentsWithMetas"
            }
          }
        },
        "x-doc" : {
          "tag" : "Comments"
        }
      },
      "post" : {
        "tags" : [ "Comments" ],
        "summary" : "Create a Comment",
        "description" : "Creates a comment for the given Resource.",
        "operationId" : "create-comment",
        "consumes" : [ "application/json" ],
        "produces" : [ "application/json" ],
        "parameters" : [ {
          "name" : "resource_type",
          "in" : "path",
          "description" : "The kind of Resource that a Comment belongs to. Should be one of [elasticsearch, kibana, apm, appsearch, enterprise_search, integrations_server, allocator, constructor, runner, proxy].",
          "required" : true,
          "type" : "string"
        }, {
          "name" : "resource_id",
          "in" : "path",
          "description" : "Id of the Resource that a Comment belongs to.",
          "required" : true,
          "type" : "string"
        }, {
          "in" : "body",
          "name" : "body",
          "description" : "Data for comment creation",
          "required" : true,
          "schema" : {
            "$ref" : "#/definitions/CommentCreateRequest"
          }
        } ],
        "responses" : {
          "201" : {
            "description" : "The Comment that was just created.",
            "headers" : {
              "x-cloud-resource-version" : {
                "type" : "string",
                "description" : "The resource version, which is used to avoid update conflicts with concurrent operations"
              },
              "x-cloud-resource-created" : {
                "type" : "string",
                "description" : "The date-time when the resource was created (ISO format relative to UTC)"
              },
              "x-cloud-resource-last-modified" : {
                "type" : "string",
                "description" : "The date-time when the resource was last modified (ISO format relative to UTC)"
              }
            },
            "schema" : {
              "$ref" : "#/definitions/Comment"
            }
          },
          "401" : {
            "description" : "Your current session does not have a user id associated with it. (code: `comments.no_user_id`)",
            "headers" : {
              "x-cloud-error-codes" : {
                "type" : "string",
                "description" : "The error codes associated with the response",
                "enum" : [ "comments.no_user_id" ]
              }
            },
            "schema" : {
              "$ref" : "#/definitions/BasicFailedReply"
            }
          },
  

# --- truncated at 32 KB (1163 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/elk-stack/refs/heads/main/openapi/_original/elk-stack-elastic-cloud-swagger.json