action braze_custom_events_analytics {
  label: "Custom Events Analytics"
  description: "This endpoint allows you to retrieve a series of the number of occurrences of a custom event in your app over a designated time period.\n\n### Components Used\n-[Segment Identifier](https://www.braze.com/docs/api/identifier_types/)\n\n\n## Response\n\n```json\nContent-Type: application/json\nAuthorization: Bearer YOUR-REST-API-KEY\n{\n    \"message\": (required, string) the status of the export, returns 'success' when completed without errors,\n    \"data\" : [\n        {\n            \"time\" : (string) point in time - as ISO 8601 extended when unit is \"hour\" and as ISO 8601 date when unit is \"day\",\n            \"count\" : (int)\n        },\n        ...\n    ]\n}\n```\n\n### Fatal Error Response Codes\nThe following status codes and associated error messages will be returned if your request encounters a fatal error. Any of these error codes indicate that no data will be processed.\n\n| Error Code       | Reason / Cause                                                   |\n| ---------------- | ---------------------------------------------------------------- |\n| 400 Bad Request  | Bad Syntax                                                       |\n| 401 Unauthorized | Unknown or missing REST API Key                                  |\n| 429 Rate Limited | Over rate limit                                                  |\n| 5XX              | Internal server error, you should retry with exponential backoff |"
  provider: braze
  method: GET
  path: "/events/data_series"
  encoding: json
  input: {
    type: "object"
    properties: {
      app_id: {
        type: "string"
      }
      ending_at: {
        type: "string"
      }
      event: {
        type: "string"
      }
      length: {
        type: "string"
      }
      segment_id: {
        type: "string"
      }
      unit: {
        type: "string"
      }
    }
    additionalProperties: false
  }
  output: {
    type: "object"
    additionalProperties: true
  }
}