Lists

Reassign List Owner

Hand a list to someone else.

mode="list_and_records" ALSO re-owns every record in the list. Under record-level scoping that changes who can see them, so preview it first.

This route carries no verify_list_access_dep in the app - the transfer rules are enforced inside the handler instead, and they are stricter than the per-list read gate rather than weaker.

patch/lists/{audience_id}/owner

Request

  • Base URL: https://be.graph8.com/api/v1
  • URL: https://be.graph8.com/api/v1/lists/{audience_id}/owner
  • Auth: HTTP bearer

Path parameters

audience_idinteger required

List (audience) id.

Headers

Authorizationstring nullable
X-Target-Org-Idstring nullable

Request body

owner_user_idstring required
owner_emailstring email required

Must agree with the user id - the app verifies both. Typed as an email at the request layer because the app's model is EmailStr and is built inside the handler: a malformed address would otherwise raise there and escape as a 500 rather than a 422.

mode'list_only' | 'list_and_records'

list_only moves just the list. list_and_records also re-owns every record in it, which can change who else can see them.

Response

Successful Response

dataListPayload required

An open envelope for a list, a capability map or a job result.

Open because several of these return the whole Audience, whose shape carries per-source metadata that differs between an uploaded file, a dynamic query and a master list - and grows with them.

Changes