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"
}

{
  "rights_id": "janssen_likeness_voice",
  "impression_cap": 200000
}

{
  "rights_id": "janssen_likeness_voice",
  "paused": true
}

{
  "errors": [
    {
      "code": "invalid_update",
      "message": "New impression_cap (50000) must be >= impressions already delivered (78432)"
    }
  ]
}

{
  "rights_id": "janssen_likeness_voice",
  "terms": {
    "pricing_option_id": "monthly_exclusive",
    "amount": 350,
    "currency": "EUR",
    "period": "monthly",
    "uses": ["likeness", "voice"],
    "impression_cap": 200000,
    "overage_cpm": 4.00,
    "start_date": "2026-04-01",
    "end_date": "2026-09-30",
    "exclusivity": {
      "scope": "Exclusive licensee for Daan Janssen in NL for food/restaurant brands",
      "countries": ["NL"]
    }
  },
  "generation_credentials": [
    {
      "provider": "midjourney",
      "rights_key": "rk_mj_abc123_renewed...",
      "uses": ["likeness"],
      "expires_at": "2026-09-30T23:59:59Z"
    },
    {
      "provider": "elevenlabs",
      "rights_key": "rk_el_def456_renewed...",
      "uses": ["voice"],
      "expires_at": "2026-09-30T23:59:59Z"
    }
  ],
  "rights_constraint": {
    "rights_id": "janssen_likeness_voice",
    "rights_agent": { "url": "https://agent.lotientertainment.com/mcp", "id": "loti_entertainment" },
    "valid_from": "2026-04-01T00:00:00Z",
    "valid_until": "2026-09-30T23:59:59Z",
    "uses": ["likeness", "voice"],
    "countries": ["NL"],
    "impression_cap": 200000,
    "approval_status": "approved",
    "verification_url": "https://agent.lotientertainment.com/rights/rts_abc123/verify"
  },
  "implementation_date": "2026-06-28T14:30:00Z"
}

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.