post https://{subdomain}.ip-api-sandbox.yakoa.io/{network}/token//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. (Eitherbrand_id
orbrand_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").