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

# Obtener workspace

> Devuelve los detalles completos del workspace, los permisos de quien llama y su organización individual de recursos.

Cualquier miembro puede llamar a esto (no hay un permiso de lectura para el propio workspace: o perteneces a él o
recibes `404`). Una clave de API necesita el scope `workspaces:read`.

> [!NOTE]
>
> Un workspace que no existe y uno al que no perteneces responden igual: `404 WORKSPACE_NOT_FOUND`. Es intencional:
> distinguir ambos casos revelaría qué IDs de workspace existen.

### Ruta

**id** `string` *required*

ID del workspace.

### Respuesta

**response** `APIWorkspaceInfoResponse`

Todo lo de [Listar workspaces](https://docs.vertracloud.app/es-es/api-reference/endpoint/workspaces/get-all.md), más:

**Mostrar objeto**

**members** `APIWorkspaceMember[]`

Lista completa de miembros, con la misma forma que [Listar miembros](https://docs.vertracloud.app/es-es/api-reference/endpoint/workspaces/members/list.md).

**roles** `APIWorkspaceRole[]`

Lista completa de roles, con la misma forma que [Listar roles](https://docs.vertracloud.app/es-es/api-reference/endpoint/workspaces/roles/list.md).

**applications** `APIApplication[]`

Aplicaciones vinculadas a este workspace.

**databases** `APIDatabase[]`

Bases de datos vinculadas a este workspace.

**permissions** `WorkspacePermission[]`

Los permisos resueltos de quien llama. El propietario recibe el catálogo completo de 20 permisos sin necesitar una fila de rol.

**is\_owner** `boolean`

**owner\_plan** `string | null`

El nombre del plan del propietario del workspace (por ejemplo, `pro` o `enterprise-8`), o `null` cuando el propietario no tiene plan. Determina qué funciones tiene el workspace.

**resource\_organization** `APIWorkspaceResourceOrganization`

Organización personal del miembro que hizo esta petición en este workspace. Tiene `scope` con el valor `workspace`,
`user_id`, `workspace_id`, `folders` y `favorites`; no es una configuración compartida con otros miembros. Ver las
[modificaciones de carpetas y favoritos](https://docs.vertracloud.app/es-es/api-reference/endpoint/workspaces/resource-organization.md).

**Mostrar objeto**

**scope** `string`

Siempre `workspace` en esta respuesta.

**user\_id** `string`

ID del miembro que hizo la petición.

**workspace\_id** `string`

ID de este workspace.

**folders** `APIWorkspaceResourceFolder[]`

Carpetas personales con `id`, `name`, `color`, `position`, `resources`, `created_at` y
`updated_at`. `color` es `neutral`, `red`, `orange`, `yellow`, `green`, `blue` o `purple`.

**favorites** `APIWorkspaceFavorite[]`

Favoritos individuales con `resource_type` (`application` o `database`), `resource_id`,
`position` y `created_at`.

### Errores

| Estado | Código | Cuándo |
| - | - | - |
| 404 | `WORKSPACE_NOT_FOUND` | El workspace no existe, está eliminado o no eres miembro. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.