Get a media handle for the header

POST /api/templates/media-handle

Downloads the file from the URL (max. 16 MB; image/jpeg, image/png, video/mp4 or application/pdf), uploads it to Meta and returns a handle for example.header_handle of the HEADER component. Requires the templates:manage scope.

Request body

Field	Type		Description
`channel_id`	string	required	channel_id of the channel (`nk_` prefix). Example: `"nk_dvzobn7m4h4y"`.
`url`	string	required	Public URL of the header example file. Types: image/jpeg, image/png, video/mp4, application/pdf. Maximum 16 MB. Example: `"https://cdn.example.com/banner.jpg"`.

Responses

Status	Description	Schema
`200`	—	MediaHandleResponseDto

Example

curl -X POST https://api.neike.dev/api/templates/media-handle \
  -H "x-neike-api-key: whk_live_…" \
  -H "Content-Type: application/json" \
  -d '{
       "channel_id": "nk_dvzobn7m4h4y",
       "url": "https://cdn.example.com/banner.jpg"
     }'

MediaHandleResponseDto

Field	Type		Description
`externalCode`	number	required	Example: `200`.
`header_handle`	string	optional	Handle for the template’s `example.header_handle`. Example: `"4::aW1hZ2UvanBlZw==:ARb"`.
`message`	string	optional	Error message, if `externalCode` != 200.