API Reference

Create or Update Token Brand Authorization

Creates or updates a Brand Authorization for a specific Token.

{user.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").
Language
Credentials
Header
URL
Click Try It! to start a request and see the response here!