Create a brand link

Creates a new brand link.

post

Path parameters

domainIdstringRequired

The id of the domain.

Header parameters

Brand-URLstringRequired

The brand URL of the request. This is used to identify the brand.

Example: YOUR_BRAND_URL

Auth-KeystringRequired

This is used to authenticate the request. If the request is not authenticated, the server will return a 401 Unauthorized response.

Example: YOUR_AUTH_KEY

Body

application/jsontext/jsonapplication/*+json

This class is used to create, update for the brand link.

parentBrandLinkIdstring | nullableOptional

The parent brand link id. If this is null, it means the link is a node link.

namestring · min: 1Required

The name.

typestring · enumOptionalPossible values:

stylesstring | nullableOptional

The styles of the link.

iconUrlstring · uri | nullableOptional

The icon url.

linkstring · uri | nullableOptional

The reference link. Clicking the link redirects to the specified URL. To use a local path, provide a relative path in the format: /path/to/your/page.

zOrderinteger · int32 | nullableOptional

The z-order numer of the link. If this is not provided, we will be checking the max z-order of the parent link and increment by 1.

statusstring · enumOptionalPossible values:

descriptionstring | nullableOptional

The description.

Responses

201

The request was successful.

application/json

401

The user is not authorized to access the requested resource. The request is missing the required Auth-Key header.

application/json

403

The user's access was denied.

application/json

429

The user has exceeded the rate limit.

application/json

post

HTTPcURLJavaScriptPython

POST /api/v1/domains/{domainId}/links HTTP/1.1
Host: protocol.jframework.io
Brand-URL: text
Auth-Key: text
Content-Type: application/json
Accept: */*
Content-Length: 196

{
  "parentBrandLinkId": "text",
  "name": "text",
  "type": "0 - Unknown",
  "styles": "text",
  "iconUrl": "https://example.com",
  "link": "https://example.com",
  "zOrder": 1,
  "status": "0 - Inactive",
  "description": "text"
}

application/jsontext/jsonapplication/*+json

{
  "success": true,
  "statusCode": 201,
  "message": "The request was successful.",
  "data": {
    "brandId": "KAOplmx0i1A",
    "parentBrandLinkId": "Plo0szlmPs",
    "name": "Name",
    "type": "BodyFooter",
    "styles": "Group Name",
    "iconURL": "https://www.example.com/icon.png",
    "link": "https://www.example.com",
    "description": "Description",
    "status": "Active",
    "items": [],
    "zOrder": 1,
    "id": "sApKpllz4sAplsmzha"
  },
  "errors": []
}