Skip to main content
Create-like operations require a requestId to ensure retries do not create duplicates. Generate a UUIDv4 on your side and reuse it when retrying the same operation. If the requestId was already used, the API returns a 409 conflict and you can safely fetch state rather than re-creating the resource. Create a portfolio wallet with a requestId
cURL
curl -X POST "$BASE_URL/v2/portfolio-wallets" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "requestId": "f0a3afc3-1e67-4c0c-a8e1-3f5d8fb9a23b",
    "label": "Treasury Portfolio",
    "positions": [
      { "positionKey": "tbills", "targetWeightBps": 6000 },
      { "positionKey": "resolvRlp", "targetWeightBps": 4000 }
    ]
  }'
Duplicate requestId response 
{
  "error": "Duplicate request ID",
  "details": "A resource was already created with this request ID"
}