Interface UpdateRightsSuccess

Type Declaration

• rights_id: string

  Rights grant identifier from the acquire_rights response

• rights_agent: { url: string; id: string }

  The agent that granted these rights

  • url: string

    MCP endpoint URL of the rights agent

  • id: string

    Agent identifier

• Optionalrights_holder?: BrandReference

• Optionalvalid_from?: string

  Start of the rights validity period

• Optionalvalid_until?: string

  End of the rights validity period. Creative should not be served after this time.

• uses: [RightUse, ...RightUse[]]

  Rights uses covered by this constraint

  Min Items

  1

• Optionalcountries?: string[]

  Countries where this creative may be served under these rights (ISO 3166-1 alpha-2). If omitted, no country restriction. When both countries and excluded_countries are present, the effective set is countries minus excluded_countries.

• Optionalexcluded_countries?: string[]

  Countries excluded from rights availability (ISO 3166-1 alpha-2). Use when the grant is worldwide except specific markets.

• Optionalimpression_cap?: number

  Maximum total impressions allowed for the full validity period (valid_from to valid_until). This is the absolute cap across all creatives using this rights grant, not a per-creative or per-period limit.

• Optionalright_type?: RightType

• Optionalapproval_status?: "rejected" | "approved" | "pending"

  Approval status from the rights holder at manifest creation time (snapshot, not a live value)

• Optionalgrant_status?: "active" | "paused" | "revoked"

  Authoritative lifecycle state bound into the grant digest and credential status evidence. Only active can evaluate to verified. paused and revoked credentials are ineligible for serving; resumption issues a fresh active credential and reference.

• Optionalrestrictions?: [string, ...string[]]

  Normalized enforceable content and usage restrictions issued with the grant. When present these values are part of content_digest and cannot be omitted or changed without invalidating the attestation.

  Min Items

  1

• Optionaldisclosure?: {}

  Disclosure obligation issued with the grant and bound by content_digest.

• Optionalcreative_approval_required?: boolean

  Whether each creative produced under this grant requires holder approval before distribution. This enforceable term is bound by content_digest.

• Optionalverification_url?: string

  Deprecated

  DEPRECATED legacy informational locator. It is not proof of grant status, a revocation source, a credential locator, or permission to make a network request. Receivers MUST NOT fetch it during rights evaluation, and HTTP status codes have no AdCP authorization meaning. Rights authorization uses attestation_refs and a verifier-of-record evaluation under evaluator-owned policy.

• Optionalcontent_digest?: string

  SHA-256 of UTF8(JCS(rights_constraint minus content_digest, attestation_refs, and verification_url)), formatted as sha256:. This binds all serving-relevant grant fields, including future extension fields, while deliberately excluding the legacy non-authoritative URL.

• Optionalattestation_refs?:
      | [
          {
              issuer: AttestationIssuer;
              claim_type: string;
              subject: AttestationSubject;
              locator?: | AttestationCredentialUriLocator
              | AttestationIssuerCredentialIdLocator;
              embedded_credential?: {
                  format: string;
                  value: string
                  | {};
                  ext?: ExtensionObject;
              };
              content_digest?: string;
              credential_version?: string;
              validity_hint?: { not_before?: string; expires_at?: string };
              verify_agent?: { agent_url: string };
              ext?: ExtensionObject;
          } & {
              issuer?: { type: "brand"; brand: BrandReference };
              claim_type?: "https://adcontextprotocol.org/claims/rights/grant";
              subject?: {
                  type: "resource";
                  resource_type: "https://adcontextprotocol.org/claims/subjects/rights-grant";
              };
          },
      ]
      | [
          {
              issuer: AttestationIssuer;
              claim_type: string;
              subject: AttestationSubject;
              locator?: | AttestationCredentialUriLocator
              | AttestationIssuerCredentialIdLocator;
              embedded_credential?: {
                  format: string;
                  value: string
                  | {};
                  ext?: ExtensionObject;
              };
              content_digest?: string;
              credential_version?: string;
              validity_hint?: { not_before?: string; expires_at?: string };
              verify_agent?: { agent_url: string };
              ext?: ExtensionObject;
          } & {
              issuer?: { type: "brand"; brand: BrandReference };
              claim_type?: "https://adcontextprotocol.org/claims/rights/grant";
              subject?: {
                  type: "resource";
                  resource_type: "https://adcontextprotocol.org/claims/subjects/rights-grant";
              };
          },
          {
              issuer: AttestationIssuer;
              claim_type: string;
              subject: AttestationSubject;
              locator?: | AttestationCredentialUriLocator
              | AttestationIssuerCredentialIdLocator;
              embedded_credential?: {
                  format: string;
                  value: string
                  | {};
                  ext?: ExtensionObject;
              };
              content_digest?: string;
              credential_version?: string;
              validity_hint?: { not_before?: string; expires_at?: string };
              verify_agent?: { agent_url: string };
              ext?: ExtensionObject;
          } & {
              issuer?: { type: "brand"; brand: BrandReference };
              claim_type?: "https://adcontextprotocol.org/claims/rights/grant";
              subject?: {
                  type: "resource";
                  resource_type: "https://adcontextprotocol.org/claims/subjects/rights-grant";
              };
          },
      ]
      | [
          {
              issuer: AttestationIssuer;
              claim_type: string;
              subject: AttestationSubject;
              locator?: | AttestationCredentialUriLocator
              | AttestationIssuerCredentialIdLocator;
              embedded_credential?: {
                  format: string;
                  value: string
                  | {};
                  ext?: ExtensionObject;
              };
              content_digest?: string;
              credential_version?: string;
              validity_hint?: { not_before?: string; expires_at?: string };
              verify_agent?: { agent_url: string };
              ext?: ExtensionObject;
          } & {
              issuer?: { type: "brand"; brand: BrandReference };
              claim_type?: "https://adcontextprotocol.org/claims/rights/grant";
              subject?: {
                  type: "resource";
                  resource_type: "https://adcontextprotocol.org/claims/subjects/rights-grant";
              };
          },
          {
              issuer: AttestationIssuer;
              claim_type: string;
              subject: AttestationSubject;
              locator?: | AttestationCredentialUriLocator
              | AttestationIssuerCredentialIdLocator;
              embedded_credential?: {
                  format: string;
                  value: string
                  | {};
                  ext?: ExtensionObject;
              };
              content_digest?: string;
              credential_version?: string;
              validity_hint?: { not_before?: string; expires_at?: string };
              verify_agent?: { agent_url: string };
              ext?: ExtensionObject;
          } & {
              issuer?: { type: "brand"; brand: BrandReference };
              claim_type?: "https://adcontextprotocol.org/claims/rights/grant";
              subject?: {
                  type: "resource";
                  resource_type: "https://adcontextprotocol.org/claims/subjects/rights-grant";
              };
          },
          {
              issuer: AttestationIssuer;
              claim_type: string;
              subject: AttestationSubject;
              locator?: | AttestationCredentialUriLocator
              | AttestationIssuerCredentialIdLocator;
              embedded_credential?: {
                  format: string;
                  value: string
                  | {};
                  ext?: ExtensionObject;
              };
              content_digest?: string;
              credential_version?: string;
              validity_hint?: { not_before?: string; expires_at?: string };
              verify_agent?: { agent_url: string };
              ext?: ExtensionObject;
          } & {
              issuer?: { type: "brand"; brand: BrandReference };
              claim_type?: "https://adcontextprotocol.org/claims/rights/grant";
              subject?: {
                  type: "resource";
                  resource_type: "https://adcontextprotocol.org/claims/subjects/rights-grant";
              };
          },
      ]
      | [
          {
              issuer: AttestationIssuer;
              claim_type: string;
              subject: AttestationSubject;
              locator?: | AttestationCredentialUriLocator
              | AttestationIssuerCredentialIdLocator;
              embedded_credential?: {
                  format: string;
                  value: string
                  | {};
                  ext?: ExtensionObject;
              };
              content_digest?: string;
              credential_version?: string;
              validity_hint?: { not_before?: string; expires_at?: string };
              verify_agent?: { agent_url: string };
              ext?: ExtensionObject;
          } & {
              issuer?: { type: "brand"; brand: BrandReference };
              claim_type?: "https://adcontextprotocol.org/claims/rights/grant";
              subject?: {
                  type: "resource";
                  resource_type: "https://adcontextprotocol.org/claims/subjects/rights-grant";
              };
          },
          {
              issuer: AttestationIssuer;
              claim_type: string;
              subject: AttestationSubject;
              locator?: | AttestationCredentialUriLocator
              | AttestationIssuerCredentialIdLocator;
              embedded_credential?: {
                  format: string;
                  value: string
                  | {};
                  ext?: ExtensionObject;
              };
              content_digest?: string;
              credential_version?: string;
              validity_hint?: { not_before?: string; expires_at?: string };
              verify_agent?: { agent_url: string };
              ext?: ExtensionObject;
          } & {
              issuer?: { type: "brand"; brand: BrandReference };
              claim_type?: "https://adcontextprotocol.org/claims/rights/grant";
              subject?: {
                  type: "resource";
                  resource_type: "https://adcontextprotocol.org/claims/subjects/rights-grant";
              };
          },
          {
              issuer: AttestationIssuer;
              claim_type: string;
              subject: AttestationSubject;
              locator?: | AttestationCredentialUriLocator
              | AttestationIssuerCredentialIdLocator;
              embedded_credential?: {
                  format: string;
                  value: string
                  | {};
                  ext?: ExtensionObject;
              };
              content_digest?: string;
              credential_version?: string;
              validity_hint?: { not_before?: string; expires_at?: string };
              verify_agent?: { agent_url: string };
              ext?: ExtensionObject;
          } & {
              issuer?: { type: "brand"; brand: BrandReference };
              claim_type?: "https://adcontextprotocol.org/claims/rights/grant";
              subject?: {
                  type: "resource";
                  resource_type: "https://adcontextprotocol.org/claims/subjects/rights-grant";
              };
          },
          {
              issuer: AttestationIssuer;
              claim_type: string;
              subject: AttestationSubject;
              locator?: | AttestationCredentialUriLocator
              | AttestationIssuerCredentialIdLocator;
              embedded_credential?: {
                  format: string;
                  value: string
                  | {};
                  ext?: ExtensionObject;
              };
              content_digest?: string;
              credential_version?: string;
              validity_hint?: { not_before?: string; expires_at?: string };
              verify_agent?: { agent_url: string };
              ext?: ExtensionObject;
          } & {
              issuer?: { type: "brand"; brand: BrandReference };
              claim_type?: "https://adcontextprotocol.org/claims/rights/grant";
              subject?: {
                  type: "resource";
                  resource_type: "https://adcontextprotocol.org/claims/subjects/rights-grant";
              };
          },
      ]

  Alternative portable presentations of a holder-issued rights-grant credential signed by its authorized rights agent. The buyer carries references only; the serving party remains verifier-of-record. At least one reference must evaluate to verified and match rights_holder, rights_id, rights_agent, content_digest, validity, revocation state, and local policy before this constraint can contribute to serving eligibility.

  Min Items

  1

  Max Items

  4

• Optionalext?: ExtensionObject

• rights_id: string

  Rights grant identifier from the acquire_rights response

• rights_agent: { url: string; id: string }

  The agent that granted these rights

  • url: string

    MCP endpoint URL of the rights agent

  • id: string

    Agent identifier

• Optionalrights_holder?: BrandReference

• Optionalvalid_from?: string

  Start of the rights validity period

• Optionalvalid_until?: string

  End of the rights validity period. Creative should not be served after this time.

• uses: [RightUse, ...RightUse[]]

  Rights uses covered by this constraint

  Min Items

  1

• Optionalcountries?: string[]

  Countries where this creative may be served under these rights (ISO 3166-1 alpha-2). If omitted, no country restriction. When both countries and excluded_countries are present, the effective set is countries minus excluded_countries.

• Optionalexcluded_countries?: string[]

  Countries excluded from rights availability (ISO 3166-1 alpha-2). Use when the grant is worldwide except specific markets.

• Optionalimpression_cap?: number

  Maximum total impressions allowed for the full validity period (valid_from to valid_until). This is the absolute cap across all creatives using this rights grant, not a per-creative or per-period limit.

• Optionalright_type?: RightType

• Optionalapproval_status?: "rejected" | "approved" | "pending"

  Approval status from the rights holder at manifest creation time (snapshot, not a live value)

• Optionalgrant_status?: "active" | "paused" | "revoked"

  Authoritative lifecycle state bound into the grant digest and credential status evidence. Only active can evaluate to verified. paused and revoked credentials are ineligible for serving; resumption issues a fresh active credential and reference.

• Optionalrestrictions?: [string, ...string[]]

  Normalized enforceable content and usage restrictions issued with the grant. When present these values are part of content_digest and cannot be omitted or changed without invalidating the attestation.

  Min Items

  1

• Optionaldisclosure?: {}

  Disclosure obligation issued with the grant and bound by content_digest.

• Optionalcreative_approval_required?: boolean

  Whether each creative produced under this grant requires holder approval before distribution. This enforceable term is bound by content_digest.

• Optionalverification_url?: string

  Deprecated

  DEPRECATED legacy informational locator. It is not proof of grant status, a revocation source, a credential locator, or permission to make a network request. Receivers MUST NOT fetch it during rights evaluation, and HTTP status codes have no AdCP authorization meaning. Rights authorization uses attestation_refs and a verifier-of-record evaluation under evaluator-owned policy.

• Optionalcontent_digest?: string

  SHA-256 of UTF8(JCS(rights_constraint minus content_digest, attestation_refs, and verification_url)), formatted as sha256:. This binds all serving-relevant grant fields, including future extension fields, while deliberately excluding the legacy non-authoritative URL.

• Optionalattestation_refs?:
      | [
          {
              issuer: AttestationIssuer;
              claim_type: string;
              subject: AttestationSubject;
              locator?: | AttestationCredentialUriLocator
              | AttestationIssuerCredentialIdLocator;
              embedded_credential?: {
                  format: string;
                  value: string
                  | {};
                  ext?: ExtensionObject;
              };
              content_digest?: string;
              credential_version?: string;
              validity_hint?: { not_before?: string; expires_at?: string };
              verify_agent?: { agent_url: string };
              ext?: ExtensionObject;
          } & {
              issuer?: { type: "brand"; brand: BrandReference };
              claim_type?: "https://adcontextprotocol.org/claims/rights/grant";
              subject?: {
                  type: "resource";
                  resource_type: "https://adcontextprotocol.org/claims/subjects/rights-grant";
              };
          },
      ]
      | [
          {
              issuer: AttestationIssuer;
              claim_type: string;
              subject: AttestationSubject;
              locator?: | AttestationCredentialUriLocator
              | AttestationIssuerCredentialIdLocator;
              embedded_credential?: {
                  format: string;
                  value: string
                  | {};
                  ext?: ExtensionObject;
              };
              content_digest?: string;
              credential_version?: string;
              validity_hint?: { not_before?: string; expires_at?: string };
              verify_agent?: { agent_url: string };
              ext?: ExtensionObject;
          } & {
              issuer?: { type: "brand"; brand: BrandReference };
              claim_type?: "https://adcontextprotocol.org/claims/rights/grant";
              subject?: {
                  type: "resource";
                  resource_type: "https://adcontextprotocol.org/claims/subjects/rights-grant";
              };
          },
          {
              issuer: AttestationIssuer;
              claim_type: string;
              subject: AttestationSubject;
              locator?: | AttestationCredentialUriLocator
              | AttestationIssuerCredentialIdLocator;
              embedded_credential?: {
                  format: string;
                  value: string
                  | {};
                  ext?: ExtensionObject;
              };
              content_digest?: string;
              credential_version?: string;
              validity_hint?: { not_before?: string; expires_at?: string };
              verify_agent?: { agent_url: string };
              ext?: ExtensionObject;
          } & {
              issuer?: { type: "brand"; brand: BrandReference };
              claim_type?: "https://adcontextprotocol.org/claims/rights/grant";
              subject?: {
                  type: "resource";
                  resource_type: "https://adcontextprotocol.org/claims/subjects/rights-grant";
              };
          },
      ]
      | [
          {
              issuer: AttestationIssuer;
              claim_type: string;
              subject: AttestationSubject;
              locator?: | AttestationCredentialUriLocator
              | AttestationIssuerCredentialIdLocator;
              embedded_credential?: {
                  format: string;
                  value: string
                  | {};
                  ext?: ExtensionObject;
              };
              content_digest?: string;
              credential_version?: string;
              validity_hint?: { not_before?: string; expires_at?: string };
              verify_agent?: { agent_url: string };
              ext?: ExtensionObject;
          } & {
              issuer?: { type: "brand"; brand: BrandReference };
              claim_type?: "https://adcontextprotocol.org/claims/rights/grant";
              subject?: {
                  type: "resource";
                  resource_type: "https://adcontextprotocol.org/claims/subjects/rights-grant";
              };
          },
          {
              issuer: AttestationIssuer;
              claim_type: string;
              subject: AttestationSubject;
              locator?: | AttestationCredentialUriLocator
              | AttestationIssuerCredentialIdLocator;
              embedded_credential?: {
                  format: string;
                  value: string
                  | {};
                  ext?: ExtensionObject;
              };
              content_digest?: string;
              credential_version?: string;
              validity_hint?: { not_before?: string; expires_at?: string };
              verify_agent?: { agent_url: string };
              ext?: ExtensionObject;
          } & {
              issuer?: { type: "brand"; brand: BrandReference };
              claim_type?: "https://adcontextprotocol.org/claims/rights/grant";
              subject?: {
                  type: "resource";
                  resource_type: "https://adcontextprotocol.org/claims/subjects/rights-grant";
              };
          },
          {
              issuer: AttestationIssuer;
              claim_type: string;
              subject: AttestationSubject;
              locator?: | AttestationCredentialUriLocator
              | AttestationIssuerCredentialIdLocator;
              embedded_credential?: {
                  format: string;
                  value: string
                  | {};
                  ext?: ExtensionObject;
              };
              content_digest?: string;
              credential_version?: string;
              validity_hint?: { not_before?: string; expires_at?: string };
              verify_agent?: { agent_url: string };
              ext?: ExtensionObject;
          } & {
              issuer?: { type: "brand"; brand: BrandReference };
              claim_type?: "https://adcontextprotocol.org/claims/rights/grant";
              subject?: {
                  type: "resource";
                  resource_type: "https://adcontextprotocol.org/claims/subjects/rights-grant";
              };
          },
      ]
      | [
          {
              issuer: AttestationIssuer;
              claim_type: string;
              subject: AttestationSubject;
              locator?: | AttestationCredentialUriLocator
              | AttestationIssuerCredentialIdLocator;
              embedded_credential?: {
                  format: string;
                  value: string
                  | {};
                  ext?: ExtensionObject;
              };
              content_digest?: string;
              credential_version?: string;
              validity_hint?: { not_before?: string; expires_at?: string };
              verify_agent?: { agent_url: string };
              ext?: ExtensionObject;
          } & {
              issuer?: { type: "brand"; brand: BrandReference };
              claim_type?: "https://adcontextprotocol.org/claims/rights/grant";
              subject?: {
                  type: "resource";
                  resource_type: "https://adcontextprotocol.org/claims/subjects/rights-grant";
              };
          },
          {
              issuer: AttestationIssuer;
              claim_type: string;
              subject: AttestationSubject;
              locator?: | AttestationCredentialUriLocator
              | AttestationIssuerCredentialIdLocator;
              embedded_credential?: {
                  format: string;
                  value: string
                  | {};
                  ext?: ExtensionObject;
              };
              content_digest?: string;
              credential_version?: string;
              validity_hint?: { not_before?: string; expires_at?: string };
              verify_agent?: { agent_url: string };
              ext?: ExtensionObject;
          } & {
              issuer?: { type: "brand"; brand: BrandReference };
              claim_type?: "https://adcontextprotocol.org/claims/rights/grant";
              subject?: {
                  type: "resource";
                  resource_type: "https://adcontextprotocol.org/claims/subjects/rights-grant";
              };
          },
          {
              issuer: AttestationIssuer;
              claim_type: string;
              subject: AttestationSubject;
              locator?: | AttestationCredentialUriLocator
              | AttestationIssuerCredentialIdLocator;
              embedded_credential?: {
                  format: string;
                  value: string
                  | {};
                  ext?: ExtensionObject;
              };
              content_digest?: string;
              credential_version?: string;
              validity_hint?: { not_before?: string; expires_at?: string };
              verify_agent?: { agent_url: string };
              ext?: ExtensionObject;
          } & {
              issuer?: { type: "brand"; brand: BrandReference };
              claim_type?: "https://adcontextprotocol.org/claims/rights/grant";
              subject?: {
                  type: "resource";
                  resource_type: "https://adcontextprotocol.org/claims/subjects/rights-grant";
              };
          },
          {
              issuer: AttestationIssuer;
              claim_type: string;
              subject: AttestationSubject;
              locator?: | AttestationCredentialUriLocator
              | AttestationIssuerCredentialIdLocator;
              embedded_credential?: {
                  format: string;
                  value: string
                  | {};
                  ext?: ExtensionObject;
              };
              content_digest?: string;
              credential_version?: string;
              validity_hint?: { not_before?: string; expires_at?: string };
              verify_agent?: { agent_url: string };
              ext?: ExtensionObject;
          } & {
              issuer?: { type: "brand"; brand: BrandReference };
              claim_type?: "https://adcontextprotocol.org/claims/rights/grant";
              subject?: {
                  type: "resource";
                  resource_type: "https://adcontextprotocol.org/claims/subjects/rights-grant";
              };
          },
      ]

  Alternative portable presentations of a holder-issued rights-grant credential signed by its authorized rights agent. The buyer carries references only; the serving party remains verifier-of-record. At least one reference must evaluate to verified and match rights_holder, rights_id, rights_agent, content_digest, validity, revocation state, and local policy before this constraint can contribute to serving eligibility.

  Min Items

  1

  Max Items

  4

• Optionalext?: ExtensionObject