update_rights

update_rights is the AdCP task for modifying active rights grants. Extend end dates, adjust impression caps, switch pricing options, or pause and resume — with re-issued generation credentials.

Experimental. Brand rights lifecycle (get_rights, acquire_rights, update_rights) is part of AdCP 3.0 as an experimental surface — it may change between 3.x releases with at least 6 weeks’ notice. Sellers implementing any of these tasks MUST declare brand.rights_lifecycle in experimental_features. See experimental status for the full contract.

Modify an existing rights grant — extend dates, adjust impression caps, change pricing, or pause/resume. Parallels update_media_buy. Only the fields you provide are updated; omitted fields remain unchanged.

Schema

• Request: update-rights-request.json
• Response: update-rights-response.json

Response time

Seconds for most updates. Pricing changes may require rights holder approval and take longer.

Quick start

Request (extend end date)

{
  "rights_id": "janssen_likeness_voice",
  "end_date": "2026-09-30"
}

Parameters

Request

Field	Type	Required	Description
rights_id	string	Yes	Rights grant identifier from acquire_rights
account	account-ref	Conditional	Account context. Pass when the brand agent has a governance agent bound to this brand+operator via sync_governance — update_rights is a modification-phase governance trigger, and the brand agent uses account to resolve the bound agent when computing the incremental commit delta. When both an inline governance_context token and a bound agent are present, the inline token wins.
end_date	date	No	New end date (must be >= current end date)
impression_cap	integer	No	New impression cap (must be >= impressions already delivered)
pricing_option_id	string	No	Switch to a different pricing option from the original get_rights offering
paused	boolean	No	Pause (true) or resume (false) the grant
idempotency_key	string	No	Client-generated key for safe retries

Response

Field	Type	Description
rights_id	string	The updated rights grant identifier
terms	object	Updated contractual terms (same shape as acquire_rights acquired response)
generation_credentials	array	Re-issued credentials with updated expiration and caps
rights_constraint	object	Updated constraint for re-embedding in creative manifests
paused	boolean	Whether the grant is currently paused (included when pause state changes)
implementation_date	datetime|null	When changes take effect (null if pending approval)

Re-issued credentials

When you extend dates or change pricing, the rights agent re-issues generation credentials with updated expiration. Both old and new credentials may work during an overlap period — old credentials remain valid until their original expiry. Replace credentials in your creative pipeline promptly, but there is no hard cutover moment that would break in-flight generation requests.

The updated rights_constraint should replace the constraint in any active creative manifests so downstream systems see the current terms.

Next steps

acquire_rights

The initial rights acquisition flow.

report_usage

Report impressions against rights grants.