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

# Criar solicitação de ação

> Pede uma ação sensível que você não tem permissão para executar sozinho. Qualquer membro; uma chave de API precisa do escopo `workspaces:write`.

> [!NOTE]
>
> Uma chave de API precisa do escopo `workspaces:write`. A solicitação só é decidida no painel —
> aprovar e rejeitar não estão disponíveis para chaves de API.

Qualquer membro pode chamar isto — a verificação real é que quem chama **não** tenha já a
permissão que a ação corresponde; se tiver, execute a ação diretamente.

| `action` | exige a permissão |
| - | - |
| `app_delete` | `apps:delete` |
| `database_delete` | `databases:delete` |
| `snapshot_create` | `snapshots:manage` |
| `snapshot_restore` | `snapshots:manage` |

### Caminho

**id** `string` *required*

ID do workspace.

### Corpo

**action** `string` *required*

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

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

A aplicação ou o banco de dados que esta ação alveja. Deve pertencer a este workspace.

**params** `object`

Parâmetros específicos da ação, gravados como estão — são exatamente o que roda se for aprovado; nada enviado na aprovação é usado. `snapshot_restore` exige `{ "snapshot_id": "<uuid>" }` (um snapshot deste recurso); as outras ações não recebem nenhum (`{}` ou omitido). Qualquer outra chave retorna `WORKSPACE_ACTION_INVALID_PARAMS`.

### Resposta

Mesmo formato de uma linha de [Listar solicitações de ação](https://docs.vertracloud.app/pt-br/api-reference/endpoint/workspaces/action-requests/list.md), com `status: "pending"`.

### Erros

| Status | Código | Quando |
| - | - | - |
| 400 | `WORKSPACE_ACTION_NOT_NEEDED` | Quem chama já tem a permissão que a ação corresponde — execute a ação diretamente em vez de solicitá-la. |
| 403 | `API_KEY_SCOPE_DENIED` | Chamada com uma chave de API que não tem o escopo `workspaces:write`. |
| 404 | `WORKSPACE_NOT_FOUND` | O workspace não existe ou você não é membro. |
| 404 | `APP_NOT_FOUND` / `DATABASE_NOT_FOUND` | `resource_id` não pertence a este workspace. |


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