Create or Update Token Brand Authorization

Creates or updates a Brand Authorization for a specific Token.

EMAIL

This endpoint establishes or modifies a record indicating that a specific Token has explicit permission from a Brand to use its intellectual property.
If an authorization for this Token and Brand already exists, its data field is updated. Otherwise, a new authorization record is created.

Use Cases:

  • A Brand explicitly approves a specific Token (e.g., a piece of user-generated content using their IP).
  • Marking a Token as a "false positive" after an infringement check, thereby authorizing it.
  • Updating the details or evidence of an existing authorization for a Token.

Path Parameters:

  • token_id (string, required, from parent router): The unique identifier of the Token receiving the authorization.
  • network (string, required, from parent router): The blockchain network.

Request Body:

  • brand_id (string, optional): The unique identifier of the Brand granting the authorization.
  • brand_name (string, optional): The name of the Brand. (Either brand_id or brand_name must be provided).
  • data (object, required): An object containing details about the authorization. The structure of this object can vary. Common fields include:
    • type (string): The type of authorization (e.g., "email", "false_positive").
    • Other fields relevant to the type (e.g., email_address for "email", reason for "false_positive").
Path Params
string
required
^0x[a-f0-9]{40}(:[0-9]+)?$
Body Params
data
required
Responses

Language
Credentials
Header
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json