> ## 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.

# Crear solicitud de acción

> Solicita una acción sensible que no tienes permiso para ejecutar por ti mismo. Cualquier miembro; una clave de API necesita el scope `workspaces:write`.

> [!NOTE]
>
> Una clave de API necesita el scope `workspaces:write`. La solicitud solo se decide en el panel:
> aprobar y rechazar no están disponibles para las claves de API.

Cualquier miembro puede llamar a esto. La verificación real es que quien llama **no** tenga ya el permiso al que se
asocia la acción; si lo tiene, ejecuta la acción directamente.

| `action` | requiere permiso |
| - | - |
| `app_delete` | `apps:delete` |
| `database_delete` | `databases:delete` |
| `snapshot_create` | `snapshots:manage` |
| `snapshot_restore` | `snapshots:manage` |

### Ruta

**id** `string` *required*

ID del workspace.

### Body

**action** `string` *required*

Una de `app_delete`, `database_delete`, `snapshot_create`, `snapshot_restore`.

**resource\_id** `string` *required*

La aplicación o base de datos sobre la que actúa esta acción. Debe pertenecer a este workspace.

**params** `object`

Parámetros específicos de la acción, guardados tal cual: son exactamente lo que se ejecuta si se aprueba; lo que se envía al aprobar no se usa. `snapshot_restore` requiere `{ "snapshot_id": "<uuid>" }` (un snapshot de este recurso); las demás acciones no reciben ninguno (`{}` o se omite). Cualquier otra clave devuelve `WORKSPACE_ACTION_INVALID_PARAMS`.

### Respuesta

Igual que una fila de [Listar solicitudes de acción](https://docs.vertracloud.app/es-es/api-reference/endpoint/workspaces/action-requests/list.md), con `status: "pending"`.

### Errores

| Estado | Código | Cuándo |
| - | - | - |
| 400 | `WORKSPACE_ACTION_NOT_NEEDED` | Quien llama ya tiene el permiso al que se asocia la acción; ejecútala directamente en lugar de pedirla. |
| 403 | `API_KEY_SCOPE_DENIED` | Se llamó con una clave de API que no tiene el scope `workspaces:write`. |
| 404 | `WORKSPACE_NOT_FOUND` | El workspace no existe o no eres miembro. |
| 404 | `APP_NOT_FOUND` / `DATABASE_NOT_FOUND` | `resource_id` no pertenece a este workspace. |


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