> ## 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 > Update a Workspace. ## OpenAPI ````yaml /astro/api/v-1-beta-1/platform/openapi.yaml post /organizations/{organizationId}/workspaces/{workspaceId} openapi: 3.0.3 info: contact: {} description: Astro Platform API title: Astro Platform API version: v1beta1 servers: - url: https://api.astronomer.io/platform/v1beta1 security: - JWT: [] tags: - description: >- A `cluster` object represents an Astro cluster, which is a Kubernetes cluster that hosts the infrastructure required to run Deployments. Make requests to `cluster` endpoints to manage your standard and dedicated clusters. See [Create a dedicated cluster](https://astronomer.io/docs/astro/create-dedicated-cluster). name: Cluster - description: >- The `organization` object contains the metadata and configurations of an Astro Organization. It does not include objects within the Organization, such as users and clusters. Make requests to `organization` endpoints to view and update high level settings for your Organization, including settings related to authentication and billing. To manage resources within an Organization, make requests to the endpoints related to those resources, such as `users`. See [Billing](https://astronomer.io/docs/astro/manage-billing), [Set up single sign-on](https://astronomer.io/docs/astro/configure-idp), and [Manage domains](https://astronomer.io/docs/astro/manage-domains). name: Organization - description: >- The `options` object represents all possible configurations for a given Astro component. Make requests to the `options` object to get the configuration constraints for creating or updating a given Astro component. name: Options - description: >- The `workspace` object represents an Astro Workspace, which is a collection of Deployments that can be accessed by a specific group of users. It contains metadata about a Workspace, but does not contain objects within the Workspace such as users and Deployments. Make requests to `workspace` endpoints to manage high level details about your Workspace. To manage resources within a Workspace, make requests to the endpoints related to those resources, such as `users`, and use the `workspaceIds` parameter to filter results by Workspace. See [Configure Workspaces](https://astronomer.io/docs/astro/manage-workspaces). name: Workspace - name: notification-channels x-group: Notification Channels paths: /organizations/{organizationId}/workspaces/{workspaceId}: post: tags: - Workspace summary: Update Workspace description: Update a Workspace. operationId: UpdateWorkspace parameters: - description: The ID of the Organization to which the Workspace belongs. in: path name: organizationId required: true schema: type: string - description: The Workspace's ID. in: path name: workspaceId required: true schema: type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/UpdateWorkspaceRequest' description: The request body for updating a new Workspace. required: true x-originalParamName: body responses: '200': content: application/json: schema: $ref: '#/components/schemas/Workspace' description: OK '400': content: application/json: schema: $ref: '#/components/schemas/Error' description: Bad Request '401': content: application/json: schema: $ref: '#/components/schemas/Error' description: Unauthorized '403': content: application/json: schema: $ref: '#/components/schemas/Error' description: Forbidden '404': content: application/json: schema: $ref: '#/components/schemas/Error' description: Not Found '500': content: application/json: schema: $ref: '#/components/schemas/Error' description: Internal Server Error security: - JWT: [] components: schemas: UpdateWorkspaceRequest: properties: cicdEnforcedDefault: description: Whether new Deployments enforce CI/CD deploys by default. example: true type: boolean description: description: The Workspace's description. example: This is a test workspace type: string name: description: The Workspace's name. example: My Workspace maxLength: 50 type: string required: - cicdEnforcedDefault - description - name type: object Workspace: properties: cicdEnforcedDefault: description: Whether CI/CD deploys are enforced by default. example: true type: boolean createdAt: description: >- The time when the Workspace was created in UTC, formatted as `YYYY-MM-DDTHH:MM:SSZ` example: '2023-09-08T12:00:00Z' format: date-time type: string createdBy: $ref: '#/components/schemas/BasicSubjectProfile' description: description: The Workspace's description. example: This is a test workspace type: string id: description: The Workspace's ID. example: clm8t5u4q000008jq4qoc3036 type: string name: description: The Workspace's name. example: My Workspace type: string organizationId: description: The ID of the organization to which the workspace belongs. example: clm8t5u4q000008jq4qoc3036 type: string organizationName: description: The name of the Organization to which the Workspace belongs. example: My Organization type: string updatedAt: description: >- The time when the Workspace was updated in UTC, formatted as `YYYY-MM-DDTHH:MM:SSZ` example: '2023-09-08T13:30:00Z' format: date-time type: string updatedBy: $ref: '#/components/schemas/BasicSubjectProfile' required: - cicdEnforcedDefault - createdAt - id - name - organizationId - updatedAt type: object Error: properties: message: type: string requestId: type: string statusCode: maximum: 600 minimum: 400 type: integer required: - message - requestId - statusCode type: object BasicSubjectProfile: properties: apiTokenName: description: >- The API token's name. Returned only when `SubjectType` is `SERVICEKEY`. example: my-token type: string avatarUrl: description: >- The URL for the user's profile image. Returned only when `SubjectType` is `USER`. example: https://avatar.url type: string fullName: description: The subject's full name. Returned only when `SubjectType` is `USER`. example: Jane Doe type: string id: description: The subject's ID. example: clm8qv74h000008mlf08scq7k type: string subjectType: description: The subject type. enum: - USER - SERVICEKEY example: USER type: string username: description: The subject's username. Returned only when `SubjectType` is `USER`. example: user1@company.com type: string required: - id type: object securitySchemes: JWT: scheme: bearer type: http ````