Endpoint
PATCH /admin/v1/workspaces/{workspaceId}Operation ID: updateWorkspace
Authentication
Send a Nexus Management Key as Authorization: Bearer <management-key>. This credential is control-plane only.
Idempotency
This operation does not declare an Idempotency-Key requirement in the accepted OpenAPI contract.
Request
Parameters
| Name | Location | Required | Schema | Description |
|---|---|---|---|---|
workspaceId |
path | Yes | string |
— |
application/json body
Required: Yes
Type: UpdateWorkspaceDto
| Field | Required | Type | Description |
|---|---|---|---|
name |
No | string |
— |
slug |
No | string |
— |
status |
No | string (ACTIVE | SUSPENDED | ARCHIVED) |
— |
Responses
| Status | Description | Content type | Schema |
|---|---|---|---|
200 |
— | application/json | WorkspaceDto |
Only responses explicitly declared by the accepted Admin OpenAPI contract are shown. The current contract does not declare operation-specific error bodies; the SDK preserves any non-success status and body in AdminApiError.
200 application/json schema
Type: WorkspaceDto
| Field | Required | Type | Description |
|---|---|---|---|
id |
Yes | string |
— |
organizationId |
Yes | string |
— |
name |
Yes | string |
— |
slug |
Yes | string |
— |
status |
Yes | string (ACTIVE | SUSPENDED | ARCHIVED) |
— |
createdAt |
Yes | string / date-time |
— |
updatedAt |
Yes | string / date-time |
— |
Examples
TypeScript Management SDK
NexusAdminClient.updateWorkspace uses AdminOperationInput<"updateWorkspace"> and returns Promise<AdminOperationOutput<"updateWorkspace">>.
import { NexusAdminClient } from '@nexus/sdk-typescript';
const nexus = new NexusAdminClient({
baseUrl: 'https://nexus.microvoid.io',
managementKey: process.env.NEXUS_MANAGEMENT_KEY,
});
const result = await nexus.updateWorkspace({
path: {
workspaceId: '533c4e1e-2823-4349-86b9-d6f1a869a2ca',
},
body: {},
});Fetch
const response = await fetch('https://nexus.microvoid.io/admin/v1/workspaces/533c4e1e-2823-4349-86b9-d6f1a869a2ca', {
method: 'PATCH',
headers: {
Authorization: `Bearer ${process.env.NEXUS_MANAGEMENT_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({}),
});
if (!response.ok) throw new Error(`Nexus request failed: ${response.status}`);curl
curl --request PATCH \
"https://nexus.microvoid.io/admin/v1/workspaces/533c4e1e-2823-4349-86b9-d6f1a869a2ca" \
--header "Authorization: Bearer ${NEXUS_MANAGEMENT_KEY}" \
--header "Content-Type: application/json" \
--data "{}"