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

# Replace embed origins

> Set the full list of origins allowed to frame the wallet embed.

The list is replaced, not merged. Send every origin you want allowed.

<ParamField body="origins" type="string[]" required>Web origins. HTTPS only, except loopback hosts for local development. Duplicates are dropped.</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X PUT https://api.agentcard.sh/api/v2/embed_origins \
    -H "Authorization: Bearer $ORG_TOKEN" \
    -H "Content-Type: application/json" \
    -d '{"origins": ["https://app.example.com", "http://localhost:3000"]}'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  { "object": "embed_origins", "origins": ["https://app.example.com", "http://localhost:3000"] }
  ```
</ResponseExample>

**Errors.** `400 invalid_origin` names the value that was refused. `400 invalid_request` when the array exceeds the maximum length.