v1Resources/Clients/postAssign publisher sets

Assign publisher sets

Owners/admins with Clients access manage publisher sets. Agency-wide members can list assignment choices and assign sets to accessible clients. Client-restricted credentials are refused. Empty siteIds excludes every directory; sets cannot expand agency entitlements. Updates require the current revision and at least one changed field. Assigned sets cannot be deleted. Assignment is atomic and queues background listing adjustments.

post/api/v1/publisher-sets/assignment
clients:write
Request body
clientIdsarray of stringrequired
1–100 distinct accessible client database IDs.
publisherSetIdstringrequired
Publisher set ID, or null to restore the agency’s default directory coverage.
Response
dataobjectoptional
changedarray of stringoptional
unchangedarray of stringoptional
Errors
400The request is missing a required parameter or is otherwise malformed.
401Missing, invalid, expired, or revoked API key.
403The key lacks the required scope, or isn't authorized for this client/location.
404The resource wasn't found, or doesn't belong to your agency.
409The name is taken, the revision is stale, or the set is still assigned.
429Too many requests. Retry after the number of seconds in the Retry-After header.
post/api/v1/publisher-sets/assignment
Your API key
Request body*
{}

Guides that use this resource