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

# Update Portal

> Update an existing claim portal. Same version-discriminated body as Create Portal.

Update an existing claim portal. The body uses the same `version`-discriminated
shape as [Create Portal](/apis/admin/portals/create-portal) — send the fields you
want to change for the portal's version.

**Route:** `POST /api/external/v1/portals/{id}/update`

## Headers

| Header              | Required | Description                |
| ------------------- | -------- | -------------------------- |
| `Content-Type`      | Yes      | Must be `application/json` |
| `x-magna-api-token` | Yes      | Your Magna API token       |

## Path parameters

| Parameter | Type          | Description             |
| --------- | ------------- | ----------------------- |
| `id`      | string (uuid) | The portal ID to update |

## Body parameters

Same as [Create Portal](/apis/admin/portals/create-portal) — a discriminated
union on `version` (`V1` or `V2`).

## Request example

```sh theme={null}
curl -X POST 'https://app.magna.so/api/external/v1/portals/{portal_id}/update?id={portal_id}' \
-H 'Content-Type: application/json' \
-H 'x-magna-api-token: YOUR_API_KEY' \
-d '{
  "version": "V2",
  "metadata": { "title": "Acme Token Claim" }
}'
```

## Response example

```json theme={null}
{
  "id": "po...uuid",
  "name": "Acme Claim Portal",
  "version": "V2",
  "updatedAt": "2024-04-16T10:00:00.000Z"
}
```