Endpoint
GET /admin/v1/workspaces/{workspaceId}Operation ID: getWorkspace
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 |
— |
Body
This operation has no request body.
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.getWorkspace uses AdminOperationInput<"getWorkspace"> and returns Promise<AdminOperationOutput<"getWorkspace">>.
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.getWorkspace({
path: {
workspaceId: '533c4e1e-2823-4349-86b9-d6f1a869a2ca',
},
});Fetch
const response = await fetch('https://nexus.microvoid.io/admin/v1/workspaces/533c4e1e-2823-4349-86b9-d6f1a869a2ca', {
method: 'GET',
headers: {
Authorization: `Bearer ${process.env.NEXUS_MANAGEMENT_KEY}`,
},
});
if (!response.ok) throw new Error(`Nexus request failed: ${response.status}`);curl
curl --request GET \
"https://nexus.microvoid.io/admin/v1/workspaces/533c4e1e-2823-4349-86b9-d6f1a869a2ca" \
--header "Authorization: Bearer ${NEXUS_MANAGEMENT_KEY}"