# Ravion Docs ## Docs - [Create ApiKey](https://www.ravion.com/docs/api-reference/apikeys/create-apikey.md) - [Delete ApiKey](https://www.ravion.com/docs/api-reference/apikeys/delete-apikey.md) - [Get ApiKey by id](https://www.ravion.com/docs/api-reference/apikeys/get-apikey-by-id.md) - [List ApiKeys](https://www.ravion.com/docs/api-reference/apikeys/list-apikeys.md) - [Patch ApiKey](https://www.ravion.com/docs/api-reference/apikeys/patch-apikey.md) - [Get current user information](https://www.ravion.com/docs/api-reference/auth/get-current-user-information.md) - [Log in](https://www.ravion.com/docs/api-reference/auth/log-in.md) - [Log out](https://www.ravion.com/docs/api-reference/auth/log-out.md) - [OAuth callback](https://www.ravion.com/docs/api-reference/auth/oauth-callback.md): OAuth callback. Exchanges code for user profile and performs the requested action. - [Sign up](https://www.ravion.com/docs/api-reference/auth/sign-up.md) - [Start OAuth authentication](https://www.ravion.com/docs/api-reference/auth/start-oauth-authentication.md): Start OAuth authentication flow. Redirects to the OAuth provider's authorization page. - [Verify email with one-time code](https://www.ravion.com/docs/api-reference/auth/verify-email-with-one-time-code.md): Complete an OAuth sign-in that requires email verification by submitting the one-time code emailed to the user. The pending authentication token is read from a secure cookie set during the OAuth callback. - [Create AwsAccount](https://www.ravion.com/docs/api-reference/awsaccounts/create-awsaccount.md) - [Delete AwsAccount](https://www.ravion.com/docs/api-reference/awsaccounts/delete-awsaccount.md) - [Get AwsAccount by id](https://www.ravion.com/docs/api-reference/awsaccounts/get-awsaccount-by-id.md) - [Get IAM policy diff for an AWS account](https://www.ravion.com/docs/api-reference/awsaccounts/get-iam-policy-diff-for-an-aws-account.md) - [Get the S3 CloudFormation template URL and a scoped JWT for connecting or upgrading the given AWS account](https://www.ravion.com/docs/api-reference/awsaccounts/get-the-s3-cloudformation-template-url-and-a-scoped-jwt-for-connecting-or-upgrading-the-given-aws-account.md) - [List AwsAccounts](https://www.ravion.com/docs/api-reference/awsaccounts/list-awsaccounts.md) - [Patch AwsAccount](https://www.ravion.com/docs/api-reference/awsaccounts/patch-awsaccount.md) - [Get CloudWatch metric data](https://www.ravion.com/docs/api-reference/awscloudwatch/get-cloudwatch-metric-data.md): Fetch CloudWatch metric data for a module instance UI metric. Resolves the AWS account from `awsAccountId` + `region`. Applies a short Redis cache (60s for ranges that end at `now`, 5 min for fixed ranges). - [Query CloudWatch Logs Insights histogram](https://www.ravion.com/docs/api-reference/awscloudwatch/query-cloudwatch-logs-insights-histogram.md): Compute the full-window per-level histogram for the same scope/window/filter as the row query. Separate from the row endpoint so it can be cached on a longer cadence (it scans the whole window) and so rows aren't blocked on the aggregation. - [Query CloudWatch Logs Insights rows](https://www.ravion.com/docs/api-reference/awscloudwatch/query-cloudwatch-logs-insights-rows.md): Run CloudWatch Logs Insights over a selected set of module-instance ui.logs sources, filtered by a structured predicate tree. Returns normalized log rows (paged via `nextEndTimeMs`). The histogram is a SEPARATE endpoint so rows render without waiting for the full-window aggregation. POST (not GET) b… - [Stream CloudWatch logs (SSE)](https://www.ravion.com/docs/api-reference/awscloudwatch/stream-cloudwatch-logs-sse.md): Stream CloudWatch logs via SSE. Fetches historical logs first, then optionally tails for new logs. - [Create AwsDefaultNetwork](https://www.ravion.com/docs/api-reference/awsdefaultnetworks/create-awsdefaultnetwork.md) - [Check if module.yaml exists at path](https://www.ravion.com/docs/api-reference/codesources/check-if-moduleyaml-exists-at-path.md): Check if module.yaml exists at a given base path for a branch. - [Create CodeSource](https://www.ravion.com/docs/api-reference/codesources/create-codesource.md) - [Delete CodeSource](https://www.ravion.com/docs/api-reference/codesources/delete-codesource.md): Remove a code source from the organization by unlinking it. Fails if a project still uses it. - [Get CodeSource by id](https://www.ravion.com/docs/api-reference/codesources/get-codesource-by-id.md) - [Get repository from git provider](https://www.ravion.com/docs/api-reference/codesources/get-repository-from-git-provider.md): Get repository info from git provider for a code source. - [List code source branches](https://www.ravion.com/docs/api-reference/codesources/list-code-source-branches.md): List all branches for the repository associated with a code source. - [List CodeSources](https://www.ravion.com/docs/api-reference/codesources/list-codesources.md): List the organization's code sources - [Search code source by repo URL](https://www.ravion.com/docs/api-reference/codesources/search-code-source-by-repo-url.md): Search for a code source by repository URL within the user's organization - [Search code source terraform variables](https://www.ravion.com/docs/api-reference/codesources/search-code-source-terraform-variables.md): Search terraform variable declarations in repository files for a code source. - [Create DefaultValueDefinition](https://www.ravion.com/docs/api-reference/defaultvaluedefinitions/create-defaultvaluedefinition.md) - [Delete DefaultValueDefinition](https://www.ravion.com/docs/api-reference/defaultvaluedefinitions/delete-defaultvaluedefinition.md) - [Get DefaultValueDefinition by id](https://www.ravion.com/docs/api-reference/defaultvaluedefinitions/get-defaultvaluedefinition-by-id.md) - [List DefaultValueDefinitions](https://www.ravion.com/docs/api-reference/defaultvaluedefinitions/list-defaultvaluedefinitions.md) - [Patch DefaultValueDefinition](https://www.ravion.com/docs/api-reference/defaultvaluedefinitions/patch-defaultvaluedefinition.md) - [Create DefaultValue](https://www.ravion.com/docs/api-reference/defaultvalues/create-defaultvalue.md) - [Delete DefaultValue](https://www.ravion.com/docs/api-reference/defaultvalues/delete-defaultvalue.md) - [Get DefaultValue by id](https://www.ravion.com/docs/api-reference/defaultvalues/get-defaultvalue-by-id.md) - [List DefaultValues](https://www.ravion.com/docs/api-reference/defaultvalues/list-defaultvalues.md) - [Patch DefaultValue](https://www.ravion.com/docs/api-reference/defaultvalues/patch-defaultvalue.md) - [Get DeploymentResource by id](https://www.ravion.com/docs/api-reference/deploymentresources/get-deploymentresource-by-id.md) - [List DeploymentResources](https://www.ravion.com/docs/api-reference/deploymentresources/list-deploymentresources.md) - [Cancel a deployment](https://www.ravion.com/docs/api-reference/deployments/cancel-a-deployment.md): Cancel a deployment. - [Continue a paused deployment](https://www.ravion.com/docs/api-reference/deployments/continue-a-paused-deployment.md): Continue a paused deployment. Native blue_green / linear / canary deployments pause at the lifecycle stages configured under `deploy.strategy.pause_stages`; this control resolves the pending pause hook with CONTINUE. - [Create a deployment for a module](https://www.ravion.com/docs/api-reference/deployments/create-a-deployment-for-a-module.md) - [Get Deployment by id](https://www.ravion.com/docs/api-reference/deployments/get-deployment-by-id.md) - [List Deployments](https://www.ravion.com/docs/api-reference/deployments/list-deployments.md) - [List rollback candidates](https://www.ravion.com/docs/api-reference/deployments/list-rollback-candidates.md): List past successful deployments eligible for rollback. - [Redeploy a deployment](https://www.ravion.com/docs/api-reference/deployments/redeploy-a-deployment.md): Redeploy: create a new deployment that force-deploys the exact task definition revision the source deployment registered — no new revision is created. Requires the source deployment to have a stored task definition. - [Start a rollback deployment](https://www.ravion.com/docs/api-reference/deployments/start-a-rollback-deployment.md): Start a rollback: create a new deployment that redeploys the exact task definition revision a previously-successful deploy registered — no new revision is created. The target deployment ID is in the URL path. Description is auto-generated. - [Describe a Ravion resource ID with frontend links](https://www.ravion.com/docs/api-reference/describe/describe-a-ravion-resource-id-with-frontend-links.md) - [Create Environment](https://www.ravion.com/docs/api-reference/environments/create-environment.md) - [Delete Environment](https://www.ravion.com/docs/api-reference/environments/delete-environment.md) - [Get Environment by id](https://www.ravion.com/docs/api-reference/environments/get-environment-by-id.md) - [Get environment module graph](https://www.ravion.com/docs/api-reference/environments/get-environment-module-graph.md): Returns the module dependency graph for an environment: module instance nodes, producer to consumer edges with the outputs each edge consumes, and version-mismatch messages. - [List Environments](https://www.ravion.com/docs/api-reference/environments/list-environments.md) - [Patch Environment](https://www.ravion.com/docs/api-reference/environments/patch-environment.md) - [Create ExecutionEnvironment](https://www.ravion.com/docs/api-reference/executionenvironments/create-executionenvironment.md) - [Delete ExecutionEnvironment](https://www.ravion.com/docs/api-reference/executionenvironments/delete-executionenvironment.md) - [Get ExecutionEnvironment by id](https://www.ravion.com/docs/api-reference/executionenvironments/get-executionenvironment-by-id.md) - [List ExecutionEnvironments](https://www.ravion.com/docs/api-reference/executionenvironments/list-executionenvironments.md) - [Patch ExecutionEnvironment](https://www.ravion.com/docs/api-reference/executionenvironments/patch-executionenvironment.md) - [Get self-hosted server](https://www.ravion.com/docs/api-reference/git/get-self-hosted-server.md): Get a self-hosted Git server by ID - [List Git namespaces](https://www.ravion.com/docs/api-reference/git/list-git-namespaces.md): List Git namespaces (GitHub installations, GitLab groups/users) - [List self-hosted servers](https://www.ravion.com/docs/api-reference/git/list-self-hosted-servers.md): List self-hosted Git servers for the organization - [Configure GitHub App installation](https://www.ravion.com/docs/api-reference/github/configure-github-app-installation.md): Configure GitHub App installation. Redirects to GitHub App settings to grant/revoke repository access - [GitHub OAuth callback](https://www.ravion.com/docs/api-reference/github/github-oauth-callback.md): GitHub OAuth callback. Exchanges code for tokens and redirects to original URL - [List GitHub installations](https://www.ravion.com/docs/api-reference/github/list-github-installations.md): List GitHub App installations referenced by the organization's code sources - [List GitHub repositories](https://www.ravion.com/docs/api-reference/github/list-github-repositories.md): List repositories for a GitHub installation - [Start GitHub App installation](https://www.ravion.com/docs/api-reference/github/start-github-app-installation.md): Start GitHub App installation. Redirects to GitHub, then back to /github/callback - [Stream GitHub repositories (SSE)](https://www.ravion.com/docs/api-reference/github/stream-github-repositories-sse.md): Stream GitHub repositories via SSE in batches of 20 - [GitLab OAuth callback](https://www.ravion.com/docs/api-reference/gitlab/gitlab-oauth-callback.md): GitLab OAuth callback. Exchanges code for tokens and redirects to original URL - [GitLab OAuth reauthentication](https://www.ravion.com/docs/api-reference/gitlab/gitlab-oauth-reauthentication.md): Reauthenticate with GitLab. Redirects to GitLab, then back to /gitlab/callback - [List GitLab repositories](https://www.ravion.com/docs/api-reference/gitlab/list-gitlab-repositories.md): List repositories for a GitLab namespace - [List GitLab self-hosted repositories](https://www.ravion.com/docs/api-reference/gitlab/list-gitlab-self-hosted-repositories.md): List repositories for a self-hosted GitLab namespace - [Self-hosted GitLab OAuth reauthentication](https://www.ravion.com/docs/api-reference/gitlab/self-hosted-gitlab-oauth-reauthentication.md): Reauthenticate with a self-hosted GitLab server - [Start GitLab OAuth](https://www.ravion.com/docs/api-reference/gitlab/start-gitlab-oauth.md): Start GitLab OAuth for gitlab.com - [Start self-hosted GitLab OAuth](https://www.ravion.com/docs/api-reference/gitlab/start-self-hosted-gitlab-oauth.md): Start OAuth for a self-hosted GitLab server - [Stream GitLab repositories (SSE)](https://www.ravion.com/docs/api-reference/gitlab/stream-gitlab-repositories-sse.md): Stream GitLab repositories via SSE in batches of 20 - [Stream GitLab self-hosted repositories (SSE)](https://www.ravion.com/docs/api-reference/gitlab/stream-gitlab-self-hosted-repositories-sse.md): Stream self-hosted GitLab repositories via SSE in batches of 20 - [Health check](https://www.ravion.com/docs/api-reference/health/health-check.md) - [List InfrastructureEvents](https://www.ravion.com/docs/api-reference/infrastructureevents/list-infrastructureevents.md): 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. - [Accept Membership Invitation](https://www.ravion.com/docs/api-reference/memberships/accept-membership-invitation.md) - [Create Membership](https://www.ravion.com/docs/api-reference/memberships/create-membership.md) - [Delete Membership](https://www.ravion.com/docs/api-reference/memberships/delete-membership.md) - [Get Membership by id](https://www.ravion.com/docs/api-reference/memberships/get-membership-by-id.md) - [List Memberships](https://www.ravion.com/docs/api-reference/memberships/list-memberships.md) - [Patch Membership](https://www.ravion.com/docs/api-reference/memberships/patch-membership.md) - [Create ModuleDefinition](https://www.ravion.com/docs/api-reference/moduledefinitions/create-moduledefinition.md) - [Delete ModuleDefinition](https://www.ravion.com/docs/api-reference/moduledefinitions/delete-moduledefinition.md) - [Get module definition schema reference](https://www.ravion.com/docs/api-reference/moduledefinitions/get-module-definition-schema-reference.md) - [Get module input schema reference](https://www.ravion.com/docs/api-reference/moduledefinitions/get-module-input-schema-reference.md) - [Get ModuleDefinition by id](https://www.ravion.com/docs/api-reference/moduledefinitions/get-moduledefinition-by-id.md) - [List ModuleDefinitions](https://www.ravion.com/docs/api-reference/moduledefinitions/list-moduledefinitions.md) - [Patch ModuleDefinition](https://www.ravion.com/docs/api-reference/moduledefinitions/patch-moduledefinition.md) - [Create ModuleInstance](https://www.ravion.com/docs/api-reference/moduleinstances/create-moduleinstance.md) - [Delete ModuleInstance](https://www.ravion.com/docs/api-reference/moduleinstances/delete-moduleinstance.md) - [Get ModuleInstance by id](https://www.ravion.com/docs/api-reference/moduleinstances/get-moduleinstance-by-id.md) - [List ModuleInstances](https://www.ravion.com/docs/api-reference/moduleinstances/list-moduleinstances.md) - [Patch ModuleInstance](https://www.ravion.com/docs/api-reference/moduleinstances/patch-moduleinstance.md) - [Create ModuleVersion](https://www.ravion.com/docs/api-reference/moduleversions/create-moduleversion.md) - [Get ModuleVersion by id](https://www.ravion.com/docs/api-reference/moduleversions/get-moduleversion-by-id.md) - [List ModuleVersions](https://www.ravion.com/docs/api-reference/moduleversions/list-moduleversions.md) - [OAuth 2.0 device authorization approval](https://www.ravion.com/docs/api-reference/oauth/oauth-20-device-authorization-approval.md): Records a logged-in user's approve/deny decision for a pending device authorization request. Cookie-authenticated only (mirrors /oauth/authorize): a Bearer credential cannot approve a device grant on the user's behalf. - [OAuth 2.0 device authorization request](https://www.ravion.com/docs/api-reference/oauth/oauth-20-device-authorization-request.md): Initiates the RFC 8628 device authorization grant. Mints a device_code + user_code bound to a pending request. Unauthenticated — the device_code is the polling secret; approval happens in an authenticated browser session via /oauth/device/approve. - [OAuth 2.1 PKCE authorize](https://www.ravion.com/docs/api-reference/oauth/oauth-21-pkce-authorize.md): Mints a one-shot authorization code bound to the current session. Called by the approval page after the user approves. - [OAuth 2.1 PKCE token exchange](https://www.ravion.com/docs/api-reference/oauth/oauth-21-pkce-token-exchange.md): Exchanges a single-use authorization code (plus the PKCE verifier) for an access+refresh token pair. Called by the CLI after catching the loopback redirect from /oauth/authorize. - [OAuth 2.1 refresh token rotation](https://www.ravion.com/docs/api-reference/oauth/oauth-21-refresh-token-rotation.md): Rotates an opaque refresh token. The previous refresh token is single-use; the response carries a fresh access+refresh pair within the same token family. - [Create Organization](https://www.ravion.com/docs/api-reference/organizations/create-organization.md) - [Delete Organization](https://www.ravion.com/docs/api-reference/organizations/delete-organization.md) - [Get Admin Portal link for SAML SSO setup](https://www.ravion.com/docs/api-reference/organizations/get-admin-portal-link-for-saml-sso-setup.md): Enterprise only. Generate a Admin Portal link (SSO intent) so an organization owner can self-configure their SAML connection. Owner-only. - [Get Organization by id](https://www.ravion.com/docs/api-reference/organizations/get-organization-by-id.md) - [Get permitted identity providers for an organization](https://www.ravion.com/docs/api-reference/organizations/get-permitted-identity-providers-for-an-organization.md) - [Get SAML SSO settings](https://www.ravion.com/docs/api-reference/organizations/get-saml-sso-settings.md): Enterprise only. Get the organization's SAML SSO settings (whether SSO is enabled and whether it is enforced as the sole login method). - [List Organizations](https://www.ravion.com/docs/api-reference/organizations/list-organizations.md) - [Patch Organization](https://www.ravion.com/docs/api-reference/organizations/patch-organization.md) - [Update permitted identity providers for an organization](https://www.ravion.com/docs/api-reference/organizations/update-permitted-identity-providers-for-an-organization.md) - [Update SAML SSO settings](https://www.ravion.com/docs/api-reference/organizations/update-saml-sso-settings.md): Enterprise only. Enforce or un-enforce SAML SSO as the sole login method. Owner-only; - [API overview](https://www.ravion.com/docs/api-reference/overview.md): Automate Ravion projects, environments, pipelines, deployments, and infrastructure workflows from your own tools with the Ravion REST API. - [Cancel a pipeline run](https://www.ravion.com/docs/api-reference/pipelineruns/cancel-a-pipeline-run.md) - [Create PipelineRun](https://www.ravion.com/docs/api-reference/pipelineruns/create-pipelinerun.md) - [Get PipelineRun by id](https://www.ravion.com/docs/api-reference/pipelineruns/get-pipelinerun-by-id.md) - [List PipelineRuns](https://www.ravion.com/docs/api-reference/pipelineruns/list-pipelineruns.md) - [List Terraform resources for a pipeline run](https://www.ravion.com/docs/api-reference/pipelineruns/list-terraform-resources-for-a-pipeline-run.md): List Terraform resources emitted by a Terraform step in this pipeline run. - [Retry a pipeline run](https://www.ravion.com/docs/api-reference/pipelineruns/retry-a-pipeline-run.md) - [Create Pipeline](https://www.ravion.com/docs/api-reference/pipelines/create-pipeline.md) - [Delete Pipeline](https://www.ravion.com/docs/api-reference/pipelines/delete-pipeline.md) - [Get Pipeline by id](https://www.ravion.com/docs/api-reference/pipelines/get-pipeline-by-id.md) - [Get pipeline schema reference](https://www.ravion.com/docs/api-reference/pipelines/get-pipeline-schema-reference.md) - [List Pipelines](https://www.ravion.com/docs/api-reference/pipelines/list-pipelines.md) - [Patch Pipeline](https://www.ravion.com/docs/api-reference/pipelines/patch-pipeline.md) - [Approve a pipeline step execution](https://www.ravion.com/docs/api-reference/pipelinestepexecutions/approve-a-pipeline-step-execution.md) - [Get PipelineStepExecution by id](https://www.ravion.com/docs/api-reference/pipelinestepexecutions/get-pipelinestepexecution-by-id.md) - [List PipelineStepExecutions](https://www.ravion.com/docs/api-reference/pipelinestepexecutions/list-pipelinestepexecutions.md) - [List Terraform resources for a step execution](https://www.ravion.com/docs/api-reference/pipelinestepexecutions/list-terraform-resources-for-a-step-execution.md): List Terraform resources emitted by this step execution. - [Stream pipeline step execution logs (SSE)](https://www.ravion.com/docs/api-reference/pipelinestepexecutions/stream-pipeline-step-execution-logs-sse.md): Stream this pipeline step execution's CloudWatch logs via SSE. The AWS account, region, log group, and stream prefix are resolved from the step execution's persisted log metadata. - [Create PipelineVersion](https://www.ravion.com/docs/api-reference/pipelineversions/create-pipelineversion.md) - [Get PipelineVersion by id](https://www.ravion.com/docs/api-reference/pipelineversions/get-pipelineversion-by-id.md) - [List PipelineVersions](https://www.ravion.com/docs/api-reference/pipelineversions/list-pipelineversions.md) - [Create Project](https://www.ravion.com/docs/api-reference/projects/create-project.md) - [Delete Project](https://www.ravion.com/docs/api-reference/projects/delete-project.md) - [Get Project by id](https://www.ravion.com/docs/api-reference/projects/get-project-by-id.md) - [Get project config schema reference](https://www.ravion.com/docs/api-reference/projects/get-project-config-schema-reference.md) - [Get project modules config](https://www.ravion.com/docs/api-reference/projects/get-project-modules-config.md): Returns project metadata, environments, and module instances with their selected module versions. The default raw format mirrors persisted module instance input for debugging. Use format=pretty for an authoring-oriented project modules config with portable module references and resolver-derived inpu… - [List Projects](https://www.ravion.com/docs/api-reference/projects/list-projects.md) - [Patch Project](https://www.ravion.com/docs/api-reference/projects/patch-project.md) - [Update project modules config](https://www.ravion.com/docs/api-reference/projects/update-project-modules-config.md): Updates project module configuration for explicitly selected environments, or every environment when the selector is omitted. The operation validates and plans module create, update, unchanged, and destroy actions before updating project resources and starting required stack runs. - [Create ServiceAccount](https://www.ravion.com/docs/api-reference/serviceaccounts/create-serviceaccount.md) - [Delete ServiceAccount](https://www.ravion.com/docs/api-reference/serviceaccounts/delete-serviceaccount.md) - [Get ServiceAccount by id](https://www.ravion.com/docs/api-reference/serviceaccounts/get-serviceaccount-by-id.md) - [List ServiceAccounts](https://www.ravion.com/docs/api-reference/serviceaccounts/list-serviceaccounts.md) - [Patch ServiceAccount](https://www.ravion.com/docs/api-reference/serviceaccounts/patch-serviceaccount.md) - [Count current-state terraform resources for stacks](https://www.ravion.com/docs/api-reference/stacks/count-current-state-terraform-resources-for-stacks.md): Count the resources currently live in each given stack's Terraform state (latest APPLY per address, destroyed addresses excluded). Batched across stacks so the environment/project delete dialogs can show how many provisioned resources each module instance would orphan — a config-only delete never de… - [Get Stack by id](https://www.ravion.com/docs/api-reference/stacks/get-stack-by-id.md) - [List Stacks](https://www.ravion.com/docs/api-reference/stacks/list-stacks.md) - [Trigger a pipeline run for a stack](https://www.ravion.com/docs/api-reference/stacks/trigger-a-pipeline-run-for-a-stack.md) - [List stack workspaces in the active organization](https://www.ravion.com/docs/api-reference/stackworkspaces/list-stack-workspaces-in-the-active-organization.md): Lists every stack workspace in the authenticated user's active organization. - [Get terraform execution summary](https://www.ravion.com/docs/api-reference/terraformexecutionsummaries/get-terraform-execution-summary.md): Get a single terraform execution summary by ID. - [List terraform execution summaries](https://www.ravion.com/docs/api-reference/terraformexecutionsummaries/list-terraform-execution-summaries.md): List terraform execution summaries with filters. - [Get resource change summary](https://www.ravion.com/docs/api-reference/terraformresources/get-resource-change-summary.md): Get resource change summary across pipeline runs. - [Get terraform resource](https://www.ravion.com/docs/api-reference/terraformresources/get-terraform-resource.md): Get a single terraform resource by ID. - [List terraform resources](https://www.ravion.com/docs/api-reference/terraformresources/list-terraform-resources.md): List terraform resources with filters. - [Change user password](https://www.ravion.com/docs/api-reference/user/change-user-password.md) - [Disconnect an identity provider](https://www.ravion.com/docs/api-reference/user/disconnect-an-identity-provider.md) - [Get auth settings for a user](https://www.ravion.com/docs/api-reference/user/get-auth-settings-for-a-user.md) - [Get user organizations](https://www.ravion.com/docs/api-reference/user/get-user-organizations.md): Get all organizations this user has access to, including ones not logged in to. - [Update user profile](https://www.ravion.com/docs/api-reference/user/update-user-profile.md) - [Get AWS EC2 instance type values](https://www.ravion.com/docs/api-reference/values/get-aws-ec2-instance-type-values.md): Get EC2 instance types for a given AWS account and region - [Get AWS ECR image values](https://www.ravion.com/docs/api-reference/values/get-aws-ecr-image-values.md): Get ECR image details for fully-qualified ECR image references. Images that no longer exist in ECR are omitted from the response, so callers can infer existence by matching `image_ref`. Lookups resolve the AWS account and region from each reference's registry host, scoped to accounts connected to th… - [Get AWS Fargate size values](https://www.ravion.com/docs/api-reference/values/get-aws-fargate-size-values.md): Get AWS Fargate task sizes with optional regional pricing - [Get AWS region values](https://www.ravion.com/docs/api-reference/values/get-aws-region-values.md): List available AWS regions as select options - [Get AWS security group values](https://www.ravion.com/docs/api-reference/values/get-aws-security-group-values.md): Get AWS security groups for a given VPC - [Get AWS subnet values](https://www.ravion.com/docs/api-reference/values/get-aws-subnet-values.md): Get AWS subnets for a given VPC - [Get AWS VPC values](https://www.ravion.com/docs/api-reference/values/get-aws-vpc-values.md): Get AWS VPCs for a given AWS account and region - [Get OpenTofu version values](https://www.ravion.com/docs/api-reference/values/get-opentofu-version-values.md): List stable OpenTofu release versions - [Get Terraform version values](https://www.ravion.com/docs/api-reference/values/get-terraform-version-values.md): List stable Terraform release versions - [WebSocket event stream](https://www.ravion.com/docs/api-reference/websocket/websocket-event-stream.md): Upgrade to a WebSocket connection for real-time domain events. - [Authentication](https://www.ravion.com/docs/cli/authentication.md): Sign in to Ravion from the CLI, choose an active organization, and manage stored credentials for scripting and day-to-day operations. - [Install the Ravion CLI](https://www.ravion.com/docs/cli/installation.md): Install the Ravion CLI on macOS and Linux with the official installer, package managers, or a direct binary download for CI environments. - [CLI overview](https://www.ravion.com/docs/cli/overview.md): Manage Ravion projects, environments, deployments, modules, and infrastructure directly from your terminal with the official Ravion CLI. - [ravion api-key](https://www.ravion.com/docs/cli/reference/api-key.md): Create, list, rotate, and delete Ravion API keys used by service accounts and automation tools from the `ravion api-key` CLI command group. - [ravion aws](https://www.ravion.com/docs/cli/reference/aws.md): Connect AWS accounts, manage CloudFormation templates, and configure default networks and regions for Ravion with the `ravion aws` commands. - [ravion code-source](https://www.ravion.com/docs/cli/reference/code-source.md): Manage Ravion code sources, including connected Git repositories, branches, and build contexts used by modules, pipelines, and deployments. - [ravion default-value](https://www.ravion.com/docs/cli/reference/default-value.md): Set, list, and remove default values for Ravion module inputs at the organization, project, or environment level from the command line. - [ravion deploy](https://www.ravion.com/docs/cli/reference/deploy.md): Trigger, list, inspect, promote, and roll back Ravion module deployments from the command line using the `ravion deploy` command group. - [ravion describe](https://www.ravion.com/docs/cli/reference/describe.md): Print full details for any Ravion resource by its unique id, including projects, modules, environments, pipelines, and deployments. - [ravion environment](https://www.ravion.com/docs/cli/reference/environment.md): Create, list, update, and delete Ravion environments and their settings from the command line with the `ravion environment` commands. - [ravion git](https://www.ravion.com/docs/cli/reference/git.md): Manage Git integrations for Ravion projects, including connected repositories, branches, webhooks, and authentication from the CLI. - [ravion github](https://www.ravion.com/docs/cli/reference/github.md): Install, configure, and inspect the Ravion GitHub App integration and connected repositories from the `ravion github` CLI commands. - [ravion gitlab](https://www.ravion.com/docs/cli/reference/gitlab.md): Connect GitLab.com or self-hosted GitLab to Ravion, manage tokens, and inspect connected projects with the `ravion gitlab` commands. - [ravion infrastructure-event](https://www.ravion.com/docs/cli/reference/infrastructure-event.md): List, inspect, filter, and stream infrastructure events emitted by Ravion modules, deployments, and pipelines directly from the command line. - [ravion login](https://www.ravion.com/docs/cli/reference/login.md): Authenticate the Ravion CLI by signing in with your account credentials and storing an access token for subsequent commands and CI runs. - [ravion logout](https://www.ravion.com/docs/cli/reference/logout.md): Sign out of the Ravion CLI by clearing locally stored credentials and active organization context from your developer machine or CI runner. - [ravion logs](https://www.ravion.com/docs/cli/reference/logs.md): Query historical CloudWatch logs and stream live log output for Ravion modules, deployments, and services straight from the command line. - [ravion membership](https://www.ravion.com/docs/cli/reference/membership.md): Invite, list, update roles for, and remove members of a Ravion organization using the `ravion membership` CLI command group and its aliases. - [ravion metrics](https://www.ravion.com/docs/cli/reference/metrics.md): Query CloudWatch metrics for Ravion modules and services, including CPU, memory, request volume, and latency, from the command line. - [ravion module](https://www.ravion.com/docs/cli/reference/module.md): Create, list, update, and delete Ravion module instances, plus inspect their inputs and outputs, with the `ravion module` commands. - [ravion organization](https://www.ravion.com/docs/cli/reference/organization.md): Create, list, switch between, and configure Ravion organizations, including billing, defaults, and integrations, from the command line. - [ravion pipeline](https://www.ravion.com/docs/cli/reference/pipeline.md): Create, list, run, and inspect Ravion pipelines for builds, deploys, and other code execution from the `ravion pipeline` CLI commands. - [ravion project](https://www.ravion.com/docs/cli/reference/project.md): Create, list, update, and delete Ravion projects and their settings, including default environments and integrations, from the CLI. - [ravion service-account](https://www.ravion.com/docs/cli/reference/service-account.md): Create and manage Ravion service accounts and their API keys for CI, automation, and AI-agent access using the `ravion service-account` commands. - [ravion shell-completion](https://www.ravion.com/docs/cli/reference/shell-completion.md): Generate shell completion scripts for bash, zsh, fish, and PowerShell to enable tab completion for the Ravion CLI on any developer machine. - [ravion signup](https://www.ravion.com/docs/cli/reference/signup.md): Sign up for a new Ravion account from the CLI, create an initial organization, and store credentials for immediate use in your shell. - [ravion stack](https://www.ravion.com/docs/cli/reference/stack.md): Manage Ravion-managed Terraform stacks, inspect resources and state, and trigger plan and apply runs from the `ravion stack` commands. - [ravion switch](https://www.ravion.com/docs/cli/reference/switch.md): Switch the Ravion CLI's active organization, project, or environment context so subsequent commands target the intended resources. - [ravion terraform](https://www.ravion.com/docs/cli/reference/terraform.md): Manage Terraform Cloud credentials, providers, workspaces, and resources connected to Ravion from the `ravion terraform` CLI command group. - [ravion user](https://www.ravion.com/docs/cli/reference/user.md): View and update settings for your Ravion user account, including profile, email, and personal access tokens, from the command line. - [ravion values](https://www.ravion.com/docs/cli/reference/values.md): List the possible values for Ravion input fields such as AWS regions, EC2 instance types, and other enumerated configuration choices. - [ravion whoami](https://www.ravion.com/docs/cli/reference/whoami.md): Print the currently authenticated Ravion identity, including user, service account, organization, and token scope for the CLI session. - [ravion workspace](https://www.ravion.com/docs/cli/reference/workspace.md): List, inspect, and delete the local Ravion workspaces that store CLI state, cached credentials, and active context on your machine. - [Releases and changelog](https://www.ravion.com/docs/cli/releases.md): Download the latest Ravion CLI binaries for macOS and Linux, review release notes, and track changes across versions in the changelog. - [Core concepts](https://www.ravion.com/docs/concepts/core-concepts.md): How modules, stacks, deploys, and pipelines relate to each other in Ravion — the mental model behind everything else in these docs. - [Infrastructure as code](https://www.ravion.com/docs/concepts/infrastructure-as-code.md): Ravion uses infrastructure as code to manage cloud resources declaratively with Terraform, giving you reviewable, repeatable changes. - [Modules](https://www.ravion.com/docs/concepts/modules.md): Modules are the core Ravion primitive that defines, tracks, and manages a piece of infrastructure, from a database to a full application. - [Pipelines concept](https://www.ravion.com/docs/concepts/pipelines.md): Pipelines orchestrate builds, deploys, and other code-execution tasks across Ravion modules and environments using reusable, declarative steps. - [Projects and environments](https://www.ravion.com/docs/concepts/projects-and-environments.md): Ravion organizations, projects, and environments scope, group, and isolate your modules, resources, and access. - [CI integration](https://www.ravion.com/docs/config-as-code/ci-integration.md): Plan Ravion configuration changes on every pull request and apply them on merge using GitHub Actions, GitLab CI, or your own runner. - [Pipeline config file](https://www.ravion.com/docs/config-as-code/pipeline-config-file.md): Pull, edit, version-control, and apply a Ravion pipeline's configuration from a single declarative YAML file checked into your repository. - [Project config file](https://www.ravion.com/docs/config-as-code/project-config-file.md): Manage a full Ravion project's configuration—environments, modules, and pipelines—from a single declarative YAML file in source control. - [Contact support](https://www.ravion.com/docs/contact-support.md): Contact the Ravion support team by email for help with your account, billing, CLI setup, module deployments, pipelines, and infrastructure issues. - [Custom domains](https://www.ravion.com/docs/guides/custom-domains.md): Serve traffic on your own domain by creating an ACM certificate module, validating it with DNS, attaching it to your load balancer or CDN module, and cutting over traffic. - [How Ravion works](https://www.ravion.com/docs/how-ravion-works.md): Ravion automates your own cloud account from a control plane, so your application code and user traffic never flow through Ravion servers. - [Simplify cloud infrastructure without sacrificing control](https://www.ravion.com/docs/index.md): Ravion turns IaC into self-service building blocks: developers and AI agents ship without touching Terraform, platform teams keep full control. - [Ravion Docs MCP](https://www.ravion.com/docs/mcp/overview.md): Connect Claude, Cursor, and other AI tools to the Ravion Docs MCP server so agents can search and read Ravion documentation in context. - [Migrate from Flightcontrol](https://www.ravion.com/docs/migrate/from-flightcontrol.md): Migrate an existing Flightcontrol project to Ravion: map services to modules, move environments, and cut over deployments without downtime. - [Import existing resources into a standard module](https://www.ravion.com/docs/migrate/import-into-standard-module.md): Bring existing infrastructure under Ravion management by importing it into a module's Terraform state without recreating anything. - [Import existing resources into a Terraform Stack](https://www.ravion.com/docs/migrate/import-into-terraform-stack.md): Use Terraform import blocks to bring existing resources from any provider under a Ravion rvn-stack module's management through the normal plan and apply pipeline. - [Module catalog](https://www.ravion.com/docs/module-definitions/catalog.md): The Ravion module catalog hosts reusable infrastructure modules, with definitions, versions, and instances that teams provision on demand. - [ACM Certificate](https://www.ravion.com/docs/module-definitions/catalog/rvn-acm-certificate.md): ACM certificate requests an AWS Certificate Manager public certificate with DNS validation. - [Aurora Database](https://www.ravion.com/docs/module-definitions/catalog/rvn-aurora.md): Creates and manages an Amazon Aurora cluster. Supports Aurora PostgreSQL and Aurora MySQL with provisioned or Serverless v2 capacity. - [AWS IAM Role](https://www.ravion.com/docs/module-definitions/catalog/rvn-aws-iam-role.md): AWS IAM role with configurable trust relationships, managed policies, inline policies, permission boundaries, and optional instance profiles. - [VPC Network](https://www.ravion.com/docs/module-definitions/catalog/rvn-aws-network.md): Production-ready AWS VPC with public and private subnets, NAT gateways, and compliance-ready flow logs. - [Static Hosting](https://www.ravion.com/docs/module-definitions/catalog/rvn-aws-static.md): Static file hosting for S3-backed sites and assets delivered through CloudFront. - [CloudFront CDN](https://www.ravion.com/docs/module-definitions/catalog/rvn-cloudfront.md): CloudFront CDN distribution that serves web applications and private S3 buckets from ECS services, load balancers, S3 origins, and other custom origins. - [ECS Cluster](https://www.ravion.com/docs/module-definitions/catalog/rvn-ecs-cluster.md): Production-ready AWS ECS cluster with Fargate, Fargate Spot, optional EC2 capacity, and shared load balancers. - [ECS Network Service](https://www.ravion.com/docs/module-definitions/catalog/rvn-ecs-nlb.md): Network Load Balanced ECS service for running TCP, UDP, or TLS workloads behind an ECS cluster Network Load Balancer. - [ECS Web Service](https://www.ravion.com/docs/module-definitions/catalog/rvn-ecs-web.md): Web server ECS service for running an HTTP application behind an ECS cluster load balancer. - [ECS Worker](https://www.ravion.com/docs/module-definitions/catalog/rvn-ecs-worker.md): Background worker ECS service for running private container workloads without exposed ports. - [EFS File System](https://www.ravion.com/docs/module-definitions/catalog/rvn-efs.md): Creates and manages an Amazon EFS file system with mount targets, security groups, automatic backups, and an optional access point. - [ElastiCache](https://www.ravion.com/docs/module-definitions/catalog/rvn-elasticache.md): Creates and manages Amazon ElastiCache for Redis, Valkey, Memcached, or serverless Redis-compatible caches. - [Lambda Function](https://www.ravion.com/docs/module-definitions/catalog/rvn-lambda.md): AWS Lambda function with zip or container image deployments, alias-based releases, IAM, logs, and optional function URLs. - [RDS Database](https://www.ravion.com/docs/module-definitions/catalog/rvn-rds.md): Creates and manages an Amazon RDS database. Supports PostgreSQL, MySQL, MariaDB, Oracle, and SQL Server engines. - [Route 53 DNS](https://www.ravion.com/docs/module-definitions/catalog/rvn-route53.md): Manage Route 53 hosted zones, DNS records, query logging, and DNSSEC. - [S3 Bucket](https://www.ravion.com/docs/module-definitions/catalog/rvn-s3.md): S3 bucket with public access blocking, encryption, versioning, CORS, lifecycle rules, and configurable bucket policies. - [Terraform Stack](https://www.ravion.com/docs/module-definitions/catalog/rvn-stack.md): Automate Terraform and OpenTofu workflows with git-driven deployments and managed state. - [Module definition schema](https://www.ravion.com/docs/module-definitions/definition-schema.md): Reference for the Ravion module definition schema: inputs, outputs, source, runtime, and the fields that describe each catalog module. - [Standard library](https://www.ravion.com/docs/module-definitions/standard-library.md): The Ravion standard library of production-ready modules: Terraform-backed building blocks for networking, compute, databases, storage, and DNS in your own AWS account. - [Module builds](https://www.ravion.com/docs/modules/build.md): Build a Ravion module's code — container images, static assets, or Lambda packages — with a one-line pipeline step, and feed the artifact to a deploy. - [Module deploys](https://www.ravion.com/docs/modules/deploy.md): A deploy is a single release of application code to a Ravion module instance, with statuses, instance-level events, and one-command rollback. - [Module links](https://www.ravion.com/docs/modules/links.md): Display custom http links on each module for quick access to your other systems. - [Module logs](https://www.ravion.com/docs/modules/logs.md): Stream and query CloudWatch logs for a Ravion module, including filtering, time ranges, and structured log fields from the dashboard. - [Module metrics](https://www.ravion.com/docs/modules/metrics.md): View CloudWatch metrics for a Ravion module, including CPU, memory, request volume, and latency, across environments and deployments. - [Module overview](https://www.ravion.com/docs/modules/overview.md): Anatomy of a Ravion module instance: which capabilities like build, deploy, logs, and metrics apply, and how they map to underlying cloud resources. - [Module stack](https://www.ravion.com/docs/modules/stack.md): The stack is the Terraform or OpenTofu state behind a Ravion module instance: provisioned resources, plan and apply history, and outputs. - [Product philosophy](https://www.ravion.com/docs/philosophy.md): Ravion gives developers and AI agents fast self-service while keeping platform and DevOps teams in control through guardrails and policy. - [Pipeline configuration](https://www.ravion.com/docs/pipelines/config-reference.md): Complete reference for the Ravion pipeline configuration schema, including steps, blocks, inputs, variants, triggers, and outputs. - [Pipeline examples](https://www.ravion.com/docs/pipelines/examples.md): Complete, validated pipeline configuration examples: sequential build and deploy, parallel builds and deploys, CI steps alongside module builds, and one image build feeding multiple deploys. - [Pipelines reference overview](https://www.ravion.com/docs/pipelines/overview.md): Reference overview of Ravion pipelines: how runs are structured, how steps execute, and how to author pipeline configuration for your project. - [Step types](https://www.ravion.com/docs/pipelines/step-types.md): Catalog of Ravion pipeline step types, including module actions, CI steps, approvals, parallel groups, and other control-flow primitives. - [Pipeline templating](https://www.ravion.com/docs/pipelines/templating.md): Reference pipeline inputs, run context, and step outputs inside step configuration with Ravion's expression and templating syntax. - [Pipeline variants](https://www.ravion.com/docs/pipelines/variants.md): Reuse one Ravion pipeline across production, staging, and other environments with variants, and hard-code input values per variant. - [Start here (human + agent)](https://www.ravion.com/docs/start-here.md): Set up Ravion for an AI agent: connect human-owned accounts and point the agent to the authoritative config, pipeline, and CI workflows. - [Agent self-service](https://www.ravion.com/docs/use-cases/agent-self-service.md): Give AI agents a guarded, policy-controlled path to provision and deploy cloud infrastructure on Ravion without risking production safety. - [Build code](https://www.ravion.com/docs/use-cases/build-code.md): Build container images, AWS Lambda functions, and static front-end assets with Ravion pipelines, cached layers, and reusable build steps. - [Deploy code](https://www.ravion.com/docs/use-cases/deploy-code.md): Deploy application code to AWS ECS services and static site hosting with Ravion modules, including blue-green rollout and rollback. - [Developer self-service](https://www.ravion.com/docs/use-cases/developer-self-service.md): Give developers a safe, self-service path to ship to production without deep cloud expertise, backed by Ravion guardrails and modules. - [Metrics and logs](https://www.ravion.com/docs/use-cases/metrics-and-logs.md): View live CloudWatch metrics and logs for your Ravion modules and services in the dashboard to debug incidents and monitor performance over time. - [Preview environments](https://www.ravion.com/docs/use-cases/preview-environments.md): Spin up ephemeral preview environments for every pull request on Ravion, with isolated infrastructure and automatic teardown on merge. - [Provision infrastructure](https://www.ravion.com/docs/use-cases/provision-infrastructure.md): Use Ravion to provision Terraform-managed cloud infrastructure declaratively, with reviewable plans, guarded applies, and drift detection. ## OpenAPI Specs - [openapi](https://api.ravion.com/openapi.yaml)