Sign in
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}

Path parameters

profile_idinteger required

Discovery Agent profile ID.

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 recorded changes to this endpoint across all 1 revision of this API.