Skip to main content

Update Affiliate

PATCH 
/affiliates/:affiliateId

Updates an affiliate's details including status, lock state, offer assignment, custom fields, URL configuration, merchant-assigned external identifier, and parent affiliate assignment. Supports partial updates - only the fields provided in the request body will be updated.

Any transition between the valid public statuses (APPROVED, PENDING, DENIED) is permitted. Transitioning from APPROVED to DENIED is blocked if the affiliate has pending or unpaid conversions. Setting status to DELETED or DISABLED is not allowed via this endpoint — DISABLED is an internal flag managed via the locked field, and deletion uses the DELETE endpoint.

The locked field abstracts the internal DISABLED state: locked: true locks an APPROVED affiliate, and locked: false unlocks it. locked is only accepted when the affiliate's current status is APPROVED, and it cannot be combined with status in the same request.

The parentAffiliateId field accepts another affiliate ID owned by the authenticated client. Passing null clears the existing parent relationship.

Request​

Responses​

Affiliate updated successfully