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

# Update Retainer Condition

> Update the retainer condition on an accepted application

Change the retainer condition on an accepted application. Requires `write:affiliates`. Foreign-team IDs return 404.

## Path Parameters

**id** `string` *required*

Encoded campaign id

**applicationId** `string` *required*

Encoded application id

## Body Parameters

**has\_condition** `boolean` *required*

`true` to keep or set a condition. `false` clears the condition text.

**condition** `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](/api/endpoint/campaigns/accept-application).

```bash cURL theme={null}
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"
  }'
```

```bash cURL (clear condition) theme={null}
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
  }'
```

```json Response theme={null}
{
  "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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.