curl -X PATCH "https://api.affonso.io/v1/program/campaigns/cmretainer01camp0001/applications/cmapp01retainer0001/condition" \
-H "Authorization: Bearer sk_live_your_api_key" \
-H "Content-Type: application/json" \
-d '{
"has_condition": true,
"condition": "Post at least 3 Shorts per week mentioning our product"
}'
curl -X PATCH "https://api.affonso.io/v1/program/campaigns/cmretainer01camp0001/applications/cmapp01retainer0001/condition" \
-H "Authorization: Bearer sk_live_your_api_key" \
-H "Content-Type: application/json" \
-d '{
"has_condition": false
}'
{
"success": true,
"data": {
"id": "cmapp01retainer0001",
"campaign_id": "cmretainer01camp0001",
"affiliate_id": "aff_abc123",
"affiliate": {
"id": "aff_abc123",
"name": "Jane Smith",
"email": "jane@example.com"
},
"answers": "I publish weekly Shorts to 40k followers",
"status": "ACCEPTED",
"reviewed_at": "2026-10-12T16:00:00.000Z",
"retainer_has_condition": true,
"retainer_condition": "Post at least 3 Shorts per week mentioning our product",
"retainer_ended_at": null,
"retainer_resumed_at": null,
"created_at": "2026-10-10T12:00:00.000Z",
"updated_at": "2026-10-12T16:30:00.000Z"
}
}
Campaigns
Update Retainer Condition
Update the retainer condition on an accepted application
PATCH
/
v1
/
program
/
campaigns
/
{id}
/
applications
/
{applicationId}
/
condition
curl -X PATCH "https://api.affonso.io/v1/program/campaigns/cmretainer01camp0001/applications/cmapp01retainer0001/condition" \
-H "Authorization: Bearer sk_live_your_api_key" \
-H "Content-Type: application/json" \
-d '{
"has_condition": true,
"condition": "Post at least 3 Shorts per week mentioning our product"
}'
curl -X PATCH "https://api.affonso.io/v1/program/campaigns/cmretainer01camp0001/applications/cmapp01retainer0001/condition" \
-H "Authorization: Bearer sk_live_your_api_key" \
-H "Content-Type: application/json" \
-d '{
"has_condition": false
}'
{
"success": true,
"data": {
"id": "cmapp01retainer0001",
"campaign_id": "cmretainer01camp0001",
"affiliate_id": "aff_abc123",
"affiliate": {
"id": "aff_abc123",
"name": "Jane Smith",
"email": "jane@example.com"
},
"answers": "I publish weekly Shorts to 40k followers",
"status": "ACCEPTED",
"reviewed_at": "2026-10-12T16:00:00.000Z",
"retainer_has_condition": true,
"retainer_condition": "Post at least 3 Shorts per week mentioning our product",
"retainer_ended_at": null,
"retainer_resumed_at": null,
"created_at": "2026-10-10T12:00:00.000Z",
"updated_at": "2026-10-12T16:30:00.000Z"
}
}
Change the retainer condition on an accepted application. Requires
write:affiliates. Foreign-team IDs return 404.
Path Parameters
string
required
Encoded campaign id
string
required
Encoded application id
Body Parameters
boolean
required
true to keep or set a condition. false clears the condition text.string | null
Condition text. Required when
has_condition is true. Maximum 2000 characters. Cleared when has_condition is false.Response
Returns the updated application object. Same structure as Accept Campaign Application.curl -X PATCH "https://api.affonso.io/v1/program/campaigns/cmretainer01camp0001/applications/cmapp01retainer0001/condition" \
-H "Authorization: Bearer sk_live_your_api_key" \
-H "Content-Type: application/json" \
-d '{
"has_condition": true,
"condition": "Post at least 3 Shorts per week mentioning our product"
}'
curl -X PATCH "https://api.affonso.io/v1/program/campaigns/cmretainer01camp0001/applications/cmapp01retainer0001/condition" \
-H "Authorization: Bearer sk_live_your_api_key" \
-H "Content-Type: application/json" \
-d '{
"has_condition": false
}'
{
"success": true,
"data": {
"id": "cmapp01retainer0001",
"campaign_id": "cmretainer01camp0001",
"affiliate_id": "aff_abc123",
"affiliate": {
"id": "aff_abc123",
"name": "Jane Smith",
"email": "jane@example.com"
},
"answers": "I publish weekly Shorts to 40k followers",
"status": "ACCEPTED",
"reviewed_at": "2026-10-12T16:00:00.000Z",
"retainer_has_condition": true,
"retainer_condition": "Post at least 3 Shorts per week mentioning our product",
"retainer_ended_at": null,
"retainer_resumed_at": null,
"created_at": "2026-10-10T12:00:00.000Z",
"updated_at": "2026-10-12T16:30:00.000Z"
}
}
Notes
- Requires
write:affiliates. - Only accepted retainer applications can be updated. Non-retainer or non-accepted applications return an error.
Was this page helpful?