> ## Documentation Index
> Fetch the complete documentation index at: https://adcp-docs-ja.pier1.co.jp/llms.txt
> Use this file to discover all available pages before exploring further.

# update_rights

> update_rights はアクティブな権利付与を変更するための AdCP タスク。終了日の延長、インプレッション上限の調整、価格オプションの変更、一時停止と再開 — 再発行された生成資格情報付き。

既存の権利付与を変更する — 日程の延長、インプレッション上限の調整、価格の変更、一時停止/再開。`update_media_buy` と並行します。提供したフィールドのみが更新される; 省略されたフィールドは変更されない。

## スキーマ

* **リクエスト**: [`update-rights-request.json`](https://adcontextprotocol.org/schemas/latest/brand/update-rights-request.json)
* **レスポンス**: [`update-rights-response.json`](https://adcontextprotocol.org/schemas/latest/brand/update-rights-response.json)

## 応答時間

ほとんどの更新は数秒。価格変更には権利保有者の承認が必要でより時間がかかる場合があります。

## クイックスタート

<CodeGroup>
  ```json リクエスト（終了日の延長） theme={null}
  {
    "rights_id": "janssen_likeness_voice",
    "end_date": "2026-09-30"
  }
  ```

  ```json リクエスト（インプレッション上限の引き上げ） theme={null}
  {
    "rights_id": "janssen_likeness_voice",
    "impression_cap": 200000
  }
  ```

  ```json リクエスト（付与の一時停止） theme={null}
  {
    "rights_id": "janssen_likeness_voice",
    "paused": true
  }
  ```

  ```json レスポンス（エラー） theme={null}
  {
    "errors": [
      {
        "code": "invalid_update",
        "message": "New impression_cap (50000) must be >= impressions already delivered (78432)"
      }
    ]
  }
  ```

  ```json レスポンス（成功） theme={null}
  {
    "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"
  }
  ```
</CodeGroup>

## パラメーター

### リクエスト

| フィールド               | 型       | 必須  | 説明                                          |
| ------------------- | ------- | --- | ------------------------------------------- |
| `rights_id`         | string  | Yes | `acquire_rights` からの権利付与識別子                 |
| `end_date`          | date    | No  | 新しい終了日（現在の終了日以降である必要があります）                  |
| `impression_cap`    | integer | No  | 新しいインプレッション上限（すでに配信されたインプレッション以上である必要があります） |
| `pricing_option_id` | string  | No  | 元の `get_rights` オファリングの別の価格オプションに切り替える      |
| `paused`            | boolean | No  | 付与を一時停止（`true`）または再開（`false`）               |
| `idempotency_key`   | string  | No  | 安全な再試行のためのクライアント生成キー                        |

### レスポンス

| フィールド                    | 型              | 説明                                                |
| ------------------------ | -------------- | ------------------------------------------------- |
| `rights_id`              | string         | 更新された権利付与識別子                                      |
| `terms`                  | object         | 更新された契約条件（`acquire_rights` の acquired レスポンスと同じ形状） |
| `generation_credentials` | array          | 更新された有効期限と上限で再発行された資格情報                           |
| `rights_constraint`      | object         | クリエイティブマニフェストへの再埋め込み用の更新された制約                     |
| `paused`                 | boolean        | 付与が現在一時停止されているか（一時停止状態が変わる場合に含まれる）                |
| `implementation_date`    | datetime\|null | 変更が有効になる時刻（承認待ちの場合は `null`）                       |

## 再発行された資格情報

日程を延長したり価格を変更したりすると、権利エージェントは更新された有効期限で生成資格情報を再発行します。古い資格情報と新しい資格情報は重複期間中に両方機能する場合がある — 古い資格情報は元の有効期限まで有効のままです。クリエイティブパイプライン内の資格情報を速やかに置き換える必要があるが、進行中の生成リクエストが途切れるような厳格な切り替え時点はない。

更新された `rights_constraint` は、ダウンストリームシステムが現在の条件を確認できるよう、アクティブなクリエイティブマニフェスト内の制約を置き換えるべきです。

## 次のステップ

<CardGroup cols={2}>
  <Card title="acquire_rights" icon="handshake" href="/docs/brand-protocol/tasks/acquire_rights">
    最初の権利取得フロー。
  </Card>

  <Card title="report_usage" icon="chart-line" href="/docs/accounts/tasks/report_usage">
    権利付与に対するインプレッションを報告します。
  </Card>
</CardGroup>