> ## Documentation Index
> Fetch the complete documentation index at: https://astronomer.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Update workspace configuration with the APC API

<Note>
  The examples on this page show common ways to use the APC API — they're not a complete API reference. For the full, interactive API documentation for your installation, including every available query, mutation, and type, go to `https://houston.<your-base-domain>/v1`, and click on the **Docs** tab. See [Develop and test APC API queries](/docs/astro-private-cloud/v-2-x/houston-api-develop-test) for more on using the built-in GraphQL explorer.
</Note>

Use the `updateWorkspaceDeploymentsConfig` mutation to add or update workspace-level overrides:

```graphql wrap theme={null}
mutation {
  updateWorkspaceDeploymentsConfig(
    workspaceUuid: "<workspace-id>"
    deploymentsConfigOverride: {
      deploymentLifecycle: {
        deployRollback: {
          enabled: true
        }
      }
    }
    reason: "Enable deploy rollback for all deployments in this workspace"
  ) {
    id
    config
  }
}
```

The `deploymentsConfigOverride` argument accepts a partial JSON object. Keys you provide are merged into the existing workspace override. Keys you omit are left unchanged. To remove a specific key from the stored override, set its value to the string `"DELETE_KEY"`:

```graphql wrap theme={null}
mutation {
  updateWorkspaceDeploymentsConfig(
    workspaceUuid: "<workspace-id>"
    deploymentsConfigOverride: {
      deploymentLifecycle: {
        deployRollback: {
          enabled: "DELETE_KEY"
        }
      }
    }
    reason: "Remove deploy rollback override, revert to cluster/platform default"
  ) {
    id
    config
  }
}
```

For the full config governance model these overrides participate in, see [Config governance](/docs/astro-private-cloud/v-2-x/config-governance).