Brands

Prev Next
Get
/public/v1/brand-management/brands

Retrieves the list of brands that the authenticated tenant is connected to. A tenant is connected to a brand when it has subscribed to one or more of that brand's services.

Security

The requesting user must have the following permission to retrieve brands:

  • Administration → View Brand Manager

This permission is visible in the permission tree on corporate instances only — it does not appear for customers on a standard instance.

Security
HTTP
Type Bearer
Header parameters
x-r365-context-tenant-id
stringRequired

Identifies the R365 tenant the request applies to. Required on every request.

Responses
200

Connected Brands

Array of object
object
id
integer (int64)

Unique identifier of the connected brand.

name
string | null

Display name of the connected brand.

Array of object
object
id
integer (int64)

Unique identifier of the connected brand.

name
string | null

Display name of the connected brand.

Array of object
object
id
integer (int64)

Unique identifier of the connected brand.

name
string | null

Display name of the connected brand.

400

Bad Request — a parameter value is malformed, of the wrong type, or outside its allowed range.

401

Unauthorized — the bearer token is missing, invalid or expired, or is not valid for the specified tenant.

403

Forbidden — the caller lacks the permission required for this operation.

404

Not Found — the requested resource does not exist, or the supplied continuation token is unknown or has expired.

409

Conflict — the request conflicts with the current state of the resource and cannot be applied.

422

Unprocessable Entity — a required parameter is missing, or a supplied parameter value is invalid.

429

Too Many Requests — the caller has exceeded the rate limit; retry after a short delay.

500

Internal Server Error — an unexpected error occurred while processing the request.