> ## Documentation Index > Fetch the complete documentation index at: https://ravion-b90c0359-devin-1788408180-cross-module-output-refs.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # List InfrastructureEvents > List events filtered by resource OR by deploy. GET /infrastructure-events in the Ravion API reference. ## OpenAPI ````yaml https://api.ravion.com/openapi.yaml get /infrastructure-events openapi: 3.0.0 info: title: Ravion version: 0.0.0 servers: - url: https://api.ravion.com security: - BearerAuth: [] tags: - name: Projects - name: Environments - name: FeatureFlags - name: Pipelines - name: PipelineRuns - name: TerraformResources - name: TerraformExecutionSummaries - name: PipelineStepExecutions - name: AwsCloudWatch - name: PipelineVersions - name: Organizations - name: Stacks - name: StackWorkspaces - name: Auth - name: OAuth - name: User - name: Health - name: Memberships - name: ServiceAccounts - name: AwsDefaultNetworks - name: AwsAccounts - name: ApiKeys - name: AwsAmp - name: EksPrometheus - name: EksLoki - name: ExecutionEnvironments - name: ModuleDefinitions - name: ModuleCategories - name: ModuleVersions - name: ModuleInstances - name: DefaultValueDefinitions - name: DefaultValues - name: CodeSources - name: Github - name: Gitlab - name: Git - name: Values - name: Deployments - name: DeploymentResources - name: InfrastructureEvents - name: WebSocket - name: Domains - name: AcmCertificates - name: Describe - name: Reports - name: BillingPlans - name: BillingAccounts - name: BillingCycles - name: BillingUsageSummaries - name: BillingAddOns - name: BillingInvoices paths: /infrastructure-events: get: tags: - InfrastructureEvents summary: List InfrastructureEvents description: |- List events filtered by resource OR by deploy. Kind filter is optional; omitting it returns both task-state-change and service-action events so the drawer can build a unified timeline in a single call. operationId: ListInfrastructureEvents parameters: - in: query name: deploymentResourceId schema: nullable: true type: string - in: query name: moduleDeploymentId schema: nullable: true type: string - in: query name: kind schema: nullable: true type: string - $ref: '#/components/parameters/PaginationQueryParams.cursor' - $ref: '#/components/parameters/PaginationQueryParams.limit' responses: '200': content: application/json: schema: additionalProperties: false properties: data: $ref: '#/components/schemas/InfrastructureEvent.ListResponse' required: - data type: object description: The request has succeeded. '401': content: application/json: schema: $ref: '#/components/schemas/Errors.UserFacingErrorData' description: You are not authenticated '403': content: application/json: schema: $ref: '#/components/schemas/Errors.UserFacingErrorData' description: You do not have permission to access this resource. '404': content: application/json: schema: $ref: '#/components/schemas/Errors.UserFacingErrorData' description: The server cannot find the requested resource. '500': content: application/json: schema: $ref: '#/components/schemas/Errors.UserFacingErrorData' description: Server error components: parameters: PaginationQueryParams.cursor: in: query name: cursor schema: nullable: true type: string PaginationQueryParams.limit: in: query name: limit schema: format: int32 nullable: true type: integer schemas: InfrastructureEvent.ListResponse: additionalProperties: false properties: data: items: $ref: '#/components/schemas/InfrastructureEvent.Summary' type: array required: - data type: object Errors.UserFacingErrorData: additionalProperties: false description: |- User-facing error presentation data. This is what the API returns to the frontend after formatting ErrorData using CEL templates from the error registry. Used for both: - Error fields on domain models (e.g., PipelineRun.error) - API error response bodies (HTTP 4xx/5xx responses) properties: action: allOf: - $ref: '#/components/schemas/Errors.Action' description: Optional action to help resolve the error code: description: Full error code, e.g., "Ravion:Pipeline:NOT_FOUND" type: string description: description: Additional description with more details type: string details: description: Structured details rendered as user-facing sections. items: $ref: '#/components/schemas/Errors.UserFacingErrorDetailSection' type: array isInternal: description: >- Indicates whether this error is internal (only set when ShowInternal=true). This allows SUPERADMINs to identify internal errors while viewing full details. type: boolean message: description: Main error message (required) type: string metadata: additionalProperties: {} description: >- Error params/metadata. Stripped for internal errors unless superadmin. type: object requestId: description: Request ID for correlating errors with server logs. type: string required: - code - message type: object InfrastructureEvent.Summary: additionalProperties: false properties: awsAccountId: type: string data: $ref: '#/components/schemas/InfrastructureEventData' deploymentResourceId: description: |- The deployment resource this event is about, when there is one (task state changes, future Lambda invocation phases). Null for deploy-wide events (service actions, future CloudFront polls). type: string detailType: type: string eventId: description: AWS event-envelope idempotency key. type: string eventTime: $ref: '#/components/schemas/UtcDateTime' id: type: string kind: $ref: '#/components/schemas/Deployments.InfrastructureEventKind' moduleDeploymentId: description: |- The deploy this event is about, when derivable. ECS_SERVICE_ACTION resolves this via the serviceArn bracketed against active deploy windows; ECS_TASK_STATE_CHANGE inherits it from the task's DeploymentResource.moduleDeploymentId. type: string region: type: string source: type: string required: - id - kind - eventId - eventTime - source - detailType - data type: object Errors.Action: additionalProperties: false description: Action to help user resolve the error properties: label: description: Button/link label text type: string url: description: URL to navigate to for resolution type: string required: - label - url type: object Errors.UserFacingErrorDetailSection: additionalProperties: false description: Structured user-facing error detail section. properties: items: description: List of detail values for this section. items: type: string type: array object: additionalProperties: {} description: Structured detail payload for object rendering. type: object render: description: Rendering hint for clients. Valid values are list or object. type: string title: description: Detail section title shown in the UI. type: string required: - title - render type: object InfrastructureEventData: description: |- Discriminated union over `data` payloads. Adding a new kind (LAMBDA_INVOCATION_PHASE, LAMBDA_EXECUTION_REPORT, STATIC_DISTRIBUTION_POLL) adds one enum value on `Kind` and one variant here. discriminator: mapping: EC2_ASG_INSTANCE_LIFECYCLE: $ref: '#/components/schemas/Deployments.AwsEc2AsgInstanceLifecycleData' ECS_DEPLOYMENT_STATE_CHANGE: $ref: '#/components/schemas/Deployments.EcsDeploymentStateChangeData' ECS_HOOK_STATE_CHANGE: $ref: '#/components/schemas/Deployments.EcsHookStateChangeData' ECS_SERVICE_ACTION: $ref: '#/components/schemas/Deployments.EcsServiceActionData' ECS_TASK_STATE_CHANGE: $ref: '#/components/schemas/Deployments.EcsTaskStateChangeData' K8S_EVENT: $ref: '#/components/schemas/Deployments.K8sEventData' K8S_WORKLOAD_REGRESSION: $ref: '#/components/schemas/Deployments.K8sWorkloadRegressionData' propertyName: type oneOf: - $ref: '#/components/schemas/Deployments.EcsTaskStateChangeData' - $ref: '#/components/schemas/Deployments.EcsServiceActionData' - $ref: '#/components/schemas/Deployments.EcsDeploymentStateChangeData' - $ref: '#/components/schemas/Deployments.EcsHookStateChangeData' - $ref: '#/components/schemas/Deployments.AwsEc2AsgInstanceLifecycleData' - $ref: '#/components/schemas/Deployments.K8sEventData' - $ref: '#/components/schemas/Deployments.K8sWorkloadRegressionData' type: object UtcDateTime: description: UTC RFC3339 timestamp with a required Z suffix format: date-time pattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d{1,9})?Z$ type: string x-go-type: apitypes.UTCDateTime x-go-type-import: name: apitypes path: ravion/api-go/pkg/apitypes Deployments.InfrastructureEventKind: description: |- Which event kind a InfrastructureEvent row carries. Drives the shape of its `data` JSON column. enum: - ECS_TASK_STATE_CHANGE - ECS_SERVICE_ACTION - ECS_DEPLOYMENT_STATE_CHANGE - ECS_HOOK_STATE_CHANGE - EC2_ASG_INSTANCE_LIFECYCLE - K8S_EVENT - K8S_WORKLOAD_REGRESSION - LAMBDA_FUNCTION_UPDATE_STATE_CHANGE type: string Deployments.AwsEc2AsgInstanceLifecycleData: additionalProperties: false description: >- Raw, append-only projection of an Auto Scaling instance lifecycle result. properties: activityId: type: string autoScalingGroupName: type: string availabilityZone: type: string destination: type: string instanceId: type: string lifecycleHookName: type: string lifecycleTransition: type: string notificationMetadata: type: string origin: type: string rawDetail: additionalProperties: {} description: >- Original EventBridge detail object retained for forward compatibility. type: object statusCode: type: string statusMessage: type: string subnetId: type: string type: enum: - EC2_ASG_INSTANCE_LIFECYCLE type: string required: - type - autoScalingGroupName - rawDetail type: object Deployments.EcsDeploymentStateChangeData: additionalProperties: false description: |- Typed payload for InfrastructureEvent.data when kind == ECS_DEPLOYMENT_STATE_CHANGE. AWS publishes one of these per rolling-deploy transition; the `awsDeploymentId` matches the value returned by `UpdateService`, so tower-go can correlate this event to the in-flight deploy and short-circuit its waitHealthy poll. properties: awsDeploymentId: description: |- AWS-side ECS deployment id (e.g. "ecs-svc/0436798713461887077"). Matches the `Id` returned by `ecs:UpdateService` so tower-go can reject events for stale / superseded deploys. type: string clusterArn: type: string eventName: description: |- AWS detail.eventName — the transition that fired. Known values: SERVICE_DEPLOYMENT_IN_PROGRESS, SERVICE_DEPLOYMENT_COMPLETED, SERVICE_DEPLOYMENT_FAILED. type: string eventType: description: 'Severity tag AWS attaches: "INFO" | "WARN" | "ERROR".' type: string rawDetail: additionalProperties: {} type: object reason: description: AWS free-form reason, when present. type: string serviceArn: type: string serviceDeploymentArn: description: |- ARN of the AWS service deployment, when the event carries one (`ECS Service Deployment State Change` events emitted by native blue_green / linear / canary deployments). Used to correlate the event to `EcsDeploymentData.serviceDeploymentArn`. type: string type: enum: - ECS_DEPLOYMENT_STATE_CHANGE type: string required: - type - clusterArn - serviceArn - eventName - eventType - awsDeploymentId - rawDetail type: object Deployments.EcsHookStateChangeData: additionalProperties: false description: |- Typed payload for InfrastructureEvent.data when kind == ECS_HOOK_STATE_CHANGE. AWS publishes one of these per lifecycle hook transition during a native blue_green / linear / canary deployment (`detail-type: "ECS Hook State Change"`). The ingester forwards PAUSE-hook transitions to the in-flight deploy workflow so it can surface PAUSED state (HOOK_AWAITING_ACTION) or resume its poll loop (HOOK_SUCCEEDED / HOOK_FAILED / HOOK_TIMED_OUT) without waiting for the next polling tick. properties: clusterArn: type: string eventName: description: |- AWS detail.eventName — the hook transition that fired. Known values: HOOK_AWAITING_ACTION, HOOK_SUCCEEDED, HOOK_FAILED, HOOK_TIMED_OUT. type: string eventType: description: 'Severity tag AWS attaches: "INFO" | "WARN" | "ERROR".' type: string expiresAt: description: When a pending pause hook auto-resolves (timeoutAction fires). format: date-time type: string hookId: description: |- Unique id of the hook execution. Pause hooks are continued by passing this to `ContinueServiceDeployment`. type: string hookType: description: 'Hook type: "PAUSE" | "AWS_LAMBDA".' type: string lifecycleStage: description: Lifecycle stage the hook ran at (AWS enum spelling). type: string rawDetail: additionalProperties: {} type: object serviceArn: type: string serviceDeploymentArn: description: ARN of the service deployment this hook belongs to. type: string type: enum: - ECS_HOOK_STATE_CHANGE type: string required: - type - clusterArn - serviceArn - eventName - eventType - hookId - rawDetail type: object Deployments.EcsServiceActionData: additionalProperties: false description: |- Typed payload for InfrastructureEvent.data when kind == ECS_SERVICE_ACTION. These events are about the service / deploy, not a specific task — they interleave into the drawer timeline as deploy-wide context and are linked via the envelope's moduleDeploymentId. properties: clusterArn: type: string eventName: description: |- AWS detail.eventName — the action that fired. Known values: SERVICE_STEADY_STATE, SERVICE_DEPLOYMENT_FAILED, SERVICE_TASK_START_IMPAIRED, SERVICE_DEPLOYMENT_IN_PROGRESS, SERVICE_DEPLOYMENT_COMPLETED, … type: string message: description: |- AWS free-form reason, when present. Used as the human-readable description in the drawer timeline. type: string rawDetail: additionalProperties: {} type: object serviceArn: type: string type: enum: - ECS_SERVICE_ACTION type: string required: - type - clusterArn - serviceArn - eventName - rawDetail type: object Deployments.EcsTaskStateChangeData: additionalProperties: false description: |- Typed payload for InfrastructureEvent.data when kind == ECS_TASK_STATE_CHANGE. Mirrors the EventBridge detail path so the drawer's raw-event view can render any field AWS emitted without re-parsing from the saved envelope. The ecstaskmerge state machine reads lastStatus + phase timestamps out of this shape to fold events into the DeploymentResource.data projection. Pull timestamps are extracted here per event; the instance projection aggregates them as MIN / MAX. properties: attachments: description: |- ENI / attachment snapshots. Used to extract the task's private IP for target-group join lookups. items: additionalProperties: {} type: object type: array availabilityZone: type: string capacityProviderName: type: string clusterArn: type: string connectivity: type: string containerInstanceArn: type: string containers: description: |- Per-container snapshot AWS attached to the event. Shape varies by transition — the drawer renders whatever's present. items: additionalProperties: {} type: object type: array desiredStatus: type: string exitCode: description: |- Exit code of the essential container — extracted at ingest time from the per-event `containers[]` payload. Surfaced here so the drawer's per-event view can show the exit code without re-walking the unstructured `containers` array. format: int32 type: integer healthStatus: type: string lastStatus: type: string launchType: type: string platformVersion: type: string pullStartedAt: description: |- Earliest container pullStartedAt across this event's containers array. format: date-time type: string pullStoppedAt: description: |- Latest container pullStoppedAt across this event's containers array. format: date-time type: string rawDetail: additionalProperties: {} description: |- Raw detail payload AWS emitted, kept verbatim so future AWS fields surface in the drawer without a code change. type: object startedAt: format: date-time type: string startedBy: type: string stopCode: type: string stoppedAt: format: date-time type: string stoppedReason: type: string taskArn: type: string taskDefinitionArn: type: string taskDefinitionFamily: type: string taskDefinitionRevision: format: int32 type: integer taskGroup: type: string taskTargetId: description: |- See EcsTaskData.taskTargetId — same semantics, stored per-event so the value is visible even before the instance projection merges. type: string type: enum: - ECS_TASK_STATE_CHANGE type: string required: - type - taskArn - rawDetail type: object Deployments.K8sEventData: additionalProperties: false description: Typed payload for `InfrastructureEvent.data` when kind == K8S_EVENT. properties: component: type: string eventCount: description: >- Total recurrences Kubernetes has folded into this Event, and how many of those were new since the agent's previous transmission. The pair is what makes an appended row a delta rather than a duplicate. format: int32 type: integer eventCountDelta: format: int32 type: integer eventName: type: string eventNamespace: description: |- The Event object's own identity in the cluster. Not the row's identity — the row's is the synthesized `eventId` — but it is what that synthesis is derived from, and what a reader correlates against `kubectl get events`. type: string eventType: description: |- Normal or Warning, verbatim. Free-form for the same version-skew reason every other agent-reported classification is. Named `eventType` rather than `type` because `type` is the payload's own discriminator. type: string fieldPath: description: |- Narrows the event to part of the involved object, e.g. `spec.containers{api}`. The only machine-readable link between a probe or image-pull event and the container it concerns. type: string firstAt: description: >- The cluster's clock for the event. `lastAt` is what the timeline orders by and what retention (`InfrastructureEvent.expiresAt`) is measured from — so a batch delayed by an agent's backlog does not buy its events extra life. format: date-time type: string involved: $ref: '#/components/schemas/Deployments.K8sEventInvolvedObject' lastAt: format: date-time type: string message: type: string reason: type: string release: $ref: '#/components/schemas/Deployments.K8sEventReleaseRef' sequence: description: |- The batch's monotonic ordering key. Retained for forensics rather than for ordering: dedup rides the synthesized `eventId` now, so one shared sequence per batch is enough. format: int64 type: integer truncated: description: |- True when the agent cut the message to bound the uplink, so a reader knows the ellipsis is ours rather than the cluster's. type: boolean type: enum: - K8S_EVENT type: string workload: allOf: - $ref: '#/components/schemas/Deployments.K8sEventWorkloadRef' description: |- The owning workload, resolved in-cluster by the agent walking ownership. required: - type - eventType - reason - eventNamespace - eventName - involved type: object Deployments.K8sWorkloadRegressionData: additionalProperties: false description: |- Typed payload for `InfrastructureEvent.data` when kind == K8S_WORKLOAD_REGRESSION: one phase change of a post-deploy regression episode, in the shape the workload's own row keeps its live episode. Both `phase` and the workload/release identity are copied onto the event rather than left to a join, so the timeline entry stays readable after the workload row has moved on to a later episode or been retired. properties: baselineAt: format: date-time type: string churnKinds: type: string churnPodCount: format: int32 type: integer degradedAt: format: date-time type: string desiredReplicas: format: int32 type: integer flapping: type: boolean flaps: format: int32 type: integer message: type: string phase: description: |- opened | resolved. The two phase changes worth a timeline entry; `active` republishes never reach here. Free-form for the same version-skew reason every other agent-reported classification is. type: string readyReplicas: format: int32 type: integer reason: type: string release: $ref: '#/components/schemas/Deployments.K8sEventReleaseRef' resolution: description: |- For `resolved`, why the agent closed the episode. See `EksWorkloadRegression.resolution`. type: string resolvedAt: format: date-time type: string sequence: description: |- The agent's ordering key for the REGRESSION stream, so the entry can be matched to the transmission that produced it. format: int64 type: integer status: description: The rollout status the agent judged the regression from. type: string suggestedRemediation: description: >- restart | rollback, copied from the workload row's live episode. Same free-form reason, same origin: the CONTROL PLANE derived it from the agent's report, the agent did not send it, and nothing executes it. Copied onto the event for the reason `phase` and the workload identity are — the timeline entry has to stay readable after the workload row has moved on to a later episode, and "what we would have suggested at the time" is exactly the kind of fact a later reader is trying to reconstruct. type: string summary: description: Prose to lead with. Nothing should parse it. type: string symptoms: description: Comma-separated, most specific first. type: string type: enum: - K8S_WORKLOAD_REGRESSION type: string workload: $ref: '#/components/schemas/Deployments.K8sEventWorkloadRef' required: - type - phase - workload - sequence type: object Deployments.K8sEventInvolvedObject: additionalProperties: false description: |- The Kubernetes object an Event is about. Frequently a Pod that no longer exists — an evicted pod's event is often the only surviving explanation of what happened to it, so nothing here is a foreign key. properties: kind: type: string name: type: string namespace: type: string uid: type: string required: - kind - namespace - name type: object Deployments.K8sEventReleaseRef: additionalProperties: false description: |- The Helm release the event's workload belongs to, verbatim from the cluster. properties: name: type: string namespace: type: string required: - name - namespace type: object Deployments.K8sEventWorkloadRef: additionalProperties: false description: |- A Kubernetes workload reference carried alongside a relayed Event so a timeline can be scoped to the workload rather than to whichever pod happened to exist at the time. properties: kind: type: string name: type: string namespace: type: string type: object securitySchemes: BearerAuth: scheme: Bearer type: http ````