REreacherapp
Discovery Agent

Update a Discovery Agent creator profile

Partially update one brief — only the fields you send are changed.

Changing search_query or filters re-derives the stored title and re-resolves the match set, and if the brief already backs a Vault list that list is re-synced. Editing a Reacher-generated brief flips its source to user_created; it is then yours and is no longer regenerated.

is_deleted is not settable here — use DELETE /discovery/profiles/{profile_id} — so a PATCH can never silently retire a brief.

Returns 404 if the profile does not exist or belongs to another shop. Requires read_write scope. Single-shop only.

patch/discovery/profiles/{profile_id}

Request

  • Base URL
    https://api.reacherapp.com/public/v1
  • URL
    https://api.reacherapp.com/public/v1/discovery/profiles/{profile_id}
  • Auth
    API key in header x-api-key and API key in header x-shop-id

Path parameters

profile_idinteger required

Discovery Agent profile ID.

Headers

Idempotency-Keystring nullable

Request body

titlestring nullable
descriptionstring nullable
search_querystring nullable
filtersobject nullable

Replaces the stored demographic filters wholesale.

is_activeboolean nullable

Whether the brief is refreshed on the usual schedule.

is_hiddenboolean nullable

Hide the brief from the profile list without deleting it.

hide_unsafeboolean nullable

Exclude brand-unsafe creators from the match set.

Response

Successful Response

successboolean required

Changes

No operation changes recorded.