Domain Management
Domain Management
To use the Domain Management APIs, the calling Domain must be part the Partner Management Group of 3Q. Contact the Support, if this is needed.
/domains/clonefornetwork
POST
https://api.nexx.cloud/v3.1/manage/domains/clonefornetwork
Request Body
title*
string
the Title of the new registered Domain
url*
string
the URL of the new registered Domain
networkmode*
string
[mixed, master, own, all] defines the Rights on Network Contents for the new Domain
refnr
string
an internal Reference Number of the Client
/domains/:domainid/markfordeletion
DELETE
https://api.nexx.cloud/v3.1/manage/domains/:domainid/markfordeletion
will mark the given Domain for Deletion. The given Domain cannot be the calling Domain and must be part of the same Network. Contents of the target Domain will not be deleted.
Path Parameters
domainid*
integer
a valid Domain ID of the Network of the calling Domain
Domain References
Domain References handles Objects and Structures, that are not considered as "Media", but belong to the Domain and serve as References.
/channels/add
POST
https://api.nexx.cloud/v3.1/manage/channels/add
all Parameters of the /channels/update Methods are supported.
/channels/:channelid/update
PUT
https://api.nexx.cloud/v3.1/manage/channels/:channelid/update
Path Parameters
channelid*
integer
the ID of a Channel of the calling Domain
Request Body
title*
string
subtitle
string
refnr
string
teaser
string
description
string
parent
integer
if the Channel shall be a Sub Channel of a parent Channel, add the parent Channel ID here
pos
integer
an optional Sorting Parameter for publically visible Channels
color
string
/channels/:channelid/cover
POST
https://api.nexx.cloud/v3.1/manage/channels/:channelid/cover
Path Parameters
channelid*
integer
the ID of a Channel of the calling Domain
Query Parameters
url*
String
the URL to the Image, that should be used as Cover
description
String
an optional Description of the Cover
assetLanguage
string
if the Domain supports MultiLanguage Assets, this Cover will be used only in Contexts with this given Language and not override the main Cover
copyright
String
an optional Copyright for the Cover
isAIGenerated
[0, 1]
if set to 1, the System will assume, that this Asset has been created by an AI.
/channels/:channelid/actionshot
POST
https://api.nexx.cloud/v3.1/manage/channels/actionshot
Path Parameters
channelid*
integer
the ID of a Channel of the calling Domain
Query Parameters
url*
String
the URL to the Image, that should be used as ActionShot
description
String
an optional Description of the Cover
assetLanguage
String
if the Domain supports MultiLanguage Assets, this Cover will be used only in Contexts with this given Language and not override the main Cover
copyright
String
an optional Copyright for the Cover.
isAIGenerated
[0, 1]
if set to 1, the System will assume, that this Asset has been created by an AI.
/channels/:channelid/remove
DELETE
https://api.nexx.cloud/v3.1/manage/channels/:channelid/remove
Path Parameters
channelid*
integer
the ID of a Channel of the calling Domain
/formats/add
POST
https://api.nexx.cloud/v3.1/manage/formats/add
all Parameters of the /formats/update Methods are supported.
/formats/:formatid/update
PUT
https://api.nexx.cloud/v3.1/manage/formats/:formatid/update
Path Parameters
formatid
integer
the ID of a Channel of the calling Domain
Request Body
title*
string
subtitle
string
refnr
string
teaser
string
description
string
/formats/:formatid/cover
POST
https://api.nexx.cloud/v3.1/manage/formats/:formatid/cover
Path Parameters
formatid*
integer
the ID of a Format of the calling Domain
Query Parameters
url*
String
the URL to the Image, that should be used as Cover
description
String
an optional Description of the Cover
assetLanguage
String
if the Domain supports MultiLanguage Assets, this Cover will be used only in Contexts with this given Language and not override the main Cover
copyright
String
an optional Copyright for the Cover.
isAIGenerated
[0, 1]
if set to 1, the System will assume, that this Asset has been created by an AI.
/formats/:formatid/actionshot
POST
https://api.nexx.cloud/v3.1/manage/formats/:formatid/actionshot
Path Parameters
formatid*
integer
the ID of a Format of the calling Domain
Query Parameters
url*
String
the URL to the Image, that should be used as Cover
description
String
an optional Description of the Cover
assetLanguage
String
if the Domain supports MultiLanguage Assets, this Cover will be used only in Contexts with this given Language and not override the main Cover
copyright
String
an optional Copyright for the Cover
isAIGenerated
[0, 1]
if set to 1, the System will assume, that this Asset has been created by an AI.
/formats/:formatid/remove
DELETE
https://api.nexx.cloud/v3.1/manage/formats/:formatid/remove
Path Parameters
channelid
integer
the ID of a Channel of the calling Domain
/:streamtypecategories/add
POST
https://api.nexx.cloud/v3.1/manage/:streamtypecategories/add
all Parameters of the /channels/update Methods are supported.
Path Parameters
streamtypecategories*
string
[videocategories, audiocategories, imagecategories, filecategories, articlecategories, eventcategories, placecategories, productcategories]
/:streamtypecategories/:categoryid/update
PUT
https://api.nexx.cloud/v3.1/manage/:streamtypecategories/:categoryid/update
Path Parameters
streamtypecategories*
string
[videocategories, audiocategories, imagecategories, filecategories, articlecategories, eventcategories, placecategories, productcategories]
categoryid*
integer
the ID of a Category of the given Type of the calling Domain
Request Body
title*
string
subtitle
string
color
string
only valid for Event Categories
/:streamtypecategories/:categoryid/cover
POST
https://api.nexx.cloud/v3.1/manage/:streamtypecategories/:categoryid/cover
Path Parameters
categoryid*
integer
the ID of a Category of the given Type of the calling Domain
streamtypecategories*
String
[videocategories, audiocategories, imagecategories, filecategories, articlecategories, eventcategories, placecategories, productcategories]
Query Parameters
url*
String
the URL to the Image, that should be used as Cover
description
String
an optional Description of the Cover
assetLanguage
String
if the Domain supports MultiLanguage Assets, this Cover will be used only in Contexts with this given Language and not override the main Cover
copyright
String
an optional Copyright of the Cover
/:streamtypecategories/:categoryid/remove
DELETE
https://api.nexx.cloud/v3.1/manage/:streamtypecategories/:categoryid/remove
Path Parameters
streamtypecategories*
string
[videocategories, audiocategories, imagecategories, filecategories, articlecategories, eventcategories, placecategories, productcategories]
categoryid*
integer
the ID of a Category of the given Type of the calling Domain
UploadLinks
UploadsLinks are dynamic URLs, that allow external Users to upload Files to a specific nexxOMNIA Account.
/uploadlinks/add
POST
https://api.nexx.cloud/v3.1/manage/uploadlinks/add
Request Body
title*
string
a Title for the new UploadLink
selectedStreamtypes*
string
a comma-seperated List of Streamtypes, that can be uploaded via this Link. Possible is [video, audio, image, file]
language*
string
a 2-Letter coded Language for the Frontend. Currently supported is [de, en, es, fr]
maxUsages
integer
if the UploadLink shall be restricted in Usage, use this Parameter for the maximal Number of Usages.
code
string
if desired, an optional code for further Protection of the Link.
useDomainStyle
boolean
if set to 1, the UploadLink UI will use the target Domain Colors and Icons.
askForNotes
boolean
if set to 1, the UploadLink will force the User to add some "Notes" as addiitonal Info for this Upload
/uploadlinks/:uploadlinkid/remove
DELETE
https://api.nexx.cloud/v3.1/manage/uploadlinks/:uploadlinkid/remove
Path Parameters
uploadlinkid
integer
the ID of an UploadLink of the calling Domain
Last updated