Skip to main content
Update an existing claim portal. The body uses the same version-discriminated shape as Create Portal — send the fields you want to change for the portal’s version. Route: POST /api/external/v1/portals/{id}/update

​
Headers

HeaderRequiredDescription
Content-TypeYesMust be application/json
x-magna-api-tokenYesYour Magna API token

​
Path parameters

ParameterTypeDescription
idstring (uuid)The portal ID to update

​
Body parameters

Same as Create Portal — a discriminated union on version (V1 or V2).

​
Request example

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

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