---
title: "Submit Update Vault Change Proposal"
method: POST
path: "/api/v1/vaults/{id}/proposals"
tags: ["Vaults"]
---

# Submit Update Vault Change Proposal

`POST /api/v1/vaults/{id}/proposals`

Submit an update vault change proposal. Verify, approve, and abort are handled via the user-actions API.

## Path parameters

- `id` string, uuid, required — ID of the vault to submit a change proposal for.

## Request body

- SubmitUpdateVaultChangeProposalRequest
  - `diff` UpdateVaultChangeRequestDiff, required
    - `added_vault_group_ids` string[] — The vault group ids to add the vault to.
    - `removed_vault_group_ids` string[] — The vault group ids to remove the vault from.

## Response `204`

Successful Response

## Other responses

- `400` — Bad Request
- `401` — Unauthorized User
- `403` — Forbidden User
- `404` — Not Found
- `408` — Request Timeout
- `422` — Validation Error
- `429` — Rate Limit Exceeded
- `500` — Unexpected Error

---

[API](https://skmtc.net/fordefi/apis/fordefi-api.md) · [All operations](https://skmtc.net/fordefi/apis/fordefi-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fordefi/fordefi-api/versions/c4c28d233105/schema)