Retarget
Retarget changes who a container is aimed at — a new email, a new language, a new code group — without changing its crid. It exists only in API 2.1: v3 has no equivalent call, which is one of the two reasons an integration stays on 2.1 rather than moving to v3.
API 2.1
Base URL
{API_BASE}/v2.1 — the base URL is provided with your access
OpenAPI specification
Retarget
Method POST
/v2.1/client/{key}/{crid}/retarget
Scope
client_v2
Reassign a container's recipient, language or code group, keeping the same crid.
The request body is entirely optional — send only the fields you want to change.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
key |
Path | string |
Required | Your 2.1 client API key. |
crid |
Path | string |
Required | The container's crid. |
email |
Body | string |
Optional | New recipient email address. |
language |
Body | string |
Optional | Language applied to the recipient-facing surfaces for this container. |
codeGroup |
Body | string |
Optional | Code group the container is reassigned to. |
additionalData |
Body | object |
Optional | Free-form object, preserved as given. |
Response
json
200 OK
{
"status": 0,
"url": "https://livstick.io/5f3e9c2b8a1d4f60",
"urid": "5f3e9c2b8a1d4f60",
"urlRead": "https://livstick.io/5f3e9c2b8a1d4f60",
"urlWrite": "https://livstick.io/overwrite/5f3e9c2b8a1d4f60",
"urlPreview": "https://livstick.io/preview/5f3e9c2b8a1d4f60",
"messageUrl": "livstick.io/5f3e9c2b8a1d4f60"
}Notes
- url resolves to urlWrite or urlRead depending on the calling platform — see Recording URLs before reading this field.