curl --request PATCH \
--url https://www.genviral.io/api/partner/v1/analytics/targets/e7a7f417-56db-4320-9e9a-fd6fdabda09d \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"favorite": true
}'
{
"ok": true,
"code": 200,
"message": "Analytics target updated",
"data": {
"id": "e7a7f417-56db-4320-9e9a-fd6fdabda09d",
"platform": "tiktok",
"identifier": "@brand",
"display_name": "Brand HQ",
"metadata": {
"favorite": true
}
}
}
Analytics
Update Analytics Target
Update display/refresh/favorite settings for one target
PATCH
/
api
/
partner
/
v1
/
analytics
/
targets
/
{id}
curl --request PATCH \
--url https://www.genviral.io/api/partner/v1/analytics/targets/e7a7f417-56db-4320-9e9a-fd6fdabda09d \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"favorite": true
}'
{
"ok": true,
"code": 200,
"message": "Analytics target updated",
"data": {
"id": "e7a7f417-56db-4320-9e9a-fd6fdabda09d",
"platform": "tiktok",
"identifier": "@brand",
"display_name": "Brand HQ",
"metadata": {
"favorite": true
}
}
}
Updates settings for a single tracked analytics target.
Path Parameters
string
required
Analytics target ID.
Body Parameters
At least one of these fields is required:string
New display name (nullable).
object
Refresh policy patch (for example
freeDailyRefresh, maxPosts).boolean
Favorite toggle stored in metadata.
curl --request PATCH \
--url https://www.genviral.io/api/partner/v1/analytics/targets/e7a7f417-56db-4320-9e9a-fd6fdabda09d \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"favorite": true
}'
{
"ok": true,
"code": 200,
"message": "Analytics target updated",
"data": {
"id": "e7a7f417-56db-4320-9e9a-fd6fdabda09d",
"platform": "tiktok",
"identifier": "@brand",
"display_name": "Brand HQ",
"metadata": {
"favorite": true
}
}
}
Error Responses
400 missing_target_id- missing path parameter400 invalid_json- PATCH body is not valid JSON400 invalid_payload- PATCH body must be a JSON object400- no valid updates provided404- target not found in current key scope401/403- authentication failed or key lacks workspace access500- unexpected database/analytics service error
error_code field.