API docs by Redocly

Polario API (5.5)

Download OpenAPI specification:Download

API for Polario

Naming:

  • json properties are formatted in camel case (fooBar) besides of enums (FooBar)
  • route params are formatted in hyphen case (foo-bar)
  • query params are formatted in snake case (foo_bar)
  • query params could hold lists of elements if they are comma separated
  • enum properties are formatted in capitalized camel case (FooBar)

Default values:

  • default values are specified for optional parameters do only apply to POST requests

Types:

  • numbers are considered to be float values
  • strings that are not specified to be html formatted should not be interpreted as html to avoid unexpected bahavior, like xss attacks
  • timestamps are considered to be in unix time

Headers:

  • Platform: can be always set as header param to specify the platform of the request for the logging output

Account

Get push token

This endpoint is for requesting account device push token. Session is linked to a device.

accessible without permission (can only be used for the own account. Session must match requested account id.)

path Parameters
id
required
string

Account ID of JWT

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "acceptLanguage": "fr-CH, fr;q=0.9, en;q=0.8, de;q=0.7, *;q=0.5",
  • "iosEnv": "Production",
  • "pushToken": "string",
  • "webPushKeys": {
    }
}

Set push token

This endpoint is for setting account device push token. Session is linked to a device. The Accept-Language header is used to select the language for sending the push notification. If no language is selected, it will be sent for the default language of the system.

accessible without permission (can only be used for the own account. Session must match requested account id.)

path Parameters
id
required
string

Account ID of JWT

header Parameters
Session
required
string

JWT

Accept-Language
string

client language(s)

Request Body schema: application/json

device push values

iosEnv
string or null <optional>
Enum: "Production" "Sandbox"
pushToken
string

endpoint for web push

object or null <optional>

Responses

Request samples

Content type
application/json
{
  • "iosEnv": "Production",
  • "pushToken": "string",
  • "webPushKeys": {
    }
}

Response samples

Content type
application/json
{
  • "status": "ok"
}

Remove push token

This endpoint is for removing account device push token. Session is linked to a device.

accessible without permission (can only be used for the own account. Session must match requested account id.)

path Parameters
id
required
string

Account ID of JWT

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "status": "ok"
}

Get roles of an account

This endpoint is for retrieving the roles of a given account

only accessible with permission : "ManageAccounts"

fully accessible with permission : "ManageAccounts"

path Parameters
id
required
string

Account ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Update the roles of an account

This endpoint is for updating the roles of an account. You are only allowed to add and remove roles that have permissions you already own through your roles. If you have "ManageGlobalRoles" you are allowed to add and remove all roles. If a user already own a role, that user can keep this role with this request, even if you do not own the permissions of that role. You are not allowed to add or remove roles that have permissions you don't own but user own them from other role.

only accessible with permission : "ManageAccounts"

fully accessible with permission : "ManageAccounts"

path Parameters
id
required
string

Account ID

header Parameters
Session
required
string

JWT

Request Body schema: application/json

the new account roles

Array
projectId
string or null
roleId
string

Responses

Request samples

Content type
application/json
[
  • {
    }
]

Response samples

Content type
application/json
[
  • {
    }
]

Update account credentials

This endpoint is for updating account credential information without the SCRAM flow. Credentials cannot be changed for an accounts that is linked to a sso provider. If an email address is provided, a password must also be provided. (Because of SCRAM the email address can only be changed by providing a password.) User has to login again after credentials change.

only accessible with permission : "ManageAccounts"

fully accessible with permission : "ManageAccounts"

path Parameters
id
required
string

Account ID

header Parameters
Session
required
string

JWT

Request Body schema: application/json

new credentials

email
string
password
string

Responses

Request samples

Content type
application/json
{
  • "email": "test@api.plazz",
  • "password": "string"
}

Response samples

Content type
application/json
{
  • "status": "ok"
}

Get accounts

This endpoint is for requesting account list of the system. If a limit is set, a cursor for this endpoint may be created to iterate over all accounts. If Platform header is "Cms" Accept-Language header will be ignored.

only accessible with permission : "ManageAccounts"

fully accessible with permission : "ManageAccounts"

query Parameters
cursor
string

id of the cursor used for pagination; required if page is set

limit
integer

amount of results per page (1 ... 100)

page
integer

current page index of the cursor used for pagination; required if cursor is set

header Parameters
Session
required
string

JWT

Accept-Language
string

client language(s)

Platform
string
Enum: "Cms" "Android" "Ios" "Web"

The client platform

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Create account

This endpoint is for creating a new account. An email can be sent to the account owner to inform about the new account. If no password is provided, an email with a set password token will be sent to the account owner. You are only allowed to add roles that have permissions you already own through your roles. If you have "ManageGlobalRoles" you are allowed to add all roles. The Accept-Language header is used to select the language for sending the email. If no language is selected, the email will be sent for the default language of the system.

only accessible with permission : "ManageAccounts"

fully accessible with permission : "ManageAccounts"

header Parameters
Session
required
string

JWT

Accept-Language
string

client language(s)

Request Body schema: application/json

Account to create

object (model.Access)
email
string
firstName
string
image
string or null
keywordIds
Array of strings <optional>

Default: []

lastName
string
Array of objects (model.AccountMetaData)
ownAccess
string or null
Enum: "Read" "Write" "Delete" "Create" "changeProof"

Delete (includes) Write (includes) Read

password
string <optional>

must be empty if sso is set

product
string
Enum: "App" "Cms"
Array of objects (model.AccountRole)

Default: []

salutation
string or null
Enum: "Mr" "Ms"
sendMail
boolean
ssoIdentity
string <optional>

must be empty if password is set; must be set if ssoProviderId is set

ssoProviderId
string <optional>

must be empty if password is set; must be set if ssoIdentity is set

title
string or null

Responses

Request samples

Content type
application/json
{
  • "access": {
    },
  • "email": "test@api.plazz",
  • "firstName": "string",
  • "image": "string",
  • "keywordIds": [
    ],
  • "lastName": "string",
  • "meta": [
    ],
  • "ownAccess": "Read",
  • "password": "string",
  • "product": "App",
  • "roles": [
    ],
  • "salutation": "Mr",
  • "sendMail": true,
  • "ssoIdentity": "string",
  • "ssoProviderId": "string",
  • "title": "string"
}

Response samples

Content type
application/json
{
  • "access": {
    },
  • "accessEditAllowed": true,
  • "color": {
    },
  • "email": "string",
  • "firstName": "string",
  • "id": "string",
  • "image": "string",
  • "keywordIds": [
    ],
  • "lastName": "string",
  • "meta": [
    ],
  • "profileEditAllowed": true,
  • "roles": [
    ],
  • "salutation": "Mr",
  • "ssoIdentity": "string",
  • "ssoProviderId": "string",
  • "title": "string",
  • "visibility": {
    }
}

Delete accounts

This endpoint is for deleting multiple accounts from the system.

only accessible with permission : "ManageAccounts"

fully accessible with permission : "ManageAccounts"

query Parameters
ids
required
string

ids to delete

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "status": "ok"
}

Get accounts statistics

This endpoint is for requesting accounts statistics.

only accessible with permission : "ManageAccounts" "ManageConfiguration" "ManageProjects" "ViewGlobalAnalytics"

fully accessible with permission : "ManageAccounts" "ManageConfiguration" "ManageProjects" "ViewGlobalAnalytics"

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get meta item setup

This endpoint is for retrieving the meta item configuration for accounts. If Platform is "Cms" Accept-Language header will be ignored. If Platform is not "Cms" selections.options.design values are hexcolors only.

accessible without permission

header Parameters
Session
required
string

JWT

Accept-Language
string

client language(s)

Platform
string
Enum: "Cms" "Android" "Ios" "Web"

The client platform

Responses

Response samples

Content type
application/json
{
  • "items": [
    ],
  • "profileDefaultConfig": {
    },
  • "selections": [
    ]
}

Update meta item setup

This endpoint is for updating the meta item configuration for accounts

only accessible with permission : "ManageConfiguration"

fully accessible with permission : "ManageConfiguration"

header Parameters
Session
required
string

JWT

Request Body schema: application/json

new meta configuration

Array of objects (account.MetaItem)
object (model.ProfileDefaultConfig)
Array of objects (account.RequestMetaSelection)

Responses

Request samples

Content type
application/json
{
  • "items": [
    ],
  • "profileDefaultConfig": {
    },
  • "selections": [
    ]
}

Response samples

Content type
application/json
{
  • "items": [
    ],
  • "profileDefaultConfig": {
    },
  • "selections": [
    ]
}

Get account permissions

This endpoint returns all permissions the user own.

property: enums: "AccessPreview" "ManageAccounts" "ManageCheckIns" "ManageConfiguration" "ManageContent" "ManageGlobalMedia" "ManageGlobalRoles" "ManagePosts" "ManageProjects" "ViewAnalytics" "ViewGlobalAnalytics"

accessible without permission (can only be used for the own account. Session must match requested account id.)

path Parameters
id
required
string

Account ID

header Parameters
Session
required
string

JWT

Accept-Language
string

client language(s)

Responses

Response samples

Content type
application/json
{
  • "property1": {
    },
  • "property2": {
    }
}

Get account settings analytics for cursor

This endpoint returns a list of all accounts settings analytics snapshot records for a cursor in administrative representation.

Cursor could be created here: POST /auth/account/analytics/account-settings/search

accessible without permission

query Parameters
cursor
required
string

id of the cursor used for pagination; required if page is set

page
required
integer

current page index of the cursor used for pagination; required if cursor is set

limit
integer

amount of results per page (1 ... 100)

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get account

This endpoint returns the requested account. If Platform header is "Cms" Accept-Language header will be ignored.

accessible without permission (can only be used for the own account. Session must match requested account id.)

fully accessible with permission : "ManageAccounts"

path Parameters
id
required
string

Account ID

header Parameters
Session
required
string

JWT

Accept-Language
string

client language(s)

Platform
string
Enum: "Cms" "Android" "Ios" "Web"

The client platform

Responses

Response samples

Content type
application/json
{
  • "access": {
    },
  • "accessEditAllowed": true,
  • "color": {
    },
  • "email": "string",
  • "firstName": "string",
  • "id": "string",
  • "image": "string",
  • "keywordIds": [
    ],
  • "lastName": "string",
  • "meta": [
    ],
  • "profileEditAllowed": true,
  • "roles": [
    ],
  • "salutation": "Mr",
  • "ssoIdentity": "string",
  • "ssoProviderId": "string",
  • "title": "string",
  • "visibility": {
    }
}

Delete account

This endpoint is for deleting a single account.

For deletion of own account via frontend see: POST /auth/account/delete-own

only accessible with permission : "ManageAccounts"

fully accessible with permission : "ManageAccounts"

path Parameters
id
required
string

Account ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "status": "ok"
}

Create account settings analytics cursor

This endpoint returns a cursor for list account settings snapshot records with applied filter and sort options. In case of cursor response total will be 0 the status 204 with not content is returned instead.

only accessible with permission : "ManageAccounts" "ManageConfiguration" "ManageContent" "ManageProjects" "ViewAnalytics" "ViewGlobalAnalytics"

fully accessible with permission : "ManageAccounts" "ManageConfiguration" "ManageContent" "ManageProjects" "ViewAnalytics" "ViewGlobalAnalytics"

header Parameters
Session
required
string

JWT

Request Body schema: application/json

options to create cursor

object (analytics.CursorFilterOption)
Array of objects

only one property per entry allowed; property enums: "snapshotDate" "snapshotTimestamp"; value enums: "ASC" "DESC"

Responses

Request samples

Content type
application/json
{
  • "filter": {
    },
  • "sort": [
    ]
}

Response samples

Content type
application/json
{
  • "cursor": "string",
  • "endpoints": [
    ],
  • "expiredAt": 0,
  • "total": 0
}

Logout device

This endpoint is for account device logout.

accessible without permission (can only be used for the own account. Session must match requested account id.)

path Parameters
id
required
string

Account ID

deviceId
required
string

Device ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "status": "ok"
}

account colors

This endpoint is for requesting available account profile colors.

accessible without permission

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Account entered project first time

This endpoint is for announcing that an account has entered a project for the first time. It will enable the notification settings for the entered project.

accessible without permission (can only be used for the own account. Session must match requested account id.)

path Parameters
id
required
string

Account ID of JWT

projectId
required
string

Project ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "status": "ok"
}

Delete own

This endpoint is for deleting an account with the correct password. This endpoint uses the final message of the SCRAM challenge to validate the password. The Platform must match the Platform from the first message. See RFC 5802 for detail SCRAM definition.

To perform this action call SCRAM First first: POST /auth/auth

accessible without permission

header Parameters
Platform
string
Enum: "Cms" "Android" "Ios" "Web"

The client platform

Request Body schema: application/json

Clients Final Message

email
string
nonce
string
proof
string

Responses

Request samples

Content type
application/json
{
  • "email": "test@api.plazz",
  • "nonce": "hvYDpWUa2RaTCAfuxFIlj)hNlF$k0",
  • "proof": "dHzbZapWIk4jUhN+Ute9ytag9zjfMHgsqmmiz7AndVQ="
}

Response samples

Content type
application/json
{
  • "signature": "6rriTRBi23WpRR/wtup+mMhUZUn/dB5nLTJRsjl95G4="
}

Get accounts statistic records

This endpoint is for requesting accounts statistic records.

only accessible with permission : "ManageAccounts" "ManageConfiguration" "ManageProjects" "ViewGlobalAnalytics"

fully accessible with permission : "ManageAccounts" "ManageConfiguration" "ManageProjects" "ViewGlobalAnalytics"

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "property1": {
    },
  • "property2": {
    }
}

Get project account ids

This endpoint is for requesting account ids of a project

only accessible with permission : "ManageAccounts" "ManageConfiguration" "ManageContent" "ManageProjects" "ViewAnalytics" "ViewGlobalAnalytics"

fully accessible with permission : "ManageAccounts" "ManageConfiguration" "ManageContent" "ManageProjects" "ViewAnalytics" "ViewGlobalAnalytics"

path Parameters
projectId
required
string

Project ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
[
  • "string"
]

Get account access configuration

This endpoint returns the access configuration for the requested account.

only accessible with permission : "ManageAccounts"

fully accessible with permission : "ManageAccounts"

path Parameters
id
required
string

Account ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "access": {
    },
  • "accessEditAllowed": true
}

Update account access configuration

This endpoint updates the access configuration for the requested account. Only the changes should be transmitted due this endpoint.

only accessible with permission : "ManageAccounts"

fully accessible with permission : "ManageAccounts"

path Parameters
id
required
string

Account ID

header Parameters
Session
required
string

JWT

Request Body schema: application/json

changed access rights

object

accountId to operation; null for operation removes access

any
string or null
Enum: "Read" "Write" "Delete" "Create" "changeProof"

Delete (includes) Write (includes) Read; null for operation removes access

object

groupId to operation; null for operation removes access

user
string or null
Enum: "Read" "Write" "Delete" "Create" "changeProof"

Delete (includes) Write (includes) Read; null for operation removes access

Responses

Request samples

Content type
application/json
{
  • "accounts": {
    },
  • "any": "Read",
  • "groups": {
    },
  • "user": "Read"
}

Response samples

Content type
application/json
{
  • "accounts": {
    },
  • "any": "Read",
  • "groups": {
    },
  • "user": "Read"
}

Get project accounts statistics

This endpoint is for requesting accounts statistics of a project Only accounts that have access and entered the project once are considered.

only accessible with permission : "ManageAccounts" "ManageConfiguration" "ManageContent" "ManageProjects" "ViewAnalytics" "ViewGlobalAnalytics"

fully accessible with permission : "ManageAccounts" "ManageConfiguration" "ManageContent" "ManageProjects" "ViewAnalytics" "ViewGlobalAnalytics"

path Parameters
projectId
required
string

Project ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Change email final

This endpoint should be requested for redeeming the token to finish the email address change. For this action a one time token is needed. The email cannot be changed for an accounts that is linked to a sso provider. After a successful change of the email address all session and refresh tokens will be invalidated and a notification is sent to the old email address of the account. The Accept-Language header is used to select the language for sending the email. If no language is selected, the email will be sent for the default language of the system. On success this endpoint provides a new refresh token and new session in the 200 response. In case of response status is 205 login has to be performed again.

accessible without permission

header Parameters
Accept-Language
string

client language(s)

Platform
string
Enum: "Cms" "Android" "Ios" "Web"

The client platform

Request Body schema: application/json

email change token

browser
string or null <optional>

Default: null

deviceName
string or null <optional>

Default: null

os
string
Enum: "Android" "IOS" "Windows" "Linux" "Mac" "Other"
osVersion
string
token
string

Responses

Request samples

Content type
application/json
{
  • "browser": "string",
  • "deviceName": "string",
  • "os": "Android",
  • "osVersion": "string",
  • "token": "hvYDpWUa2RaTCAfuxFIlj)hNlF$k0"
}

Response samples

Content type
application/json
{
  • "deviceId": "string",
  • "refreshToken": "XX4EWw5Hz6zb10FlyMazboBGmlvYX7Y878j6zSjQjJmsbTDVUvfPd7eOm1YqRPQb",
  • "sendbirdSessionToken": "string"
}

Change email first

This endpoint should be requested first for changing the current email address for an account. The email cannot be changed for an accounts that is linked to a sso provider. A link with a confirmation token is sent to the new email address. This token must be redeemed to save the change. The Platform header is for creating the correct token link send to the requested new email address. The token should be redeemed on PUT /auth/email This function is safe against enumeration attacks, so it is not possible to get information about already used emails in the system. If there already is an account for the requested mail, the address cannot be changed for the current account The Accept-Language header is used to select the language for sending the email. If no language is selected, the email will be sent for the default language of the system.

accessible without permission

header Parameters
Session
required
string

JWT

Accept-Language
string

client language(s)

Platform
string
Enum: "Cms" "Android" "Ios" "Web"

The client platform

Request Body schema: application/json

requested mail change

newEmail
string
password
string

Responses

Request samples

Content type
application/json
{
  • "newEmail": "test@api.plazz",
  • "password": "string"
}

Response samples

Content type
application/json
{
  • "status": "ok"
}

Get project accounts statistic records

This endpoint is for requesting accounts statistic records of a project. Only accounts that have access and entered the project once are considered.

only accessible with permission : "ManageAccounts" "ManageConfiguration" "ManageContent" "ManageProjects" "ViewAnalytics" "ViewGlobalAnalytics"

fully accessible with permission : "ManageAccounts" "ManageConfiguration" "ManageContent" "ManageProjects" "ViewAnalytics" "ViewGlobalAnalytics"

path Parameters
projectId
required
string

Project ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "property1": {
    },
  • "property2": {
    }
}

Get group list for account for project

This endpoint returns a list of all groups for the requested account and project. If a limit is set, a cursor for this endpoint may be created to iterate over all groups.

only accessible with permission : "ManageAccounts"

fully accessible with permission : "ManageAccounts"

path Parameters
id
required
string

Account ID

projectId
required
string

Project ID

query Parameters
cursor
string

id of the cursor used for pagination; required if page is set

limit
integer

amount of results per page (1 ... 100)

page
integer

current page index of the cursor used for pagination; required if cursor is set

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Update account groups membership for project

This endpoint is for updating the group membership of an account for a specific project. In case of response status is 205 the request was only executed partial. Use GET to receive the stored configuration.

only accessible with permission : "ManageAccounts"

fully accessible with permission : "ManageAccounts"

path Parameters
id
required
string

Account ID

projectId
required
string

Project ID

header Parameters
Session
required
string

JWT

Request Body schema: application/json

group ids

Array
string

Responses

Request samples

Content type
application/json
[
  • "string"
]

Response samples

Content type
application/json
[
  • "string"
]

Search accounts

This endpoint is for requesting account list with a search If Platform header is "Cms" Accept-Language header will be ignored.

only accessible with permission : "ManageAccounts"

fully accessible with permission : "ManageAccounts"

header Parameters
Session
required
string

JWT

Accept-Language
string

client language(s)

Platform
string
Enum: "Cms" "Android" "Ios" "Web"

The client platform

Request Body schema: application/json

search

email
string <optional>

Deprecated: use Emails

emails
Array of strings <optional>
ids
Array of strings <optional>

Responses

Request samples

Content type
application/json
{
  • "email": "test@api.plazz",
  • "emails": [
    ],
  • "ids": [
    ]
}

Response samples

Content type
application/json
[
  • {
    }
]

Get account profile

This endpoint is for requesting account profile information. If Platform header is "Cms" Accept-Language header will be ignored.

accessible without permission

fully accessible with permission : "ManageAccounts"

path Parameters
id
required
string

Account ID

header Parameters
Session
required
string

JWT

Accept-Language
string

client language(s)

Platform
string
Enum: "Cms" "Android" "Ios" "Web"

The client platform

Responses

Response samples

Content type
application/json
{
  • "accessEditAllowed": true,
  • "color": {
    },
  • "email": "string",
  • "firstName": "string",
  • "id": "string",
  • "image": "string",
  • "keywordIds": [
    ],
  • "lastName": "string",
  • "meta": [
    ],
  • "profileEditAllowed": true,
  • "salutation": "Mr",
  • "title": "string",
  • "visibility": {
    }
}

Update account profile

This endpoint is for updating account profile information. Read only items can only be patched with cms session. If Platform header is "Cms" Accept-Language header will be ignored.

Note: meta.translations may not hold data. Translation takes places async. Call GET /auth/account/{id}/profile to check for translation again later.

accessible without permission

fully accessible with permission : "ManageAccounts"

path Parameters
id
required
string

Account ID

header Parameters
Session
required
string

JWT

Accept-Language
string

client language(s)

Platform
string
Enum: "Cms" "Android" "Ios" "Web"

The client platform

Request Body schema: application/json

account profile

object (model.AccountProfileColor)
firstName
string
image
string or null

media id

keywordIds
Array of strings
lastName
string
Array of objects (model.AccountMetaData)

only updated entries have to be transmitted -> to empty a field transmit an empty value!

salutation
string or null
Enum: "Mr" "Ms"
title
string or null

Responses

Request samples

Content type
application/json
{
  • "color": {
    },
  • "firstName": "string",
  • "image": "string",
  • "keywordIds": [
    ],
  • "lastName": "string",
  • "meta": [
    ],
  • "salutation": "Mr",
  • "title": "string"
}

Response samples

Content type
application/json
{
  • "accessEditAllowed": true,
  • "color": {
    },
  • "email": "string",
  • "firstName": "string",
  • "id": "string",
  • "image": "string",
  • "keywordIds": [
    ],
  • "lastName": "string",
  • "meta": [
    ],
  • "profileEditAllowed": true,
  • "salutation": "Mr",
  • "title": "string",
  • "visibility": {
    }
}

Get account devices

This endpoint is for requesting account devices. The Platform header is for filtering devices for the correct product (App|Cms).

accessible without permission (can only be used for the own account. Session must match requested account id.)

path Parameters
id
required
string

Account ID

header Parameters
Session
required
string

JWT

Platform
string
Enum: "Cms" "Android" "Ios" "Web"

The client platform

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get account tracking settings

This endpoint is for requesting account tracking settings.

accessible without permission (can only be used for the own account. Session must match requested account id.)

fully accessible with permission : "ManageAccounts"

path Parameters
id
required
string

Account ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "tracking": "Disabled"
}

Update account tracking settings

This endpoint is for updating account tracking settings.

accessible without permission (can only be used for the own account. Session must match requested account id.)

fully accessible with permission : "ManageAccounts"

path Parameters
id
required
string

Account ID

header Parameters
Session
required
string

JWT

Request Body schema: application/json

account tracking settings

tracking
string
Enum: "Disabled" "Anonym" "Personalized"

Responses

Request samples

Content type
application/json
{
  • "tracking": "Disabled"
}

Response samples

Content type
application/json
{
  • "tracking": "Disabled"
}

Get account project settings

This endpoint is for requesting account project settings for the requested project.

accessible without permission (can only be used for the own account. Session must match requested account id.)

fully accessible with permission : "ManageAccounts"

path Parameters
id
required
string

Account ID

projectId
required
string

Project ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "notification": "Disabled",
  • "projectEnteredAt": 0
}

Update account project settings

This endpoint updates the account project settings for the requested project.

accessible without permission (can only be used for the own account. Session must match requested account id.)

fully accessible with permission : "ManageAccounts"

path Parameters
id
required
string

Account ID

projectId
required
string

Project ID

header Parameters
Session
required
string

JWT

Request Body schema: application/json

account project settings

notification
string
Enum: "Enabled" "Mute"

Responses

Request samples

Content type
application/json
{
  • "notification": "Enabled"
}

Response samples

Content type
application/json
[
  • {
    }
]

Get account settings

This endpoint is for requesting account settings.

accessible without permission (can only be used for the own account. Session must match requested account id.)

fully accessible with permission : "ManageAccounts"

path Parameters
id
required
string

Account ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "notifications": {
    },
  • "projectSettings": {
    },
  • "tracking": "Disabled",
  • "visibility": {
    }
}

Get account notification settings

This endpoint is for requesting account notification settings.

accessible without permission (can only be used for the own account. Session must match requested account id.)

fully accessible with permission : "ManageAccounts"

path Parameters
id
required
string

Account ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "bundleEmails": true,
  • "notifyConfiguration": {
    }
}

Update account notification settings

This endpoint updates the account notification settings. In case of response status is 205 the request was only executed partial. Use GET to receive the stored configuration.

accessible without permission (can only be used for the own account. Session must match requested account id.)

fully accessible with permission : "ManageAccounts"

path Parameters
id
required
string

Account ID

header Parameters
Session
required
string

JWT

Request Body schema: application/json

account notification settings

bundleEmails
boolean

may be replaced with enum value (No,Day,Week)

object

property enums: "Appointment" "Chat" "Custom" "Journey" "Mention" "News" "System"

Responses

Request samples

Content type
application/json
{
  • "bundleEmails": true,
  • "notifyConfiguration": {
    }
}

Response samples

Content type
application/json
[
  • {
    }
]

Get account visibility settings

This endpoint is for requesting account visibility settings.

accessible without permission (can only be used for the own account. Session must match requested account id.)

fully accessible with permission : "ManageAccounts"

path Parameters
id
required
string

Account ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "appointmentVisible": true,
  • "chatVisible": true,
  • "emailVisible": true,
  • "imageVisible": true,
  • "salutationVisible": true,
  • "titleVisible": true,
  • "visibleForOthers": true
}

Update account visibility settings

This endpoint is for updating account visibility settings. In order to enable the chat, the account should have first or last name set. After enabling the chat the refresh session endpoint must be called to get also a sendbird session token.

Note: In exceptional cases the user has to login again.

accessible without permission (can only be used for the own account. Session must match requested account id.)

fully accessible with permission : "ManageAccounts"

path Parameters
id
required
string

Account ID

header Parameters
Session
required
string

JWT

Request Body schema: application/json

account visibility settings

appointmentVisible
boolean
chatVisible
boolean

handles reactions allowed

emailVisible
boolean
imageVisible
boolean
salutationVisible
boolean
titleVisible
boolean
visibleForOthers
boolean

Responses

Request samples

Content type
application/json
{
  • "appointmentVisible": true,
  • "chatVisible": true,
  • "emailVisible": true,
  • "imageVisible": true,
  • "salutationVisible": true,
  • "titleVisible": true,
  • "visibleForOthers": true
}

Response samples

Content type
application/json
{
  • "appointmentVisible": true,
  • "chatVisible": true,
  • "emailVisible": true,
  • "imageVisible": true,
  • "salutationVisible": true,
  • "titleVisible": true,
  • "visibleForOthers": true
}

Recover Password

This endpoint is for recovering password for given email. It always returns 200 if the request body is correct. If there is an existing account for the given email address, an email will be sent to this address with a token link. The Platform header is used for setting the interface the recovering link should lead. The Accept-Language header is used to select the language for sending the email. If no language is selected, the email will be sent for the default language of the system.

accessible without permission

header Parameters
Accept-Language
string

client language(s)

Platform
string
Enum: "Cms" "Android" "Ios" "Web"

The client platform

Request Body schema: application/json

password recover

email
string

Responses

Request samples

Content type
application/json
{
  • "email": "test@api.plazz"
}

Response samples

Content type
application/json
{
  • "status": "ok"
}

Request password change

This endpoint is for requesting a one time token to change the password of an account. The password cannot be changed for an accounts that is linked to a sso provider. This endpoint uses the final message of the SCRAM challenge to validate the old password. The Platform must match the Platform from the first message. See RFC 5802 for detail SCRAM definition.

To perform this action call SCRAM First first: POST /auth/auth

accessible without permission

header Parameters
Platform
string
Enum: "Cms" "Android" "Ios" "Web"

The client platform

Request Body schema: application/json

Clients Final Message

email
string
nonce
string
proof
string

Responses

Request samples

Content type
application/json
{
  • "email": "test@api.plazz",
  • "nonce": "hvYDpWUa2RaTCAfuxFIlj)hNlF$k0",
  • "proof": "dHzbZapWIk4jUhN+Ute9ytag9zjfMHgsqmmiz7AndVQ="
}

Response samples

Content type
application/json
{
  • "signature": "6rriTRBi23WpRR/wtup+mMhUZUn/dB5nLTJRsjl95G4=",
  • "token": "XX4EWw5Hz6zb10FlyMazboBGmlvYX7Y878j6zSjQjJmsbTDVUvfPd7eOm1YqRPQb"
}

Change Password

This endpoint is for replacing old password with new one. For this action a one time token is needed. The token can be created with a new account registration, a password recover action or changing password request. The new password must be supplied in plain text to check if it matches the password security guidelines. If the new password does not match the guidelines the reason can be found in the 400 response message. After a successful change of the password every session and refresh token for this user will be invalidated. On success this endpoint provides a new refresh token and new session in the 200 response. In case of response status is 205 login has to be performed again.

Error messages:

  • Error.Token.Invalid
  • Error.Password.NoLower
  • Error.Password.TooShort
  • Error.Password.NoNumber
  • Error.Password.NotDictionarySafe
  • Error.Password.NoSpecial
  • Error.Password.NoUpper
  • Error.Password.UsedBefore

accessible without permission

header Parameters
Platform
string
Enum: "Cms" "Android" "Ios" "Web"

The client platform

Request Body schema: application/json

password change

browser
string or null <optional>

Default: null

deviceName
string or null <optional>

Default: null

newPassword
string
os
string
Enum: "Android" "IOS" "Windows" "Linux" "Mac" "Other"
osVersion
string
token
string

Responses

Request samples

Content type
application/json
{
  • "browser": "string",
  • "deviceName": "string",
  • "newPassword": "string",
  • "os": "Android",
  • "osVersion": "string",
  • "token": "hvYDpWUa2RaTCAfuxFIlj)hNlF$k0"
}

Response samples

Content type
application/json
{
  • "deviceId": "string",
  • "refreshToken": "XX4EWw5Hz6zb10FlyMazboBGmlvYX7Y878j6zSjQjJmsbTDVUvfPd7eOm1YqRPQb",
  • "sendbirdSessionToken": "string"
}

Registration

This endpoint is used for registration of an account with a valid email address. An email with registration token will be sent to the given address. If there already is an account for that email address, a password forgotten link will be sent to the user instead. The received one time token can be redeemed for setting password: PUT /auth/password If registration is disabled in the security configuration this endpoint is also disabled. The Accept-Language header is used to select the language for sending the email. If no language is selected, the email will be sent for the default language of the system.

accessible without permission

header Parameters
Accept-Language
string

client language(s)

Request Body schema: application/json

email address

email
string

Responses

Request samples

Content type
application/json
{
  • "email": "test@api.plazz"
}

Response samples

Content type
application/json
{
  • "status": "ok"
}

Admin Area

Get page list preview for project

This endpoint returns a list of all pages for the requested project without content in default representation. If a limit is set, a cursor for this endpoint may be created to iterate over all pages.

If the requested language is not available it will fall back to the default language.

only accessible with permission : "AccessPreview" "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Project ID

query Parameters
cursor
string

id of the cursor used for pagination; required if page is set

limit
integer

amount of results per page (1 ... 100)

page
integer

current page index of the cursor used for pagination; required if cursor is set

header Parameters
Session
required
string

JWT

Accept-Language
string

client language(s)

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get page preview mobile

This endpoint returns a localized page in default user representation by given id.

For published view use: GET /page/default/{id}

If the requested language is not available it will fall back to the default language.

only accessible with permission : "AccessPreview" "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Page ID

header Parameters
Session
required
string

JWT

Accept-Language
string

client language(s)

Responses

Response samples

Content type
application/json
{
  • "channelId": "string",
  • "content": [
    ],
  • "createdAt": 0,
  • "creator": "string",
  • "hasDesktop": true,
  • "id": "string",
  • "keywordIds": [
    ],
  • "lastModified": 0,
  • "pagePlatform": "Mobile",
  • "projectId": "string",
  • "publishedAt": 0,
  • "settings": {
    },
  • "status": "Draft",
  • "title": "string",
  • "translations": [
    ]
}

Get article preview mobile

This endpoint returns a localized article in default user representation by given id.

For published view use: GET /news/default/{id}

only accessible with permission : "AccessPreview" "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Article ID

header Parameters
Session
required
string

JWT

Accept-Language
string

client language(s)

Responses

Response samples

Content type
application/json
{
  • "author": "string",
  • "channelId": "string",
  • "content": [
    ],
  • "contentRepresentation": "Mobile",
  • "createdAt": 0,
  • "hasDesktop": true,
  • "headerImage": "string",
  • "id": "string",
  • "keywordIds": [
    ],
  • "lastModified": 0,
  • "linkedProjectIds": [
    ],
  • "projectId": "string",
  • "publishedAt": 0,
  • "settings": {
    },
  • "status": "Draft",
  • "teaserText": "string",
  • "timeZone": "Europe/Berlin",
  • "title": "string",
  • "translations": [
    ]
}

Get page preview desktop

This endpoint returns a localized page preview for desktop in default user representation by given id.

For published view use: GET /page/default/{id}/desktop

If there is no specific desktop version of the page the standard (mobile) version of the page will be selected. If the requested language is not available it will fall back to the default language.

only accessible with permission : "AccessPreview" "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Page ID

header Parameters
Session
required
string

JWT

Accept-Language
string

client language(s)

Responses

Response samples

Content type
application/json
{
  • "channelId": "string",
  • "content": [
    ],
  • "createdAt": 0,
  • "creator": "string",
  • "hasDesktop": true,
  • "id": "string",
  • "keywordIds": [
    ],
  • "lastModified": 0,
  • "pagePlatform": "Mobile",
  • "projectId": "string",
  • "publishedAt": 0,
  • "settings": {
    },
  • "status": "Draft",
  • "title": "string",
  • "translations": [
    ]
}

Get article list preview for project

This endpoint returns a list of all articles for the requested project without content in default representation. The entries are sorted by publishedAt:DESC. If a limit is set, a cursor for this endpoint may be created to iterate over all articles.

For published view list use: GET /news/default/project/{id}

only accessible with permission : "AccessPreview" (counts also for linked projects) "ManageContent" (counts also for linked projects) "ManageProjects"

fully accessible with permission : "ManageContent" (counts also for linked projects) "ManageProjects"

path Parameters
id
required
string

Project ID

query Parameters
cursor
string

id of the cursor used for pagination; required if page is set

limit
integer

amount of results per page (1 ... 100)

page
integer

current page index of the cursor used for pagination; required if cursor is set

header Parameters
Session
required
string

JWT

Accept-Language
string

client language(s)

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Create cursor

This endpoint returns a cursor for preview list articles in default representation with applied filter and sort options. In case of cursor response total will be 0 the status 204 with not content is returned instead.

For published list cursor use: GET /news/default/search

only accessible with permission : "AccessPreview" (counts also for linked projects) "ManageContent" (counts also for linked projects) "ManageProjects"

fully accessible with permission : "ManageContent" (counts also for linked projects) "ManageProjects"

header Parameters
Accept-Language
string

client language(s)

Session
string

JWT

Request Body schema: application/json

options to create cursor

object (news.CursorFilterOptionPreviewDefault)
Array of objects

only one property per entry allowed; property enums: "author" "createdAt" "id" "lastModified" "publishedAt"; value enums: "ASC" "DESC"

Responses

Request samples

Content type
application/json
{
  • "filter": {
    },
  • "sort": [
    ]
}

Response samples

Content type
application/json
{
  • "cursor": "string",
  • "endpoints": [
    ],
  • "expiredAt": 0,
  • "total": 0
}

Get article preview ids for project

This endpoint returns a list of all articles for the requested project without content in default representation. The entries are sorted by publishedAt:DESC.

For published list ids use: GET /news/default/project/{id}/ids

only accessible with permission : "AccessPreview" (counts also for linked projects) "ManageContent" (counts also for linked projects) "ManageProjects"

fully accessible with permission : "ManageContent" (counts also for linked projects) "ManageProjects"

path Parameters
id
required
string

Project ID

header Parameters
Session
required
string

JWT

Accept-Language
string

client language(s)

Responses

Response samples

Content type
application/json
[
  • "string"
]

Get article preview desktop

This endpoint returns a localized article preview for desktop in default user representation by given id.

For published view use: GET /news/default/{id}/desktop

If there is no specific desktop version of the article the standard (mobile) version of the article will be selected.

only accessible with permission : "AccessPreview" "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Article ID

header Parameters
Session
required
string

JWT

Accept-Language
string

client language(s)

Responses

Response samples

Content type
application/json
{
  • "author": "string",
  • "channelId": "string",
  • "content": [
    ],
  • "contentRepresentation": "Mobile",
  • "createdAt": 0,
  • "hasDesktop": true,
  • "headerImage": "string",
  • "id": "string",
  • "keywordIds": [
    ],
  • "lastModified": 0,
  • "linkedProjectIds": [
    ],
  • "projectId": "string",
  • "publishedAt": 0,
  • "settings": {
    },
  • "status": "Draft",
  • "teaserText": "string",
  • "timeZone": "Europe/Berlin",
  • "title": "string",
  • "translations": [
    ]
}

Appointment (Admin)

Get appointment config

This endpoint is for retrieving one appointment configuration.

Note: Appointments is a premium feature and requires a valid subscription.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Appointment config ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "id": "string",
  • "locationIds": [
    ],
  • "projectId": "string",
  • "receiverGroupIds": [
    ],
  • "requestGroupIds": [
    ],
  • "timeConfig": {
    },
  • "title": "string"
}

Delete appointment config

This endpoint is for deleting an appointment configuration.

Note: Appointments is a premium feature and requires a valid subscription.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Appointment config ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "status": "ok"
}

Update appointment config

This endpoint is for updating an existing appointment configuration.

Note: Appointments is a premium feature and requires a valid subscription.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Appointment config ID

header Parameters
Session
required
string

JWT

Request Body schema: application/json

appointment config to create

locationIds
Array of strings or null

null for all locations, empty array for no location

receiverGroupIds
Array of strings or null

null for all groups, empty array for no group

requestGroupIds
Array of strings or null

null for all groups, empty array for no group

object (model.AppointmentSlotTimeConfig)
title
string

Responses

Request samples

Content type
application/json
{
  • "locationIds": [
    ],
  • "receiverGroupIds": [
    ],
  • "requestGroupIds": [
    ],
  • "timeConfig": {
    },
  • "title": "string"
}

Response samples

Content type
application/json
{
  • "id": "string",
  • "locationIds": [
    ],
  • "projectId": "string",
  • "receiverGroupIds": [
    ],
  • "requestGroupIds": [
    ],
  • "timeConfig": {
    },
  • "title": "string"
}

Get appointment config list for project

This endpoint is for retrieving all appointment configurations for the requested project. If a limit is set, a cursor for this endpoint may be created to iterate over all calendars.

Note: Appointments is a premium feature and requires a valid subscription.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

project ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Create appointment config

This endpoint is for creating a new appointment configuration.

Note: Appointments is a premium feature and requires a valid subscription.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

header Parameters
Session
required
string

JWT

Request Body schema: application/json

appointment config to create

locationIds
Array of strings or null

null for all locations, empty array for no location

projectId
string
receiverGroupIds
Array of strings or null

null for all groups, empty array for no group

requestGroupIds
Array of strings or null

null for all groups, empty array for no group

object (model.AppointmentSlotTimeConfig)
title
string

Responses

Request samples

Content type
application/json
{
  • "locationIds": [
    ],
  • "projectId": "string",
  • "receiverGroupIds": [
    ],
  • "requestGroupIds": [
    ],
  • "timeConfig": {
    },
  • "title": "string"
}

Response samples

Content type
application/json
{
  • "id": "string",
  • "locationIds": [
    ],
  • "projectId": "string",
  • "receiverGroupIds": [
    ],
  • "requestGroupIds": [
    ],
  • "timeConfig": {
    },
  • "title": "string"
}

Appointment (Default)

Get all appointment slot options

This endpoint is for retrieving all appointment slot options.

accessible without permission

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "allAccountIds": [
    ],
  • "allDurations": [
    ],
  • "allLocationIds": [
    ],
  • "allProjectIds": [
    ],
  • "allStartTimes": [
    ]
}

Create cursor

This endpoint returns a cursor for list appointments in default representation with applied filter and sort options. In case of cursor response total will be 0 the status 204 with not content is returned instead.

accessible without permission

header Parameters
Session
required
string

JWT

Request Body schema: application/json

options to create cursor

object (appointment.CursorFilterOptionDefault)
Array of objects

only one property per entry allowed; property enums: "expiresAt" "id" "projectId" "requester" "requesterName"; value enums: "ASC" "DESC"

Responses

Request samples

Content type
application/json
{
  • "filter": {
    },
  • "sort": [
    ]
}

Response samples

Content type
application/json
{
  • "cursor": "string",
  • "endpoints": [
    ],
  • "expiredAt": 0,
  • "total": 0
}

Get possible appointment slot options

This endpoint is for retrieving all possible appointment slot options for requested search. It only applies restrictions but ignores occupied and blocked meeting options as long as it's allowed to create such "conflicts". All values that were returned could be selected to create an appointment.

accessible without permission

header Parameters
Session
required
string

JWT

Request Body schema: application/json

appointment slot search query

object (appointment.SlotFilter)

Responses

Request samples

Content type
application/json
{
  • "filter": {
    }
}

Response samples

Content type
application/json
{
  • "possibleAccountIds": [
    ],
  • "possibleDurationSlots": [
    ],
  • "possibleDurations": [
    ],
  • "possibleLocationIds": [
    ],
  • "possibleProjectIds": [
    ],
  • "possibleSlots": [
    ],
  • "possibleStartTimes": [
    ]
}

Get appointment list for cursor

This endpoint is for retrieving all appointments for the requested cursor in default representation.

Cursor could be created here: POST /calendar/default/appointment/search

accessible without permission

query Parameters
cursor
required
string

id of the cursor used for pagination; required if page is set

page
required
integer

current page index of the cursor used for pagination; required if cursor is set

limit
integer

amount of results per page (1 ... 100)

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Create appointment

This endpoint is for creating a new appointment.

Note: Appointments is a premium feature and requires a valid subscription.

accessible without permission

header Parameters
Session
required
string

JWT

Request Body schema: application/json

appointment to create

description
string
duration
integer >= 1

minutes

locationId
string or null
locationNote
string
projectId
string
receiverAccountIds
Array of strings
start
integer
title
string

Responses

Request samples

Content type
application/json
{
  • "description": "string",
  • "duration": 1,
  • "locationId": "string",
  • "locationNote": "string",
  • "projectId": "string",
  • "receiverAccountIds": [
    ],
  • "start": 0,
  • "title": "string"
}

Response samples

Content type
application/json
{
  • "calendarEntryId": "string",
  • "calendarId": "string",
  • "description": "string",
  • "expiresAt": 0,
  • "id": "string",
  • "locationNote": "string",
  • "projectId": "string",
  • "receiver": {
    },
  • "requester": "string",
  • "requesterImage": "string",
  • "requesterName": "string",
  • "title": "string"
}

Get appointment

This endpoint is for retrieving one appointment for requested id.

accessible without permission

path Parameters
id
required
string

Appointment config ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "calendarEntryId": "string",
  • "calendarId": "string",
  • "description": "string",
  • "expiresAt": 0,
  • "id": "string",
  • "locationNote": "string",
  • "projectId": "string",
  • "receiver": {
    },
  • "requester": "string",
  • "requesterImage": "string",
  • "requesterName": "string",
  • "title": "string"
}

Auth

SCRAM First

This endpoint provides the first message of a salted challenge response authentication mechanism (SCRAM). This challenge is used to validate the users password. It is used to perform login or change password with old password. The Platform header is for creating session use range. See RFC 5802 for detail SCRAM definition.

accessible without permission

header Parameters
Platform
string
Enum: "Cms" "Android" "Ios" "Web"

The client platform

Request Body schema: application/json

Clients First Message

email
string
nonce
string

Responses

Request samples

Content type
application/json
{
  • "email": "test@api.plazz",
  • "nonce": "rOprNGfwEbeRWgbNEkqO"
}

Response samples

Content type
application/json
{
  • "expires": 1574864625,
  • "iterationCount": 4096,
  • "nonce": "hvYDpWUa2RaTCAfuxFIlj)hNlF$k0",
  • "salt": "W22ZaJ0SNY7soEsUEjb6gQ=="
}

Calendar (Admin)

Get calendar detail view items

This endpoint is for retrieving calendar items.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Calendar ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Create booking

This endpoint is for creating calendar entry's booking in admin representation. Calendars of type "Appointment" are readonly.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects" (not for "Appointment" calendars)

path Parameters
id
required
string

Entry ID

header Parameters
Session
required
string

JWT

Request Body schema: application/json

booking to create

accountId
string
ticketCode
string
ticketParty
string

Responses

Request samples

Content type
application/json
{
  • "accountId": "string",
  • "ticketCode": "string",
  • "ticketParty": "string"
}

Response samples

Content type
application/json
{
  • "accountId": "string",
  • "ticketCode": "string",
  • "ticketParty": "string"
}

Delete booking

This endpoint is for deleting a booking. Calendars of type "Appointment" are readonly.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects" (not for "Appointment" calendars)

path Parameters
id
required
string

Entry ID

accountId
required
string

Account ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "status": "ok"
}

Get calendar template list

This endpoint retrieving templates to enhance the creation of new calendars. If a limit is set, a cursor for this endpoint may be created to iterate over all templates.

query Parameters
cursor
string

id of the cursor used for pagination; required if page is set

limit
integer

amount of results per page (1 ... 100)

page
integer

current page index of the cursor used for pagination; required if cursor is set

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get calendar detail view selections

This endpoint is for retrieving calendar selections.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Calendar ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Create calendar

This endpoint is for creating a new calendar for chosen template.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

header Parameters
Session
required
string

JWT

Request Body schema: application/json

calendar to create

object <optional>

Default: {"any": "Read", "user": "Read", "accounts": {}, "groups": {}}

description
string
projectId
string
templateId
string or null
title
string

Responses

Request samples

Content type
application/json
{
  • "access": {
    },
  • "description": "string",
  • "projectId": "string",
  • "templateId": "string",
  • "title": "string"
}

Response samples

Content type
application/json
{
  • "access": {
    },
  • "accessEditAllowed": true,
  • "createAccesses": {
    },
  • "description": "string",
  • "detail": {
    },
  • "entriesCount": 0,
  • "id": "string",
  • "items": [
    ],
  • "listSettings": {
    },
  • "period": {
    },
  • "projectId": "string",
  • "selections": [
    ],
  • "title": "string",
  • "type": "Appointment"
}

Get calendar list settings

This endpoint is for retrieving the list settings of a specific calendar

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Calendar ID

header Parameters
Session
string

JWT

Responses

Response samples

Content type
application/json
{
  • "fieldPrimary": "string",
  • "fieldSecondary": "string",
  • "shareEntries": true
}

Update calendar list settings

This endpoint is for updating the list settings of an existing calendar. Calendars of type "Appointment" are readonly.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects" (not for "Appointment" calendars)

path Parameters
id
required
string

Calendar ID

header Parameters
Session
required
string

JWT

Request Body schema: application/json

list settings to be updated

fieldPrimary
string or null

itemId // item must be ModuleDirectoryContentRows, ModuleLocations, TextPlainLine or TextBlock

fieldSecondary
string or null

itemId // item must be ModuleDirectoryContentRows, ModuleLocations, TextPlainLine or null if fieldPrimary is TextBlock

shareEntries
boolean

Responses

Request samples

Content type
application/json
{
  • "fieldPrimary": "string",
  • "fieldSecondary": "string",
  • "shareEntries": true
}

Response samples

Content type
application/json
{
  • "fieldPrimary": "string",
  • "fieldSecondary": "string",
  • "shareEntries": true
}

Get calendar entries list for calendar

This endpoint is for retrieving all entries of the requested calendar in admin representation. The entries are sorted by dateTime.dateStart:ASC dateTime.timeStart:ASC position:ASC. If a limit is set, a cursor for this endpoint may be created to iterate over all calendar entries.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects" (not for "Appointment" calendars)

path Parameters
id
required
string

Calendar ID

query Parameters
cursor
string

id of the cursor used for pagination; required if page is set

limit
integer

amount of results per page (1 ... 100)

page
integer

current page index of the cursor used for pagination; required if cursor is set

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Add calendar entries

This endpoint is for adding new entries to the requested calendar. Calendars of type "Appointment" are readonly. In case of response status is 205 the request was only executed partial. Use GET to receive the stored configuration.

Note: Widgets for tab type WidgetPartyDirectory must not have a referenceId

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects" (not for "Appointment" calendars)

path Parameters
id
required
string

Calendar ID

header Parameters
Session
required
string

JWT

Request Body schema: application/json

calendar content entries to create; max 100 elements are permitted per request

Array
object (model.Access)
bookingEnabled
boolean <optional>

bookingEnabled can only be true if externalId is not null; Default: false

object
end
integer
externalId
string or null <optional>

externalParty must be set if externalId is set; Default: null

externalParty
string or null <optional>
Value: "Doo"

Default: null

id
string
keywordIds
Array of strings
parentId
string or null
position
integer
publishedAt
integer or null
start
integer
Array of objects (content.EntryTabRequest)
timeZone
string

IANA Time Zone

title
string
object <optional>

Responses

Request samples

Content type
application/json
[
  • {
    }
]

Response samples

Content type
application/json
[
  • {
    }
]

Get calendar detail view

This endpoint is for retrieving the detail config, items and selections of a calendar

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Calendar ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "detail": {
    },
  • "items": [
    ],
  • "selections": [
    ]
}

Update calendar detail view

Endpoint is returning 501 only at the moment!

This endpoint is for updating the detail of an existing calendar. New Items need a client generated unique id for setting reference in detail. client generated id will be changed from server so item ids in response will differ! Calendars of type "Appointment" are readonly.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects" (not for "Appointment" calendars)

path Parameters
id
required
string

Calendar ID

header Parameters
Session
required
string

JWT

Request Body schema: application/json

detail to be updated

object (calendar.RequestDetailPart)
Array of objects (calendar.RequestItem)
Array of objects (calendar.RequestCalendarSelection)

Responses

Request samples

Content type
application/json
{
  • "detail": {
    },
  • "items": [
    ],
  • "selections": [
    ]
}

Response samples

Content type
application/json
{
  • "detail": {
    },
  • "items": [
    ],
  • "selections": [
    ]
}

Sync operators for all calendar entries

This endpoint is sync operators for all chat feeds with sendbird. This endpoint should rarely be used because of its workload.

only accessible with permission : "ManageProjects"

fully accessible with permission : "ManageProjects"

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "status": "ok"
}

Get calendar

This endpoint is for retrieving one calendar in admin representation.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Calendar ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "access": {
    },
  • "accessEditAllowed": true,
  • "createAccesses": {
    },
  • "description": "string",
  • "detail": {
    },
  • "entriesCount": 0,
  • "id": "string",
  • "items": [
    ],
  • "listSettings": {
    },
  • "period": {
    },
  • "projectId": "string",
  • "selections": [
    ],
  • "title": "string",
  • "type": "Appointment"
}

Delete calendar

This endpoint is for deleting a calendar with all localizations. Calendars of type "Appointment" are readonly.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects" (not for "Appointment" calendars)

path Parameters
id
required
string

Calendar ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "status": "ok"
}

Update calendar info

This endpoint is for updating the base info of an existing calendar. Calendars of type "Appointment" are readonly.

createAccesses.CalendarEntry.any: must be false; true currently not supported

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects" (not for "Appointment" calendars)

path Parameters
id
required
string

Calendar ID

header Parameters
Session
required
string

JWT

Request Body schema: application/json

calendar information to be updated

object

property enums: "CalendarEntry"; see route description for additional information

description
string
title
string

Responses

Request samples

Content type
application/json
{
  • "createAccesses": {
    },
  • "description": "string",
  • "title": "string"
}

Response samples

Content type
application/json
{
  • "access": {
    },
  • "accessEditAllowed": true,
  • "createAccesses": {
    },
  • "description": "string",
  • "detail": {
    },
  • "entriesCount": 0,
  • "id": "string",
  • "items": [
    ],
  • "listSettings": {
    },
  • "period": {
    },
  • "projectId": "string",
  • "selections": [
    ],
  • "title": "string",
  • "type": "Appointment"
}

Get calendar entry

This endpoint is for retrieving an entry of a calendar.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects" (not for "Appointment" calendars)

path Parameters
id
required
string

Entry ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "access": {
    },
  • "accessEditAllowed": true,
  • "bookingEnabled": true,
  • "calendarId": "string",
  • "dataSet": {
    },
  • "dateTime": {
    },
  • "detailDisabled": true,
  • "end": 0,
  • "externalId": "string",
  • "externalParty": "Doo",
  • "id": "string",
  • "isAppointment": true,
  • "keywordIds": [
    ],
  • "parentId": "string",
  • "position": 0,
  • "projectId": "string",
  • "publishedAt": 0,
  • "start": 0,
  • "tabs": [
    ],
  • "timeZone": "string",
  • "title": "string",
  • "translations": [
    ],
  • "widgets": {
    }
}

Update calendar entry

This endpoint is for updating a calendar entry. Calendars of type "Appointment" are readonly.

Note: Widgets for tab type WidgetPartyDirectory must not have a referenceId

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects" (not for "Appointment" calendars)

path Parameters
id
required
string

Entry ID

header Parameters
Session
required
string

JWT

Request Body schema: application/json

calendar content entry to be replaced

bookingEnabled
boolean <optional>

bookingEnabled can only be true if externalId is not null; Default: false

object
end
integer
externalId
string or null <optional>

externalParty must be set if externalId is set; Default: null

externalParty
string or null <optional>
Value: "Doo"

Default: null

keywordIds
Array of strings
parentId
string or null
position
integer
publishedAt
integer or null
start
integer
Array of objects (content.EntryTabRequest)
timeZone
string

IANA Time Zone

title
string
object <optional>

Responses

Request samples

Content type
application/json
{
  • "bookingEnabled": true,
  • "dataSet": {
    },
  • "end": 0,
  • "externalId": "string",
  • "externalParty": "Doo",
  • "keywordIds": [
    ],
  • "parentId": "string",
  • "position": 0,
  • "publishedAt": 0,
  • "start": 0,
  • "tabs": [
    ],
  • "timeZone": "string",
  • "title": "string",
  • "widgets": {
    }
}

Response samples

Content type
application/json
{
  • "access": {
    },
  • "accessEditAllowed": true,
  • "bookingEnabled": true,
  • "calendarId": "string",
  • "dataSet": {
    },
  • "dateTime": {
    },
  • "detailDisabled": true,
  • "end": 0,
  • "externalId": "string",
  • "externalParty": "Doo",
  • "id": "string",
  • "isAppointment": true,
  • "keywordIds": [
    ],
  • "parentId": "string",
  • "position": 0,
  • "projectId": "string",
  • "publishedAt": 0,
  • "start": 0,
  • "tabs": [
    ],
  • "timeZone": "string",
  • "title": "string",
  • "translations": [
    ],
  • "widgets": {
    }
}

Delete calendar entry

This endpoint is for deleting a calendar entry. Calendars of type "Appointment" are readonly.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects" (not for "Appointment" calendars)

path Parameters
id
required
string

Entry ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "status": "ok"
}

Get calendar entry access configuration

This endpoint returns the access configuration for the requested calendar entry. Calendars of type "Appointment" are readonly.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects" (not for "Appointment" calendars)

path Parameters
id
required
string

Entry ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "access": {
    },
  • "accessEditAllowed": true
}

Update calendar entry access configuration

This endpoint updates the access configuration for the requested calendar entry. Only the changes should be transmitted due this endpoint. Calendars of type "Appointment" are readonly.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects" (not for "Appointment" calendars)

path Parameters
id
required
string

Entry ID

header Parameters
Session
required
string

JWT

Request Body schema: application/json

changed access rights

object

accountId to operation; null for operation removes access

any
string or null
Enum: "Read" "Write" "Delete" "Create" "changeProof"

Delete (includes) Write (includes) Read; null for operation removes access

object

groupId to operation; null for operation removes access

user
string or null
Enum: "Read" "Write" "Delete" "Create" "changeProof"

Delete (includes) Write (includes) Read; null for operation removes access

Responses

Request samples

Content type
application/json
{
  • "accounts": {
    },
  • "any": "Read",
  • "groups": {
    },
  • "user": "Read"
}

Response samples

Content type
application/json
{
  • "accounts": {
    },
  • "any": "Read",
  • "groups": {
    },
  • "user": "Read"
}

Get calendar list for project

This endpoint is for retrieving all calendars of a project in admin representation. If a limit is set, a cursor for this endpoint may be created to iterate over all calendars.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Project ID

query Parameters
cursor
string

id of the cursor used for pagination; required if page is set

limit
integer

amount of results per page (1 ... 100)

page
integer

current page index of the cursor used for pagination; required if cursor is set

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Calendar (Default)

Get calendar

This endpoint is for retrieving one calendar in default representation. If the requested language is not available it will fall back to the default language.

accessible without permission

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Calendar ID

header Parameters
Accept-Language
string

client language(s)

Session
string

JWT

Responses

Response samples

Content type
application/json
{
  • "detail": {
    },
  • "entriesCount": 0,
  • "id": "string",
  • "items": [
    ],
  • "listSettings": {
    },
  • "period": {
    },
  • "projectId": "string",
  • "selections": [
    ],
  • "title": "string",
  • "translations": [
    ],
  • "type": "Appointment"
}

Create entry cursor

This endpoint returns a cursor for list published calendar entries in default representation with applied filter and sort options. In case of cursor response total will be 0 the status 204 with not content is returned instead.

accessible without permission

header Parameters
Accept-Language
string

client language(s)

Session
string

JWT

Request Body schema: application/json

options to create cursor

bookingEnabled
Array of booleans <optional> [ items <optional > ]
calendarIds
Array of strings <optional>
object <optional>

property is itemId to filter values for

ids
Array of strings <optional>
keywordIds
Array of strings <optional>
object <optional>

property is itemId to filter values for

parentIds
Array of strings <optional>
searchLanguage
string <optional>

specifies the language the search string should be interpreted in // TODO: TBD

searchString
string <optional>

must be empty or have at least 3 characters; Default: "" LiveSearch: space separated groups of characters are treated as disjunctive regex group; WordSearch: exact match of whole words, for phrases wrap in escaped double quotes, exclude words by prepending "-"

searchType
string <optional>
Enum: "LiveSearch" "WordSearch"

specifies how searchString should be interpreted; Default: LiveSearch

object <optional>

property is itemId to filter values for

Responses

Request samples

Content type
application/json
{
  • "bookingEnabled": [
    ],
  • "calendarIds": [
    ],
  • "directoryContentRowIds": {
    },
  • "ids": [
    ],
  • "keywordIds": [
    ],
  • "locationIds": {
    },
  • "parentIds": [
    ],
  • "searchLanguage": "string",
  • "searchString": "string",
  • "searchType": "LiveSearch",
  • "selectionOptionIds": {
    }
}

Response samples

Content type
application/json
{
  • "cursor": "string",
  • "endpoints": [
    ],
  • "expiredAt": 0,
  • "total": 0
}

Get calendar entry

This endpoint is for retrieving an entry of a calendar.

accessible without permission

fully accessible with permission : "ManageContent" "ManageProjects" (not for "Appointment" calendars)

path Parameters
id
required
string

Entry ID

header Parameters
Accept-Language
string

client language(s)

Session
string

JWT

Responses

Response samples

Content type
application/json
{
  • "bookingEnabled": true,
  • "calendarId": "string",
  • "dataSet": {
    },
  • "dateTime": {
    },
  • "detailDisabled": true,
  • "end": 0,
  • "id": "string",
  • "isAppointment": true,
  • "keywordIds": [
    ],
  • "parentId": "string",
  • "position": 0,
  • "projectId": "string",
  • "publishedAt": 0,
  • "start": 0,
  • "tabs": [
    ],
  • "title": "string",
  • "translations": [
    ],
  • "widgets": {
    }
}

Get calendar entries list for calendar

This endpoint is for retrieving all entries of the requested calendar in default representation. The entries are sorted by dateTime.dateStart:ASC dateTime.timeStart:ASC position:ASC. If a limit is set, a cursor for this endpoint may be created to iterate over all calendar entries.

accessible without permission

path Parameters
id
required
string

Calendar ID

query Parameters
cursor
string

id of the cursor used for pagination; required if page is set

limit
integer

amount of results per page (1 ... 100)

page
integer

current page index of the cursor used for pagination; required if cursor is set

header Parameters
Accept-Language
string

client language(s)

Session
string

JWT

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get calendar entries list for cursor

This endpoint is for retrieving all entries for the requested cursor in default representation.

Cursor could be created here: POST /calendar/default/entry/search

accessible without permission

query Parameters
cursor
required
string

id of the cursor used for pagination; required if page is set

page
required
integer

current page index of the cursor used for pagination; required if cursor is set

limit
integer

amount of results per page (1 ... 100)

header Parameters
Accept-Language
string

client language(s)

Session
string

JWT

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get calendar entries list for my calendar

This endpoint is for retrieving all entries of my calendar in default representation. The entries are sorted by dateTime.dateStart:ASC dateTime.timeStart:ASC position:ASC. If a limit is set, a cursor for this endpoint may be created to iterate over all calendar entries.

accessible without permission

query Parameters
cursor
string

id of the cursor used for pagination; required if page is set

limit
integer

amount of results per page (1 ... 100)

page
integer

current page index of the cursor used for pagination; required if cursor is set

header Parameters
Accept-Language
string

client language(s)

Session
required
string

JWT

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get booking

This endpoint is for retrieving calendar entry's booking in default representation.

accessible without permission (can only be used for the own account. Session must match requested account id.)

path Parameters
id
required
string

Entry ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "accountId": "string",
  • "ticketCode": "string"
}

Get my calendar

This endpoint is for retrieving my calendar in default representation.

accessible without permission

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "detail": {
    },
  • "entriesCount": 0,
  • "id": "string",
  • "items": null,
  • "listSettings": {
    },
  • "period": {
    },
  • "projectId": "string",
  • "selections": [
    ],
  • "title": "string",
  • "translations": [
    ],
  • "type": "Appointment"
}

Chat (Admin)

Create chat feed

This endpoint is for creating a new chat feed.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

header Parameters
Session
required
string

JWT

Request Body schema: application/json

Chat-Feed to create

object (model.Access)
image
string or null

a media image id from project or global context

projectId
string
title
string

Responses

Request samples

Content type
application/json
{
  • "access": {
    },
  • "image": "string",
  • "projectId": "string",
  • "title": "string"
}

Response samples

Content type
application/json
{
  • "access": {
    },
  • "accessEditAllowed": true,
  • "creator": "string",
  • "id": "string",
  • "image": "string",
  • "projectId": "string",
  • "title": "string",
  • "visits": 0
}

delete a chat channel

This endpoint is for deleting a single chat channel.

only accessible with admin role

path Parameters
channelURL
required
string

The Sendbird Channel ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "status": "ok"
}

Sync Operators for all chat feeds

This endpoint is sync operators for all chat feeds with sendbird. This endpoint should be rarely used, because of its workload.

only accessible with permission : "ManageProjects"

fully accessible with permission : "ManageProjects"

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "status": "ok"
}

Get list of chat channels

This endpoint is for getting list of all chat channels. If a limit is set, a cursor for this endpoint may be created to iterate over all chat channels.

only accessible with admin role

query Parameters
cursor
string

id of the cursor used for pagination; required if page is set

limit
integer

amount of results per page (1 ... 100)

page
integer

current page index of the cursor used for pagination; required if cursor is set

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get chat feeds of project

This endpoint is for retrieving all chat feeds of a project in admin representation. If a limit is set, a cursor for this endpoint may be created to iterate over all chat feeds.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Project ID

query Parameters
cursor
string

id of the cursor used for pagination; required if page is set

limit
integer

amount of results per page (1 ... 100)

page
integer

current page index of the cursor used for pagination; required if cursor is set

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get chat feed

This endpoint is for retrieving a single chat feed in admin representation.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Chat Feed ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "access": {
    },
  • "accessEditAllowed": true,
  • "creator": "string",
  • "id": "string",
  • "image": "string",
  • "projectId": "string",
  • "title": "string",
  • "visits": 0
}

Delete chat feed

This endpoint is for deleting a single chat feed.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Form ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "status": "ok"
}

Update chat feed

This endpoint is for updating an existing chat feed

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Chat Feed ID

header Parameters
Session
required
string

JWT

Request Body schema: application/json

chat feed data to update

image
string or null

a media image id from project or global context

title
string

Responses

Request samples

Content type
application/json
{
  • "image": "string",
  • "title": "string"
}

Response samples

Content type
application/json
{
  • "access": {
    },
  • "accessEditAllowed": true,
  • "creator": "string",
  • "id": "string",
  • "image": "string",
  • "projectId": "string",
  • "title": "string",
  • "visits": 0
}

Get chat feed access configuration

This endpoint returns the access configuration for the requested chat feed.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

ChatFeed ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "access": {
    },
  • "accessEditAllowed": true
}

Update chat feed access configuration

This endpoint updates the access configuration for the requested chat feed. Only the changes should be transmitted due this endpoint.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

ChatFeed ID

header Parameters
Session
required
string

JWT

Request Body schema: application/json

changed access rights

object

accountId to operation; null for operation removes access

any
string or null
Enum: "Read" "Write" "Delete" "Create" "changeProof"

Delete (includes) Write (includes) Read; null for operation removes access

object

groupId to operation; null for operation removes access

user
string or null
Enum: "Read" "Write" "Delete" "Create" "changeProof"

Delete (includes) Write (includes) Read; null for operation removes access

Responses

Request samples

Content type
application/json
{
  • "accounts": {
    },
  • "any": "Read",
  • "groups": {
    },
  • "user": "Read"
}

Response samples

Content type
application/json
{
  • "accounts": {
    },
  • "any": "Read",
  • "groups": {
    },
  • "user": "Read"
}

Chat (Default)

get requests for chat channel

This endpoint returns all requests for the requested channel.

Note: Only operators of the provided sendbird channel can call this endpoint

accessible without permission

path Parameters
channelURL
required
string

The Sendbird Channel URL

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
[
  • {
    }
]

get requests for all chat channels for requesting account

This endpoint returns all pending requests for all channels for the current user. If a limit is set, a cursor for this endpoint may be created to iterate over all pending requests.

accessible without permission

query Parameters
cursor
string

id of the cursor used for pagination; required if page is set

limit
integer

amount of results per page (1 ... 100)

page
integer

current page index of the cursor used for pagination; required if cursor is set

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
[
  • {
    }
]

get requests for chat channels

This endpoint returns all requests for the requested channels.

Note: Only operators of the provided sendbird channels can call this endpoint

accessible without permission

header Parameters
Session
required
string

JWT

Request Body schema: application/json

channelURLs

channelUrls
Array of strings <= 100 items

Responses

Request samples

Content type
application/json
{
  • "channelUrls": [
    ]
}

Response samples

Content type
application/json
[
  • {
    }
]

Join chat feed

This endpoint is for joining a chat feed.

accessible without permission

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Chat Feed ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "status": "ok"
}

request join for protected chat channel

This endpoint is for joining a protected chat channel

If user is already a member of the channel a http 200 is returned without creating a request.

accessible without permission

path Parameters
channelURL
required
string

The Sendbird Channel URL

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "status": "ok"
}

Get chat feed

This endpoint is for retrieving a single chat feed in default representation. If the requested language is not available it will fall back to the default language.

accessible without permission

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Chat Feed ID

header Parameters
Accept-Language
string

client language(s)

Session
string

JWT

Responses

Response samples

Content type
application/json
{
  • "channelId": "string",
  • "id": "string",
  • "image": "string",
  • "isMember": true,
  • "projectId": "string",
  • "title": "string",
  • "translations": [
    ]
}

get request of account for chat channel

This endpoint returns the request of an account for a chat channel.

Note: Only operators of the provided sendbird channel and the requesting accountID can call this endpoint

accessible without permission

path Parameters
channelURL
required
string

The Sendbird Channel URL

id
required
string

The ID of the account which should be processed

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "accountId": "string",
  • "channelUrl": "string",
  • "requestedAt": 0
}

process join request for protected chat channel

This endpoint is for processing a joining request for a protected chat channel

Note: Only operators of the provided sendbird channel can call this endpoint

accessible without permission

path Parameters
channelURL
required
string

The Sendbird Channel URL

id
required
string

The ID of the account which should be processed

header Parameters
Session
required
string

JWT

Request Body schema: application/json

action to be performed

action
string
Enum: "Accept" "Decline"

Responses

Request samples

Content type
application/json
{
  • "action": "Accept"
}

Response samples

Content type
application/json
{
  • "status": "ok"
}

Get chat feeds of project

This endpoint is for retrieving all chat feeds of a project in default representation. If the requested language is not available it will fall back to the default language. If a limit is set, a cursor for this endpoint may be created to iterate over all chat feeds.

accessible without permission

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Project ID

query Parameters
cursor
string

id of the cursor used for pagination; required if page is set

limit
integer

amount of results per page (1 ... 100)

page
integer

current page index of the cursor used for pagination; required if cursor is set

header Parameters
Accept-Language
string

client language(s)

Session
string

JWT

Responses

Response samples

Content type
application/json
[
  • {
    }
]

invite users to protected chat channel

This endpoint is for inviting users to a protected chat channel In case of response status is 205 the request was only executed partial.

Note: Only operators of the provided sendbird channel can call this endpoint

accessible without permission

path Parameters
channelURL
required
string

The Sendbird Channel URL

header Parameters
Session
required
string

JWT

Request Body schema: application/json

Account IDs

Array
string

Responses

Request samples

Content type
application/json
[
  • "string"
]

Response samples

Content type
application/json
{
  • "status": "ok"
}

Config (Admin)

Get knowledge base articles

This endpoint returns all articles for a objectType in de and en

This keys of the object represents the language codes (de-DE|en-US).

accessible without permission

path Parameters
objectType
required
string
Enum: "Account" "Calendar" "ChatFeed" "Configuration" "Directory" "Location" "LocationMap" "Keyword" "Media" "Menu" "News" "Notification" "Page" "Project" "ProjectTracking" "Shipping" "Stream"

objectType

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "property1": {
    },
  • "property2": {
    }
}

Get features

This endpoint returns the features configuration in admin representation. The If-Modified-Since header can be used for omitting the output if nothing has changed.

accessible without permission

fully accessible with permission : "ManageConfiguration"

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "chat": {
    }
}

Update features

This endpoint is for updating the features configuration. The If-Modified-Since header can be used for omitting the request if nothing has changed.

only accessible with permission : "ManageConfiguration"

fully accessible with permission : "ManageConfiguration"

header Parameters
Session
required
string

JWT

Request Body schema: application/json

features data to be updated

object (configuration.PatchChatRequestAdmin)

Responses

Request samples

Content type
application/json
{
  • "chat": {
    }
}

Response samples

Content type
application/json
{
  • "chat": {
    }
}

Get factory default security settings

This endpoint returns the default security configuration in administrative representation. This can be used for reset settings to default value.

accessible without permission

fully accessible with permission : "ManageConfiguration"

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "blockOldPasswords": 0,
  • "loginActivated": true,
  • "loginTerms": true,
  • "lowerCaseRequired": true,
  • "minPasswordLength": 1,
  • "numberRequired": true,
  • "passwordExpiration": 1,
  • "preventDictionaryAttack": true,
  • "refreshTokenLifetime": 1,
  • "registrationActivated": true,
  • "specialLettersRequired": true,
  • "trackingEnabled": true,
  • "upperCaseRequired": true
}

Get premium features

This endpoint returns the premium configuration in admin representation.

accessible without permission

fully accessible with permission : "Plazz"

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "appointment": {
    },
  • "autoTranslation": {
    },
  • "journey": {
    },
  • "systemNotificationMuted": {
    },
  • "whitelabel": {
    }
}

Update premium features

This endpoint updates the premium configuration.

only accessible with permission : "Plazz"

fully accessible with permission : "Plazz"

header Parameters
Session
required
string

JWT

Request Body schema: application/json

premium configuration to be updated

object (model.FeaturePaidUntil)
object (model.AutoTranslation)
object (model.FeaturePaidUntil)
object (model.SystemNotification)
object (model.FeaturePaidUntil)

Responses

Request samples

Content type
application/json
{
  • "appointment": {
    },
  • "autoTranslation": {
    },
  • "journey": {
    },
  • "systemNotificationMuted": {
    },
  • "whitelabel": {
    }
}

Response samples

Content type
application/json
{
  • "appointment": {
    },
  • "autoTranslation": {
    },
  • "journey": {
    },
  • "systemNotificationMuted": {
    },
  • "whitelabel": {
    }
}

Get security settings

This endpoint returns the security configuration in administrative representation. This endpoint returns the security configuration in administrative representation. The If-Modified-Since header can be used for omitting the output if nothing has changed.

accessible without permission

fully accessible with permission : "ManageConfiguration"

header Parameters
Session
required
string

JWT

If-Modified-Since
integer

unix timestamp of the last sync

Responses

Response samples

Content type
application/json
{
  • "blockOldPasswords": 0,
  • "loginActivated": true,
  • "loginTerms": true,
  • "lowerCaseRequired": true,
  • "minPasswordLength": 1,
  • "numberRequired": true,
  • "passwordExpiration": 1,
  • "preventDictionaryAttack": true,
  • "refreshTokenLifetime": 1,
  • "registrationActivated": true,
  • "specialLettersRequired": true,
  • "trackingEnabled": true,
  • "upperCaseRequired": true
}

Update security settings

This endpoint is for updating specific data of the security configuration. The If-Modified-Since header can be used for omitting the request if nothing has changed.

only accessible with permission : "ManageConfiguration"

fully accessible with permission : "ManageConfiguration"

header Parameters
Session
required
string

JWT

If-Modified-Since
integer

unix timestamp

Request Body schema: application/json

security data to be updated

blockOldPasswords
integer
loginActivated
boolean
loginTerms
boolean

specify if there are terms of use or privacy policy the user have to confirm for login first

lowerCaseRequired
boolean
minPasswordLength
integer >= 1
numberRequired
boolean
passwordExpiration
integer or null >= 1

amount of days

preventDictionaryAttack
boolean
refreshTokenLifetime
integer [ 1 .. 360 ]

token lifetime in days

registrationActivated
boolean
specialLettersRequired
boolean
upperCaseRequired
boolean

Responses

Request samples

Content type
application/json
{
  • "blockOldPasswords": 0,
  • "loginActivated": true,
  • "loginTerms": true,
  • "lowerCaseRequired": true,
  • "minPasswordLength": 1,
  • "numberRequired": true,
  • "passwordExpiration": 1,
  • "preventDictionaryAttack": true,
  • "refreshTokenLifetime": 1,
  • "registrationActivated": true,
  • "specialLettersRequired": true,
  • "upperCaseRequired": true
}

Response samples

Content type
application/json
{
  • "blockOldPasswords": 0,
  • "loginActivated": true,
  • "loginTerms": true,
  • "lowerCaseRequired": true,
  • "minPasswordLength": 1,
  • "numberRequired": true,
  • "passwordExpiration": 1,
  • "preventDictionaryAttack": true,
  • "refreshTokenLifetime": 1,
  • "registrationActivated": true,
  • "specialLettersRequired": true,
  • "trackingEnabled": true,
  • "upperCaseRequired": true
}

Get Custom CSS

This endpoint returns the custom css settings in admin representation.

only accessible with permission : "Plazz"

fully accessible with permission : "Plazz"

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "customCss": "body { background-color: #000000; }",
  • "customCssStatus": "Draft"
}

Update Custom CSS

This endpoint updates the custom css settings in admin representation.

only accessible with permission : "Plazz"

fully accessible with permission : "Plazz"

header Parameters
Session
required
string

JWT

Request Body schema: application/json

custom css

customCss
string

css code

customCssStatus
string
Enum: "Draft" "Published"

Responses

Request samples

Content type
application/json
{
  • "customCss": "body { background-color: #000000; }",
  • "customCssStatus": "Draft"
}

Response samples

Content type
application/json
{
  • "customCss": "body { background-color: #000000; }",
  • "customCssStatus": "Draft"
}

Get schemes list

This endpoint returns an array of all scheme. The output is in administrative representation. The If-Modified-Since header can be used for omitting the output if nothing has changed. If a limit is set, a cursor for this endpoint may be created to iterate over all schemes.

accessible without permission

fully accessible with permission : "ManageConfiguration"

query Parameters
cursor
string

id of the cursor used for pagination; required if page is set

limit
integer

amount of results per page (1 ... 100)

page
integer

current page index of the cursor used for pagination; required if cursor is set

header Parameters
Session
required
string

JWT

If-Modified-Since
integer

unix timestamp of the last sync

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Create custom scheme

This endpoint is for creating a new scheme.

only accessible with permission : "ManageConfiguration"

fully accessible with permission : "ManageConfiguration"

header Parameters
Session
required
string

JWT

Request Body schema: application/json

scheme to create

object (model.Palette)
object (model.PaletteAuto)
object (model.Palette)
title
string

Responses

Request samples

Content type
application/json
{
  • "dark": {
    },
  • "darkAuto": {
    },
  • "light": {
    },
  • "title": "Cherry Blossom"
}

Response samples

Content type
application/json
{
  • "dark": {
    },
  • "darkAuto": {
    },
  • "id": "string",
  • "light": {
    },
  • "systemScheme": true,
  • "title": "Cherry Blossom"
}

Get factory default design

This endpoint returns the default design configuration in administrative representation. This can be used for reset settings to default value.

accessible without permission

fully accessible with permission : "ManageConfiguration"

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "backgroundDarkPrimary": "#000000",
  • "backgroundDarkPrimaryAuto": true,
  • "backgroundDarkSecondary": "#000000",
  • "backgroundDarkSecondaryAuto": true,
  • "backgroundLightPrimary": "#FFFFFF",
  • "backgroundLightSecondary": "#FFFFFF",
  • "backgroundType": "Gradient",
  • "companyLogo": "5d9ef49c396f2d5d84806146",
  • "schemeCurrent": "5e1705243a2ef1289ae3cbc2"
}

Get design

This endpoint returns the design configuration in administrative representation. The If-Modified-Since header can be used for omitting the output if nothing has changed.

accessible without permission

fully accessible with permission : "ManageConfiguration"

header Parameters
Session
required
string

JWT

If-Modified-Since
integer

unix timestamp of the last sync

Responses

Response samples

Content type
application/json
{
  • "backgroundDarkPrimary": "#000000",
  • "backgroundDarkPrimaryAuto": true,
  • "backgroundDarkSecondary": "#000000",
  • "backgroundDarkSecondaryAuto": true,
  • "backgroundLightPrimary": "#FFFFFF",
  • "backgroundLightSecondary": "#FFFFFF",
  • "backgroundType": "Gradient",
  • "companyLogo": "5d9ef49c396f2d5d84806146",
  • "schemeCurrent": "5e1705243a2ef1289ae3cbc2"
}

Update design

This endpoint is for updating specific data of the design configuration. The If-Modified-Since header can be used for omitting the request if nothing has changed.

only accessible with permission : "ManageConfiguration"

fully accessible with permission : "ManageConfiguration"

header Parameters
Session
required
string

JWT

If-Modified-Since
integer

unix timestamp

Request Body schema: application/json

design data to be updated

backgroundDarkPrimary
string

only used for backgroundType{Gradient|Color}; hexcolor or enum: "backgroundPrimary" "backgroundSecondary" "backgroundTertiary" "border" "contrast" "error" "primary" "secondary" "success" "textPrimary" "textSecondary"

backgroundDarkPrimaryAuto
boolean

only used for backgroundType{Gradient|Color}

backgroundDarkSecondary
string

only used for backgroundType{Gradient}; hexcolor or enum: "backgroundPrimary" "backgroundSecondary" "backgroundTertiary" "border" "contrast" "error" "primary" "secondary" "success" "textPrimary" "textSecondary"

backgroundDarkSecondaryAuto
boolean

only used for backgroundType{Gradient}

backgroundLightPrimary
string

only used for backgroundType{Gradient|Color}; hexcolor or enum: "backgroundPrimary" "backgroundSecondary" "backgroundTertiary" "border" "contrast" "error" "primary" "secondary" "success" "textPrimary" "textSecondary"

backgroundLightSecondary
string

only used for backgroundType{Gradient}; hexcolor or enum: "backgroundPrimary" "backgroundSecondary" "backgroundTertiary" "border" "contrast" "error" "primary" "secondary" "success" "textPrimary" "textSecondary"

backgroundType
string
Enum: "Gradient" "Color" "Transparent"
companyLogo
string or null

media id

schemeCurrent
string

scheme id

Responses

Request samples

Content type
application/json
{
  • "backgroundDarkPrimary": "#000000",
  • "backgroundDarkPrimaryAuto": true,
  • "backgroundDarkSecondary": "#000000",
  • "backgroundDarkSecondaryAuto": true,
  • "backgroundLightPrimary": "#FFFFFF",
  • "backgroundLightSecondary": "#FFFFFF",
  • "backgroundType": "Gradient",
  • "companyLogo": "5d9ef49c396f2d5d84806146",
  • "schemeCurrent": "5e1705243a2ef1289ae3cbc2"
}

Response samples

Content type
application/json
{
  • "backgroundDarkPrimary": "#000000",
  • "backgroundDarkPrimaryAuto": true,
  • "backgroundDarkSecondary": "#000000",
  • "backgroundDarkSecondaryAuto": true,
  • "backgroundLightPrimary": "#FFFFFF",
  • "backgroundLightSecondary": "#FFFFFF",
  • "backgroundType": "Gradient",
  • "companyLogo": "5d9ef49c396f2d5d84806146",
  • "schemeCurrent": "5e1705243a2ef1289ae3cbc2"
}

Get scheme

This endpoint returns a scheme in administrative representation by given id. The If-Modified-Since header can be used for omitting the output if nothing has changed.

accessible without permission

fully accessible with permission : "ManageConfiguration"

path Parameters
id
required
string

Scheme ID

header Parameters
Session
required
string

JWT

If-Modified-Since
integer

unix timestamp of the last sync

Responses

Response samples

Content type
application/json
{
  • "dark": {
    },
  • "darkAuto": {
    },
  • "id": "string",
  • "light": {
    },
  • "systemScheme": true,
  • "title": "Cherry Blossom"
}

Delete custom scheme

This endpoint is for deleting a single scheme. System schemes are not deletable. The If-Modified-Since header can be used for omitting the request if nothing has changed.

only accessible with permission : "ManageConfiguration"

fully accessible with permission : "ManageConfiguration"

path Parameters
id
required
string

Scheme ID

header Parameters
Session
required
string

JWT

If-Modified-Since
integer

unix timestamp of the last sync

Responses

Response samples

Content type
application/json
{
  • "status": "ok"
}

Update scheme

This endpoint is for updating specific data of an existing scheme. The title of system schemes is not editable. The If-Modified-Since header can be used for omitting the request if nothing has changed.

only accessible with permission : "ManageConfiguration"

fully accessible with permission : "ManageConfiguration"

path Parameters
id
required
string

Scheme ID

header Parameters
Session
required
string

JWT

If-Modified-Since
integer

unix timestamp

Request Body schema: application/json

scheme to create

object (model.Palette)
object (model.PaletteAuto)
object (model.Palette)
title
string

Responses

Request samples

Content type
application/json
{
  • "dark": {
    },
  • "darkAuto": {
    },
  • "light": {
    },
  • "title": "Cherry Blossom"
}

Response samples

Content type
application/json
{
  • "dark": {
    },
  • "darkAuto": {
    },
  • "id": "string",
  • "light": {
    },
  • "systemScheme": true,
  • "title": "Cherry Blossom"
}

Get factory default for system scheme

This endpoint returns the default data of a system scheme in administrative representation by given id.

accessible without permission

fully accessible with permission : "ManageConfiguration"

path Parameters
id
required
string

Scheme ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "dark": {
    },
  • "darkAuto": {
    },
  • "id": "string",
  • "light": {
    },
  • "systemScheme": true,
  • "title": "Cherry Blossom"
}

Config (Default)

Get design

This endpoint returns the design configuration in default representation. The If-Modified-Since header can be used for omitting the output if nothing has changed.

accessible without permission

fully accessible with permission : "ManageConfiguration"

header Parameters
If-Modified-Since
integer

unix timestamp of the last sync

Session
string

JWT

Responses

Response samples

Content type
application/json
{
  • "backgroundDarkPrimary": "#000000",
  • "backgroundDarkSecondary": "#000000",
  • "backgroundLightPrimary": "#FFFFFF",
  • "backgroundLightSecondary": "#FFFFFF",
  • "backgroundType": "Gradient",
  • "companyLogo": "5d9ef49c396f2d5d84806146",
  • "customCss": "body { background-color: #000000; }",
  • "menu": {
    },
  • "schemeCurrent": "5e1705243a2ef1289ae3cbc2"
}

Get security settings

This endpoint returns the security configuration in default representation. The If-Modified-Since header can be used for omitting the output if nothing has changed.

accessible without permission

fully accessible with permission : "ManageConfiguration"

header Parameters
If-Modified-Since
integer

unix timestamp of the last sync

Session
string

JWT

Responses

Response samples

Content type
application/json
{
  • "loginActivated": true,
  • "loginTerms": true,
  • "lowerCaseRequired": true,
  • "minPasswordLength": 1,
  • "numberRequired": true,
  • "registrationActivated": true,
  • "specialLettersRequired": true,
  • "trackingEnabled": true,
  • "upperCaseRequired": true
}

Get features

This endpoint returns the features configuration in default representation. The If-Modified-Since header can be used for omitting the output if nothing has changed.

accessible without permission

fully accessible with permission : "ManageConfiguration"

header Parameters
Session
string

JWT

Responses

Response samples

Content type
application/json
{
  • "chat": {
    }
}

Get scheme

This endpoint returns a scheme in default representation by given id. The If-Modified-Since header can be used for omitting the output if nothing has changed.

accessible without permission

fully accessible with permission : "ManageConfiguration"

path Parameters
id
required
string

Scheme ID

header Parameters
Session
string

JWT

If-Modified-Since
integer

unix timestamp of the last sync

Responses

Response samples

Content type
application/json
{
  • "dark": {
    },
  • "id": "string",
  • "light": {
    }
}

Get premium features

This endpoint returns the premium configuration in default representation.

accessible without permission

fully accessible with permission : "Plazz"

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "appointment": {
    },
  • "autoTranslation": {
    },
  • "journey": {
    },
  • "systemNotificationMuted": {
    },
  • "whitelabel": {
    }
}

Connected App

Add secret

This endpoint updates the requested connected App to add a new secret.

only accessible with permission : "ManageApps"

fully accessible with permission : "ManageApps"

path Parameters
id
required
string

Connected App ID

header Parameters
Session
required
string

JWT

Request Body schema: application/json

expiration timestamp for secret

expiration
integer or null

Responses

Request samples

Content type
application/json
{
  • "expiration": 0
}

Response samples

Content type
application/json
{
  • "expiration": 0,
  • "secret": "string"
}

Remove secret

Deletes a secret by given of a connected app

only accessible with permission : "ManageApps"

fully accessible with permission : "ManageApps"

path Parameters
id
required
string

Connected App ID

header Parameters
Session
required
string

JWT

Request Body schema: application/json

secret to be removed

secret
string

Responses

Request samples

Content type
application/json
{
  • "secret": "string"
}

Response samples

Content type
application/json
{
  • "status": "ok"
}

get connected apps list

This endpoint is for retrieving all existing connected apps, which are currently stored in db.

only accessible with permission : "ManageApps"

fully accessible with permission : "ManageApps"

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Create connected app

This endpoint is for creating a new connected app. It also creates a new technical account that will be linked with the connected app. You are only allowed to add roles that have permissions you already own through your roles. If you have "ManageGlobalRoles" you are allowed to add all roles.

only accessible with permission : "ManageApps"

fully accessible with permission : "ManageApps"

header Parameters
Session
required
string

JWT

Request Body schema: application/json

Connected app to create

description
string
Array of objects (model.AccountRole)
title
string
url
string or null

Responses

Request samples

Content type
application/json
{
  • "description": "string",
  • "roles": [
    ],
  • "title": "string",
  • "url": "string"
}

Response samples

Content type
application/json
{
  • "description": "string",
  • "id": "string",
  • "roles": [
    ],
  • "secrets": {
    },
  • "title": "string",
  • "url": "string"
}

get connected app

This endpoint is for retrieving one connected app, which is currently stored in db.

only accessible with permission : "ManageApps"

fully accessible with permission : "ManageApps"

path Parameters
id
required
string

Connected App ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "description": "string",
  • "id": "string",
  • "roles": [
    ],
  • "secrets": {
    },
  • "title": "string",
  • "url": "string"
}

Delete connected app

Deletes a connected app by given id and removes the roles from the linked robot account.

only accessible with permission : "ManageApps"

fully accessible with permission : "ManageApps"

path Parameters
id
required
string

Connected App ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "status": "ok"
}

Update connected app

This endpoint updates the requested connected App. It also updates the linked technical account for the connected app. Only the changes should be transmitted due this endpoint.

only accessible with permission : "ManageApps"

fully accessible with permission : "ManageApps"

path Parameters
id
required
string

Connected App ID

header Parameters
Session
required
string

JWT

Request Body schema: application/json

changed connected app

description
string
Array of objects (model.AccountRole)
title
string
url
string or null

Responses

Request samples

Content type
application/json
{
  • "description": "string",
  • "roles": [
    ],
  • "title": "string",
  • "url": "string"
}

Response samples

Content type
application/json
{
  • "description": "string",
  • "id": "string",
  • "roles": [
    ],
  • "secrets": {
    },
  • "title": "string",
  • "url": "string"
}

Create session

This endpoint creates a session for a connected app

accessible without permission

path Parameters
id
required
string

Connected App ID

header Parameters
Secret
required
string

connected app token

Responses

Response samples

Content type
application/json
{
  • "status": "ok"
}

Directory (Admin)

Get directory template list

This endpoint retrieving templates to enhance the creation of new directories. If a limit is set, a cursor for this endpoint may be created to iterate over all templates.

query Parameters
cursor
string

id of the cursor used for pagination; required if page is set

limit
integer

amount of results per page (1 ... 100)

page
integer

current page index of the cursor used for pagination; required if cursor is set

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get directory detail view items

This endpoint is for retrieving directory items.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Directory ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get directory detail view selections

This endpoint is for retrieving directory selections.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Directory ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get directory list for cursor

This endpoint is for retrieving all directories for the requested cursor in admin representation.

Cursor could be created here: POST /directory/admin/search

accessible without permission

query Parameters
cursor
required
string

id of the cursor used for pagination; required if page is set

page
required
integer

current page index of the cursor used for pagination; required if cursor is set

limit
integer

amount of results per page (1 ... 100)

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Create directory

This endpoint is for creating a new directory for chosen template.

Supported objectTypes for contentRowFilter:

  • contentRowObjectType = "Account" supported objectTypes: "Group"

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

header Parameters
Session
required
string

JWT

Request Body schema: application/json

directory to create

object <optional>

Default: {"any": "Read", "user": "Read", "accounts": {}, "groups": {}}

object or null

see route description for additional information

contentRowObjectType
string or null
Enum: "Selection" "SelectionOption" "Role" "CronJob" "Configuration" "Localization" "Scheme" "Menu" "MenuItem" "Party" "PartyReaction" "Group" "Keyword" "KeywordCategory" "SsoProvider" "Index" "Stream" "Shipping" "News" "NewsSection" "NewsColumn" "NewsItem" "Location" "LocationMap" "LocationMapMarker" "ConnectedApp" "Notification" "NotificationJob" "AccountNotification" "Page" "PageSection" "PageColumn" "PageItem" "ChatChannel" "ChatChannelRequest" "ChatFeed" "Bookmark" "Journey" "JourneyProcess" "Reaction" "Appointment" "AppointmentConfig" "Calendar" "CalendarBodySection" "CalendarItem" "CalendarSelection" "CalendarSelectionOption" "CalendarEntry" "CalendarEntryTab" "CalendarEntryWidget" "CalendarTemplate" "Account" "AccountSettingsAnalyticsRecord" "Media" "MediaAudio" "MediaDocument" "MediaDownloadRequest" "MediaFolder" "MediaIcon" "MediaImage" "MediaOther" "MediaVideo" "Project" "ProjectTracking" "ProjectCopyProcess" "Directory" "DirectoryBodySection" "DirectoryItem" "DirectorySelection" "DirectorySelectionOption" "DirectoryContentRow" "DirectoryTemplate" "Webhook" "WebhookLogMessage"

null = static directory

description
string
projectId
string
templateId
string or null

must be null for dynamic directory

title
string

Responses

Request samples

Content type
application/json
{
  • "access": {
    },
  • "contentRowFilter": {
    },
  • "contentRowObjectType": "Account",
  • "description": "string",
  • "projectId": "string",
  • "templateId": "string",
  • "title": "string"
}

Response samples

Content type
application/json
{
  • "access": {
    },
  • "accessEditAllowed": true,
  • "contentRowFilter": {
    },
  • "contentRowObjectType": "Account",
  • "contentRowsCount": 0,
  • "createAccesses": {
    },
  • "description": "string",
  • "detail": {
    },
  • "id": "string",
  • "isSystem": true,
  • "items": [
    ],
  • "listSettings": {
    },
  • "projectId": "string",
  • "selections": [
    ],
  • "title": "string",
  • "type": "Account",
  • "typeReferenceId": "string"
}

Get directory list settings

This endpoint returns the list settings of a specific directory.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Directory ID

header Parameters
Session
string

JWT

Responses

Response samples

Content type
application/json
{
  • "allowChat": true,
  • "fieldHeaderImage": "string",
  • "fieldPrimary": "string",
  • "fieldSecondary": "string",
  • "headlineItems": [
    ],
  • "layout": "ColumnSingle",
  • "order": "Alphabetical",
  • "orderWithHighlights": true,
  • "shareEntries": true,
  • "size": "S",
  • "sort": [
    ]
}

Update directory list settings

This endpoint is for updating the list settings of an existing directory.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Directory ID

header Parameters
Session
required
string

JWT

Request Body schema: application/json

list settings to be updated

allowChat
boolean <optional>
fieldHeaderImage
string or null

itemId // item must be Media with subtype Image -> Image for header area of each list item

fieldPrimary
string or null

itemId // item must be PropertyCreator, TextBlock, TextDateTime, TextMail, TextNumber, TextPhone or TextPlainLine

fieldSecondary
string or null

itemId // item must be PropertyCreator, TextDateTime, TextMail, TextNumber, TextPhone, TextPlainLine or null if fieldPrimary is TextBlock

headlineItems
Array of strings <= 3 items

items must be PropertyCreator, TextDateTime, TextNumber or TextPlainLine max 3 items

layout
string
Enum: "ColumnSingle" "ColumnDouble" "Grid" "List"

ColumnSingle and ColumnDouble are deprecated and will be removed in 6.0

order
string
Enum: "Alphabetical" "Custom" "Latest" "Position" "Random" "Recent"

for "Custom" property `sort" is used

orderWithHighlights
boolean
shareEntries
boolean
size
string <optional>
Enum: "S" "M" "L"

Default: "S"

Array of objects

only one property per entry allowed; property enums: "createdAt" "id" "lastModified" "position" or "data.{{itemID}}" of subtype TextDateTime, TextNumber or TextPlainLine; value enums: "ASC" "DESC"

Responses

Request samples

Content type
application/json
{
  • "allowChat": true,
  • "fieldHeaderImage": "string",
  • "fieldPrimary": "string",
  • "fieldSecondary": "string",
  • "headlineItems": [
    ],
  • "layout": "ColumnSingle",
  • "order": "Alphabetical",
  • "orderWithHighlights": true,
  • "shareEntries": true,
  • "size": "S",
  • "sort": [
    ]
}

Response samples

Content type
application/json
{
  • "allowChat": true,
  • "fieldHeaderImage": "string",
  • "fieldPrimary": "string",
  • "fieldSecondary": "string",
  • "headlineItems": [
    ],
  • "layout": "ColumnSingle",
  • "order": "Alphabetical",
  • "orderWithHighlights": true,
  • "shareEntries": true,
  • "size": "S",
  • "sort": [
    ]
}

Get directory row access configuration

This endpoint returns the access configuration for the requested directory row.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Row ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "access": {
    },
  • "accessEditAllowed": true
}

Update directory row access configuration

This endpoint updates the access configuration for the requested directory row. Only the changes should be transmitted due this endpoint.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Row ID

header Parameters
Session
required
string

JWT

Request Body schema: application/json

changed access rights

object

accountId to operation; null for operation removes access

any
string or null
Enum: "Read" "Write" "Delete" "Create" "changeProof"

Delete (includes) Write (includes) Read; null for operation removes access

object

groupId to operation; null for operation removes access

user
string or null
Enum: "Read" "Write" "Delete" "Create" "changeProof"

Delete (includes) Write (includes) Read; null for operation removes access

Responses

Request samples

Content type
application/json
{
  • "accounts": {
    },
  • "any": "Read",
  • "groups": {
    },
  • "user": "Read"
}

Response samples

Content type
application/json
{
  • "accounts": {
    },
  • "any": "Read",
  • "groups": {
    },
  • "user": "Read"
}

Copy directory

This endpoint is for coping a directory. In case of response status is 205 the request was performed correctly, but the server was not able to send the response data. Use GET to receive the stored configuration.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Directory ID

header Parameters
Session
required
string

JWT

Request Body schema: application/json

directory to be copied

contentRowIds
Array of strings or null <optional>

content row ids to be copied with directory; null for copy all content; [] for no copy content

title
string

Responses

Request samples

Content type
application/json
{
  • "contentRowIds": [
    ],
  • "title": "string"
}

Response samples

Content type
application/json
{
  • "access": {
    },
  • "accessEditAllowed": true,
  • "contentRowFilter": {
    },
  • "contentRowObjectType": "Account",
  • "contentRowsCount": 0,
  • "createAccesses": {
    },
  • "description": "string",
  • "detail": {
    },
  • "id": "string",
  • "isSystem": true,
  • "items": [
    ],
  • "listSettings": {
    },
  • "projectId": "string",
  • "selections": [
    ],
  • "title": "string",
  • "type": "Account",
  • "typeReferenceId": "string"
}

Get directory

This endpoint returns a localized directory in administrative representation by given id.

DateTime formats:

  • "DateOnly": "2006-01-02"
  • "DateTime": "2006-01-02 15:04:05"
  • "RFC822X": "02 Jan 06 15:04"
  • "RFC1123X": "Mon, 02 Jan 2006 15:04"
  • "RFC1123DateOnly": "Mon, 02 Jan 2006"
  • "TimeOnlyX": "15:04"

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Directory ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "access": {
    },
  • "accessEditAllowed": true,
  • "contentRowFilter": {
    },
  • "contentRowObjectType": "Account",
  • "contentRowsCount": 0,
  • "createAccesses": {
    },
  • "description": "string",
  • "detail": {
    },
  • "id": "string",
  • "isSystem": true,
  • "items": [
    ],
  • "listSettings": {
    },
  • "projectId": "string",
  • "selections": [
    ],
  • "title": "string",
  • "type": "Account",
  • "typeReferenceId": "string"
}

Delete directory

This endpoint is for deleting a directory with all localizations.

Note: if isSystem = true the directory is not deletable, api call will result in a http 409

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Directory ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "status": "ok"
}

Update directory info

This endpoint is for updating the base info of an existing directory. System directories have limited patch support

Supported objectTypes for contentRowFilter:

  • contentRowObjectType = "Account" supported objectTypes: "Group"

createAccesses.DirectoryContentRow.any: must be false; true currently not supported

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Directory ID

header Parameters
Session
required
string

JWT

Request Body schema: application/json

directory information to be updated

object or null

see route description for additional information, readonly for system directories

object

property enums: "DirectoryContentRow"; see route description for additional information

description
string

readonly for system directories

title
string

Responses

Request samples

Content type
application/json
{
  • "contentRowFilter": {
    },
  • "createAccesses": {
    },
  • "description": "string",
  • "title": "string"
}

Response samples

Content type
application/json
{
  • "access": {
    },
  • "accessEditAllowed": true,
  • "contentRowFilter": {
    },
  • "contentRowObjectType": "Account",
  • "contentRowsCount": 0,
  • "createAccesses": {
    },
  • "description": "string",
  • "detail": {
    },
  • "id": "string",
  • "isSystem": true,
  • "items": [
    ],
  • "listSettings": {
    },
  • "projectId": "string",
  • "selections": [
    ],
  • "title": "string",
  • "type": "Account",
  • "typeReferenceId": "string"
}

Get directory list for project

This endpoint is for retrieving all directories of a project in admin representation. If a limit is set, a cursor for this endpoint may be created to iterate over all directories.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Project ID

query Parameters
cursor
string

id of the cursor used for pagination; required if page is set

limit
integer

amount of results per page (1 ... 100)

page
integer

current page index of the cursor used for pagination; required if cursor is set

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Create cursor

This endpoint returns a cursor for list directories in admin representation with applied filter and sort options. In case of cursor response total will be 0 the status 204 with not content is returned instead.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

header Parameters
Session
required
string

JWT

Request Body schema: application/json

options to create cursor

object (directory.CursorFilterOptionAdmin)
Array of objects

only one property per entry allowed; property enums: "id" "lastModified"; value enums: "ASC" "DESC"

Responses

Request samples

Content type
application/json
{
  • "filter": {
    },
  • "sort": [
    ]
}

Response samples

Content type
application/json
{
  • "cursor": "string",
  • "endpoints": [
    ],
  • "expiredAt": 0,
  • "total": 0
}

Get directory detail view

This endpoint is for retrieving the detail config, items and selections of a directory

DateTime formats:

  • "DateOnly": "2006-01-02"
  • "DateTime": "2006-01-02 15:04:05"
  • "RFC822X": "02 Jan 06 15:04"
  • "RFC1123X": "Mon, 02 Jan 2006 15:04"
  • "RFC1123DateOnly": "Mon, 02 Jan 2006"
  • "TimeOnlyX": "15:04"

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Directory ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "detail": {
    },
  • "items": [
    ],
  • "selections": [
    ]
}

Update directory detail view

This endpoint is for updating the detail of an existing directory. New Items need a client generated unique id for setting reference in detail. client generated id will be changed from server so item ids in response will differ!

DateTime formats:

  • "DateOnly": "2006-01-02"
  • "DateTime": "2006-01-02 15:04:05"
  • "RFC822X": "02 Jan 06 15:04"
  • "RFC1123X": "Mon, 02 Jan 2006 15:04"
  • "RFC1123DateOnly": "Mon, 02 Jan 2006"
  • "TimeOnlyX": "15:04"

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Directory ID

header Parameters
Session
required
string

JWT

Request Body schema: application/json

detail to be updated

object (directory.RequestDetailPart)
Array of objects (directory.RequestItem)
Array of objects (directory.RequestDirectorySelection)

Responses

Request samples

Content type
application/json
{
  • "detail": {
    },
  • "items": [
    ],
  • "selections": [
    ]
}

Response samples

Content type
application/json
{
  • "detail": {
    },
  • "items": [
    ],
  • "selections": [
    ]
}

Get directory content rows list

This endpoint is for retrieving all content rows of the requested directory in admin representation. If directory has no items defined, output for dynamic directories will be empty. If a limit is set, a cursor for this endpoint may be created to iterate over all content rows.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Directory ID

query Parameters
cursor
string

id of the cursor used for pagination; required if page is set

limit
integer

amount of results per page (1 ... 100)

page
integer

current page index of the cursor used for pagination; required if cursor is set

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Add directory content rows

This endpoint is for adding new content rows to the requested static directory. For dynamic directories no content can be added in this way. In case of response status is 205 the request was only executed partial. Use GET to receive the stored configuration.

Note: rows for dynamic directory (contentRowObjectType != null) are not creatable here. Status 409 Conflict will be returned.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Directory ID

header Parameters
Session
required
string

JWT

Request Body schema: application/json

directory content rows to create; max 100 elements are permitted per request

Array
object (model.Access)
Array of objects (content.RowValueRequest)
featured
boolean
keywordIds
Array of strings <optional>

Default: []

position
integer

Responses

Request samples

Content type
application/json
[
  • {
    }
]

Response samples

Content type
application/json
[
  • {
    }
]

Get directory content row

This endpoint is for retrieving a content row of a directory.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Row ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "access": {
    },
  • "accessEditAllowed": true,
  • "createdAt": 0,
  • "creator": "string",
  • "data": [
    ],
  • "directoryId": "string",
  • "featured": true,
  • "id": "string",
  • "keywordIds": [
    ],
  • "lastModified": 0,
  • "position": 0
}

Update directory content row

This endpoint is for updating a directory content row by row ID.

Note: rows for dynamic directory (contentRowObjectType != null) are not changeable here. Status 409 Conflict will be returned.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Row ID

header Parameters
Session
required
string

JWT

Request Body schema: application/json

directory content row to be replaced

Array of objects (content.RowValueRequest)
featured
boolean
keywordIds
Array of strings <optional>

Default: []

position
integer

Responses

Request samples

Content type
application/json
{
  • "data": [
    ],
  • "featured": true,
  • "keywordIds": [
    ],
  • "position": 0
}

Response samples

Content type
application/json
{
  • "access": {
    },
  • "accessEditAllowed": true,
  • "createdAt": 0,
  • "creator": "string",
  • "data": [
    ],
  • "directoryId": "string",
  • "featured": true,
  • "id": "string",
  • "keywordIds": [
    ],
  • "lastModified": 0,
  • "position": 0
}

Delete directory content row

This endpoint is for deleting a directory content row.

Note: rows for dynamic directory (contentRowObjectType != null) are not deletable here. Status 409 Conflict will be returned.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Row ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "status": "ok"
}

Directory (Default)

Add directory content row

This endpoint is for adding new a new content row to the requested static directory. For dynamic directories no content can be added in this way.

Note: rows for dynamic directory (contentRowObjectType != null) are not creatable here. Status 409 Conflict will be returned.

Note: data.translations will be always empty. Translation takes places async. Call GET /directory/default/row/{rowId} to check for translation later.

accessible without permission

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Directory ID

header Parameters
Session
required
string

JWT

Request Body schema: application/json

directory content row to create

Array of objects (content.RowValueRequest)

Responses

Request samples

Content type
application/json
{
  • "data": [
    ]
}

Response samples

Content type
application/json
{
  • "createdAt": 0,
  • "creator": "string",
  • "data": [
    ],
  • "directoryId": "string",
  • "featured": true,
  • "id": "string",
  • "keywordIds": [
    ],
  • "lastModified": 0,
  • "position": 0
}

Get directory content row

This endpoint is for retrieving a content row of a directory. If the requested language is not available it will fall back to the default language.

accessible without permission

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Row ID

header Parameters
Accept-Language
string

client language(s)

Session
string

JWT

Responses

Response samples

Content type
application/json
{
  • "createdAt": 0,
  • "creator": "string",
  • "data": [
    ],
  • "directoryId": "string",
  • "featured": true,
  • "id": "string",
  • "keywordIds": [
    ],
  • "lastModified": 0,
  • "position": 0
}

Update directory content row

This endpoint is for updating a directory content row by row ID. If the requested language is not available it will fall back to the default language.

Note: rows for dynamic directory (contentRowObjectType != null) are not changeable here. Status 409 Conflict will be returned.

Note: data.translations may not hold data. Translation takes places async. Call GET /directory/default/row/{id} to check for translation again later.

accessible without permission

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Row ID

header Parameters
Accept-Language
string

client language(s)

Session
string

JWT

Request Body schema: application/json

directory content row to be replaced

Array of objects (content.RowValueRequest)

Responses

Request samples

Content type
application/json
{
  • "data": [
    ]
}

Response samples

Content type
application/json
{
  • "createdAt": 0,
  • "creator": "string",
  • "data": [
    ],
  • "directoryId": "string",
  • "featured": true,
  • "id": "string",
  • "keywordIds": [
    ],
  • "lastModified": 0,
  • "position": 0
}

Delete directory content row

This endpoint is for deleting a directory content row.

Note: rows for dynamic directory (contentRowObjectType != null) are not deletable here. Status 409 Conflict will be returned.

accessible without permission

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Row ID

header Parameters
Session
string

JWT

Responses

Response samples

Content type
application/json
{
  • "status": "ok"
}

Get directory

This endpoint returns a localized directory in default user representation by given id. If the requested language is not available it will fall back to the default language.

DateTime formats:

  • "DateOnly": "2006-01-02"
  • "DateTime": "2006-01-02 15:04:05"
  • "RFC822X": "02 Jan 06 15:04"
  • "RFC1123X": "Mon, 02 Jan 2006 15:04"
  • "RFC1123DateOnly": "Mon, 02 Jan 2006"
  • "TimeOnlyX": "15:04"

Note: when the property sort does not have any elements than order will not be "Custom"

accessible without permission

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Directory ID

header Parameters
Accept-Language
string

client language(s)

Session
string

JWT

Responses

Response samples

Content type
application/json
{
  • "createRows": true,
  • "detail": {
    },
  • "id": "string",
  • "items": [
    ],
  • "listSettings": {
    },
  • "projectId": "string",
  • "selections": [
    ],
  • "title": "string",
  • "translations": [
    ],
  • "type": "Account"
}

Get directory content rows list

This endpoint is for retrieving all content rows of the requested directory in default representation. If directory has no items defined, output for dynamic directories will be empty. If the requested language is not available it will fall back to the default language. If a limit is set, a cursor for this endpoint may be created to iterate over all content rows.

accessible without permission

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Directory ID

query Parameters
cursor
string

id of the cursor used for pagination; required if page is set

limit
integer

amount of results per page (1 ... 100)

page
integer

current page index of the cursor used for pagination; required if cursor is set

header Parameters
Accept-Language
string

client language(s)

Session
string

JWT

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Email (Admin)

Test email content

This endpoint is for testing email data.

Note: email will send without attachments if attachments exceed limit of 16MiB (16.7MB)

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

header Parameters
Session
required
string

JWT

Accept-Language
string

client language(s)

Request Body schema: application/json

email data to be tested

attachments
Array of strings

media ids; currently not translatable

emailBody
string
emailReplyTo
string or null

currently not translatable

emailSenderName
string <= 100 characters

max 100 characters; currently not translatable

language
string <optional>

if no language is selected the email will be sent for the default language of the system

previewLine
string <= 90 characters

max 90 characters

projectId
string or null
object (model.NotificationRecipients)
subject
string <= 255 characters

max 255 characters

Responses

Request samples

Content type
application/json
{
  • "attachments": [
    ],
  • "emailBody": "string",
  • "emailReplyTo": "string",
  • "emailSenderName": "string",
  • "language": "string",
  • "previewLine": "string",
  • "projectId": "string",
  • "recipients": {
    },
  • "subject": "string"
}

Response samples

Content type
application/json
{
  • "status": "ok"
}

Get email

This endpoint returns email in admin representation.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Email ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "attachments": [
    ],
  • "createdAt": 0,
  • "creator": "string",
  • "emailBody": "string",
  • "emailEditorConfig": "string",
  • "emailReplyTo": "string",
  • "emailSenderName": "string",
  • "id": "string",
  • "isPublished": true,
  • "previewLine": "string",
  • "projectId": "string",
  • "publishedAt": 0,
  • "recipientGroups": [
    ],
  • "subject": "string",
  • "timeZone": "Europe/Berlin",
  • "type": "Email"
}

Delete email

This endpoint is for deleting an email with all localizations.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Email ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "status": "ok"
}

Update email

This endpoint is for updating email.

If the email is already published, it cannot be updated.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Email ID

header Parameters
Session
required
string

JWT

Request Body schema: application/json

email information to be updated

attachments
Array of strings

media ids; currently not translatable

emailBody
string
emailEditorConfig
string
emailReplyTo
string or null

currently not translatable

emailSenderName
string <= 100 characters

max 100 characters; currently not translatable

previewLine
string <= 90 characters

max 90 characters

publishedAt
integer or null

0 = now

recipientGroups
Array of strings or null

null = sent to everyone; group ids must belong to provided project id

subject
string <= 255 characters

max 255 characters

timeZone
string

IANA Time Zone

Responses

Request samples

Content type
application/json
{
  • "attachments": [
    ],
  • "emailBody": "string",
  • "emailEditorConfig": "string",
  • "emailReplyTo": "string",
  • "emailSenderName": "string",
  • "previewLine": "string",
  • "publishedAt": 0,
  • "recipientGroups": [
    ],
  • "subject": "string",
  • "timeZone": "string"
}

Response samples

Content type
application/json
{
  • "attachments": [
    ],
  • "createdAt": 0,
  • "creator": "string",
  • "emailBody": "string",
  • "emailEditorConfig": "string",
  • "emailReplyTo": "string",
  • "emailSenderName": "string",
  • "id": "string",
  • "isPublished": true,
  • "previewLine": "string",
  • "projectId": "string",
  • "publishedAt": 0,
  • "recipientGroups": [
    ],
  • "subject": "string",
  • "timeZone": "Europe/Berlin",
  • "type": "Email"
}

Get all project emails

This endpoint returns all emails in admin representation for a project. If a limit is set, a cursor for this endpoint may be created to iterate over all emails.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Project ID

query Parameters
cursor
string

id of the cursor used for pagination; required if page is set

limit
integer

amount of results per page (1 ... 100)

page
integer

current page index of the cursor used for pagination; required if cursor is set

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Create email

This endpoint is for creating a new email.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

header Parameters
Session
required
string

JWT

Request Body schema: application/json

email to create

attachments
Array of strings

media ids; currently not translatable

emailBody
string
emailEditorConfig
string
emailReplyTo
string or null

currently not translatable

emailSenderName
string <= 100 characters

max 100 characters; currently not translatable

previewLine
string <= 90 characters

max 90 characters

projectId
string or null
publishedAt
integer or null

0 = now

recipientGroups
Array of strings or null

null = sent to everyone; group ids must belong to provided project id

subject
string <= 255 characters

max 255 characters

timeZone
string

IANA Time Zone

Responses

Request samples

Content type
application/json
{
  • "attachments": [
    ],
  • "emailBody": "string",
  • "emailEditorConfig": "string",
  • "emailReplyTo": "string",
  • "emailSenderName": "string",
  • "previewLine": "string",
  • "projectId": "string",
  • "publishedAt": 0,
  • "recipientGroups": [
    ],
  • "subject": "string",
  • "timeZone": "string"
}

Response samples

Content type
application/json
{
  • "attachments": [
    ],
  • "createdAt": 0,
  • "creator": "string",
  • "emailBody": "string",
  • "emailEditorConfig": "string",
  • "emailReplyTo": "string",
  • "emailSenderName": "string",
  • "id": "string",
  • "isPublished": true,
  • "previewLine": "string",
  • "projectId": "string",
  • "publishedAt": 0,
  • "recipientGroups": [
    ],
  • "subject": "string",
  • "timeZone": "Europe/Berlin",
  • "type": "Email"
}

Group

Get group

This endpoint returns group by given id with all additional information.

only accessible with permission : "ManageAccounts" "ManageContent" "ManageGlobalMedia" "ManageProjects"

fully accessible with permission : "ManageAccounts" "ManageContent" "ManageGlobalMedia" "ManageProjects"

path Parameters
id
required
string

Group ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "accounts": [
    ],
  • "id": "string",
  • "isSystem": true,
  • "parentId": "string",
  • "position": 0,
  • "projectId": "string",
  • "title": "string",
  • "type": "Custom"
}

Delete group

This endpoint is for deleting a specific group. If a group has children, the child will remain at the place the deleted parent group was before.

Note: if isSystem = true the group is immutable, api call will result in a http 409

only accessible with permission : "ManageAccounts"

fully accessible with permission : "ManageAccounts"

path Parameters
id
required
string

Group ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "status": "ok"
}

Update group

This endpoint is for updating a group.

Note: if isSystem = true the group is immutable, api call will result in a http 409

only accessible with permission : "ManageAccounts"

fully accessible with permission : "ManageAccounts"

path Parameters
id
required
string

Group ID

header Parameters
Session
required
string

JWT

Request Body schema: application/json

group data to update

parentId
string or null
position
integer >= 0
title
string

must match regex /^([^,\s]|[^,\s][^,]*[^,\s])$/

Responses

Request samples

Content type
application/json
{
  • "parentId": "string",
  • "position": 0,
  • "title": "string"
}

Response samples

Content type
application/json
{
  • "accounts": [
    ],
  • "id": "string",
  • "isSystem": true,
  • "parentId": "string",
  • "position": 0,
  • "projectId": "string",
  • "title": "string",
  • "type": "Custom"
}

Get accounts of group

This endpoint returns all account ids for a specific group.

only accessible with permission : "ManageAccounts" "ManageContent" "ManageGlobalMedia" "ManageProjects"

fully accessible with permission : "ManageAccounts" "ManageContent" "ManageGlobalMedia" "ManageProjects"

path Parameters
id
required
string

Group ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
[
  • "string"
]

add accounts to group

This endpoint adds accounts to a specific group.

Note: if isSystem = true the group is immutable, api call will result in a http 409

only accessible with permission : "ManageAccounts"

fully accessible with permission : "ManageAccounts"

path Parameters
id
required
string

Group ID

header Parameters
Session
required
string

JWT

Request Body schema: application/json

account ids

Array
string

Responses

Request samples

Content type
application/json
[
  • "string"
]

Response samples

Content type
application/json
[
  • "string"
]

remove accounts from group

This endpoint removes accounts from a specific group.

Note: if isSystem = true the group is immutable, api call will result in a http 409

only accessible with permission : "ManageAccounts"

fully accessible with permission : "ManageAccounts"

path Parameters
id
required
string

Group ID

header Parameters
Session
required
string

JWT

Request Body schema: application/json

account ids

Array
string

Responses

Request samples

Content type
application/json
[
  • "string"
]

Response samples

Content type
application/json
[
  • "string"
]

Get group list

This endpoint returns a list of all existing groups. If a limit is set, a cursor for this endpoint may be created to iterate over all groups.

only accessible with permission : "ManageAccounts"

fully accessible with permission : "ManageAccounts"

query Parameters
cursor
string

id of the cursor used for pagination; required if page is set

limit
integer

amount of results per page (1 ... 100)

page
integer

current page index of the cursor used for pagination; required if cursor is set

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Create group

This endpoint is for creating a new group.

only accessible with permission : "ManageAccounts"

fully accessible with permission : "ManageAccounts"

header Parameters
Session
required
string

JWT

Request Body schema: application/json

group data to create

accounts
Array of strings
parentId
string or null
position
integer >= 0
projectId
string
title
string

must match regex /^([^,\s]|[^,\s][^,]*[^,\s])$/

Responses

Request samples

Content type
application/json
{
  • "accounts": [
    ],
  • "parentId": "string",
  • "position": 0,
  • "projectId": "string",
  • "title": "string"
}

Response samples

Content type
application/json
{
  • "accounts": [
    ],
  • "id": "string",
  • "isSystem": true,
  • "parentId": "string",
  • "position": 0,
  • "projectId": "string",
  • "title": "string",
  • "type": "Custom"
}

Get group list for project

This endpoint returns a list of all groups for the requested project. If a limit is set, a cursor for this endpoint may be created to iterate over all groups.

only accessible with permission : "ManageAccounts" "ManageContent" "ManageGlobalMedia" "ManageProjects"

fully accessible with permission : "ManageAccounts" "ManageContent" "ManageGlobalMedia" "ManageProjects"

path Parameters
id
required
string

Project ID

query Parameters
cursor
string

id of the cursor used for pagination; required if page is set

limit
integer

amount of results per page (1 ... 100)

page
integer

current page index of the cursor used for pagination; required if cursor is set

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
[
  • {
    }
]

I18n (Admin)

Reset localizations

This endpoint updates all localizations in the system for the provided language to the default value if the localization is customized and not deprecated.

only accessible with permission : "ManageConfiguration"

fully accessible with permission : "ManageConfiguration"

path Parameters
id
required
string

Language code in format: IETF BCP 47

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get localization

This endpoint returns a localization in administrative representation by given id.

only accessible with permission : "ManageConfiguration"

fully accessible with permission : "ManageConfiguration"

path Parameters
id
required
string

Localization ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "autoTranslated": true,
  • "description": "string",
  • "id": "string",
  • "isCustomized": true,
  • "isDeprecated": true,
  • "key": "string",
  • "langCode": "string",
  • "langVariant": "string",
  • "lastModified": 0,
  • "placeholders": [
    ],
  • "value": "string"
}

Update localization

This endpoint updates a localization in the system by given id.

only accessible with permission : "ManageConfiguration"

fully accessible with permission : "ManageConfiguration"

path Parameters
id
required
string

Localization ID

header Parameters
Session
required
string

JWT

Request Body schema: application/json

localization data to be updated

value
string

Responses

Request samples

Content type
application/json
{
  • "value": "string"
}

Response samples

Content type
application/json
{
  • "autoTranslated": true,
  • "description": "string",
  • "id": "string",
  • "isCustomized": true,
  • "isDeprecated": true,
  • "key": "string",
  • "langCode": "string",
  • "langVariant": "string",
  • "lastModified": 0,
  • "placeholders": [
    ],
  • "value": "string"
}

Get glossary

This endpoint returns all glossary entries.

only accessible with permission : "ManageConfiguration"

fully accessible with permission : "ManageConfiguration"

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Create glossary entry

This endpoint creates a single glossary entry.

only accessible with permission : "ManageConfiguration"

fully accessible with permission : "ManageConfiguration"

header Parameters
Session
required
string

JWT

Request Body schema: application/json

Entry to be created

object

key: language, value: translation -> not all languages have to be provided, min 2 entries

Responses

Request samples

Content type
application/json
{
  • "translations": {
    }
}

Response samples

Content type
application/json
{
  • "id": "string",
  • "translations": {
    }
}

Create cursor

This endpoint returns a cursor for list localizations in admin representation with applied filter and sort options. In case of cursor response total will be 0 the status 204 with not content is returned instead.

only accessible with permission : "ManageConfiguration"

fully accessible with permission : "ManageConfiguration"

header Parameters
Session
required
string

JWT

Request Body schema: application/json

options to create cursor

object (localization.CursorFilterOptionAdmin)
Array of objects

only one property per entry allowed; property enums: "key" "langCode" "lastModified"; value enums: "ASC" "DESC"

Responses

Request samples

Content type
application/json
{
  • "filter": {
    },
  • "sort": [
    ]
}

Response samples

Content type
application/json
{
  • "cursor": "string",
  • "endpoints": [
    ],
  • "expiredAt": 0,
  • "total": 0
}

Reset localization

This endpoint updates a localization in the system to the default value if the localization is customized and not deprecated. It will send status 409 if localization is deprecated.

only accessible with permission : "ManageConfiguration"

fully accessible with permission : "ManageConfiguration"

path Parameters
id
required
string

Localization ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "autoTranslated": true,
  • "description": "string",
  • "id": "string",
  • "isCustomized": true,
  • "isDeprecated": true,
  • "key": "string",
  • "langCode": "string",
  • "langVariant": "string",
  • "lastModified": 0,
  • "placeholders": [
    ],
  • "value": "string"
}

Get localization keys

This endpoint returns a list of localization keys.

Cursor could be created here: POST /config/admin/localization/search

accessible without permission

query Parameters
cursor
string

id of the cursor used for pagination; required if page is set

page
integer

current page index of the cursor used for pagination; required if cursor is set

limit
integer

amount of results per page (1 ... 100)

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
[
  • "string"
]

Get localizations for cursor

This endpoint returns a list of all localizations for a cursor in administrative representation.

Cursor could be created here: POST /config/admin/localization/search

accessible without permission

query Parameters
cursor
required
string

id of the cursor used for pagination; required if page is set

page
required
integer

current page index of the cursor used for pagination; required if cursor is set

limit
integer

amount of results per page (1 ... 100)

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get glossary entry

This endpoint returns a single glossary entry for provided id.

only accessible with permission : "ManageConfiguration"

fully accessible with permission : "ManageConfiguration"

path Parameters
id
required
string

Entry ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "id": "string",
  • "translations": {
    }
}

Update glossary entry

This endpoint updates a single glossary entry.

only accessible with permission : "ManageConfiguration"

fully accessible with permission : "ManageConfiguration"

path Parameters
id
required
string

Entry ID

header Parameters
Session
required
string

JWT

Request Body schema: application/json

Entry to be updated

object

key: language, value: translation -> not all languages have to be provided, min 2 entries

Responses

Request samples

Content type
application/json
{
  • "translations": {
    }
}

Response samples

Content type
application/json
{
  • "id": "string",
  • "translations": {
    }
}

Delete glossary entry

This endpoint deletes a single glossary entry for provided id.

only accessible with permission : "ManageConfiguration"

fully accessible with permission : "ManageConfiguration"

path Parameters
id
required
string

Entry ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "status": "ok"
}

Get language

This endpoint returns a language in administrative representation by given id.

only accessible with permission : "ManageConfiguration"

fully accessible with permission : "ManageConfiguration"

path Parameters
id
required
string

Language code in format: IETF BCP 47

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "autoTranslated": true,
  • "id": "string",
  • "isDefault": true,
  • "lastModified": 0,
  • "status": "Draft",
  • "variantCurrent": "string",
  • "variants": [
    ]
}

Update language

This endpoint updates a language in the system by given id. The default language must be published. Status of languages could only be changed if auto translation is activated. To switch the default language, use the following endpoint: PUT /config/admin/language/default

Note: Auto translations is a premium feature and requires a valid subscription.

only accessible with permission : "ManageConfiguration"

fully accessible with permission : "ManageConfiguration"

path Parameters
id
required
string

Language code in format: IETF BCP 47

header Parameters
Session
required
string

JWT

Request Body schema: application/json

language data to be updated

status
string
Enum: "Draft" "Published"
variantCurrent
string

entry of variants list from the language

Responses

Request samples

Content type
application/json
{
  • "status": "Draft",
  • "variantCurrent": "string"
}

Response samples

Content type
application/json
{
  • "autoTranslated": true,
  • "id": "string",
  • "isDefault": true,
  • "lastModified": 0,
  • "status": "Draft",
  • "variantCurrent": "string",
  • "variants": [
    ]
}

Get localizations of language

This endpoint returns a localizations in administrative representation by given language.

only accessible with permission : "ManageConfiguration"

fully accessible with permission : "ManageConfiguration"

path Parameters
id
required
string

Language code in format: IETF BCP 47

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get languages

This endpoint returns all available languages in administrative representation.

only accessible with permission : "ManageConfiguration"

fully accessible with permission : "ManageConfiguration"

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Update default language

This endpoint updates the default language in the system. The default language will be published automatically. If auto translation is disabled, the current default language will be set to Draft.

only accessible with permission : "ManageConfiguration"

fully accessible with permission : "ManageConfiguration"

header Parameters
Session
required
string

JWT

Request Body schema: application/json

configuration for default language

id
string

the ID is the language code in format: IETF BCP 47

Responses

Request samples

Content type
application/json
{
  • "id": "string"
}

Response samples

Content type
application/json
{
  • "status": "ok"
}

I18n (Default)

Get languages

This endpoint returns all published languages in default representation.

accessible without permission

fully accessible with permission : "ManageConfiguration"

header Parameters
Session
string

JWT

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get localizations

This endpoint returns all localizations either in provided or default language in default representation.

accessible without permission

fully accessible with permission : "ManageConfiguration"

header Parameters
Accept-Language
string

client language(s)

Session
string

JWT

Responses

Response samples

Content type
application/json
{
  • "property1": "string",
  • "property2": "string"
}

Index (Admin)

Get index items for cursor

This endpoint returns a list of all index items for a cursor in administrative representation.

Cursor could be created here: POST /index/admin/search

accessible without permission

query Parameters
cursor
required
string

id of the cursor used for pagination; required if page is set

page
required
integer

current page index of the cursor used for pagination; required if cursor is set

limit
integer

amount of results per page (1 ... 100)

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get linked items

This endpoint is for requesting all linked items for a specific object. If a limit is set, a cursor for this endpoint may be created to iterate over all linked items.

accessible without permission

fully accessible with permission : "ManageContent" "ManageGlobalMedia" "ManageProjects"

path Parameters
objectType
required
string
Enum: "Account" "Calendar" "CalendarEntry" "ChatFeed" "Directory" "DirectoryContentRow" "Group" "Keyword" "Location" "LocationMap" "MediaAudio" "MediaDocument" "MediaFolder" "MediaIcon" "MediaImage" "MediaOther" "MediaVideo" "Menu" "News" "Page" "Project" "Scheme" "Stream"

object type

objectId
required
string

object ID

query Parameters
cursor
string

id of the cursor used for pagination; required if page is set

limit
integer

amount of results per page (1 ... 100)

page
integer

current page index of the cursor used for pagination; required if cursor is set

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Create cursor

This endpoint returns a cursor for list index items in admin representation with applied filter and sort options. private items will not be part of the result. In case of cursor response total will be 0 the status 204 with not content is returned instead.

accessible without permission

fully accessible with permission : "ManageAccounts" "ManageContent" "ManageGlobalMedia" "ManageProjects" (depending on requested object type)

header Parameters
Session
required
string

JWT

Request Body schema: application/json

search criteria to create cursor

object (model.Search)
Array of objects

only one property per entry allowed; property enums: "lastModified" "objectId" "objectType" "projectId" "referenceId" "title"; value enums: "ASC" "DESC"

Responses

Request samples

Content type
application/json
{
  • "filter": {
    },
  • "sort": [
    ]
}

Response samples

Content type
application/json
{
  • "cursor": "string",
  • "endpoints": [
    ],
  • "expiredAt": 0,
  • "total": 0
}

Get index

This endpoint is for requesting a specific index items.

accessible without permission

fully accessible with permission : "ManageAccounts" "ManageContent" "ManageGlobalMedia" "ManageProjects" (depending on requested object type)

path Parameters
objectType
required
string
Enum: "Account" "Calendar" "CalendarEntry" "ChatFeed" "Directory" "DirectoryContentRow" "Group" "Keyword" "Location" "LocationMap" "MediaAudio" "MediaDocument" "MediaFolder" "MediaIcon" "MediaImage" "MediaOther" "MediaVideo" "Menu" "News" "Page" "Project" "Scheme" "Stream"

object type

objectId
required
string

object ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "deeplinkUrl": "string",
  • "lastModified": 0,
  • "meta": {
    },
  • "objectId": "string",
  • "objectType": "Account",
  • "projectId": "string",
  • "projectTitle": "string",
  • "referenceId": "string",
  • "referenceTitle": "string",
  • "title": "string"
}

Index (Default)

Get linked items

This endpoint is for requesting all linked items for a specific object. If a limit is set, a cursor for this endpoint may be created to iterate over all linked items.

accessible without permission

fully accessible with permission : "ManageContent" "ManageGlobalMedia" "ManageProjects" (depending on requested object type)

path Parameters
objectType
required
string
Enum: "Account" "Calendar" "CalendarEntry" "ChatFeed" "Directory" "DirectoryContentRow" "Group" "Keyword" "Location" "LocationMap" "MediaAudio" "MediaDocument" "MediaFolder" "MediaIcon" "MediaImage" "MediaOther" "MediaVideo" "Menu" "News" "Page" "Project" "Scheme" "Stream"

object type

objectId
required
string

object ID

query Parameters
cursor
string

id of the cursor used for pagination; required if page is set

limit
integer

amount of results per page (1 ... 100)

page
integer

current page index of the cursor used for pagination; required if cursor is set

header Parameters
Accept-Language
string

client language(s)

Session
string

JWT

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get index items for cursor

This endpoint returns a list of all index items for a cursor in default representation.

Cursor could be created here: POST /index/default/search

accessible without permission

query Parameters
cursor
required
string

id of the cursor used for pagination; required if page is set

page
required
integer

current page index of the cursor used for pagination; required if cursor is set

limit
integer

amount of results per page (1 ... 100)

header Parameters
Accept-Language
string

client language(s)

Session
string

JWT

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Create cursor

This endpoint returns a cursor for list index items in default representation with applied filter and sort options. private items will not be part of the result. In case of cursor response total will be 0 the status 204 with not content is returned instead.

accessible without permission

fully accessible with permission : "ManageAccounts" "ManageContent" "ManageGlobalMedia" "ManageProjects" (depending on requested object type)

header Parameters
Accept-Language
string

client language(s)

Session
string

JWT

Request Body schema: application/json

search criteria

object (model.Search)
Array of objects

only one property per entry allowed; property enums: "lastModified" "objectId" "objectType" "projectId" "referenceId" "title"; value enums: "ASC" "DESC"

Responses

Request samples

Content type
application/json
{
  • "filter": {
    },
  • "sort": [
    ]
}

Response samples

Content type
application/json
{
  • "cursor": "string",
  • "endpoints": [
    ],
  • "expiredAt": 0,
  • "total": 0
}

Journey (Admin)

Get journey

This endpoint returns a journey in administrative representation by given id.

Note: Journeys is a premium feature and requires a valid subscription.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Journey ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "assignedCount": 0,
  • "completedCount": 0,
  • "creator": "string",
  • "id": "string",
  • "image": "string",
  • "inProgressCount": 0,
  • "lastModified": 0,
  • "notificationEnabled": true,
  • "projectId": "string",
  • "stages": [
    ],
  • "stagesCount": 0,
  • "title": "string"
}

Delete journey

This endpoint is for deleting a single journey with all localizations.

Note: Journeys is a premium feature and requires a valid subscription.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Journey ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "status": "ok"
}

Update journey

This endpoint is for updating specific data of an existing journey.

Note: Journeys is a premium feature and requires a valid subscription.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Journey ID

header Parameters
Session
required
string

JWT

Request Body schema: application/json

journey data to be updated

image
string or null

media id

notificationEnabled
boolean
title
string

Responses

Request samples

Content type
application/json
{
  • "image": "string",
  • "notificationEnabled": true,
  • "title": "string"
}

Response samples

Content type
application/json
{
  • "assignedCount": 0,
  • "completedCount": 0,
  • "creator": "string",
  • "id": "string",
  • "image": "string",
  • "inProgressCount": 0,
  • "lastModified": 0,
  • "notificationEnabled": true,
  • "projectId": "string",
  • "stages": [
    ],
  • "stagesCount": 0,
  • "title": "string"
}

Get journey process

This endpoint returns one specific journey processes in admin representation.

Note: Journeys is a premium feature and requires a valid subscription.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Process ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "accountId": "string",
  • "completedAt": 0,
  • "createdAt": 0,
  • "creator": "string",
  • "id": "string",
  • "journeyId": "string",
  • "processId": "string",
  • "stageStatus": {
    },
  • "stagesCompleted": [
    ],
  • "stagesCount": 0,
  • "stagesRunning": [
    ],
  • "stagesUpcoming": [
    ],
  • "startDate": "2006-01-02",
  • "status": "Completed"
}

Get journey list for project

This endpoint returns a list of all journeys for the requested project without items in administrative representation. If a limit is set, a cursor for this endpoint may be created to iterate over all journeys.

Note: Journeys is a premium feature and requires a valid subscription.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
projectId
required
string

Project ID

query Parameters
cursor
string

id of the cursor used for pagination; required if page is set

limit
integer

amount of results per page (1 ... 100)

page
integer

current page index of the cursor used for pagination; required if cursor is set

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get journey processes of account

This endpoint returns all journey processes of a specific account for a specific journey in admin representation.

Note: Journeys is a premium feature and requires a valid subscription.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Journey ID

accountId
required
string

Account ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Create journey

This endpoint is for creating a new journey.

Note: Journeys is a premium feature and requires a valid subscription.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

header Parameters
Session
required
string

JWT

Request Body schema: application/json

Journey to create

image
string or null

media id

notificationEnabled
boolean
projectId
string
Array of objects (journey.RequestStage)
title
string

Responses

Request samples

Content type
application/json
{
  • "image": "string",
  • "notificationEnabled": true,
  • "projectId": "string",
  • "stages": [
    ],
  • "title": "string"
}

Response samples

Content type
application/json
{
  • "assignedCount": 0,
  • "completedCount": 0,
  • "creator": "string",
  • "id": "string",
  • "image": "string",
  • "inProgressCount": 0,
  • "lastModified": 0,
  • "notificationEnabled": true,
  • "projectId": "string",
  • "stages": [
    ],
  • "stagesCount": 0,
  • "title": "string"
}

Get journey processes of journey

This endpoint returns all account processes for 1 journey in admin representation.

Note: Journeys is a premium feature and requires a valid subscription.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Journey ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get attendees

This endpoint is for retrieving attendees from journey processes.

Note: Journeys is a premium feature and requires a valid subscription.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Journey ID

query Parameters
cursor
string

id of the cursor used for pagination; required if page is set

limit
integer

amount of results per page (1 ... 100)

page
integer

current page index of the cursor used for pagination; required if cursor is set

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Add attendees

This endpoint is for creating new journey processes by adding attendees.

Note: Journeys is a premium feature and requires a valid subscription.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Journey ID

header Parameters
Session
required
string

JWT

Request Body schema: application/json

Attendees to create

Array
accountId
string
startDate
string

Responses

Request samples

Content type
application/json
[
  • {
    }
]

Response samples

Content type
application/json
[
  • {
    }
]

Remove attendees

This endpoint is for removing journey processes.

Note: when no query parameter is set, all attendees will be removed.

Note: Journeys is a premium feature and requires a valid subscription.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Journey ID

query Parameters
ids
string

account ids to be removed from journey

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "status": "ok"
}

Update attendees

This endpoint is for updating journey processes. Note: when no query parameter is set, all attendees will be updated.

Note: Journeys is a premium feature and requires a valid subscription.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Journey ID

query Parameters
ids
string

account ids to be updated

header Parameters
Session
required
string

JWT

Request Body schema: application/json

values to patch attendees for

startDate
string

Responses

Request samples

Content type
application/json
{
  • "startDate": "2006-01-02"
}

Response samples

Content type
application/json
{
  • "status": "ok"
}

Get all journey processes of account

This endpoint returns all journey processes for 1 account in admin representation.

Note: Journeys is a premium feature and requires a valid subscription.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
accountId
required
string

Account ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get stages

This endpoint returns the stages for a journey object in administrative representation by given id.

Note: Journeys is a premium feature and requires a valid subscription.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Journey ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Update stages

This endpoint updates the stages for a journey object in administrative representation by given id.

Note: Journeys is a premium feature and requires a valid subscription.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Journey ID

header Parameters
Session
required
string

JWT

Request Body schema: application/json

journey stages to be updated

Array
object or null
description
string

html formatted string, following tags are allowed to use: "em" "i" "strong" "b" "u" "ul" "li" "ol" "a" "p"

id
string
Array of objects (model.JourneyStageStartCondition) [ items ]

outer array OR, inner arrays AND: [[{} && {}] || [{}]]

title
string
url
string or null

Responses

Request samples

Content type
application/json
[
  • {
    }
]

Response samples

Content type
application/json
[
  • {
    }
]

Journey (Default)

Get journey stats

This endpoint returns aggregated statistics for journeys of the authenticated account.

Note: Journeys is a premium feature and requires a valid subscription.

accessible without permission

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "stagesRunningCount": 0
}

Get journey process

This endpoint returns a journey process in default representation by given journey id. If the requested language is not available it will fall back to the default language.

Note: Journeys is a premium feature and requires a valid subscription.

accessible without permission

path Parameters
id
required
string

Journey ID

header Parameters
Session
required
string

JWT

Accept-Language
string

client language(s)

Responses

Response samples

Content type
application/json
{
  • "completedAt": 0,
  • "createdAt": 0,
  • "id": "string",
  • "image": "string",
  • "journeyId": "string",
  • "nextUpcomingAt": 0,
  • "projectId": "string",
  • "stageStatus": {
    },
  • "stagesCompleted": [
    ],
  • "stagesCount": 0,
  • "stagesRunning": [
    ],
  • "stagesUpcoming": [
    ],
  • "startAt": 0,
  • "startDate": "2006-01-02",
  • "status": "Completed",
  • "title": "string",
  • "translations": [
    ]
}

Update stage status

This endpoint is for updating the status of a stage for an own journey process. If the requested language is not available it will fall back to the default language.

Note: Journeys is a premium feature and requires a valid subscription.

accessible without permission

path Parameters
id
required
string

Journey ID

stageId
required
string

Stage ID

header Parameters
Session
required
string

JWT

Accept-Language
string

client language(s)

Request Body schema: application/json

stage status information

status
string
Value: "Completed"

Responses

Request samples

Content type
application/json
{
  • "status": "Completed"
}

Response samples

Content type
application/json
{
  • "completedAt": 0,
  • "createdAt": 0,
  • "id": "string",
  • "image": "string",
  • "journeyId": "string",
  • "nextUpcomingAt": 0,
  • "projectId": "string",
  • "stageStatus": {
    },
  • "stagesCompleted": [
    ],
  • "stagesCount": 0,
  • "stagesRunning": [
    ],
  • "stagesUpcoming": [
    ],
  • "startAt": 0,
  • "startDate": "2006-01-02",
  • "status": "Completed",
  • "title": "string",
  • "translations": [
    ]
}

Create cursor

This endpoint returns a cursor for list own journeys in default representation with applied filter and sort options. In case of cursor response total will be 0 the status 204 with not content is returned instead.

Note: Journeys is a premium feature and requires a valid subscription.

accessible without permission

header Parameters
Session
required
string

JWT

Request Body schema: application/json

options to create cursor

object (journeyprocess.CursorFilterOptionDefault)
Array of objects

only one property per entry allowed; property enums: "completedAt" "createdAt" "id" "lastModified" "projectId" "startDate" "status"; value enums: "ASC" "DESC"`

Responses

Request samples

Content type
application/json
{
  • "filter": {
    },
  • "sort": [
    ]
}

Response samples

Content type
application/json
{
  • "cursor": "string",
  • "endpoints": [
    ],
  • "expiredAt": 0,
  • "total": 0
}

Get journey processes list for cursor

This endpoint returns a list of all journey processes for account without content in default representation.

Note: Journeys is a premium feature and requires a valid subscription.

Cursor could be created here: POST /reaction/default/journey/search

accessible without permission

query Parameters
cursor
string

id of the cursor used for pagination; required if page is set

page
integer

current page index of the cursor used for pagination; required if cursor is set

limit
integer

amount of results per page (1 ... 100)

header Parameters
Session
required
string

JWT

Accept-Language
string

client language(s)

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get journey

This endpoint returns a journey in default representation by given id. If the requested language is not available it will fall back to the default language.

Note: Journeys is a premium feature and requires a valid subscription.

accessible without permission

path Parameters
id
required
string

Journey ID

header Parameters
Session
required
string

JWT

Accept-Language
string

client language(s)

Responses

Response samples

Content type
application/json
{
  • "id": "string",
  • "image": "string",
  • "projectId": "string",
  • "stages": [
    ],
  • "stagesCount": 0,
  • "title": "string",
  • "translations": [
    ]
}

Keyword (Admin)

Get keyword category list

This endpoint returns a list of all keyword categories in admin representation.

accessible without permission

fully accessible with permission : "ManageProjects"

query Parameters
cursor
string

id of the cursor used for pagination; required if page is set

limit
integer

amount of results per page (1 ... 100); by default no limit (no pagination headers) currently; only allowed if cursor is not set

page
integer

current page index of the cursor used for pagination; required if cursor is set

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Create keyword category

This endpoint is for creating a new keyword category.

accessible without permission

fully accessible with permission : "ManageProjects"

header Parameters
Session
required
string

JWT

Request Body schema: application/json

keyword category to create

description
string
position
integer >= 0
object (model.KeywordCategorySettings)
title
string

Responses

Request samples

Content type
application/json
{
  • "description": "string",
  • "position": 0,
  • "settings": {
    },
  • "title": "string"
}

Response samples

Content type
application/json
{
  • "description": "string",
  • "id": "string",
  • "position": 0,
  • "settings": {
    },
  • "title": "string"
}

Get keyword list

This endpoint returns a list of all keywords in admin representation. If a limit is set, a cursor for this endpoint may be created to iterate over all keywords.

accessible without permission

fully accessible with permission : "ManageProjects"

query Parameters
cursor
string

id of the cursor used for pagination; required if page is set

limit
integer

amount of results per page (1 ... 100)

page
integer

current page index of the cursor used for pagination; required if cursor is set

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Create keyword

This endpoint is for creating a new keyword.

accessible without permission

fully accessible with permission : "ManageProjects"

header Parameters
Session
required
string

JWT

Request Body schema: application/json

keyword to create

backgroundColor
string or null <optional>

hexcolor or enum: "backgroundPrimary" "backgroundSecondary" "backgroundTertiary" "border" "contrast" "error" "primary" "secondary" "success" "textPrimary" "textSecondary"; Default: null

backgroundColorDark
string or null <optional>

hexcolor or enum: "backgroundPrimary" "backgroundSecondary" "backgroundTertiary" "border" "contrast" "error" "primary" "secondary" "success" "textPrimary" "textSecondary"; Default: null

categoryId
string or null <optional>

Default: null

projectId
string or null <optional>

Deprecated: will be removed in 6.0; must be null

title
string

Responses

Request samples

Content type
application/json
{
  • "backgroundColor": "#FFFFFF",
  • "backgroundColorDark": "#000000",
  • "categoryId": "string",
  • "projectId": "string",
  • "title": "string"
}

Response samples

Content type
application/json
{
  • "backgroundColor": "#FFFFFF",
  • "backgroundColorDark": "#000000",
  • "categoryId": "string",
  • "id": "string",
  • "projectId": "string",
  • "title": "string"
}

Get keyword category

This endpoint returns a localized keyword category by given id in admin representation.

accessible without permission

fully accessible with permission : "ManageProjects"

path Parameters
id
required
string

Category ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "description": "string",
  • "id": "string",
  • "position": 0,
  • "settings": {
    },
  • "title": "string"
}

Delete keyword category

This endpoint is for deleting a single keyword category Remove all references in keywords, do not delete keywords

accessible without permission

fully accessible with permission : "ManageProjects"

path Parameters
id
required
string

Category ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "status": "ok"
}

Update keyword category

This endpoint is for updating keyword category.

accessible without permission

fully accessible with permission : "ManageProjects"

path Parameters
id
required
string

Category ID

header Parameters
Session
required
string

JWT

Request Body schema: application/json

keyword category information to be updated

description
string
position
integer >= 0
object (model.KeywordCategorySettings)
title
string

Responses

Request samples

Content type
application/json
{
  • "description": "string",
  • "position": 0,
  • "settings": {
    },
  • "title": "string"
}

Response samples

Content type
application/json
{
  • "description": "string",
  • "id": "string",
  • "position": 0,
  • "settings": {
    },
  • "title": "string"
}

Get keyword

This endpoint returns a localized keyword by given id in admin representation.

accessible without permission

fully accessible with permission : "ManageProjects"

path Parameters
id
required
string

Keyword ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "backgroundColor": "#FFFFFF",
  • "backgroundColorDark": "#000000",
  • "categoryId": "string",
  • "id": "string",
  • "projectId": "string",
  • "title": "string"
}

Delete keyword

This endpoint is for deleting a single keyword.

accessible without permission

fully accessible with permission : "ManageProjects"

path Parameters
id
required
string

Keyword ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "status": "ok"
}

Update keyword

This endpoint is for updating keyword.

accessible without permission

fully accessible with permission : "ManageProjects"

path Parameters
id
required
string

Keyword ID

header Parameters
Session
required
string

JWT

Request Body schema: application/json

keyword information to be updated

backgroundColor
string or null

hexcolor or enum: "backgroundPrimary" "backgroundSecondary" "backgroundTertiary" "border" "contrast" "error" "primary" "secondary" "success" "textPrimary" "textSecondary"

backgroundColorDark
string or null

hexcolor or enum: "backgroundPrimary" "backgroundSecondary" "backgroundTertiary" "border" "contrast" "error" "primary" "secondary" "success" "textPrimary" "textSecondary"

categoryId
string or null
title
string

Responses

Request samples

Content type
application/json
{
  • "backgroundColor": "#FFFFFF",
  • "backgroundColorDark": "#000000",
  • "categoryId": "string",
  • "title": "string"
}

Response samples

Content type
application/json
{
  • "backgroundColor": "#FFFFFF",
  • "backgroundColorDark": "#000000",
  • "categoryId": "string",
  • "id": "string",
  • "projectId": "string",
  • "title": "string"
}

Keyword (Default)

Get keyword category

This endpoint returns a localized keyword category by given id in default representation.

accessible without permission

path Parameters
id
required
string

Category ID

Responses

Response samples

Content type
application/json
{
  • "description": "string",
  • "id": "string",
  • "position": 0,
  • "settings": {
    },
  • "title": "string",
  • "translations": [
    ]
}

Get keyword category list

This endpoint returns a list of all keyword categories in default representation.

accessible without permission

query Parameters
cursor
string

id of the cursor used for pagination; required if page is set

limit
integer

amount of results per page (1 ... 100); by default no limit (no pagination headers) currently; only allowed if cursor is not set

page
integer

current page index of the cursor used for pagination; required if cursor is set

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get keyword list

This endpoint returns a list of all keywords in default representation. If the requested language is not available it will fall back to the default language. If a limit is set, a cursor for this endpoint may be created to iterate over all keywords.

accessible without permission

query Parameters
cursor
string

id of the cursor used for pagination; required if page is set

limit
integer

amount of results per page (1 ... 100)

page
integer

current page index of the cursor used for pagination; required if cursor is set

header Parameters
Accept-Language
string

client language(s)

Session
string

JWT

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Legal (Admin)

Get legal

This endpoint returns the legal information in administrative representation. The If-Modified-Since header can be used for omitting the output if nothing has changed.

accessible without permission

fully accessible with permission : "ManageConfiguration"

header Parameters
Session
required
string

JWT

If-Modified-Since
integer

unix timestamp of the last sync

Responses

Response samples

Content type
application/json
{
  • "imprint": "string",
  • "policy": "string",
  • "terms": "string"
}

Update legal

This endpoint is for updating specific data of the legal information. The If-Modified-Since header can be used for omitting the output if nothing has changed.

only accessible with permission : "ManageConfiguration"

fully accessible with permission : "ManageConfiguration"

header Parameters
Session
required
string

JWT

If-Modified-Since
integer

unix timestamp of the last sync

Request Body schema: application/json

legal information to be updated

imprint
string

html formatted string

policy
string

html formatted string

terms
string

html formatted string

Responses

Request samples

Content type
application/json
{
  • "imprint": "string",
  • "policy": "string",
  • "terms": "string"
}

Response samples

Content type
application/json
{
  • "imprint": "string",
  • "policy": "string",
  • "terms": "string"
}

Get imprint

This endpoint returns the imprint in administrative representation. The imprint is a html formatted string. The If-Modified-Since header can be used for omitting the output if nothing has changed.

accessible without permission

fully accessible with permission : "ManageConfiguration"

header Parameters
Session
required
string

JWT

If-Modified-Since
integer

unix timestamp of the last sync

Responses

Response samples

Content type
application/json
{
  • "imprint": "string"
}

Update imprint

This endpoint is for replacing the imprint. The imprint can be a html formatted string.

only accessible with permission : "ManageConfiguration"

fully accessible with permission : "ManageConfiguration"

header Parameters
Session
required
string

JWT

Request Body schema: application/json

imprint to be replaced

imprint
string

html formatted string

Responses

Request samples

Content type
application/json
{
  • "imprint": "string"
}

Response samples

Content type
application/json
{
  • "imprint": "string"
}

Get terms

This endpoint returns the terms in administrative representation. The terms is a html formatted string. The If-Modified-Since header can be used for omitting the output if nothing has changed.

accessible without permission

fully accessible with permission : "ManageConfiguration"

header Parameters
Session
required
string

JWT

If-Modified-Since
integer

unix timestamp of the last sync

Responses

Response samples

Content type
application/json
{
  • "terms": "string"
}

Update terms

This endpoint is for replacing the terms. The terms can be a html formatted string.

only accessible with permission : "ManageConfiguration"

fully accessible with permission : "ManageConfiguration"

header Parameters
Session
required
string

JWT

Request Body schema: application/json

terms to be replaced

terms
string

html formatted string

Responses

Request samples

Content type
application/json
{
  • "terms": "string"
}

Response samples

Content type
application/json
{
  • "terms": "string"
}

Get policy

This endpoint returns the policy in administrative representation. The policy is a html formatted string. The If-Modified-Since header can be used for omitting the output if nothing has changed.

accessible without permission

fully accessible with permission : "ManageConfiguration"

header Parameters
Session
required
string

JWT

If-Modified-Since
integer

unix timestamp of the last sync

Responses

Response samples

Content type
application/json
{
  • "policy": "string"
}

Update policy

This endpoint is for replacing the policy. The policy can be a html formatted string.

only accessible with permission : "ManageConfiguration"

fully accessible with permission : "ManageConfiguration"

header Parameters
Session
required
string

JWT

Request Body schema: application/json

policy to be replaced

policy
string

html formatted string

Responses

Request samples

Content type
application/json
{
  • "policy": "string"
}

Response samples

Content type
application/json
{
  • "policy": "string"
}

Legal (Default)

Get terms

This endpoint returns the terms in default representation. The terms is a html formatted string. The If-Modified-Since header can be used for omitting the output if nothing has changed.

accessible without permission

fully accessible with permission : "ManageConfiguration"

header Parameters
If-Modified-Since
integer

unix timestamp of the last sync

Session
string

JWT

Responses

Response samples

Content type
application/json
{
  • "terms": "string"
}

Get policy

This endpoint returns the policy in default representation. The policy is a html formatted string. The If-Modified-Since header can be used for omitting the output if nothing has changed.

accessible without permission

fully accessible with permission : "ManageConfiguration"

header Parameters
If-Modified-Since
integer

unix timestamp of the last sync

Session
string

JWT

Responses

Response samples

Content type
application/json
{
  • "policy": "string"
}

Get tracking legal

This endpoint returns the tracking legal information in default representation. The tracking legal information is a html formatted string.

accessible without permission

fully accessible with permission : "ManageConfiguration"

header Parameters
Session
string

JWT

Responses

Response samples

Content type
application/json
{
  • "tracking": "string"
}

Get legal

This endpoint returns the legal information in default representation. The If-Modified-Since header can be used for omitting the output if nothing has changed.

accessible without permission

fully accessible with permission : "ManageConfiguration"

header Parameters
If-Modified-Since
integer

unix timestamp of the last sync

Session
string

JWT

Responses

Response samples

Content type
application/json
{
  • "imprint": "string",
  • "policy": "string",
  • "terms": "string"
}

Get imprint

This endpoint returns the imprint in default representation. The imprint is a html formatted string. The If-Modified-Since header can be used for omitting the output if nothing has changed.

accessible without permission

fully accessible with permission : "ManageConfiguration"

header Parameters
If-Modified-Since
integer

unix timestamp of the last sync

Session
string

JWT

Responses

Response samples

Content type
application/json
{
  • "imprint": "string"
}

Location (Admin)

Create location

This endpoint is for creating a new location.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

header Parameters
Session
required
string

JWT

Request Body schema: application/json

Location to create

object <optional>

Default: {"any": "Read", "user": "Read", "accounts": {}, "groups": {}}

object (model.Address)
description
string
image
string or null

media id

limit
integer <optional> >= 1

Note: null if no limit should apply, Default: null

projectId
string
title
string
type
string <optional>
Value: "Custom"

Default: "Custom"

Responses

Request samples

Content type
application/json
{
  • "access": {
    },
  • "address": {
    },
  • "description": "string",
  • "image": "string",
  • "limit": 1,
  • "projectId": "string",
  • "title": "string",
  • "type": "Custom"
}

Response samples

Content type
application/json
{
  • "access": {
    },
  • "accessEditAllowed": true,
  • "address": {
    },
  • "description": "string",
  • "id": "string",
  • "image": "string",
  • "limit": 1,
  • "lockedSlots": [
    ],
  • "projectId": "string",
  • "title": "string",
  • "type": "Custom"
}

Get places config

This endpoint returns config for places search. It provides the google places api key.

accessible without permission

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "googlePlacesApiKey": "string"
}

Get location list for project

This endpoint returns a list of all locations for the requested project. If a limit is set, a cursor for this endpoint may be created to iterate over all locations.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Project ID

query Parameters
cursor
string

id of the cursor used for pagination; required if page is set

limit
integer

amount of results per page (1 ... 100)

page
integer

current page index of the cursor used for pagination; required if cursor is set

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get location access configuration

This endpoint returns the access configuration for the requested location.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Location ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "access": {
    },
  • "accessEditAllowed": true
}

Update location access configuration

This endpoint updates the access configuration for the requested location. Only the changes should be transmitted due this endpoint.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Location ID

header Parameters
Session
required
string

JWT

Request Body schema: application/json

changed access rights

object

accountId to operation; null for operation removes access

any
string or null
Enum: "Read" "Write" "Delete" "Create" "changeProof"

Delete (includes) Write (includes) Read; null for operation removes access

object

groupId to operation; null for operation removes access

user
string or null
Enum: "Read" "Write" "Delete" "Create" "changeProof"

Delete (includes) Write (includes) Read; null for operation removes access

Responses

Request samples

Content type
application/json
{
  • "accounts": {
    },
  • "any": "Read",
  • "groups": {
    },
  • "user": "Read"
}

Response samples

Content type
application/json
{
  • "accounts": {
    },
  • "any": "Read",
  • "groups": {
    },
  • "user": "Read"
}

Get location

This endpoint returns a location in administrative representation by given id.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Location ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "access": {
    },
  • "accessEditAllowed": true,
  • "address": {
    },
  • "description": "string",
  • "id": "string",
  • "image": "string",
  • "limit": 1,
  • "lockedSlots": [
    ],
  • "projectId": "string",
  • "title": "string",
  • "type": "Custom"
}

Delete location

This endpoint is for deleting a single location.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Location ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "status": "ok"
}

Update location

This endpoint is for updating specific data of an existing location.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Location ID

header Parameters
Session
required
string

JWT

Request Body schema: application/json

location data to be updated

object (model.Address)
description
string
image
string or null

media id

limit
integer <optional> >= 1

Note: null if no limit should apply, Default: null

title
string
type
string <optional>
Value: "Custom"

Default: "Custom"

Responses

Request samples

Content type
application/json
{
  • "address": {
    },
  • "description": "string",
  • "image": "string",
  • "limit": 1,
  • "title": "string",
  • "type": "Custom"
}

Response samples

Content type
application/json
{
  • "access": {
    },
  • "accessEditAllowed": true,
  • "address": {
    },
  • "description": "string",
  • "id": "string",
  • "image": "string",
  • "limit": 1,
  • "lockedSlots": [
    ],
  • "projectId": "string",
  • "title": "string",
  • "type": "Custom"
}

Location (Default)

Get location

This endpoint returns a location in default representation by given id. If the requested language is not available it will fall back to the default language.

accessible without permission

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Location ID

header Parameters
Accept-Language
string

client language(s)

Session
string

JWT

Responses

Response samples

Content type
application/json
{
  • "address": {
    },
  • "description": "string",
  • "id": "string",
  • "image": "string",
  • "limit": 1,
  • "lockedSlots": [
    ],
  • "projectId": "string",
  • "title": "string",
  • "translations": [
    ],
  • "type": "Custom"
}

Get location list for project

This endpoint returns a list of all locations for the requested project. If the requested language is not available it will fall back to the default language. If a limit is set, a cursor for this endpoint may be created to iterate over all locations.

accessible without permission

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Project ID

query Parameters
cursor
string

id of the cursor used for pagination; required if page is set

limit
integer

amount of results per page (1 ... 100)

page
integer

current page index of the cursor used for pagination; required if cursor is set

header Parameters
Accept-Language
string

client language(s)

Session
string

JWT

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get places config

This endpoint returns config for places search. It provides the google places api key.

accessible without permission

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "googlePlacesApiKey": "string"
}

Map (Admin)

Get map access configuration

This endpoint returns the access configuration for the requested location map.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Map ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "access": {
    },
  • "accessEditAllowed": true
}

Update map access configuration

This endpoint updates the access configuration for the requested location map. Only the changes should be transmitted due this endpoint.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Map ID

header Parameters
Session
required
string

JWT

Request Body schema: application/json

changed access rights

object

accountId to operation; null for operation removes access

any
string or null
Enum: "Read" "Write" "Delete" "Create" "changeProof"

Delete (includes) Write (includes) Read; null for operation removes access

object

groupId to operation; null for operation removes access

user
string or null
Enum: "Read" "Write" "Delete" "Create" "changeProof"

Delete (includes) Write (includes) Read; null for operation removes access

Responses

Request samples

Content type
application/json
{
  • "accounts": {
    },
  • "any": "Read",
  • "groups": {
    },
  • "user": "Read"
}

Response samples

Content type
application/json
{
  • "accounts": {
    },
  • "any": "Read",
  • "groups": {
    },
  • "user": "Read"
}

Create map

This endpoint is for creating a new location map.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

header Parameters
Session
required
string

JWT

Request Body schema: application/json

Map to create

object <optional>

Default: {"any": "Read", "user": "Read", "accounts": {}, "groups": {}}

image
string or null

media id

Array of objects (locationmap.MarkerRequest)

array must contain all markers to set

projectId
string
title
string

Responses

Request samples

Content type
application/json
{
  • "access": {
    },
  • "image": "string",
  • "marker": [
    ],
  • "projectId": "string",
  • "title": "string"
}

Response samples

Content type
application/json
{
  • "access": {
    },
  • "accessEditAllowed": true,
  • "id": "string",
  • "image": "string",
  • "marker": [
    ],
  • "projectId": "string",
  • "title": "string"
}

Get map list for project

This endpoint returns a list of all location maps for the requested project. If a limit is set, a cursor for this endpoint may be created to iterate over all maps.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Project ID

query Parameters
cursor
string

id of the cursor used for pagination; required if page is set

limit
integer

amount of results per page (1 ... 100)

page
integer

current page index of the cursor used for pagination; required if cursor is set

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get map

This endpoint returns a location map in administrative representation by given id.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Map ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "access": {
    },
  • "accessEditAllowed": true,
  • "id": "string",
  • "image": "string",
  • "marker": [
    ],
  • "projectId": "string",
  • "title": "string"
}

Delete map

This endpoint is for deleting a single location map.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Map ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "status": "ok"
}

Update map

This endpoint is for updating specific data of an existing location map.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

nMap ID

header Parameters
Session
required
string

JWT

Request Body schema: application/json

map data to be updated

image
string or null

media id

Array of objects (locationmap.MarkerRequest)

array must contain all markers to set

title
string

Responses

Request samples

Content type
application/json
{
  • "image": "string",
  • "marker": [
    ],
  • "title": "string"
}

Response samples

Content type
application/json
{
  • "access": {
    },
  • "accessEditAllowed": true,
  • "id": "string",
  • "image": "string",
  • "marker": [
    ],
  • "projectId": "string",
  • "title": "string"
}

Map (Default)

Get map

This endpoint returns a location map in default representation by given id. If the requested language is not available it will fall back to the default language.

accessible without permission

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Map ID

header Parameters
Accept-Language
string

client language(s)

Session
string

JWT

Responses

Response samples

Content type
application/json
{
  • "id": "string",
  • "image": "string",
  • "marker": [
    ],
  • "projectId": "string",
  • "title": "string",
  • "translations": [
    ]
}

Media (Admin)

Get media item

This endpoint is for retrieving a media item with a signed url to the file in admin representation.

only accessible with permission : "ManageContent" "ManageGlobalMedia" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageGlobalMedia" "ManageProjects"

path Parameters
id
required
string

Media ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "access": {
    },
  • "accessEditAllowed": true,
  • "altText": "string",
  • "author": "string",
  • "description": "string",
  • "expires": 0,
  • "filename": "string",
  • "folderId": "string",
  • "id": "string",
  • "lastModified": 0,
  • "mediaType": "Document",
  • "mimeType": "application/msword",
  • "private": true,
  • "projectId": "string",
  • "resolution": {
    },
  • "size": 0,
  • "thumbnailExpires": 0,
  • "thumbnailUrl": "string",
  • "title": "string",
  • "uploadTime": 0,
  • "url": "string"
}

Delete media item and file

This endpoint is for deleting a file (media item). Items of a readonly folder are not deletable.

only accessible with permission : "ManageContent" "ManageGlobalMedia" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageGlobalMedia" "ManageProjects"

path Parameters
id
required
string

Media ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "status": "ok"
}

Update media item metadata

This endpoint offers the possibility to update the metadata of a given media item.

only accessible with permission : "ManageContent" "ManageGlobalMedia" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageGlobalMedia" "ManageProjects"

path Parameters
id
required
string

Media Item ID

header Parameters
Session
required
string

JWT

Request Body schema: application/json

media item data to update

altText
string
description
string
folderId
string or null
title
string

Responses

Request samples

Content type
application/json
{
  • "altText": "string",
  • "description": "string",
  • "folderId": "string",
  • "title": "string"
}

Response samples

Content type
application/json
{
  • "access": {
    },
  • "accessEditAllowed": true,
  • "altText": "string",
  • "author": "string",
  • "description": "string",
  • "expires": 0,
  • "filename": "string",
  • "folderId": "string",
  • "id": "string",
  • "lastModified": 0,
  • "mediaType": "Document",
  • "mimeType": "application/msword",
  • "private": true,
  • "projectId": "string",
  • "resolution": {
    },
  • "size": 0,
  • "thumbnailExpires": 0,
  • "thumbnailUrl": "string",
  • "title": "string",
  • "uploadTime": 0,
  • "url": "string"
}

Get factory default media configuration

This endpoint returns the default media configuration. This can be used for reset settings to default value.

accessible without permission

fully accessible with permission : "ManageConfiguration"

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "maxFileSize": 0,
  • "scanForViruses": true,
  • "signedURLLifetime": 0,
  • "uploadRestriction": true
}

Duplicate media item and file

This endpoint is for duplicating a file (media item). Only Media items that are not private could be duplicated.

only accessible with permission : "ManageContent" "ManageGlobalMedia" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageGlobalMedia" "ManageProjects"

path Parameters
id
required
string

Media ID

header Parameters
Session
required
string

JWT

Request Body schema: application/json

Duplication request

folderId
string or null
projectId
string or null

Responses

Request samples

Content type
application/json
{
  • "folderId": "string",
  • "projectId": "string"
}

Response samples

Content type
application/json
{
  • "access": {
    },
  • "accessEditAllowed": true,
  • "altText": "string",
  • "author": "string",
  • "description": "string",
  • "expires": 0,
  • "filename": "string",
  • "folderId": "string",
  • "id": "string",
  • "lastModified": 0,
  • "mediaType": "Document",
  • "mimeType": "application/msword",
  • "private": true,
  • "projectId": "string",
  • "resolution": {
    },
  • "size": 0,
  • "thumbnailExpires": 0,
  • "thumbnailUrl": "string",
  • "title": "string",
  • "uploadTime": 0,
  • "url": "string"
}

Get permalink

This endpoint is for retrieving the permalink of media file directly for mediaType "MediaIcon" or `"MediaImage". A permalink could only be created for media items that are not private.

only accessible with permission : "ManageGlobalMedia" "ManageProjects"

fully accessible with permission : "ManageGlobalMedia" "ManageProjects"

path Parameters
id
required
string

Media ID

header Parameters
Session
required
string

JWT

Responses

Get media item access configuration

This endpoint returns the access configuration for the requested media item (file).

only accessible with permission : "ManageContent" "ManageGlobalMedia" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageGlobalMedia" "ManageProjects"

path Parameters
id
required
string

MediaItem ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "access": {
    },
  • "accessEditAllowed": true
}

Update media item access configuration

This endpoint updates the access configuration for the requested media item (file). Only the changes should be transmitted due this endpoint.

only accessible with permission : "ManageContent" "ManageGlobalMedia" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageGlobalMedia" "ManageProjects"

path Parameters
id
required
string

MediaItem ID

header Parameters
Session
required
string

JWT

Request Body schema: application/json

changed access rights

object

accountId to operation; null for operation removes access

any
string or null
Enum: "Read" "Write" "Delete" "Create" "changeProof"

Delete (includes) Write (includes) Read; null for operation removes access

object

groupId to operation; null for operation removes access

user
string or null
Enum: "Read" "Write" "Delete" "Create" "changeProof"

Delete (includes) Write (includes) Read; null for operation removes access

Responses

Request samples

Content type
application/json
{
  • "accounts": {
    },
  • "any": "Read",
  • "groups": {
    },
  • "user": "Read"
}

Response samples

Content type
application/json
{
  • "accounts": {
    },
  • "any": "Read",
  • "groups": {
    },
  • "user": "Read"
}

Get folder

This endpoint returns a media folder specified by the given id.

only accessible with permission : "ManageContent" "ManageGlobalMedia" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageGlobalMedia" "ManageProjects"

path Parameters
id
required
string

Folder ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "id": "string",
  • "projectId": "string",
  • "readonly": true,
  • "title": "string"
}

Delete folder

This endpoint lets you delete a folder.

Note: All media items within this folder will be deleted as well!

only accessible with permission : "ManageContent" "ManageGlobalMedia" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageGlobalMedia" "ManageProjects"

path Parameters
id
required
string

Folder ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "status": "ok"
}

Update folder

This endpoint is for updating specific data of an existing folder.

only accessible with permission : "ManageContent" "ManageGlobalMedia" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageGlobalMedia" "ManageProjects"

path Parameters
id
required
string

Folder ID

header Parameters
Session
required
string

JWT

Request Body schema: application/json

Folder data to update

title
string

Responses

Request samples

Content type
application/json
{
  • "title": "string"
}

Response samples

Content type
application/json
{
  • "id": "string",
  • "projectId": "string",
  • "readonly": true,
  • "title": "string"
}

Get file

This endpoint is for retrieving a media file directly.

The content type of the media file, will be the same as the file's MIME-Type. (E.g. when a jpg file was uploaded, the response will be an image/jpg)

Error messages are json encoded, as usual.

Notice: Do not use the If-Modified-Since header.

only accessible with permission : "ManageContent" "ManageGlobalMedia" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageGlobalMedia" "ManageProjects"

path Parameters
id
required
string

Media ID

header Parameters
Session
required
string

JWT

Responses

Update file

This endpoint is for updating a specific file.

Note: You can only update a file with a file of the same mime type. So, a png can not be updated with a jpeg file. The mime type and media type always stays the same.

Supported Content-Types:

  • application/msword
  • application/pdf
  • application/vnd.ms-excel
  • application/vnd.ms-powerpoint
  • application/vnd.openxmlformats-officedocument.presentationml.presentation
  • application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
  • application/vnd.openxmlformats-officedocument.wordprocessingml.document
  • image/jpeg
  • image/png
  • image/svg+xml
  • video/mp4

For uploading other formats uploadRestriction has to be deactivated here: PATCH /config/admin/media

only accessible with permission : "ManageContent" "ManageGlobalMedia" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageGlobalMedia" "ManageProjects"

path Parameters
id
required
string

Media Item ID

header Parameters
Session
required
string

JWT

Request Body schema: multipart/form-data
file
required
string

The new file

Responses

Response samples

Content type
application/json
{
  • "access": {
    },
  • "accessEditAllowed": true,
  • "altText": "string",
  • "author": "string",
  • "description": "string",
  • "expires": 0,
  • "filename": "string",
  • "folderId": "string",
  • "id": "string",
  • "lastModified": 0,
  • "mediaType": "Document",
  • "mimeType": "application/msword",
  • "private": true,
  • "projectId": "string",
  • "resolution": {
    },
  • "size": 0,
  • "thumbnailExpires": 0,
  • "thumbnailUrl": "string",
  • "title": "string",
  • "uploadTime": 0,
  • "url": "string"
}

Create cursor

This endpoint returns a cursor for list media items in admin representation with applied filter and sort options. In case of cursor response total will be 0 the status 204 with not content is returned instead.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

header Parameters
Session
required
string

JWT

Request Body schema: application/json

options to create cursor

object (media.CursorFilterOptionAdmin)
Array of objects

only one property per entry allowed; property enums: "author" "folderId" "id" "lastModified" "mediaType" "mimeType" "projectId" "size" "uploadTime"; value enums: "ASC" "DESC"

Responses

Request samples

Content type
application/json
{
  • "filter": {
    },
  • "sort": [
    ]
}

Response samples

Content type
application/json
{
  • "cursor": "string",
  • "endpoints": [
    ],
  • "expiredAt": 0,
  • "total": 0
}

Get thumbnail

This endpoint is for retrieving the thumbnail of media file directly.

The content type of the media file, will be the same as the file's MIME-Type. (E.g. when a jpg file was uploaded, the response will be an image/jpg)

Error messages are json encoded, as usual.

Notice: Do not use the If-Modified-Since header.

only accessible with permission : "ManageContent" "ManageGlobalMedia" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageGlobalMedia" "ManageProjects"

path Parameters
id
required
string

Media ID

header Parameters
Session
required
string

JWT

Responses

Get media items list

This endpoint list all media items in admin representation. The output is filtered for the user permissions. If a limit is set, a cursor for this endpoint may be created to iterate over all media items.

only accessible with permission : "ManageContent" "ManageGlobalMedia" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageGlobalMedia" "ManageProjects"

query Parameters
cursor
string

id of the cursor used for pagination; required if page is set

limit
integer

amount of results per page (1 ... 100)

page
integer

current page index of the cursor used for pagination; required if cursor is set

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Upload file & create media item

This endpoint is for uploading a file.

Supported Content-Types:

  • application/msword
  • application/pdf
  • application/vnd.ms-excel
  • application/vnd.ms-powerpoint
  • application/vnd.openxmlformats-officedocument.presentationml.presentation
  • application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
  • application/vnd.openxmlformats-officedocument.wordprocessingml.document
  • image/jpeg
  • image/png
  • image/svg+xml
  • video/mp4

For uploading profile image the file should be PNG or JPEG.

For uploading other formats uploadRestriction has to be deactivated here: PATCH /config/admin/media

only accessible with permission : "ManageContent" "ManageGlobalMedia" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageGlobalMedia" "ManageProjects"

header Parameters
Session
required
string

JWT

Request Body schema: multipart/form-data
altText
required
string

Alt text for the media file

description
string

The description of an uploaded item

file
required
string

The actual file

folderId
required
string

The ID of the folder the file should be stored in

private
boolean

private files will not be shown in list files endpoint for admin users

projectId
required
string

The ID of the project the file belongs in

title
required
string

Title of the uploaded item

Responses

Response samples

Content type
application/json
{
  • "access": {
    },
  • "accessEditAllowed": true,
  • "altText": "string",
  • "author": "string",
  • "description": "string",
  • "expires": 0,
  • "filename": "string",
  • "folderId": "string",
  • "id": "string",
  • "lastModified": 0,
  • "mediaType": "Document",
  • "mimeType": "application/msword",
  • "private": true,
  • "projectId": "string",
  • "resolution": {
    },
  • "size": 0,
  • "thumbnailExpires": 0,
  • "thumbnailUrl": "string",
  • "title": "string",
  • "uploadTime": 0,
  • "url": "string"
}

Get media configuration

This endpoint returns the media configuration. The If-Modified-Since header can be used for omitting the output if nothing has changed.

accessible without permission

fully accessible with permission : "ManageConfiguration"

header Parameters
Session
required
string

JWT

If-Modified-Since
integer

unix timestamp of the last sync

Responses

Response samples

Content type
application/json
{
  • "maxFileSize": 0,
  • "scanForViruses": true,
  • "signedURLLifetime": 0,
  • "uploadRestriction": true
}

Update media configuration

This endpoint is for updating the media configuration. The If-Modified-Since header can be used for omitting the request if nothing has changed.

only accessible with permission : "ManageConfiguration"

fully accessible with permission : "ManageConfiguration"

header Parameters
Session
required
string

JWT

If-Modified-Since
integer

unix timestamp

Request Body schema: application/json

media data to be updated

maxFileSize
integer >= 0

in byte

scanForViruses
boolean
signedURLLifetime
integer >= 0

in seconds

uploadRestriction
boolean

restriction allows to upload following content types only: application/msword, application/pdf, application/vnd.ms-excel, application/vnd.ms-powerpoint, application/vnd.openxmlformats-officedocument.presentationml.presentation, application/vnd.openxmlformats-officedocument.spreadsheetml.sheet, application/vnd.openxmlformats-officedocument.wordprocessingml.document, image/jpeg, image/png, image/svg+xml, video/mp4

Responses

Request samples

Content type
application/json
{
  • "maxFileSize": 0,
  • "scanForViruses": true,
  • "signedURLLifetime": 0,
  • "uploadRestriction": true
}

Response samples

Content type
application/json
{
  • "maxFileSize": 0,
  • "scanForViruses": true,
  • "signedURLLifetime": 0,
  • "uploadRestriction": true
}

Get folder list

This endpoint returns all media folders. If a limit is set, a cursor for this endpoint may be created to iterate over all folders.

only accessible with permission : "ManageContent" "ManageGlobalMedia" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageGlobalMedia" "ManageProjects"

query Parameters
cursor
string

id of the cursor used for pagination; required if page is set

limit
integer

amount of results per page (1 ... 100)

page
integer

current page index of the cursor used for pagination; required if cursor is set

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Create folder

This endpoint creates a new media folder.

only accessible with permission : "ManageContent" "ManageGlobalMedia" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageGlobalMedia" "ManageProjects"

header Parameters
Session
required
string

JWT

Request Body schema: application/json

Folder to create

projectId
string or null
title
string

Responses

Request samples

Content type
application/json
{
  • "projectId": "string",
  • "title": "string"
}

Response samples

Content type
application/json
{
  • "id": "string",
  • "projectId": "string",
  • "readonly": true,
  • "title": "string"
}

Media (Default)

Get media item

This endpoint is for retrieving a media item with a signed url to the file in default representation. If the requested language is not available it will fall back to the default language.

accessible without permission

fully accessible with permission : "ManageContent" "ManageGlobalMedia" "ManageProjects"

path Parameters
id
required
string

Media ID

header Parameters
Accept-Language
string

client language(s)

Session
string

JWT

Responses

Response samples

Content type
application/json
{
  • "altText": "string",
  • "author": "string",
  • "description": "string",
  • "expires": 0,
  • "filename": "string",
  • "folderId": "string",
  • "id": "string",
  • "lastModified": 0,
  • "mediaType": "Document",
  • "mimeType": "application/msword",
  • "private": true,
  • "projectId": "string",
  • "resolution": {
    },
  • "size": 0,
  • "thumbnailExpires": 0,
  • "thumbnailUrl": "string",
  • "title": "string",
  • "translations": [
    ],
  • "uploadTime": 0,
  • "url": "string"
}

Delete media item and file

This endpoint is for deleting a file (media item). Items of a readonly folder are not deletable.

accessible without permission

fully accessible with permission : "ManageContent" "ManageGlobalMedia" "ManageProjects"

path Parameters
id
required
string

Media ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "status": "ok"
}

Update media item metadata

This endpoint offers the possibility to update the metadata of a given media item. If the requested language is not available it will fall back to the default language.

accessible without permission

fully accessible with permission : "ManageContent" "ManageGlobalMedia" "ManageProjects"

path Parameters
id
required
string

Media Item ID

header Parameters
Session
required
string

JWT

Accept-Language
string

client language(s)

Request Body schema: application/json

media item data to update

altText
string
folderId
string or null
title
string

Responses

Request samples

Content type
application/json
{
  • "altText": "string",
  • "folderId": "string",
  • "title": "string"
}

Response samples

Content type
application/json
{
  • "altText": "string",
  • "author": "string",
  • "description": "string",
  • "expires": 0,
  • "filename": "string",
  • "folderId": "string",
  • "id": "string",
  • "lastModified": 0,
  • "mediaType": "Document",
  • "mimeType": "application/msword",
  • "private": true,
  • "projectId": "string",
  • "resolution": {
    },
  • "size": 0,
  • "thumbnailExpires": 0,
  • "thumbnailUrl": "string",
  • "title": "string",
  • "translations": [
    ],
  • "uploadTime": 0,
  • "url": "string"
}

Get media item ids

This endpoint returns ids of all media items.

accessible without permission

fully accessible with permission : "ManageContent" "ManageGlobalMedia" "ManageProjects"

header Parameters
Session
string

JWT

Responses

Response samples

Content type
application/json
[
  • "string"
]

Get thumbnail

This endpoint is for retrieving the thumbnail of media file directly.

The content type of the media file, will be the same as the file's MIME-Type. (E.g. when a jpg file was uploaded, the response will be an image/jpg)

Error messages are json encoded, as usual.

Notice: Do not use the If-Modified-Since header.

accessible without permission

fully accessible with permission : "ManageContent" "ManageGlobalMedia" "ManageProjects"

path Parameters
id
required
string

Media ID

header Parameters
Session
string

JWT

Responses

Create cursor

This endpoint returns a cursor for list medias in default representation with applied filter and sort options. In case of cursor response total will be 0 the status 204 with not content is returned instead.

accessible without permission

fully accessible with permission : "ManageContent" "ManageProjects"

header Parameters
Accept-Language
string

client language(s)

Session
string

JWT

Request Body schema: application/json

options to create cursor

object (media.CursorFilterOptionDefault)
Array of objects

only one property per entry allowed; property enums: "author" "folderId" "id" "lastModified" "mediaType" "mimeType" "projectId" "size" "uploadTime"; value enums: "ASC" "DESC"

Responses

Request samples

Content type
application/json
{
  • "filter": {
    },
  • "sort": [
    ]
}

Response samples

Content type
application/json
{
  • "cursor": "string",
  • "endpoints": [
    ],
  • "expiredAt": 0,
  • "total": 0
}

Get file

This endpoint is for retrieving a media file directly.

The content type of the media file, will be the same as the file's MIME-Type. (E.g. when a jpg file was uploaded, the response will be an image/jpg)

Error messages are json encoded, as usual.

Notice: Do not use the If-Modified-Since header.

accessible without permission

fully accessible with permission : "ManageContent" "ManageGlobalMedia" "ManageProjects"

path Parameters
id
required
string

Media ID

header Parameters
Session
string

JWT

Responses

Update file

This endpoint is for updating a specific file.

Note: You can only update a file with a file of the same mime type. So, a png can not be updated with a jpeg file. The mime type and media type always stays the same.

Supported Content-Types:

  • application/msword
  • application/pdf
  • application/vnd.ms-excel
  • application/vnd.ms-powerpoint
  • application/vnd.openxmlformats-officedocument.presentationml.presentation
  • application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
  • application/vnd.openxmlformats-officedocument.wordprocessingml.document
  • image/jpeg
  • image/png
  • image/svg+xml
  • video/mp4

For uploading other formats uploadRestriction has to be deactivated here: PATCH /config/admin/media If the requested language is not available it will fall back to the default language.

accessible without permission

fully accessible with permission : "ManageContent" "ManageGlobalMedia" "ManageProjects"

path Parameters
id
required
string

Media Item ID

header Parameters
Session
required
string

JWT

Accept-Language
string

client language(s)

Request Body schema: multipart/form-data
file
required
string

The new file

Responses

Response samples

Content type
application/json
{
  • "status": "ok"
}

Get download status

This endpoint returns the information for a requested download

accessible without permission

path Parameters
id
required
string

Download ID

header Parameters
Session
string

JWT

Responses

Response samples

Content type
application/json
{
  • "downloadUrl": "string",
  • "expires": 0,
  • "id": "string",
  • "status": "Compressing"
}

Get media items list

This endpoint list all media items in default representation. The output is filtered for the user permissions. If the requested language is not available it will fall back to the default language. If a limit is set, a cursor for this endpoint may be created to iterate over all media items.

accessible without permission

fully accessible with permission : "ManageContent" "ManageGlobalMedia" "ManageProjects"

query Parameters
cursor
string

id of the cursor used for pagination; required if page is set

limit
integer

amount of results per page (1 ... 100)

page
integer

current page index of the cursor used for pagination; required if cursor is set

header Parameters
Accept-Language
string

client language(s)

Session
string

JWT

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Upload file & create media item

This endpoint is for uploading a file.

Supported Content-Types:

  • application/msword
  • application/pdf
  • application/vnd.ms-excel
  • application/vnd.ms-powerpoint
  • application/vnd.openxmlformats-officedocument.presentationml.presentation
  • application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
  • application/vnd.openxmlformats-officedocument.wordprocessingml.document
  • image/jpeg
  • image/png
  • image/svg+xml
  • video/mp4

For uploading profile image the file should be PNG or JPEG.

For uploading other formats uploadRestriction has to be deactivated here: PATCH /config/admin/media If the requested language is not available it will fall back to the default language.

Note: data.translations will be always empty. Translation takes places async. Call GET /media/default//{mediaId} to check for translation later.

accessible without permission

fully accessible with permission : "ManageContent" "ManageGlobalMedia" "ManageProjects"

header Parameters
Session
required
string

JWT

Accept-Language
string

client language(s)

Request Body schema: multipart/form-data
altText
required
string

Alt text for the media file

file
required
string

The actual file

folderId
required
string

The ID of the folder the file should be stored in or null string

private
boolean

private files will not be shown in list files endpoint for admin users

projectId
required
string

The ID of the project the file belongs in or null string

title
required
string

Title of the uploaded item

Responses

Response samples

Content type
application/json
{
  • "altText": "string",
  • "author": "string",
  • "description": "string",
  • "expires": 0,
  • "filename": "string",
  • "folderId": "string",
  • "id": "string",
  • "lastModified": 0,
  • "mediaType": "Document",
  • "mimeType": "application/msword",
  • "private": true,
  • "projectId": "string",
  • "resolution": {
    },
  • "size": 0,
  • "thumbnailExpires": 0,
  • "thumbnailUrl": "string",
  • "title": "string",
  • "translations": [
    ],
  • "uploadTime": 0,
  • "url": "string"
}

Get media configuration

This endpoint returns the media configuration. The If-Modified-Since header can be used for omitting the output if nothing has changed.

accessible without permission

fully accessible with permission : "ManageConfiguration"

header Parameters
If-Modified-Since
integer

unix timestamp of the last sync

Session
string

JWT

Responses

Response samples

Content type
application/json
{
  • "maxFileSize": 0,
  • "scanForViruses": true,
  • "signedURLLifetime": 0,
  • "uploadRestriction": true
}

Get media items list of folder

This endpoint list all media items in default representation for the requested folder id. The output is filtered for the user permissions. If the requested language is not available it will fall back to the default language. If a limit is set, a cursor for this endpoint may be created to iterate over all media items.

accessible without permission

fully accessible with permission : "ManageContent" "ManageGlobalMedia" "ManageProjects"

path Parameters
id
required
string

Folder ID

query Parameters
cursor
string

id of the cursor used for pagination; required if page is set

limit
integer

amount of results per page (1 ... 100)

page
integer

current page index of the cursor used for pagination; required if cursor is set

header Parameters
Accept-Language
string

client language(s)

Session
string

JWT

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Download media items

This endpoint is for downloading multiple documents. Once started, the request is collection the files and put them into a zip file. The url to download the zip file from will be in the response after processing and available on calling this endpoint GET /media/default/download/{id}

The download will automatically fail after 2h. After 2h downloads are released to be cleaned up.

The provided ids are interpreted as filter, so invalid or not accessible ids will be ignored.

accessible without permission

fully accessible with permission : "ManageContent" "ManageGlobalMedia" "ManageProjects"

query Parameters
ids
required
string

ids to download

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "downloadUrl": "string",
  • "expires": 0,
  • "id": "string",
  • "status": "Compressing"
}

Menu (Admin)

Get menu settings

This endpoint returns the settings of the menu for a specific project. The output is in administrative representation.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Project ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "design": {
    },
  • "itemType": "IconAndText",
  • "menuType": "Burger"
}

Update menu settings

This endpoint updates the settings of a menu and returns it.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Project ID

header Parameters
Session
required
string

JWT

Request Body schema: application/json

the settings of the menu

object (menu.RequestDesignWeb)
itemType
string
Enum: "IconAndText" "Text"
menuType
string
Enum: "Burger" "Bottom"

Responses

Request samples

Content type
application/json
{
  • "design": {
    },
  • "itemType": "IconAndText",
  • "menuType": "Burger"
}

Response samples

Content type
application/json
[
  • {
    }
]

Get menu for project

This endpoint returns the menu for a specific project. The output is in administrative representation.

content.search.objectTypes: enums limited to: "Calendar" "CalendarEntry" "ChatFeed" "Directory" "DirectoryContentRow" "Location" "LocationMap" "MediaAudio" "MediaDocument" "MediaFolder" "MediaIcon" "MediaImage" "MediaOther" "MediaVideo" "News" "Page" "Project" "Stream"

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Project ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "access": {
    },
  • "accessEditAllowed": true,
  • "content": [
    ],
  • "id": "string",
  • "projectId": "string",
  • "settings": {
    }
}

Create menu for project

This endpoint is for creating a new menu for a specific project. In case of response status is 409 the menu already exist.

content.search.objectTypes: enums limited to: "Calendar" "CalendarEntry" "ChatFeed" "Directory" "DirectoryContentRow" "Location" "LocationMap" "MediaAudio" "MediaDocument" "MediaFolder" "MediaIcon" "MediaImage" "MediaOther" "MediaVideo" "News" "Page" "Project" "Stream"

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Project ID

header Parameters
Session
required
string

JWT

Request Body schema: application/json

the settings and content of the menu

object <optional>

Default: {"any": "Read", "user": "Read", "accounts": {}, "groups": {}}

Array of objects (menu.RequestItem)
object (menu.RequestSettings)

Responses

Request samples

Content type
application/json
{
  • "access": {
    },
  • "content": [
    ],
  • "settings": {
    }
}

Response samples

Content type
application/json
{
  • "access": {
    },
  • "accessEditAllowed": true,
  • "content": [
    ],
  • "id": "string",
  • "projectId": "string",
  • "settings": {
    }
}

Get menu access configuration

This endpoint returns the access configuration for the requested menu.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Menu ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "access": {
    },
  • "accessEditAllowed": true
}

Update menu access configuration

This endpoint updates the access configuration for the requested menu. Only the changes should be transmitted due this endpoint.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Menu ID

header Parameters
Session
required
string

JWT

Request Body schema: application/json

changed access rights

object

accountId to operation; null for operation removes access

any
string or null
Enum: "Read" "Write" "Delete" "Create" "changeProof"

Delete (includes) Write (includes) Read; null for operation removes access

object

groupId to operation; null for operation removes access

user
string or null
Enum: "Read" "Write" "Delete" "Create" "changeProof"

Delete (includes) Write (includes) Read; null for operation removes access

Responses

Request samples

Content type
application/json
{
  • "accounts": {
    },
  • "any": "Read",
  • "groups": {
    },
  • "user": "Read"
}

Response samples

Content type
application/json
{
  • "accounts": {
    },
  • "any": "Read",
  • "groups": {
    },
  • "user": "Read"
}

Get menu content

This endpoint returns the content of the menu for a specific project. The output is in administrative representation.

search.objectTypes: enums limited to: "Calendar" "CalendarEntry" "ChatFeed" "Directory" "DirectoryContentRow" "Location" "LocationMap" "MediaAudio" "MediaDocument" "MediaFolder" "MediaIcon" "MediaImage" "MediaOther" "MediaVideo" "News" "Page" "Project" "Stream"

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Project ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Update menu content

This endpoint updates the content of a menu and returns it.

search.objectTypes: enums limited to: "Calendar" "CalendarEntry" "ChatFeed" "Directory" "DirectoryContentRow" "Location" "LocationMap" "MediaAudio" "MediaDocument" "MediaFolder" "MediaIcon" "MediaImage" "MediaOther" "MediaVideo" "News" "Page" "Project" "Stream"

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Project ID

header Parameters
Session
required
string

JWT

Request Body schema: application/json

the content of the menu

Array
object

not editable for Profile, Support, Imprint, Settings and LeaveProject type

object <optional>

only for Link type and deeplink.objectType = Calendar

children
Array of objects (menu.RequestItem)

only for Folder type

object or null

only for Image, Link, Support and Imprint type; must be null when url is set

icon
string or null

media id only for ChatFeed, Folder, Gallery, IndexSearch, Link, News, Support, Imprint, Settings and LeaveProject type

id
string or null

new items to create do not have an id (null)

image
string

media id only for Image type

linkBehavior
string
Enum: "Internal" "External"

only for Image, Link, Support, Imprint and Settings type; Has no effect if the url matches with the web app

platforms
Array of strings
Items Enum: "Android" "Ios" "Web"

platforms menu item should be visible for

referenceIds
Array of strings

only for ChatFeed and Gallery type

object

only for IndexSearch and News type

separatorType
string
Enum: "Separator" "SeparatorAndText" "Text"

only for Separator type

size
string
Enum: "S" "M" "L"

only for Gap type

text
string

only for ChatFeed, Folder, Gallery, IndexSearch, Link, News, Separator, Support, Imprint, Settings and LeaveProject type

textOrientation
string
Enum: "Start" "Center" "Hidden"

only for Separator type

type
string
Enum: "ChatFeed" "Folder" "Gallery" "Gap" "Image" "IndexSearch" "Link" "News" "Profile" "Separator" "Support" "Imprint" "Settings" "LeaveProject"
url
string or null

only for Image, Link, Support, Imprint and Settings type; must be null if deeplink is set

Responses

Request samples

Content type
application/json
[
  • {
    }
]

Response samples

Content type
application/json
[
  • {
    }
]

Menu (Default)

Get menu for project

This endpoint returns the menu for a specific project. The output is in default representation. The Platform header is for filtering menu items for the correct platform. If the requested language is not available it will fall back to the default language.

content.search.objectTypes: enums limited to: "Calendar" "CalendarEntry" "ChatFeed" "Directory" "DirectoryContentRow" "Location" "LocationMap" "MediaAudio" "MediaDocument" "MediaFolder" "MediaIcon" "MediaImage" "MediaOther" "MediaVideo" "News" "Page" "Project" "Stream"

accessible without permission

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Project ID

header Parameters
Accept-Language
string

client language(s)

Platform
string
Enum: "Cms" "Android" "Ios" "Web"

The client platform

Session
string

JWT

Responses

Response samples

Content type
application/json
{
  • "content": [
    ],
  • "id": "string",
  • "projectId": "string",
  • "settings": {
    }
}

News (Admin)

Get article access configuration

This endpoint returns the access configuration for the requested article.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Article ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "access": {
    },
  • "accessEditAllowed": true
}

Update article access configuration

This endpoint updates the access configuration for the requested article. Only the changes should be transmitted due this endpoint.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Article ID

header Parameters
Session
required
string

JWT

Request Body schema: application/json

changed access rights

object

accountId to operation; null for operation removes access

any
string or null
Enum: "Read" "Write" "Delete" "Create" "changeProof"

Delete (includes) Write (includes) Read; null for operation removes access

object

groupId to operation; null for operation removes access

user
string or null
Enum: "Read" "Write" "Delete" "Create" "changeProof"

Delete (includes) Write (includes) Read; null for operation removes access

Responses

Request samples

Content type
application/json
{
  • "accounts": {
    },
  • "any": "Read",
  • "groups": {
    },
  • "user": "Read"
}

Response samples

Content type
application/json
{
  • "accounts": {
    },
  • "any": "Read",
  • "groups": {
    },
  • "user": "Read"
}

Get article post counts for project

This endpoint returns a list of post counts for all articles with social interaction activated of the requested project. If a limit is set, a cursor for this endpoint may be created to iterate over all article post counts.

only accessible with permission : "ManageContent" (counts also for linked projects) "ManageProjects"

fully accessible with permission : "ManageContent" (counts also for linked projects) "ManageProjects"

path Parameters
id
required
string

Project ID

query Parameters
cursor
string

id of the cursor used for pagination; required if page is set

limit
integer

amount of results per page (1 ... 100)

page
integer

current page index of the cursor used for pagination; required if cursor is set

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Sync Operators for all articles

This endpoint is sync operators for all articles with sendbird. This endpoint should be rarely used, because of its workload. User must be Owner to call this endpoint.

only accessible with permission : "ManageProjects"

fully accessible with permission : "ManageProjects"

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "status": "ok"
}

Get article mobile content

This endpoint returns the localized mobile content of a specific article in administrative representation by given id.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Article ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Update article mobile content

This endpoint is for updating the mobile content of an existing article.

For storing desktop version use: PUT /news/admin/{id}/content/desktop

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Article ID

header Parameters
Session
required
string

JWT

Request Body schema: application/json

standard article content to update

Array
object <optional>

Default: {"any": "Read", "user": "Read", "accounts": {}, "groups": {}}

backgroundColor
string or null

background color in light mode or null for transparent; hexcolor or enum: "backgroundPrimary" "backgroundSecondary" "backgroundTertiary" "border" "contrast" "error" "primary" "secondary" "success" "textPrimary" "textSecondary"

backgroundColorDark
string or null

background color in dark mode or null for transparent; hexcolor or enum: "backgroundPrimary" "backgroundSecondary" "backgroundTertiary" "border" "contrast" "error" "primary" "secondary" "success" "textPrimary" "textSecondary"

Array of objects (news.RequestColumn)
contentType
string
Enum: "100" "50:50" "25:75" "75:25" "33:33:33" "25:50:25" "50:25:25" "25:25:50" "25:25:25:25"

25:25:25:25 only fits for desktop columns

id
string or null

new sections to create do not have an id

Responses

Request samples

Content type
application/json
[
  • {
    }
]

Response samples

Content type
application/json
[
  • {
    }
]

Get article mobile

This endpoint returns a localized article in admin representation by given id.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Article ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "access": {
    },
  • "accessEditAllowed": true,
  • "archivedAt": 0,
  • "author": "string",
  • "content": [
    ],
  • "createdAt": 0,
  • "creator": "string",
  • "hasDesktop": true,
  • "headerImage": "string",
  • "id": "string",
  • "keywordIds": [
    ],
  • "linkedProjectIds": [
    ],
  • "projectId": "string",
  • "publishedAt": 0,
  • "sendNotification": true,
  • "settings": {
    },
  • "status": "Draft",
  • "teaserText": "string",
  • "timeZone": "Europe/Berlin",
  • "title": "string"
}

Delete article

This endpoint is for deleting a single article with all localizations.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Article ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "status": "ok"
}

Update article info

This endpoint is for updating an article besides content and settings.

For storing content or settings use: PUT /news/admin/{id}/content AND PUT /news/admin/{id}/settings

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Article ID

header Parameters
Session
required
string

JWT

Request Body schema: application/json

article data to update

archivedAt
integer or null

not editable for status "Archived"; If not null must be must greater than publishedAt and in future for status "Draft" and "Published"

author
string
headerImage
string or null
keywordIds
Array of strings
linkedProjectIds
Array of strings
publishedAt
integer or null

not editable for status "Published"; If not null must be in future for status "Draft" and in past for status "Archived"

sendNotification
boolean

value can not be changed for published or archived news

status
string
Enum: "Draft" "Published" "Archived"
teaserText
string
timeZone
string

IANA Time Zone

title
string

Responses

Request samples

Content type
application/json
{
  • "archivedAt": 0,
  • "author": "string",
  • "headerImage": "string",
  • "keywordIds": [
    ],
  • "linkedProjectIds": [
    ],
  • "publishedAt": 0,
  • "sendNotification": true,
  • "status": "Draft",
  • "teaserText": "string",
  • "timeZone": "string",
  • "title": "string"
}

Response samples

Content type
application/json
{
  • "access": {
    },
  • "accessEditAllowed": true,
  • "archivedAt": 0,
  • "author": "string",
  • "content": [
    ],
  • "createdAt": 0,
  • "creator": "string",
  • "hasDesktop": true,
  • "headerImage": "string",
  • "id": "string",
  • "keywordIds": [
    ],
  • "linkedProjectIds": [
    ],
  • "projectId": "string",
  • "publishedAt": 0,
  • "sendNotification": true,
  • "settings": {
    },
  • "status": "Draft",
  • "teaserText": "string",
  • "timeZone": "Europe/Berlin",
  • "title": "string"
}

Get article settings

This endpoint returns the settings of a specific article in administrative representation by given id.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Article ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "backgroundDarkPrimary": "#000000",
  • "backgroundDarkSecondary": "#000000",
  • "backgroundImage": "string",
  • "backgroundLightPrimary": "#FFFFFF",
  • "backgroundLightSecondary": "#FFFFFF",
  • "backgroundType": "Gradient",
  • "interaction": true
}

Update article settings

This endpoint updates the settings of a specific article and returns it.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Article ID

header Parameters
Session
required
string

JWT

Request Body schema: application/json

the settings of the article

backgroundDarkPrimary
string

only used for backgroundType{Gradient|Color}; hexcolor or enum: "backgroundPrimary" "backgroundSecondary" "backgroundTertiary" "border" "contrast" "error" "primary" "secondary" "success" "textPrimary" "textSecondary"

backgroundDarkSecondary
string

only used for backgroundType{Gradient}; hexcolor or enum: "backgroundPrimary" "backgroundSecondary" "backgroundTertiary" "border" "contrast" "error" "primary" "secondary" "success" "textPrimary" "textSecondary"

backgroundImage
string or null

media id only used for backgroundType{Image}

backgroundLightPrimary
string

only used for backgroundType{Gradient|Color}; hexcolor or enum: "backgroundPrimary" "backgroundSecondary" "backgroundTertiary" "border" "contrast" "error" "primary" "secondary" "success" "textPrimary" "textSecondary"

backgroundLightSecondary
string

only used for backgroundType{Gradient}; hexcolor or enum: "backgroundPrimary" "backgroundSecondary" "backgroundTertiary" "border" "contrast" "error" "primary" "secondary" "success" "textPrimary" "textSecondary"

backgroundType
string
Enum: "Gradient" "Color" "Transparent" "Image"
interaction
boolean

defines if social interaction is allowed

Responses

Request samples

Content type
application/json
{
  • "backgroundDarkPrimary": "#000000",
  • "backgroundDarkSecondary": "#000000",
  • "backgroundImage": "string",
  • "backgroundLightPrimary": "#FFFFFF",
  • "backgroundLightSecondary": "#FFFFFF",
  • "backgroundType": "Gradient",
  • "interaction": true
}

Response samples

Content type
application/json
{
  • "backgroundDarkPrimary": "#000000",
  • "backgroundDarkSecondary": "#000000",
  • "backgroundImage": "string",
  • "backgroundLightPrimary": "#FFFFFF",
  • "backgroundLightSecondary": "#FFFFFF",
  • "backgroundType": "Gradient",
  • "interaction": true
}

Get article list for project

This endpoint returns a list of all articles for the requested project without content in administrative representation. The entries are sorted by publishedAt:DESC. If a limit is set, a cursor for this endpoint may be created to iterate over all articles.

only accessible with permission : "ManageContent" (counts also for linked projects) "ManageProjects"

fully accessible with permission : "ManageContent" (counts also for linked projects) "ManageProjects"

path Parameters
id
required
string

Project ID

query Parameters
cursor
string

id of the cursor used for pagination; required if page is set

limit
integer

amount of results per page (1 ... 100)

page
integer

current page index of the cursor used for pagination; required if cursor is set

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Create cursor

This endpoint returns a cursor for list articles in admin representation with applied filter and sort options. In case of cursor response total will be 0 the status 204 with not content is returned instead.

only accessible with permission : "ManageContent" (counts also for linked projects) "ManageProjects"

fully accessible with permission : "ManageContent" (counts also for linked projects) "ManageProjects"

header Parameters
Session
required
string

JWT

Request Body schema: application/json

options to create cursor

object (news.CursorFilterOptionAdmin)
Array of objects

only one property per entry allowed; property enums: "author" "archivedAt" "createdAt" "creator" "id" "lastModified" "publishedAt" "sendNotification" "status"; value enums: "ASC" "DESC"

Responses

Request samples

Content type
application/json
{
  • "filter": {
    },
  • "sort": [
    ]
}

Response samples

Content type
application/json
{
  • "cursor": "string",
  • "endpoints": [
    ],
  • "expiredAt": 0,
  • "total": 0
}

Get article list for cursor

This endpoint returns a list of all articles for a cursor without content in administrative representation.

Cursor could be created here: POST /news/admin/search

accessible without permission

query Parameters
cursor
required
string

id of the cursor used for pagination; required if page is set

page
required
integer

current page index of the cursor used for pagination; required if cursor is set

limit
integer

amount of results per page (1 ... 100)

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Create article

This endpoint is for creating a new article. The article will be saves as standard (mobile) version.

For storing desktop version use: PUT /news/admin/{id}/content/desktop

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

header Parameters
Session
required
string

JWT

Request Body schema: application/json

standard article to create

object (model.Access)
archivedAt
integer or null <optional>

must be null for status "Archived"; If not null must be must greater than publishedAt and in future for status "Draft" and "Published"; Default: null

author
string
Array of objects (news.RequestSection)
headerImage
string or null
keywordIds
Array of strings
linkedProjectIds
Array of strings <optional>

Default: []

projectId
string
publishedAt
integer or null

must be null for status "Published"; If not null must be in future for status "Draft" and in past for status "Archived"

sendNotification
boolean <optional>

Default: true

object (model.ArticleSettings)
status
string
Enum: "Draft" "Published" "Archived"
teaserText
string
timeZone
string

IANA Time Zone

title
string

Responses

Request samples

Content type
application/json
{
  • "access": {
    },
  • "archivedAt": 0,
  • "author": "string",
  • "content": [
    ],
  • "headerImage": "string",
  • "keywordIds": [
    ],
  • "linkedProjectIds": [
    ],
  • "projectId": "string",
  • "publishedAt": 0,
  • "sendNotification": true,
  • "settings": {
    },
  • "status": "Draft",
  • "teaserText": "string",
  • "timeZone": "string",
  • "title": "string"
}

Response samples

Content type
application/json
{
  • "access": {
    },
  • "accessEditAllowed": true,
  • "archivedAt": 0,
  • "author": "string",
  • "content": [
    ],
  • "createdAt": 0,
  • "creator": "string",
  • "hasDesktop": true,
  • "headerImage": "string",
  • "id": "string",
  • "keywordIds": [
    ],
  • "linkedProjectIds": [
    ],
  • "projectId": "string",
  • "publishedAt": 0,
  • "sendNotification": true,
  • "settings": {
    },
  • "status": "Draft",
  • "teaserText": "string",
  • "timeZone": "Europe/Berlin",
  • "title": "string"
}

Get article desktop content

This endpoint returns the localized desktop content of a specific article in administrative representation by given id.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Article ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Update article desktop content

This endpoint is for creating or updating the desktop content of an existing article.

For storing mobile version use: PUT /news/admin/{id}/content

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Article ID

header Parameters
Session
required
string

JWT

Request Body schema: application/json

desktop article content to update

Array
object <optional>

Default: {"any": "Read", "user": "Read", "accounts": {}, "groups": {}}

backgroundColor
string or null

background color in light mode or null for transparent; hexcolor or enum: "backgroundPrimary" "backgroundSecondary" "backgroundTertiary" "border" "contrast" "error" "primary" "secondary" "success" "textPrimary" "textSecondary"

backgroundColorDark
string or null

background color in dark mode or null for transparent; hexcolor or enum: "backgroundPrimary" "backgroundSecondary" "backgroundTertiary" "border" "contrast" "error" "primary" "secondary" "success" "textPrimary" "textSecondary"

Array of objects (news.RequestColumn)
contentType
string
Enum: "100" "50:50" "25:75" "75:25" "33:33:33" "25:50:25" "50:25:25" "25:25:50" "25:25:25:25"

25:25:25:25 only fits for desktop columns

id
string or null

new sections to create do not have an id

Responses

Request samples

Content type
application/json
[
  • {
    }
]

Response samples

Content type
application/json
[
  • {
    }
]

Delete article desktop version

This endpoint will delete the desktop version of an article, but not the article itself. The Mobile Version will still exist.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Article ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "status": "ok"
}

News (Default)

Get published article list for project

This endpoint returns a list of all published articles for the requested project without content in default representation. The entries are sorted by publishedAt:DESC. If a limit is set, a cursor for this endpoint may be created to iterate over all articles.

For preview list use: GET /news/default/project/{id}/preview

accessible without permission

fully accessible with permission : "ManageContent" (counts also for linked projects) "ManageProjects"

path Parameters
id
required
string

Project ID

query Parameters
cursor
string

id of the cursor used for pagination; required if page is set

limit
integer

amount of results per page (1 ... 100)

page
integer

current page index of the cursor used for pagination; required if cursor is set

header Parameters
Accept-Language
string

client language(s)

Session
string

JWT

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Create cursor

This endpoint returns a cursor for list published articles in default representation with applied filter and sort options. In case of cursor response total will be 0 the status 204 with not content is returned instead.

For preview list cursor use: GET /news/default/preview/search

accessible without permission

fully accessible with permission : "ManageContent" (counts also for linked projects) "ManageProjects"

header Parameters
Accept-Language
string

client language(s)

Session
string

JWT

Request Body schema: application/json

options to create cursor

object (news.CursorFilterOptionDefault)
Array of objects

only one property per entry allowed; property enums: "author" "createdAt" "id" "lastModified" "publishedAt"; value enums: "ASC" "DESC"

Responses

Request samples

Content type
application/json
{
  • "filter": {
    },
  • "sort": [
    ]
}

Response samples

Content type
application/json
{
  • "cursor": "string",
  • "endpoints": [
    ],
  • "expiredAt": 0,
  • "total": 0
}

Get published article ids for project

This endpoint returns ids of all published articles for the requested project. The entries are sorted by publishedAt:DESC.

For preview list ids use: GET /news/default/project/{id}/preview/ids

accessible without permission

fully accessible with permission : "ManageContent" (counts also for linked projects) "ManageProjects"

path Parameters
id
required
string

Project ID

header Parameters
Session
string

JWT

Responses

Response samples

Content type
application/json
[
  • "string"
]

Get article post counts for project

This endpoint returns a list of post counts for all published articles with social interaction activated of the requested project. If a limit is set, a cursor for this endpoint may be created to iterate over all article post counts.

accessible without permission

fully accessible with permission : "ManageContent" (counts also for linked projects) "ManageProjects"

path Parameters
id
required
string

Project ID

query Parameters
cursor
string

id of the cursor used for pagination; required if page is set

limit
integer

amount of results per page (1 ... 100)

page
integer

current page index of the cursor used for pagination; required if cursor is set

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get article post count

This endpoint returns the post count of the requested article.

accessible without permission

fully accessible with permission : "ManageContent" (counts also for linked projects) "ManageProjects"

path Parameters
id
required
string

Article ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "id": "string",
  • "postCount": 0
}

Get article mobile

This endpoint returns a localized article in default user representation by given id.

For preview use: GET /news/default/{id}/preview

accessible without permission

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Article ID

header Parameters
Accept-Language
string

client language(s)

Session
string

JWT

Responses

Response samples

Content type
application/json
{
  • "author": "string",
  • "channelId": "string",
  • "content": [
    ],
  • "contentRepresentation": "Mobile",
  • "createdAt": 0,
  • "hasDesktop": true,
  • "headerImage": "string",
  • "id": "string",
  • "keywordIds": [
    ],
  • "lastModified": 0,
  • "linkedProjectIds": [
    ],
  • "projectId": "string",
  • "publishedAt": 0,
  • "settings": {
    },
  • "status": "Draft",
  • "teaserText": "string",
  • "timeZone": "Europe/Berlin",
  • "title": "string",
  • "translations": [
    ]
}

Get article desktop

This endpoint returns a localized article for desktop in default user representation by given id. If there is no specific desktop version of the article the standard (mobile) version of the article will be selected.

For preview use: GET /news/default/{id}/preview/desktop

accessible without permission

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Article ID

header Parameters
Accept-Language
string

client language(s)

Session
string

JWT

Responses

Response samples

Content type
application/json
{
  • "author": "string",
  • "channelId": "string",
  • "content": [
    ],
  • "contentRepresentation": "Mobile",
  • "createdAt": 0,
  • "hasDesktop": true,
  • "headerImage": "string",
  • "id": "string",
  • "keywordIds": [
    ],
  • "lastModified": 0,
  • "linkedProjectIds": [
    ],
  • "projectId": "string",
  • "publishedAt": 0,
  • "settings": {
    },
  • "status": "Draft",
  • "teaserText": "string",
  • "timeZone": "Europe/Berlin",
  • "title": "string",
  • "translations": [
    ]
}

Get published article list for cursor

This endpoint returns a list of all articles for a cursor without content in default representation.

Cursor could be created for published view here: POST /news/default/search

Cursor could be created for preview view here: POST /news/default/preview/search

accessible without permission

query Parameters
cursor
required
string

id of the cursor used for pagination; required if page is set

page
required
integer

current page index of the cursor used for pagination; required if cursor is set

limit
integer

amount of results per page (1 ... 100)

header Parameters
Accept-Language
string

client language(s)

Session
string

JWT

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Notification (Admin)

Update Safari push certificate

This endpoint is for updating the safari push certificate. Certificate file must be provided in DER format.

only accessible with permission : "ManageConfiguration"

fully accessible with permission : "ManageConfiguration"

header Parameters
Session
required
string

JWT

Request Body schema: multipart/form-data
file
required
string

certificate

Responses

Response samples

Content type
application/json
{
  • "status": "ok"
}

Get certificate info

This endpoint is retrieving information about a certificate. Certificate file must be provided in DER format.

only accessible with permission : "ManageConfiguration"

fully accessible with permission : "ManageConfiguration"

header Parameters
Session
required
string

JWT

Request Body schema: multipart/form-data
file
required
string

certificate

Responses

Response samples

Content type
application/json
{
  • "certificateExpires": 0
}

Get notification configuration

This endpoint returns the notification configuration. The If-Modified-Since header can be used for omitting the output if nothing has changed.

accessible without permission

fully accessible with permission : "ManageConfiguration"

header Parameters
If-Modified-Since
integer

unix timestamp of the last sync

Session
string

JWT

Responses

Response samples

Content type
application/json
{
  • "mailSettings": {
    },
  • "pushSettings": {
    }
}

Update notification configuration

This endpoint is for updating the notification configuration. The If-Modified-Since header can be used for omitting the request if nothing has changed.

only accessible with permission : "ManageConfiguration"

fully accessible with permission : "ManageConfiguration"

header Parameters
Session
required
string

JWT

If-Modified-Since
integer

unix timestamp

Request Body schema: application/json

notification data to be updated

object (model.EmailSettings)

Responses

Request samples

Content type
application/json
{
  • "mailSettings": {
    }
}

Response samples

Content type
application/json
{
  • "mailSettings": {
    },
  • "pushSettings": {
    }
}

Update iOS push certificate

This endpoint is for updating the ios push certificate. Certificate file must be provided in DER format.

only accessible with permission : "ManageConfiguration"

fully accessible with permission : "ManageConfiguration"

header Parameters
Session
required
string

JWT

Request Body schema: multipart/form-data
file
required
string

certificate

Responses

Response samples

Content type
application/json
{
  • "status": "ok"
}

Create Safari push CSR

This endpoint is for creating a new certificate signing request for safari push notifications.

accessible without permission

fully accessible with permission : "ManageConfiguration"

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "status": "ok"
}

Create iOS push CSR

This endpoint is for creating a new certificate signing request for ios push notifications.

accessible without permission

fully accessible with permission : "ManageConfiguration"

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "status": "ok"
}

Create notification

This endpoint is for creating a new notification.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

header Parameters
Session
required
string

JWT

Request Body schema: application/json

notification to create

attachments
Array of strings <= 1 items

media ids; current implementation is limited for one attachment only and must be MediaTypeDocument; if attachments exceed 15MB they will be not attached in email notification; currently not translatable

content
string
image
string or null

media id; currently not translatable

projectId
string or null
publishedAt
integer or null

0 = now

readConfirmation
boolean
readConfirmationText
string

currently not translatable

recipientGroups
Array of strings or null

null = sent to everyone; group ids must belong to provided project id

timeZone
string

IANA Time Zone

title
string
url
string or null

Responses

Request samples

Content type
application/json
{
  • "attachments": [
    ],
  • "content": "string",
  • "image": "string",
  • "projectId": "string",
  • "publishedAt": 0,
  • "readConfirmation": true,
  • "readConfirmationText": "string",
  • "recipientGroups": [
    ],
  • "timeZone": "string",
  • "title": "string",
  • "url": "string"
}

Response samples

Content type
application/json
{
  • "attachments": [
    ],
  • "content": "string",
  • "createdAt": 0,
  • "creator": "string",
  • "deleteCount": 0,
  • "id": "string",
  • "image": "string",
  • "isPublished": true,
  • "projectId": "string",
  • "publishedAt": 0,
  • "readConfirmation": true,
  • "readConfirmationText": "string",
  • "readCount": 0,
  • "recipientGroups": [
    ],
  • "recipientsCount": 0,
  • "timeZone": "Europe/Berlin",
  • "title": "string",
  • "type": "Custom",
  • "url": "string"
}

Get all project notifications

This endpoint returns all notifications in admin representation for a project. If a limit is set, a cursor for this endpoint may be created to iterate over all notifications.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Project ID

query Parameters
cursor
string

id of the cursor used for pagination; required if page is set

limit
integer

amount of results per page (1 ... 100)

page
integer

current page index of the cursor used for pagination; required if cursor is set

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get notification

This endpoint returns notification in admin representation.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Notification ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "attachments": [
    ],
  • "content": "string",
  • "createdAt": 0,
  • "creator": "string",
  • "deleteCount": 0,
  • "id": "string",
  • "image": "string",
  • "isPublished": true,
  • "projectId": "string",
  • "publishedAt": 0,
  • "readConfirmation": true,
  • "readConfirmationText": "string",
  • "readCount": 0,
  • "recipientGroups": [
    ],
  • "recipientsCount": 0,
  • "timeZone": "Europe/Berlin",
  • "title": "string",
  • "type": "Custom",
  • "url": "string"
}

Delete notification

This endpoint is for deleting a notification with all localizations.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Notification ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "status": "ok"
}

Update notification

This endpoint is for updating notification.

If readConfirmation is set to true the notification cannot be updated if it is already published.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Notification ID

header Parameters
Session
required
string

JWT

Request Body schema: application/json

notification information to be updated

attachments
Array of strings <= 1 items

media ids; current implementation is limited for one attachment only and must be MediaTypeDocument; if attachments exceed 15MB they will be not attached in email notification; currently not translatable

content
string
image
string or null

media id; currently not translatable

publishedAt
integer or null

0 = now

readConfirmation
boolean
readConfirmationText
string

currently not translatable

recipientGroups
Array of strings or null

null = sent to everyone; group ids must belong to provided project id

timeZone
string

IANA Time Zone

title
string
url
string or null

Responses

Request samples

Content type
application/json
{
  • "attachments": [
    ],
  • "content": "string",
  • "image": "string",
  • "publishedAt": 0,
  • "readConfirmation": true,
  • "readConfirmationText": "string",
  • "recipientGroups": [
    ],
  • "timeZone": "string",
  • "title": "string",
  • "url": "string"
}

Response samples

Content type
application/json
{
  • "attachments": [
    ],
  • "content": "string",
  • "createdAt": 0,
  • "creator": "string",
  • "deleteCount": 0,
  • "id": "string",
  • "image": "string",
  • "isPublished": true,
  • "projectId": "string",
  • "publishedAt": 0,
  • "readConfirmation": true,
  • "readConfirmationText": "string",
  • "readCount": 0,
  • "recipientGroups": [
    ],
  • "recipientsCount": 0,
  • "timeZone": "Europe/Berlin",
  • "title": "string",
  • "type": "Custom",
  • "url": "string"
}

Notification (Default)

Get account notification

This endpoint is for fetching a specific account notification.

path Parameters
id
required
string

Notification ID

header Parameters
Session
required
string

JWT

Accept-Language
string

client language(s)

Responses

Response samples

Content type
application/json
{
  • "attachments": [
    ],
  • "content": "string",
  • "creator": "string",
  • "id": "string",
  • "image": "string",
  • "isPruned": true,
  • "isRead": true,
  • "linkedProjectIds": [
    ],
  • "projectId": "string",
  • "publishedAt": 0,
  • "readConfirmation": true,
  • "readConfirmationText": "string",
  • "referenceId": "string",
  • "title": "string",
  • "translations": [
    ],
  • "type": "Appointment",
  • "url": "string"
}

Update account notification

This endpoint is for updating account notification. Notifications with read confirmation cannot be marked as unread therefore 409 will be returned.

path Parameters
id
required
string

Notification ID

header Parameters
Session
required
string

JWT

Request Body schema: application/json

notification to be updated

isNotificationRead
boolean

Responses

Request samples

Content type
application/json
{
  • "isNotificationRead": true
}

Response samples

Content type
application/json
{
  • "isNotificationRead": true
}

Delete account notification

This endpoint is for deleting account notification. Deleting unread notification with read confirmation will return 409.

path Parameters
id
required
string

Notification ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "status": "ok"
}

Read all account notifications

This endpoint is for updating all account notifications to read. Only notifications without read confirmation will be marked as read.

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
[
  • "string"
]

Get vapid public key

This endpoint returns the vapid public key needed for using browser push for Chrome, Edge & Firefox.

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "vapidPublicKey": "string"
}

Get all account notifications

This endpoint returns all account notifications in default representation. If a limit is set, a cursor for this endpoint may be created to iterate over all account notifications.

query Parameters
cursor
string

id of the cursor used for pagination; required if page is set

limit
integer

amount of results per page (1 ... 100)

page
integer

current page index of the cursor used for pagination; required if cursor is set

header Parameters
Session
required
string

JWT

Accept-Language
string

client language(s)

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Delete account notifications

This endpoint is for deleting account notifications. Request containing IDs of notifications with read confirmation will result 400.

header Parameters
Session
required
string

JWT

Request Body schema: application/json

ids of the notifications to delete

Array
string

Responses

Request samples

Content type
application/json
[
  • "string"
]

Response samples

Content type
application/json
{
  • "status": "ok"
}

Read account notifications

This endpoint is for updating account notifications to read. Request containing IDs of notifications with read confirmation will result 400.

header Parameters
Session
required
string

JWT

Request Body schema: application/json

notification ids to be updated

Array
string

Responses

Request samples

Content type
application/json
[
  • "string"
]

Response samples

Content type
application/json
{
  • "status": "ok"
}

Get safari settings

This endpoint returns the needed configuration for using browser push for Safari.

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{}

Unread account notifications

This endpoint is for updating account notifications to unread. Request containing IDs of notifications with read confirmation will result 400.

header Parameters
Session
required
string

JWT

Request Body schema: application/json

notification ids to be updated

Array
string

Responses

Request samples

Content type
application/json
[
  • "string"
]

Response samples

Content type
application/json
{
  • "status": "ok"
}

Notification Job (Admin)

Get job

This endpoint returns a job in administrative representation by given id.

only accessible with permission : "ManageConfiguration"

fully accessible with permission : "ManageConfiguration"

path Parameters
id
required
string

Job ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "attachments": [
    ],
  • "emailBody": "string",
  • "emailEditorConfig": "string",
  • "emailReplyTo": "string",
  • "emailSenderAddress": "string",
  • "emailSenderName": "string",
  • "enabled": true,
  • "id": "string",
  • "isCustomized": true,
  • "isSystem": true,
  • "previewLine": "string",
  • "projectId": "string",
  • "recipients": {
    },
  • "status": "Draft",
  • "subject": "string",
  • "title": "string",
  • "triggerCron": "string",
  • "triggerCronTopic": "Newsletter",
  • "triggerEvent": "AccountCreatedWithoutPwAndSendMailImport"
}

Delete Notification Job

This endpoint is for deleting a single Notification Job.

only accessible with permission : "ManageConfiguration"

fully accessible with permission : "ManageConfiguration"

path Parameters
id
required
string

Job ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "status": "ok"
}

Update job

This endpoint is for updating specific data of an existing job. In case of response status is 205 the request was only executed partial. Use GET to receive the stored configuration.

Note: email will send without attachments if attachments exceed limit of 16MiB (16.7MB)

only accessible with permission : "ManageConfiguration"

fully accessible with permission : "ManageConfiguration"

path Parameters
id
required
string

Job ID

header Parameters
Session
required
string

JWT

Request Body schema: application/json

job data to be updated

attachments
Array of strings

media ids; currently not translatable

emailBody
string
emailEditorConfig
string
emailReplyTo
string or null

currently not translatable

emailSenderName
string <= 100 characters

max 100 characters; currently not translatable

previewLine
string <= 90 characters

max 90 characters

object (model.NotificationRecipients)
status
string
Enum: "Draft" "Live" "Archived"
subject
string <= 255 characters

max 255 characters

title
string
triggerCron
string or null

format: "* * * * *"; must be null when triggerEvent is not null

Responses

Request samples

Content type
application/json
{
  • "attachments": [
    ],
  • "emailBody": "string",
  • "emailEditorConfig": "string",
  • "emailReplyTo": "string",
  • "emailSenderName": "string",
  • "previewLine": "string",
  • "recipients": {
    },
  • "status": "Draft",
  • "subject": "string",
  • "title": "string",
  • "triggerCron": "string"
}

Response samples

Content type
application/json
{
  • "attachments": [
    ],
  • "emailBody": "string",
  • "emailEditorConfig": "string",
  • "emailReplyTo": "string",
  • "emailSenderAddress": "string",
  • "emailSenderName": "string",
  • "enabled": true,
  • "id": "string",
  • "isCustomized": true,
  • "isSystem": true,
  • "previewLine": "string",
  • "projectId": "string",
  • "recipients": {
    },
  • "status": "Draft",
  • "subject": "string",
  • "title": "string",
  • "triggerCron": "string",
  • "triggerCronTopic": "Newsletter",
  • "triggerEvent": "AccountCreatedWithoutPwAndSendMailImport"
}

Test job content

This endpoint is for testing job data.

Note: email will send without attachments if attachments exceed limit of 16MiB (16.7MB)

only accessible with permission : "ManageConfiguration"

fully accessible with permission : "ManageConfiguration"

header Parameters
Session
required
string

JWT

Accept-Language
string

client language(s)

Request Body schema: application/json

job data to be tested

attachments
Array of strings

media ids; currently not translatable

emailBody
string
emailReplyTo
string or null

currently not translatable

emailSenderName
string <= 100 characters

max 100 characters; currently not translatable

language
string <optional>

if no language is selected the email will be sent for the default language of the system

previewLine
string <= 90 characters

max 90 characters

projectId
string or null

must be null when triggerEvent is not null

object (model.NotificationRecipients)
subject
string <= 255 characters

max 255 characters

triggerCronTopic
string or null
Value: "Newsletter"

must be null when triggerEvent is not null; must be not null, when triggerEvent is null

triggerEvent
string or null
Enum: "AccountCreatedWithoutPwAndSendMailImport" "AccountCreatedWithPwAndSendMailAdminOrImport" "AccountCreateRequestDefault" "AccountCreateRequestDefaultConflict" "AccountUpdatedNotCredentialsAndSendMailImport" "AccountUpdatedCredentialsAndSendMailImport" "AccountUpdatedEmailDefault" "AccountUpdateEmailRequestDefault" "AccountUpdateEmailRequestDefaultConflict" "AccountUpdatePasswordRequestDefault" "AppointmentCancellation" "AppointmentRequest" "AppointmentResponse" "CalendarChatMention" "ChatFeedMention" "CustomNotificationPublished" "ImprintUpdated" "JourneyNotificationPublished" "NewsPublished" "PolicyUpdated" "TermsUpdated"

Responses

Request samples

Content type
application/json
{
  • "attachments": [
    ],
  • "emailBody": "string",
  • "emailReplyTo": "string",
  • "emailSenderName": "string",
  • "language": "string",
  • "previewLine": "string",
  • "projectId": "string",
  • "recipients": {
    },
  • "subject": "string",
  • "triggerCronTopic": "Newsletter",
  • "triggerEvent": "AccountCreatedWithoutPwAndSendMailImport"
}

Response samples

Content type
application/json
{
  • "status": "ok"
}

Get job list for project

This endpoint returns a list of all jobs. If a limit is set, a cursor for this endpoint may be created to iterate over all jobs.

only accessible with permission : "ManageConfiguration"

fully accessible with permission : "ManageConfiguration"

query Parameters
cursor
string

id of the cursor used for pagination; required if page is set

limit
integer

amount of results per page (1 ... 100)

page
integer

current page index of the cursor used for pagination; required if cursor is set

header Parameters
Session
required
string

JWT

Accept-Language
string

client language(s)

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Create job

This endpoint is for creating a notification job. In case of response status is 205 the request was performed, but the request data could not be created. Use GET to receive the stored notification job data.

only accessible with permission : "ManageConfiguration"

fully accessible with permission : "ManageConfiguration"

header Parameters
Session
required
string

JWT

Request Body schema: application/json

job to create

attachments
Array of strings

media ids; currently not translatable

emailBody
string
emailEditorConfig
string
emailReplyTo
string or null

currently not translatable

emailSenderName
string <= 100 characters

max 100 characters; currently not translatable

previewLine
string <= 90 characters

max 90 characters

projectId
string or null

must be null when triggerEvent is not null

object (model.NotificationRecipients)
status
string
Enum: "Draft" "Live" "Archived"
subject
string <= 255 characters

max 255 characters

title
string
triggerCron
string or null

format: "* * * * *"; must be null when triggerEvent is not null

triggerCronTopic
string or null
Value: "Newsletter"

must be null when triggerEvent is not null; must be not null, when triggerEvent is null

triggerEvent
string or null
Enum: "AccountCreatedWithoutPwAndSendMailImport" "AccountCreatedWithPwAndSendMailAdminOrImport" "AccountCreateRequestDefault" "AccountCreateRequestDefaultConflict" "AccountUpdatedNotCredentialsAndSendMailImport" "AccountUpdatedCredentialsAndSendMailImport" "AccountUpdatedEmailDefault" "AccountUpdateEmailRequestDefault" "AccountUpdateEmailRequestDefaultConflict" "AccountUpdatePasswordRequestDefault" "AppointmentCancellation" "AppointmentRequest" "AppointmentResponse" "CalendarChatMention" "ChatFeedMention" "CustomNotificationPublished" "ImprintUpdated" "JourneyNotificationPublished" "NewsPublished" "PolicyUpdated" "TermsUpdated"

Responses

Request samples

Content type
application/json
{
  • "attachments": [
    ],
  • "emailBody": "string",
  • "emailEditorConfig": "string",
  • "emailReplyTo": "string",
  • "emailSenderName": "string",
  • "previewLine": "string",
  • "projectId": "string",
  • "recipients": {
    },
  • "status": "Draft",
  • "subject": "string",
  • "title": "string",
  • "triggerCron": "string",
  • "triggerCronTopic": "Newsletter",
  • "triggerEvent": "AccountCreatedWithoutPwAndSendMailImport"
}

Response samples

Content type
application/json
{
  • "attachments": [
    ],
  • "emailBody": "string",
  • "emailEditorConfig": "string",
  • "emailReplyTo": "string",
  • "emailSenderAddress": "string",
  • "emailSenderName": "string",
  • "enabled": true,
  • "id": "string",
  • "isCustomized": true,
  • "isSystem": true,
  • "previewLine": "string",
  • "projectId": "string",
  • "recipients": {
    },
  • "status": "Draft",
  • "subject": "string",
  • "title": "string",
  • "triggerCron": "string",
  • "triggerCronTopic": "Newsletter",
  • "triggerEvent": "AccountCreatedWithoutPwAndSendMailImport"
}

Get default job

This endpoint returns the default job in administrative representation by given id.

only accessible with permission : "ManageConfiguration"

fully accessible with permission : "ManageConfiguration"

path Parameters
id
required
string

Job ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "attachments": [
    ],
  • "emailBody": "string",
  • "emailEditorConfig": "string",
  • "emailReplyTo": "string",
  • "emailSenderAddress": "string",
  • "emailSenderName": "string",
  • "enabled": true,
  • "id": "string",
  • "isCustomized": true,
  • "isSystem": true,
  • "previewLine": "string",
  • "projectId": "string",
  • "recipients": {
    },
  • "status": "Draft",
  • "subject": "string",
  • "title": "string",
  • "triggerCron": "string",
  • "triggerCronTopic": "Newsletter",
  • "triggerEvent": "AccountCreatedWithoutPwAndSendMailImport"
}

One time token

Validate one time token

This endpoint validates given one time token. The one time token must also match the platform. Only if provided token is valid it returns 200.

accessible without permission

header Parameters
Platform
string
Enum: "Cms" "Android" "Ios" "Web"

The client platform

Request Body schema: application/json

one time token

token
string

Responses

Request samples

Content type
application/json
{
  • "token": "hvYDpWUa2RaTCAfuxFIlj)hNlF$k0"
}

Response samples

Content type
application/json
{
  • "status": "ok"
}

Page (Admin)

Get page mobile content

This endpoint returns the localized mobile content of a specific page in administrative representation by given id.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Page ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Update page mobile content

This endpoint is for updating the mobile content of an existing page.

For storing desktop version use: PUT /page/admin/{id}/content/desktop

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Page ID

header Parameters
Session
required
string

JWT

Request Body schema: application/json

standard page content to update

Array
object <optional>

Default: {"any": "Read", "user": "Read", "accounts": {}, "groups": {}}

backgroundColor
string or null

background color in light mode or null for transparent; hexcolor or enum: "backgroundPrimary" "backgroundSecondary" "backgroundTertiary" "border" "contrast" "error" "primary" "secondary" "success" "textPrimary" "textSecondary"

backgroundColorDark
string or null

background color in dark mode or null for transparent; hexcolor or enum: "backgroundPrimary" "backgroundSecondary" "backgroundTertiary" "border" "contrast" "error" "primary" "secondary" "success" "textPrimary" "textSecondary"

Array of objects (page.RequestColumn)
contentType
string
Enum: "100" "50:50" "25:75" "75:25" "33:33:33" "25:50:25" "50:25:25" "25:25:50" "25:25:25:25"

25:25:25:25 only fits for desktop columns

id
string or null

new sections to create do not have an id

Responses

Request samples

Content type
application/json
[
  • {
    }
]

Response samples

Content type
application/json
[
  • {
    }
]

Get page list for project

This endpoint returns a list of all pages for the requested project without content in administrative representation. If a limit is set, a cursor for this endpoint may be created to iterate over all pages.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Project ID

query Parameters
cursor
string

id of the cursor used for pagination; required if page is set

limit
integer

amount of results per page (1 ... 100)

page
integer

current page index of the cursor used for pagination; required if cursor is set

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get page desktop content

This endpoint returns the localized desktop version of page if it exists in admin representation by given id. If the requested language is not available it will fall back to the default language.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Page ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "access": {
    },
  • "accessEditAllowed": true,
  • "content": [
    ],
  • "creator": "string",
  • "description": "string",
  • "id": "string",
  • "keywordIds": [
    ],
  • "projectId": "string",
  • "publishedAt": 0,
  • "settings": {
    },
  • "status": "Draft",
  • "title": "string"
}

Sync Operators for all pages

This endpoint is sync operators for all pages with sendbird. This endpoint should be rarely used, because of its workload.

only accessible with permission : "ManageProjects"

fully accessible with permission : "ManageProjects"

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "status": "ok"
}

Get page

This endpoint returns a localized page in administrative representation by given id.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Page ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "access": {
    },
  • "accessEditAllowed": true,
  • "content": [
    ],
  • "creator": "string",
  • "description": "string",
  • "id": "string",
  • "keywordIds": [
    ],
  • "projectId": "string",
  • "publishedAt": 0,
  • "settings": {
    },
  • "status": "Draft",
  • "title": "string"
}

Delete page

This endpoint is for deleting a single page with all localizations.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Page ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "status": "ok"
}

Update page

This endpoint is for updating the page besides content and settings.

For storing content or settings use: PUT /page/admin/{id}/content AND PUT /page/admin/{id}/settings

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Page ID

header Parameters
Session
required
string

JWT

Request Body schema: application/json

page data to update

description
string
keywordIds
Array of strings
status
string
Enum: "Draft" "Published"
title
string

Responses

Request samples

Content type
application/json
{
  • "description": "string",
  • "keywordIds": [
    ],
  • "status": "Draft",
  • "title": "string"
}

Response samples

Content type
application/json
{
  • "access": {
    },
  • "accessEditAllowed": true,
  • "content": [
    ],
  • "creator": "string",
  • "description": "string",
  • "id": "string",
  • "keywordIds": [
    ],
  • "projectId": "string",
  • "publishedAt": 0,
  • "settings": {
    },
  • "status": "Draft",
  • "title": "string"
}

Get page desktop content

This endpoint returns the localized mobile content of a specific page in administrative representation by given id.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Page ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Update page desktop content

This endpoint is for creating or updating the desktop content of an existing page.

For storing mobile version use: PUT /page/admin/{id}/content

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Page ID

header Parameters
Session
required
string

JWT

Request Body schema: application/json

desktop page content to update

Array
object <optional>

Default: {"any": "Read", "user": "Read", "accounts": {}, "groups": {}}

backgroundColor
string or null

background color in light mode or null for transparent; hexcolor or enum: "backgroundPrimary" "backgroundSecondary" "backgroundTertiary" "border" "contrast" "error" "primary" "secondary" "success" "textPrimary" "textSecondary"

backgroundColorDark
string or null

background color in dark mode or null for transparent; hexcolor or enum: "backgroundPrimary" "backgroundSecondary" "backgroundTertiary" "border" "contrast" "error" "primary" "secondary" "success" "textPrimary" "textSecondary"

Array of objects (page.RequestColumn)
contentType
string
Enum: "100" "50:50" "25:75" "75:25" "33:33:33" "25:50:25" "50:25:25" "25:25:50" "25:25:25:25"

25:25:25:25 only fits for desktop columns

id
string or null

new sections to create do not have an id

Responses

Request samples

Content type
application/json
[
  • {
    }
]

Response samples

Content type
application/json
[
  • {
    }
]

Delete desktop content

This endpoint will delete the desktop version of a page, but not the page itself. The mobile version will still exist.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Page ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "status": "ok"
}

Get page access configuration

This endpoint returns the access configuration for the requested page.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Page ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "access": {
    },
  • "accessEditAllowed": true
}

Update page access configuration

This endpoint updates the access configuration for the requested page. Only the changes should be transmitted due this endpoint.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Page ID

header Parameters
Session
required
string

JWT

Request Body schema: application/json

changed access rights

object

accountId to operation; null for operation removes access

any
string or null
Enum: "Read" "Write" "Delete" "Create" "changeProof"

Delete (includes) Write (includes) Read; null for operation removes access

object

groupId to operation; null for operation removes access

user
string or null
Enum: "Read" "Write" "Delete" "Create" "changeProof"

Delete (includes) Write (includes) Read; null for operation removes access

Responses

Request samples

Content type
application/json
{
  • "accounts": {
    },
  • "any": "Read",
  • "groups": {
    },
  • "user": "Read"
}

Response samples

Content type
application/json
{
  • "accounts": {
    },
  • "any": "Read",
  • "groups": {
    },
  • "user": "Read"
}

Get page settings

This endpoint returns the settings of a specific page in administrative representation by given id.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Page ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "backgroundDarkPrimary": "#000000",
  • "backgroundDarkSecondary": "#000000",
  • "backgroundImage": "string",
  • "backgroundLightPrimary": "#FFFFFF",
  • "backgroundLightSecondary": "#FFFFFF",
  • "backgroundType": "Gradient",
  • "interaction": true,
  • "showTitle": true
}

Update page settings

This endpoint updates the settings of a specific page returns it.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Page ID

header Parameters
Session
required
string

JWT

Request Body schema: application/json

the settings of the page

backgroundDarkPrimary
string

only used for backgroundType{Gradient|Color}; hexcolor or enum: "backgroundPrimary" "backgroundSecondary" "backgroundTertiary" "border" "contrast" "error" "primary" "secondary" "success" "textPrimary" "textSecondary"

backgroundDarkSecondary
string

only used for backgroundType{Gradient}; hexcolor or enum: "backgroundPrimary" "backgroundSecondary" "backgroundTertiary" "border" "contrast" "error" "primary" "secondary" "success" "textPrimary" "textSecondary"

backgroundImage
string or null

media id only used for backgroundType{Image}

backgroundLightPrimary
string

only used for backgroundType{Gradient|Color}; hexcolor or enum: "backgroundPrimary" "backgroundSecondary" "backgroundTertiary" "border" "contrast" "error" "primary" "secondary" "success" "textPrimary" "textSecondary"

backgroundLightSecondary
string

only used for backgroundType{Gradient}; hexcolor or enum: "backgroundPrimary" "backgroundSecondary" "backgroundTertiary" "border" "contrast" "error" "primary" "secondary" "success" "textPrimary" "textSecondary"

backgroundType
string
Enum: "Gradient" "Color" "Transparent" "Image"
interaction
boolean

flag if social interaction is allowed

showTitle
boolean

flag if title of a page should be shown or not

Responses

Request samples

Content type
application/json
{
  • "backgroundDarkPrimary": "#000000",
  • "backgroundDarkSecondary": "#000000",
  • "backgroundImage": "string",
  • "backgroundLightPrimary": "#FFFFFF",
  • "backgroundLightSecondary": "#FFFFFF",
  • "backgroundType": "Gradient",
  • "interaction": true,
  • "showTitle": true
}

Response samples

Content type
application/json
[
  • {
    }
]

Create page

This endpoint is for creating a new page. The page will be saves as standard (mobile) version.

For storing desktop version use: PUT /page/admin/{id}/content/desktop

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

header Parameters
Session
required
string

JWT

Request Body schema: application/json

standard page to create

object (model.Access)
Array of objects (page.RequestSection)
description
string
keywordIds
Array of strings
projectId
string
object (model.PageSettings)
status
string
Enum: "Draft" "Published"
title
string

Responses

Request samples

Content type
application/json
{
  • "access": {
    },
  • "content": [
    ],
  • "description": "string",
  • "keywordIds": [
    ],
  • "projectId": "string",
  • "settings": {
    },
  • "status": "Draft",
  • "title": "string"
}

Response samples

Content type
application/json
{
  • "access": {
    },
  • "accessEditAllowed": true,
  • "content": [
    ],
  • "creator": "string",
  • "description": "string",
  • "id": "string",
  • "keywordIds": [
    ],
  • "projectId": "string",
  • "publishedAt": 0,
  • "settings": {
    },
  • "status": "Draft",
  • "title": "string"
}

Get page post counts for project

This endpoint returns a list of post counts for all pages with social interaction activated of the requested project. If a limit is set, a cursor for this endpoint may be created to iterate over all post counts.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Project ID

query Parameters
cursor
string

id of the cursor used for pagination; required if page is set

limit
integer

amount of results per page (1 ... 100)

page
integer

current page index of the cursor used for pagination; required if cursor is set

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Page (Default)

Get page post count

This endpoint returns the post count of the requested page.

accessible without permission

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Page ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "id": "string",
  • "postCount": 0
}

Get page

This endpoint returns a localized page in default user representation by given id.

For preview use: GET /page/default/{id}/preview

If the requested language is not available it will fall back to the default language.

accessible without permission

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Page ID

header Parameters
Accept-Language
string

client language(s)

Session
string

JWT

Responses

Response samples

Content type
application/json
{
  • "channelId": "string",
  • "content": [
    ],
  • "createdAt": 0,
  • "creator": "string",
  • "hasDesktop": true,
  • "id": "string",
  • "keywordIds": [
    ],
  • "lastModified": 0,
  • "pagePlatform": "Mobile",
  • "projectId": "string",
  • "publishedAt": 0,
  • "settings": {
    },
  • "status": "Draft",
  • "title": "string",
  • "translations": [
    ]
}

Get page post counts for project

This endpoint returns a list of post counts for all published pages with social interaction activated of the requested project. If a limit is set, a cursor for this endpoint may be created to iterate over all post counts.

accessible without permission

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Project ID

query Parameters
cursor
string

id of the cursor used for pagination; required if page is set

limit
integer

amount of results per page (1 ... 100)

page
integer

current page index of the cursor used for pagination; required if cursor is set

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get page desktop content

This endpoint returns a localized page for desktop in default user representation by given id. If there is no specific desktop version of the page the standard (mobile) version of the page will be selected.

For preview use: GET /page/default/{id}/preview/desktop

If the requested language is not available it will fall back to the default language.

accessible without permission

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Page ID

header Parameters
Accept-Language
string

client language(s)

Session
string

JWT

Responses

Response samples

Content type
application/json
{
  • "channelId": "string",
  • "content": [
    ],
  • "createdAt": 0,
  • "creator": "string",
  • "hasDesktop": true,
  • "id": "string",
  • "keywordIds": [
    ],
  • "lastModified": 0,
  • "pagePlatform": "Mobile",
  • "projectId": "string",
  • "publishedAt": 0,
  • "settings": {
    },
  • "status": "Draft",
  • "title": "string",
  • "translations": [
    ]
}

Party (Admin)

Get reaction list for cursor

This endpoint returns a list of all reactions for a cursor in administrative representation.

Cursor could be created here: POST /party/admin/reaction/search

accessible without permission

query Parameters
cursor
required
string

id of the cursor used for pagination; required if page is set

page
required
integer

current page index of the cursor used for pagination; required if cursor is set

limit
integer

amount of results per page (1 ... 100)

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get reaction

This endpoint is for receiving a specific reaction.

only accessible with permission : "ManageAccounts"

fully accessible with permission : "ManageAccounts" + "ManageContent" "ManageProjects"

path Parameters
id
required
string

reaction id

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "accountId": "string",
  • "id": "string",
  • "partyId": "string",
  • "reaction": "Booked",
  • "reactionAt": 0,
  • "reactionFrom": "App",
  • "reactionNote": "string",
  • "ticketCode": "string"
}

Update reaction

This endpoint is for updating a specific reaction.

only accessible with permission : "ManageAccounts"

fully accessible with permission : "ManageAccounts" + "ManageContent" "ManageProjects"

path Parameters
id
required
string

reaction id

header Parameters
Session
required
string

JWT

Request Body schema: application/json

reaction to update

reaction
string
Enum: "Booked" "Declined"
reactionNote
string <optional>

Responses

Request samples

Content type
application/json
{
  • "reaction": "Booked",
  • "reactionNote": "string"
}

Response samples

Content type
application/json
{
  • "accountId": "string",
  • "id": "string",
  • "partyId": "string",
  • "reaction": "Booked",
  • "reactionAt": 0,
  • "reactionFrom": "App",
  • "reactionNote": "string",
  • "ticketCode": "string"
}

Delete reaction

This endpoint is for deleting a single reaction.

only accessible with permission : "ManageAccounts"

fully accessible with permission : "ManageAccounts" + "ManageContent" "ManageProjects"

path Parameters
id
required
string

reaction id

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "status": "ok"
}

Get party list for cursor

This endpoint returns a list of all parties for a cursor in administrative representation.

Cursor could be created here: POST /party/admin/search

accessible without permission

query Parameters
cursor
required
string

id of the cursor used for pagination; required if page is set

page
required
integer

current page index of the cursor used for pagination; required if cursor is set

limit
integer

amount of results per page (1 ... 100)

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Create party

This endpoint is for creating a new party.

accessible without permission

fully accessible with permission : "ManageContent" "ManageProjects"

header Parameters
Session
required
string

JWT

Request Body schema: application/json

party to create

object (party.RequestConfiguration)
object (deeplink.Request)

Responses

Request samples

Content type
application/json
{
  • "config": {
    },
  • "deeplink": {
    }
}

Response samples

Content type
application/json
{
  • "config": {
    },
  • "deeplink": {
    },
  • "directoryId": "string",
  • "groupId": "string",
  • "id": "string"
}

Create cursor

This endpoint returns a cursor for list reactions in admin representation with applied filter and sort options. In case of cursor response total will be 0 the status 204 with not content is returned instead.

only accessible with permission : "ManageAccounts"

fully accessible with permission : "ManageAccounts" + "ManageContent" "ManageProjects"

header Parameters
Session
required
string

JWT

Request Body schema: application/json

options to create cursor

object (git_plazz_net_repos_sandmann_backend_services_party_reaction.CursorFilterOptionAdmin)
Array of objects

only one property per entry allowed; property enums: "accountId" "partyId" "reaction" "reactionAt"; value enums: "ASC" "DESC"

Responses

Request samples

Content type
application/json
{
  • "filter": {
    },
  • "sort": [
    ]
}

Response samples

Content type
application/json
{
  • "cursor": "string",
  • "endpoints": [
    ],
  • "expiredAt": 0,
  • "total": 0
}

Create cursor

This endpoint returns a cursor for list parties in admin representation with applied filter and sort options. In case of cursor response total will be 0 the status 204 with not content is returned instead.

accessible without permission

fully accessible with permission : "ManageContent" "ManageProjects"

header Parameters
Session
required
string

JWT

Request Body schema: application/json

options to create cursor

object (party.CursorFilterOptionAdmin)
Array of objects

only one property per entry allowed; property enums: "id" "objectId" "objectType" "projectId" "referenceId"; value enums: "ASC" "DESC"

Responses

Request samples

Content type
application/json
{
  • "filter": {
    },
  • "sort": [
    ]
}

Response samples

Content type
application/json
{
  • "cursor": "string",
  • "endpoints": [
    ],
  • "expiredAt": 0,
  • "total": 0
}

Get party

This endpoint returns a party in admin representation by given id.

accessible without permission

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

party id

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "config": {
    },
  • "deeplink": {
    },
  • "directoryId": "string",
  • "groupId": "string",
  • "id": "string"
}

Delete party

This endpoint is for deleting a single party.

accessible without permission

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

party id

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "status": "ok"
}

Update party configuration

This endpoint is for updating the configuration of a specific party.

accessible without permission

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

party id

header Parameters
Session
required
string

JWT

Request Body schema: application/json

party configuration to update

bookingEnabled
boolean
Array of objects (party.RequestBookingSlot)
limit
integer

Note: null if no limit should apply

Responses

Request samples

Content type
application/json
{
  • "bookingEnabled": true,
  • "bookingSlots": [
    ],
  • "limit": 0
}

Response samples

Content type
application/json
{
  • "bookingEnabled": true,
  • "bookingSlots": [
    ],
  • "limit": 0
}

Create reaction

This endpoint is for creating a new reaction.

only accessible with permission : "ManageAccounts"

fully accessible with permission : "ManageAccounts" + "ManageContent" "ManageProjects"

path Parameters
id
required
string

party id

header Parameters
Session
required
string

JWT

Request Body schema: application/json

reaction to create

accountId
string
reaction
string
Enum: "Booked" "Declined"
reactionNote
string <optional>
ticketCode
string <optional>

Responses

Request samples

Content type
application/json
{
  • "accountId": "string",
  • "reaction": "Booked",
  • "reactionNote": "string",
  • "ticketCode": "string"
}

Response samples

Content type
application/json
{
  • "accountId": "string",
  • "id": "string",
  • "partyId": "string",
  • "reaction": "Booked",
  • "reactionAt": 0,
  • "reactionFrom": "App",
  • "reactionNote": "string",
  • "ticketCode": "string"
}

Party (Default)

Create cursor

This endpoint returns a cursor for list reactions in default representation with applied filter and sort options. In case of cursor response total will be 0 the status 204 with not content is returned instead.

only accessible with permission : "ManageAccounts"

fully accessible with permission : "ManageAccounts" + "ManageContent" "ManageProjects"

header Parameters
Session
required
string

JWT

Request Body schema: application/json

options to create cursor

object (git_plazz_net_repos_sandmann_backend_services_party_reaction.CursorFilterOptionDefault)
Array of objects

only one property per entry allowed; property enums: "partyId" "reaction" "reactionAt"; value enums: "ASC" "DESC"

Responses

Request samples

Content type
application/json
{
  • "filter": {
    },
  • "sort": [
    ]
}

Response samples

Content type
application/json
{
  • "cursor": "string",
  • "endpoints": [
    ],
  • "expiredAt": 0,
  • "total": 0
}

Get party list for cursor

This endpoint returns a list of all parties for a cursor in default representation.

Cursor could be created here: POST /party/default/search

accessible without permission

query Parameters
cursor
required
string

id of the cursor used for pagination; required if page is set

page
required
integer

current page index of the cursor used for pagination; required if cursor is set

limit
integer

amount of results per page (1 ... 100)

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get reaction list for cursor

This endpoint returns a list of all reactions for a cursor in default representation.

Cursor could be created here: POST /party/default/reaction/search

accessible without permission

query Parameters
cursor
required
string

id of the cursor used for pagination; required if page is set

page
required
integer

current page index of the cursor used for pagination; required if cursor is set

limit
integer

amount of results per page (1 ... 100)

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Create cursor

This endpoint returns a cursor for list parties in default representation with applied filter and sort options. In case of cursor response total will be 0 the status 204 with not content is returned instead.

accessible without permission

fully accessible with permission : "ManageContent" "ManageProjects"

header Parameters
Session
required
string

JWT

Request Body schema: application/json

options to create cursor

object (party.CursorFilterOptionDefault)
Array of objects

only one property per entry allowed; property enums: "id" "objectId" "objectType" "projectId" "referenceId"; value enums: "ASC" "DESC"

Responses

Request samples

Content type
application/json
{
  • "filter": {
    },
  • "sort": [
    ]
}

Response samples

Content type
application/json
{
  • "cursor": "string",
  • "endpoints": [
    ],
  • "expiredAt": 0,
  • "total": 0
}

Get reaction

This endpoint returns the reaction for the own account for given party id.

accessible without permission

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

party id

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "accountId": "string",
  • "partyId": "string",
  • "reaction": "Booked",
  • "reactionAt": 0,
  • "reactionNote": "string",
  • "ticketCode": "string"
}

Set reaction

This endpoint updates the reaction for the own account for given party id.

accessible without permission

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

party id

header Parameters
Session
required
string

JWT

Request Body schema: application/json

reaction

reaction
string
Enum: "Booked" "Declined"
reactionNote
string <optional>

Responses

Request samples

Content type
application/json
{
  • "reaction": "Booked",
  • "reactionNote": "string"
}

Response samples

Content type
application/json
{
  • "status": "ok"
}

Get parties for reference

This endpoint returns all parties for the provided reference in default representation. If the limit is set, a cursor for this endpoint may be created to iterate over all locations.

Note: for objectType CalendarEntry config.bookingSlots.dateEnd and config.bookingSlots.timeEnd will not be null; objectId is calendarId (referenceId)

accessible without permission

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
objectType
required
string
Value: "CalendarEntry"

object type

objectId
required
string

reference id

query Parameters
cursor
string

id of the cursor used for pagination; required if page is set

limit
integer

amount of results per page (1 ... 100)

page
integer

current page index of the cursor used for pagination; required if cursor is set

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get party

This endpoint returns a party in default representation by given id.

Note: for objectType CalendarEntry config.bookingSlots.dateEnd and config.bookingSlots.timeEnd will not be null

accessible without permission

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
objectType
required
string
Value: "CalendarEntry"

object type

objectId
required
string

object id

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "config": {
    },
  • "deeplink": {
    },
  • "id": "string",
  • "ownReaction": "Booked"
}

Permission

Check permission existence

This endpoint checks if a given user or any has the desired permission

In case of response status is 403 the user does not have the requested permission.

accessible without permission

path Parameters
permission
required
string
Enum: "AccessPreview" "ManageAccounts" "ManageCheckIns" "ManageConfiguration" "ManageContent" "ManageGlobalMedia" "ManageGlobalRoles" "ManagePosts" "ManageProjects" "ViewAnalytics" "ViewGlobalAnalytics"

The permission to check

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "association": "Global",
  • "projectIds": [
    ]
}

List permissions

This endpoint returns all available permissions for association with localization.

only accessible with permission : "ManageAccounts" "ManageGlobalRoles"

fully accessible with permission : "ManageAccounts" "ManageGlobalRoles"

header Parameters
Session
required
string

JWT

Accept-Language
string

client language(s)

Responses

Response samples

Content type
application/json
{
  • "Global": [
    ],
  • "Project": [
    ]
}

Project

guest visit

This endpoint is for tracking guest account.

accessible without permission

path Parameters
id
required
string

Project ID

Request Body schema: application/json

device id

deviceId
string

Responses

Request samples

Content type
application/json
{
  • "deviceId": "string"
}

Response samples

Content type
application/json
{
  • "status": "ok"
}

Project (Admin)

Get project list

This endpoint returns an array of all projects. The output is in administrative representation and filtered for the user permissions. If a limit is set, a cursor for this endpoint may be created to iterate over all projects.

only accessible with permission : "ManageConfiguration" "ManageContent" "ManageProjects" "ViewAnalytics" "ViewGlobalAnalytics"

fully accessible with permission : "ManageConfiguration" "ManageContent" "ManageProjects" "ViewAnalytics" "ViewGlobalAnalytics"

query Parameters
cursor
string

id of the cursor used for pagination; required if page is set

limit
integer

amount of results per page (1 ... 100)

page
integer

current page index of the cursor used for pagination; required if cursor is set

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Create project

This endpoint is for creating a new project.

createAccesses.AppointmentConfig.any: must be false; true currently not supported

createAccesses.Calendar.any: must be false; true currently not supported

createAccesses.CalendarTemplate.any: must be false; true currently not supported

createAccesses.ChatFeed.any: must be false; true currently not supported

createAccesses.Directory.any: must be false; true currently not supported

createAccesses.DirectoryTemplate.any: must be false; true currently not supported

createAccesses.Group.any: must be false; true currently not supported

createAccesses.Location.any: must be false; true currently not supported

createAccesses.LocationMap.any: must be false; true currently not supported

createAccesses.Media.any: must be false; true currently not supported

createAccesses.MediaFolder.any: must be false; true currently not supported

createAccesses.Menu.any: must be false; true currently not supported

createAccesses.News.any: must be false; true currently not supported

createAccesses.Notification.any: must be false; true currently not supported

createAccesses.Page.any: must be false; true currently not supported

createAccesses.Stream.any: must be false; true currently not supported

newsletter : is nullable -> null if newsletter is disabled for this project.

only accessible with permission : "ManageProjects"

fully accessible with permission : "ManageProjects"

header Parameters
Session
required
string

JWT

Request Body schema: application/json

Project to create

object (model.Access)
object <optional>

property enums: "AppointmentConfig" "Calendar" "CalendarTemplate" "ChatFeed" "Directory" "DirectoryTemplate" "Group" "Location" "LocationMap" "Media" "MediaFolder" "Menu" "News" "Notification" "Page" "Stream"; see route description for additional information; Default for all property enums: {"any": "false", "user": "false", "accounts": {}, "groups": {}}

description
string
featured
boolean
image
string or null

currently not translatable

position
integer
scheme
string or null <optional>

scheme id; Default: null

status
string
Enum: "Archived" "Draft" "Published"
timeZone
string

IANA Time Zone

title
string

Responses

Request samples

Content type
application/json
{
  • "access": {
    },
  • "createAccesses": {
    },
  • "description": "Project A is a nice project",
  • "featured": true,
  • "image": "5e54fbf7f1ce6fa77f0a2821",
  • "position": 0,
  • "scheme": "string",
  • "status": "Archived",
  • "timeZone": "string",
  • "title": "Project A"
}

Response samples

Content type
application/json
{
  • "access": {
    },
  • "accessEditAllowed": true,
  • "createAccesses": {
    },
  • "description": "Project A is a nice project",
  • "featured": true,
  • "firstPublishedAt": 0,
  • "grantedAction": "Read",
  • "id": "string",
  • "image": "5e54fbf7f1ce6fa77f0a2821",
  • "position": 0,
  • "redirectGroupIds": [
    ],
  • "scheme": "string",
  • "status": "Archived",
  • "timeZone": "string",
  • "title": "Project A",
  • "trackingEnabledAt": 0
}

Get project settings

This endpoint returns the settings for the requested project.

only accessible with permission : "ManageConfiguration"

fully accessible with permission : "ManageConfiguration"

path Parameters
id
required
string

Project ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "tracking": {
    }
}

Get project

This endpoint returns a localized project in administrative representation by given id.

only accessible with permission : "ManageConfiguration" "ManageContent" "ManageProjects" "ViewAnalytics" "ViewGlobalAnalytics"

fully accessible with permission : "ManageConfiguration" "ManageContent" "ManageProjects" "ViewAnalytics" "ViewGlobalAnalytics"

path Parameters
id
required
string

Project ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "access": {
    },
  • "accessEditAllowed": true,
  • "createAccesses": {
    },
  • "description": "Project A is a nice project",
  • "featured": true,
  • "firstPublishedAt": 0,
  • "grantedAction": "Read",
  • "id": "string",
  • "image": "5e54fbf7f1ce6fa77f0a2821",
  • "position": 0,
  • "redirectGroupIds": [
    ],
  • "scheme": "string",
  • "status": "Archived",
  • "timeZone": "string",
  • "title": "Project A",
  • "trackingEnabledAt": 0
}

Delete project

This endpoint is for deleting a single project with all localizations. Projects with status to be "Copying" cannot be manipulated, status 409 Conflict will be returned.

only accessible with permission : "ManageProjects"

fully accessible with permission : "ManageProjects"

path Parameters
id
required
string

Project ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "status": "ok"
}

Update project

This endpoint is for updating specific data of an existing project. Projects with status to be "Copying" cannot be manipulated, status 409 Conflict will be returned.

createAccesses.AppointmentConfig.any: must be false; true currently not supported

createAccesses.Calendar.any: must be false; true currently not supported

createAccesses.CalendarTemplate.any: must be false; true currently not supported

createAccesses.ChatFeed.any: must be false; true currently not supported

createAccesses.Directory.any: must be false; true currently not supported

createAccesses.DirectoryTemplate.any: must be false; true currently not supported

createAccesses.Group.any: must be false; true currently not supported

createAccesses.Location.any: must be false; true currently not supported

createAccesses.LocationMap.any: must be false; true currently not supported

createAccesses.Media.any: must be false; true currently not supported

createAccesses.MediaFolder.any: must be false; true currently not supported

createAccesses.Menu.any: must be false; true currently not supported

createAccesses.News.any: must be false; true currently not supported

createAccesses.Notification.any: must be false; true currently not supported

createAccesses.Page.any: must be false; true currently not supported

createAccesses.Stream.any: must be false; true currently not supported

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Project ID

header Parameters
Session
required
string

JWT

Request Body schema: application/json

project data to be updated

object

property enums: "AppointmentConfig" "Calendar" "CalendarTemplate" "ChatFeed" "Directory" "DirectoryTemplate" "Group" "Location" "LocationMap" "Media" "MediaFolder" "Menu" "News" "Notification" "Page" "Stream"; see route description for additional information

description
string
featured
boolean
image
string or null

currently not translatable

position
integer
redirectGroupIds
Array of strings

a list of group ids of that project

scheme
string or null

scheme id

status
string
Enum: "Archived" "Draft" "Published"
timeZone
string

IANA Time Zone

title
string

Responses

Request samples

Content type
application/json
{
  • "createAccesses": {
    },
  • "description": "Project A is a nice project",
  • "featured": true,
  • "image": "5e54fbf7f1ce6fa77f0a2821",
  • "position": 0,
  • "redirectGroupIds": [
    ],
  • "scheme": "string",
  • "status": "Archived",
  • "timeZone": "string",
  • "title": "Project A"
}

Response samples

Content type
application/json
{
  • "access": {
    },
  • "accessEditAllowed": true,
  • "createAccesses": {
    },
  • "description": "Project A is a nice project",
  • "featured": true,
  • "firstPublishedAt": 0,
  • "grantedAction": "Read",
  • "id": "string",
  • "image": "5e54fbf7f1ce6fa77f0a2821",
  • "position": 0,
  • "redirectGroupIds": [
    ],
  • "scheme": "string",
  • "status": "Archived",
  • "timeZone": "string",
  • "title": "Project A",
  • "trackingEnabledAt": 0
}

Duplicate project

This endpoint is for duplicating a project and returns the process status with its id.

only accessible with permission : "ManageProjects"

fully accessible with permission : "ManageProjects"

path Parameters
id
required
string

Project ID

header Parameters
Session
required
string

JWT

Request Body schema: application/json

Copy config

copyGroupAccounts
boolean

must be false when copyGroups is false

copyGroupStructure
boolean
title
string

Responses

Request samples

Content type
application/json
{
  • "copyGroupAccounts": true,
  • "copyGroupStructure": true,
  • "title": "string"
}

Response samples

Content type
application/json
{
  • "config": {
    },
  • "id": "string",
  • "newProjectId": "string",
  • "processStatusDetail": {
    },
  • "processedData": [
    ],
  • "status": "Processing"
}

Get project access configuration

This endpoint returns the access configuration for the requested project.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Project ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "access": {
    },
  • "accessEditAllowed": true
}

Update project access configuration

This endpoint updates the access configuration for the requested project. Only the changes should be transmitted due this endpoint. Projects with status to be "Copying" cannot be manipulated, status 409 Conflict will be returned.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Project ID

header Parameters
Session
required
string

JWT

Request Body schema: application/json

changed access rights

object

accountId to operation; null for operation removes access

any
string or null
Enum: "Read" "Write" "Delete" "Create" "changeProof"

Delete (includes) Write (includes) Read; null for operation removes access

object

groupId to operation; null for operation removes access

user
string or null
Enum: "Read" "Write" "Delete" "Create" "changeProof"

Delete (includes) Write (includes) Read; null for operation removes access

Responses

Request samples

Content type
application/json
{
  • "accounts": {
    },
  • "any": "Read",
  • "groups": {
    },
  • "user": "Read"
}

Response samples

Content type
application/json
{
  • "accounts": {
    },
  • "any": "Read",
  • "groups": {
    },
  • "user": "Read"
}

Get project tracking settings

This endpoint returns the tracking settings for the requested project.

only accessible with permission : "ManageConfiguration" "ViewAnalytics" "ViewGlobalAnalytics"

fully accessible with permission : "ManageConfiguration" "ViewAnalytics" "ViewGlobalAnalytics"

path Parameters
id
required
string

Project ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "enabled": true,
  • "matomoAuthToken": "string",
  • "matomoSiteId": 0,
  • "matomoUrl": "string",
  • "tokenExpires": 0
}

Update project tracking settings

This endpoint is for updating the tracking settings of an existing project. Projects with status to be "Copying" cannot be manipulated, status 409 Conflict will be returned.

only accessible with permission : "ManageConfiguration"

fully accessible with permission : "ManageConfiguration"

path Parameters
id
required
string

Project ID

header Parameters
Session
required
string

JWT

Request Body schema: application/json

project tracking data to be updated

enabled
boolean

Responses

Request samples

Content type
application/json
{
  • "enabled": true
}

Response samples

Content type
application/json
{
  • "enabled": true,
  • "matomoAuthToken": "string",
  • "matomoSiteId": 0,
  • "matomoUrl": "string",
  • "tokenExpires": 0
}

Get project copy process

This endpoint returns a project copy process in administrative representation by given id.

only accessible with permission : "ManageProjects"

fully accessible with permission : "ManageProjects"

path Parameters
id
required
string

Process ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "config": {
    },
  • "id": "string",
  • "newProjectId": "string",
  • "processStatusDetail": {
    },
  • "processedData": [
    ],
  • "status": "Processing"
}

Get project copy processes

This endpoint returns an array of all project copy processes. The output is in administrative representation and filtered for the user permissions.

only accessible with permission : "ManageProjects"

fully accessible with permission : "ManageProjects"

query Parameters
cursor
string

id of the cursor used for pagination; required if page is set

limit
integer

amount of results per page (1 ... 100)

page
integer

current page index of the cursor used for pagination; required if cursor is set

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Project (Default)

Get project

This endpoint returns a localized project in default representation by given id. If the requested language is not available it will fall back to the default language.

accessible without permission

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Project ID

header Parameters
Accept-Language
string

client language(s)

Session
string

JWT

Responses

Response samples

Content type
application/json
{
  • "description": "Project A is a nice project",
  • "featured": true,
  • "id": "string",
  • "image": "5e54fbf7f1ce6fa77f0a2821",
  • "matomoSiteId": 0,
  • "matomoUrl": "string",
  • "position": 0,
  • "scheme": "string",
  • "timeZone": "string",
  • "title": "Project A",
  • "translations": [
    ]
}

Get published project list

This endpoint returns an array of all published projects. The output is in default representation and filtered for the user permissions. If a limit is set, a cursor for this endpoint may be created to iterate over all projects.

accessible without permission

fully accessible with permission : "ManageContent" "ManageProjects"

query Parameters
cursor
string

id of the cursor used for pagination; required if page is set

limit
integer

amount of results per page (1 ... 100)

page
integer

current page index of the cursor used for pagination; required if cursor is set

header Parameters
Accept-Language
string

client language(s)

Session
string

JWT

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Reaction (Admin)

Get reactions of type

Currently the objects of type page and news are supported. If a limit is set, a cursor for this endpoint may be created to iterate over all reactions.

accessible without permission

fully accessible with permission : "ManageContent" "ManageGlobalMedia" "ManageProjects"

path Parameters
objectType
required
string
Enum: "Page" "News"

object type

query Parameters
cursor
string

id of the cursor used for pagination; required if page is set

limit
integer

amount of results per page (1 ... 100)

page
integer

current page index of the cursor used for pagination; required if cursor is set

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Create cursor

This endpoint returns a cursor for list reactions in admin representation with applied filter. In case of cursor response total will be 0 the status 204 with not content is returned instead.

accessible without permission

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
objectType
required
string
Enum: "Page" "News"

object type

header Parameters
Session
required
string

JWT

Request Body schema: application/json

options to create cursor

object (reaction.CursorObjectIDsFilterOption)

Responses

Request samples

Content type
application/json
{
  • "filter": {
    }
}

Response samples

Content type
application/json
{
  • "cursor": "string",
  • "endpoints": [
    ],
  • "expiredAt": 0,
  • "total": 0
}

Reaction (Default)

Get bookmarks for current user

This endpoint is for retrieving all bookmarks of the own account. If a limit is set, a cursor for this endpoint may be created to iterate over all bookmarks.

accessible without permission

query Parameters
cursor
string

id of the cursor used for pagination; required if page is set

limit
integer

amount of results per page (1 ... 100)

page
integer

current page index of the cursor used for pagination; required if cursor is set

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get bookmarks for object type

Bookmarks are not available for rows of dynamic directory entries. If a limit is set, a cursor for this endpoint may be created to iterate over all bookmarks.

accessible without permission

path Parameters
objectType
required
string
Enum: "Calendar" "CalendarEntry" "ChatFeed" "Directory" "DirectoryContentRow" "Location" "LocationMap" "MediaAudio" "MediaDocument" "MediaFolder" "MediaIcon" "MediaImage" "MediaOther" "MediaVideo" "News" "Page" "Project"

object type

query Parameters
cursor
string

id of the cursor used for pagination; required if page is set

limit
integer

amount of results per page (1 ... 100)

page
integer

current page index of the cursor used for pagination; required if cursor is set

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get reactions of object

This is only possible if the interaction on this object is allowed. Currently the objects of type page and news are supported.

accessible without permission

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
objectType
required
string
Enum: "Page" "News"

object type

objectId
required
string

object ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "counters": {
    },
  • "reaction": "Like"
}

Create or update your reaction

This endpoint is for creating or updating your reaction of a system object. This is only possible if the interaction on this object is allowed. Currently the objects of type Page and News are supported.

accessible without permission

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
objectType
required
string
Enum: "Page" "News"

object type

objectId
required
string

object ID

header Parameters
Session
required
string

JWT

Request Body schema: application/json

the configuration of your reaction

type
string
Value: "Like"

Responses

Request samples

Content type
application/json
{
  • "type": "Like"
}

Response samples

Content type
application/json
{
  • "counters": {
    },
  • "reaction": "Like"
}

Delete your reaction

This endpoint is for deleting your reaction of a system object. This is only possible if the interaction on this object is allowed. Currently the objects of type page and news are supported.

accessible without permission

path Parameters
objectType
required
string
Enum: "Page" "News"

object type

objectId
required
string

object ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "counters": {
    },
  • "reaction": "Like"
}

Create cursor

This endpoint returns a cursor for list reactions in default representation with applied filter. In case of cursor response total will be 0 the status 204 with not content is returned instead.

accessible without permission

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
objectType
required
string
Enum: "Page" "News"

object type

header Parameters
Session
string

JWT

Request Body schema: application/json

options to create cursor

object (reaction.CursorObjectIDsFilterOption)

Responses

Request samples

Content type
application/json
{
  • "filter": {
    }
}

Response samples

Content type
application/json
{
  • "cursor": "string",
  • "endpoints": [
    ],
  • "expiredAt": 0,
  • "total": 0
}

Get bookmark of object for your account

This endpoint is for retrieving the bookmark status for the requested object. Bookmarks are not available for rows of dynamic directory entries.

accessible without permission

path Parameters
objectType
required
string
Enum: "Calendar" "CalendarEntry" "ChatFeed" "Directory" "DirectoryContentRow" "Location" "LocationMap" "MediaAudio" "MediaDocument" "MediaFolder" "MediaIcon" "MediaImage" "MediaOther" "MediaVideo" "News" "Page" "Project"

object type

objectId
required
string

object ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "lastModified": 0,
  • "objectId": "string",
  • "objectType": "Account",
  • "projectId": "string",
  • "referenceId": "string"
}

Create a bookmark

This endpoint is for creating a bookmark. Bookmarks are not available for rows of dynamic directory entries.

accessible without permission

fully accessible with permission : "ManageContent" "ManageProjects" "ManageGlobalMedia"

path Parameters
objectType
required
string
Enum: "Calendar" "CalendarEntry" "ChatFeed" "Directory" "DirectoryContentRow" "Location" "LocationMap" "MediaAudio" "MediaDocument" "MediaFolder" "MediaIcon" "MediaImage" "MediaOther" "MediaVideo" "News" "Page" "Project"

object type

objectId
required
string

object ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "lastModified": 0,
  • "objectId": "string",
  • "objectType": "Account",
  • "projectId": "string",
  • "referenceId": "string"
}

Delete a bookmark

This endpoint is for deleting a bookmark from the system

accessible without permission

path Parameters
objectType
required
string
Enum: "Calendar" "CalendarEntry" "ChatFeed" "Directory" "DirectoryContentRow" "Location" "LocationMap" "MediaAudio" "MediaDocument" "MediaFolder" "MediaIcon" "MediaImage" "MediaOther" "MediaVideo" "News" "Page" "Project"

object type

objectId
required
string

object ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "status": "ok"
}

Get reactions of type

Currently the objects of type page and news are supported. If a limit is set, a cursor for this endpoint may be created to iterate over all reactions.

accessible without permission

fully accessible with permission : "ManageContent" "ManageGlobalMedia" "ManageProjects"

path Parameters
objectType
required
string
Enum: "Page" "News"

object type

query Parameters
cursor
string

id of the cursor used for pagination; required if page is set

limit
integer

amount of results per page (1 ... 100)

page
integer

current page index of the cursor used for pagination; required if cursor is set

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "property1": {
    },
  • "property2": {
    }
}

Role

Get roles

This endpoint returns all roles of the system (filtered by permissions)

only accessible with permission : "ManageAccounts" "ManageGlobalRoles"

fully accessible with permission : "ManageAccounts" "ManageGlobalRoles"

header Parameters
Session
required
string

JWT

Accept-Language
string

client language(s)

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Create role

This endpoint is for creating a new role. Project based roles can only contain project permissions and global roles can only contain global permissions. If Accept-Language is not the same as the default language, the provided localization will be also stored for the default language

Global Permissions: "ManageAccounts" "ManageConfiguration" "ManageGlobalMedia" "ManageGlobalRoles" "ManageProjects" "ViewGlobalAnalytics"

Project Permissions: "AccessPreview" "ManageCheckIns" "ManageContent" "ManagePosts" "ViewAnalytics"

Note: There is a maximum of 256 roles. You cannot create more than that. Status code 409 will be sent in that case.

only accessible with permission : "ManageGlobalRoles"

fully accessible with permission : "ManageGlobalRoles"

header Parameters
Session
required
string

JWT

Accept-Language
string

client language(s)

Request Body schema: application/json

role data to create

description
string
isAdminRole
boolean

indicator if the role is allowed to log in at management interface

permissions
Array of strings
Items Enum: "AccessPreview" "ManageAccounts" "ManageCheckIns" "ManageConfiguration" "ManageContent" "ManageGlobalMedia" "ManageGlobalRoles" "ManagePosts" "ManageProjects" "ViewAnalytics" "ViewGlobalAnalytics"

the permissions that are linked to the role -> some permissions are limited to global roles

roleType
string
Enum: "Global" "Project"

indicator if the role can be applied project based

title
string

Responses

Request samples

Content type
application/json
{
  • "description": "string",
  • "isAdminRole": true,
  • "permissions": [
    ],
  • "roleType": "Global",
  • "title": "string"
}

Response samples

Content type
application/json
{
  • "description": "string",
  • "id": "string",
  • "isAdminRole": true,
  • "permissions": [
    ],
  • "readonly": true,
  • "roleType": "Global",
  • "title": "string"
}

Get role

This endpoint returns role by given id with all additional information.

only accessible with permission : "ManageAccounts" "ManageGlobalRoles"

fully accessible with permission : "ManageAccounts" "ManageGlobalRoles"

path Parameters
id
required
string

Role ID

header Parameters
Session
required
string

JWT

Accept-Language
string

client language(s)

Responses

Response samples

Content type
application/json
{
  • "description": "string",
  • "id": "string",
  • "isAdminRole": true,
  • "permissions": [
    ],
  • "readonly": true,
  • "roleType": "Global",
  • "title": "string"
}

Delete role

This endpoint is for deleting a specific role.

only accessible with permission : "ManageGlobalRoles"

fully accessible with permission : "ManageGlobalRoles"

path Parameters
id
required
string

Role ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "status": "ok"
}

Update role

This endpoint is for updating a role. Project based roles can only contain project permissions and global roles can only contain global permissions. If Accept-Language is not provided, the localization is changed for the default language.

Global Permissions: "ManageAccounts" "ManageConfiguration" "ManageGlobalMedia" "ManageGlobalRoles" "ManageProjects" "ViewGlobalAnalytics"

Project Permissions: "AccessPreview" "ManageCheckIns" "ManageContent" "ManagePosts" "ViewAnalytics"

only accessible with permission : "ManageGlobalRoles"

fully accessible with permission : "ManageGlobalRoles"

path Parameters
id
required
string

Role ID

header Parameters
Session
required
string

JWT

Accept-Language
string

client language(s)

Request Body schema: application/json

role data to update

description
string
isAdminRole
boolean

indicator if the role can be used to login in management interface

permissions
Array of strings
Items Enum: "AccessPreview" "ManageAccounts" "ManageCheckIns" "ManageConfiguration" "ManageContent" "ManageGlobalMedia" "ManageGlobalRoles" "ManagePosts" "ManageProjects" "ViewAnalytics" "ViewGlobalAnalytics"

the permissions that are linked to the role -> some permissions are limited to global roles

title
string

Responses

Request samples

Content type
application/json
{
  • "description": "string",
  • "isAdminRole": true,
  • "permissions": [
    ],
  • "title": "string"
}

Response samples

Content type
application/json
{
  • "description": "string",
  • "id": "string",
  • "isAdminRole": true,
  • "permissions": [
    ],
  • "readonly": true,
  • "roleType": "Global",
  • "title": "string"
}

Get roles allowed assigning

This endpoint list all roles that could be assigned to other accounts the requested account is allowed for. projectID = null indicates that it is a global role or that the role can be assigned for all projects.

only accessible with permission : "ManageAccounts"

fully accessible with permission : "ManageAccounts"

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
[
  • {
    }
]

SSO (Admin)

Get all sso provider

This endpoint returns all sso-provider with content in administrative representation. If a limit is set, a cursor for this endpoint may be created to iterate over all sso-provider.

only accessible with permission : "ManageConfiguration"

fully accessible with permission : "ManageConfiguration"

query Parameters
cursor
string

id of the cursor used for pagination; required if page is set

limit
integer

amount of results per page (1 ... 100)

page
integer

current page index of the cursor used for pagination; required if cursor is set

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Creates a sso provider

This endpoint creates a sso-provider.

only accessible with permission : "ManageConfiguration"

fully accessible with permission : "ManageConfiguration"

header Parameters
Session
required
string

JWT

Request Body schema: application/json

sso provider to create

object (model.SSOAccountMapping)
backgroundColor
string

button background color; hexcolor or enum: "backgroundPrimary" "backgroundSecondary" "backgroundTertiary" "border" "contrast" "error" "primary" "secondary" "success" "textPrimary" "textSecondary"

backgroundColorDark
string

button background color (dark mode); hexcolor or enum: "backgroundPrimary" "backgroundSecondary" "backgroundTertiary" "border" "contrast" "error" "primary" "secondary" "success" "textPrimary" "textSecondary"

connectedDomains
Array of strings

a list of domains that are linked to that provider

icon
string

the icon of the button

object (model.SSOIdp)
position
integer

the position of the element

status
string
Enum: "Draft" "Published"

status of the provider

textColor
string

button text color; hexcolor or enum: "backgroundPrimary" "backgroundSecondary" "backgroundTertiary" "border" "contrast" "error" "primary" "secondary" "success" "textPrimary" "textSecondary"

textColorDark
string

button text color (dark mode); hexcolor or enum: "backgroundPrimary" "backgroundSecondary" "backgroundTertiary" "border" "contrast" "error" "primary" "secondary" "success" "textPrimary" "textSecondary"

title
string
type
string
Value: "Saml2"

the type of the authentication flow

Responses

Request samples

Content type
application/json
{
  • "accountMapping": {
    },
  • "backgroundColor": "#FFFFFF",
  • "backgroundColorDark": "#000000",
  • "connectedDomains": [
    ],
  • "icon": "string",
  • "idp": {
    },
  • "position": 0,
  • "status": "Draft",
  • "textColor": "#000000",
  • "textColorDark": "#FFFFFF",
  • "title": "string",
  • "type": "Saml2"
}

Response samples

Content type
application/json
{
  • "accountMapping": {
    },
  • "backgroundColor": "#FFFFFF",
  • "backgroundColorDark": "#000000",
  • "connectedDomains": [
    ],
  • "icon": "string",
  • "id": "string",
  • "idp": {
    },
  • "isSystem": true,
  • "polarioCrt": "string",
  • "polarioEntityId": "string",
  • "position": 0,
  • "status": "Draft",
  • "textColor": "#000000",
  • "textColorDark": "#FFFFFF",
  • "title": "string",
  • "type": "Saml2",
  • "users": 0
}

Get a single sso provider

This endpoint returns a single sso-provider with content in administrative representation.

only accessible with permission : "ManageConfiguration"

fully accessible with permission : "ManageConfiguration"

path Parameters
id
required
string

Provider ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "accountMapping": {
    },
  • "backgroundColor": "#FFFFFF",
  • "backgroundColorDark": "#000000",
  • "connectedDomains": [
    ],
  • "icon": "string",
  • "id": "string",
  • "idp": {
    },
  • "isSystem": true,
  • "polarioCrt": "string",
  • "polarioEntityId": "string",
  • "position": 0,
  • "status": "Draft",
  • "textColor": "#000000",
  • "textColorDark": "#FFFFFF",
  • "title": "string",
  • "type": "Saml2",
  • "users": 0
}

Update a sso provider

This endpoint updates a sso-provider.

Note: if isSystem = true the provider is immutable, api call will result in a http 409

only accessible with permission : "ManageConfiguration"

fully accessible with permission : "ManageConfiguration"

path Parameters
id
required
string

Provider ID

header Parameters
Session
required
string

JWT

Request Body schema: application/json

sso provider to update

object (model.SSOAccountMapping)
backgroundColor
string

button background color; hexcolor or enum: "backgroundPrimary" "backgroundSecondary" "backgroundTertiary" "border" "contrast" "error" "primary" "secondary" "success" "textPrimary" "textSecondary"

backgroundColorDark
string

button background color (dark mode); hexcolor or enum: "backgroundPrimary" "backgroundSecondary" "backgroundTertiary" "border" "contrast" "error" "primary" "secondary" "success" "textPrimary" "textSecondary"

connectedDomains
Array of strings

a list of domains that are linked to that provider

icon
string

the icon of the button

object (model.SSOIdp)
position
integer

the position of the element

status
string
Enum: "Draft" "Published"

status of the provider

textColor
string

button text color; hexcolor or enum: "backgroundPrimary" "backgroundSecondary" "backgroundTertiary" "border" "contrast" "error" "primary" "secondary" "success" "textPrimary" "textSecondary"

textColorDark
string

button text color (dark mode); hexcolor or enum: "backgroundPrimary" "backgroundSecondary" "backgroundTertiary" "border" "contrast" "error" "primary" "secondary" "success" "textPrimary" "textSecondary"

title
string
type
string
Value: "Saml2"

the type of the authentication flow

Responses

Request samples

Content type
application/json
{
  • "accountMapping": {
    },
  • "backgroundColor": "#FFFFFF",
  • "backgroundColorDark": "#000000",
  • "connectedDomains": [
    ],
  • "icon": "string",
  • "idp": {
    },
  • "position": 0,
  • "status": "Draft",
  • "textColor": "#000000",
  • "textColorDark": "#FFFFFF",
  • "title": "string",
  • "type": "Saml2"
}

Response samples

Content type
application/json
{
  • "accountMapping": {
    },
  • "backgroundColor": "#FFFFFF",
  • "backgroundColorDark": "#000000",
  • "connectedDomains": [
    ],
  • "icon": "string",
  • "id": "string",
  • "idp": {
    },
  • "isSystem": true,
  • "polarioCrt": "string",
  • "polarioEntityId": "string",
  • "position": 0,
  • "status": "Draft",
  • "textColor": "#000000",
  • "textColorDark": "#FFFFFF",
  • "title": "string",
  • "type": "Saml2",
  • "users": 0
}

Delete a sso provider

This endpoint is for deleting a single sso provider with all localizations.

Note: if isSystem = true the provider is not deletable, api call will result in a http 409

only accessible with permission : "ManageConfiguration"

fully accessible with permission : "ManageConfiguration"

path Parameters
id
required
string

Provider ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "status": "ok"
}

SSO (Default)

Response endpoint of saml2 auth flow

This endpoint processes a saml2 response and redirects the user to the frontend.

Note: This endpoint should only be called from the identity provider

Redirect Path: /{app|cms}/auth/code/{code} -> for Ios with custom url scheme

accessible without permission

path Parameters
id
required
string

Provider ID

Responses

Start a saml2 auth flow

This endpoint redirects the user to the idp login mask.

Note: This endpoint has to be opened directly in browser location, not called via ajax

accessible without permission

path Parameters
id
required
string

Provider ID

query Parameters
origin
required
string

the requesting platform (Ios|Android|Web|Cms)

Responses

Get all published sso provider

This endpoint returns all sso-provider with content in default representation. If a limit is set, a cursor for this endpoint may be created to iterate over all sso-provider.

accessible without permission

query Parameters
cursor
string

id of the cursor used for pagination; required if page is set

limit
integer

amount of results per page (1 ... 100)

page
integer

current page index of the cursor used for pagination; required if cursor is set

header Parameters
Accept-Language
string

client language(s)

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Generates a metadata.xml file

This endpoint is for providing the metadata for saml provider in xml.

Note: This endpoint has to be opened directly in browser location, not called via ajax

accessible without permission

path Parameters
id
required
string

Provider ID

Responses

Create a session based on sso auth code

This endpoint creates a new session and refresh token based on auth code. The auth code can only be redeemed once! The Platform header must match origin from sso process.

The signature will be empty

accessible without permission

header Parameters
Platform
string
Enum: "Cms" "Android" "Ios" "Web"

The client platform

Request Body schema: application/json

sso auth code to redeem

browser
string or null <optional>

Default: null

code
string
deviceName
string or null <optional>

Default: null

os
string
Enum: "Android" "IOS" "Windows" "Linux" "Mac" "Other"
osVersion
string

Responses

Request samples

Content type
application/json
{
  • "browser": "string",
  • "code": "string",
  • "deviceName": "string",
  • "os": "Android",
  • "osVersion": "string"
}

Response samples

Content type
application/json
{
  • "deviceId": "string",
  • "redirectProjectId": "string",
  • "refreshToken": "XX4EWw5Hz6zb10FlyMazboBGmlvYX7Y878j6zSjQjJmsbTDVUvfPd7eOm1YqRPQb",
  • "sendbirdSessionToken": "string",
  • "signature": "6rriTRBi23WpRR/wtup+mMhUZUn/dB5nLTJRsjl95G4="
}

Session

Login

This endpoint provides the login with a salted challenge response authentication mechanism (SCRAM). This endpoint is for the final message of the SCRAM challenge. The platform must match the platform from the first message. See RFC 5802 for detail SCRAM definition.

To perform this action call SCRAM First first: POST /auth/auth

accessible without permission

header Parameters
Platform
string
Enum: "Cms" "Android" "Ios" "Web"

The client platform

Request Body schema: application/json

Clients Final Message

browser
string or null <optional>

Default: null

deviceName
string or null <optional>

Default: null

email
string
nonce
string
os
string
Enum: "Android" "IOS" "Windows" "Linux" "Mac" "Other"
osVersion
string
proof
string

Responses

Request samples

Content type
application/json
{
  • "browser": "string",
  • "deviceName": "string",
  • "email": "test@api.plazz",
  • "nonce": "hvYDpWUa2RaTCAfuxFIlj)hNlF$k0",
  • "os": "Android",
  • "osVersion": "string",
  • "proof": "dHzbZapWIk4jUhN+Ute9ytag9zjfMHgsqmmiz7AndVQ="
}

Response samples

Content type
application/json
{
  • "deviceId": "string",
  • "redirectProjectId": "string",
  • "refreshToken": "XX4EWw5Hz6zb10FlyMazboBGmlvYX7Y878j6zSjQjJmsbTDVUvfPd7eOm1YqRPQb",
  • "sendbirdSessionToken": "string",
  • "signature": "6rriTRBi23WpRR/wtup+mMhUZUn/dB5nLTJRsjl95G4="
}

Logout

This endpoint finish current session and invalidates the refresh token for this session.

accessible without permission

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "status": "ok"
}

Refresh

This endpoint refreshes a JWT with given refresh token and return it in the response header. If refresh token is invalid it will return 416 Requested Range Not Satisfiable.

accessible without permission

Request Body schema: application/json

refresh token

refreshToken
string

Responses

Request samples

Content type
application/json
{
  • "refreshToken": "string"
}

Response samples

Content type
application/json
{
  • "deviceId": "string",
  • "sendbirdSessionToken": "string"
}

Shipping (Admin)

Get accounts shipping list

This endpoint returns a list of all account shipping in admin representation. If a limit is set, a cursor for this endpoint may be created to iterate over all account shipping's.

only accessible with permission : "ManageAccounts"

fully accessible with permission : "ManageAccounts"

query Parameters
cursor
string

id of the cursor used for pagination; required if page is set

limit
integer

amount of results per page (1 ... 100)

page
integer

current page index of the cursor used for pagination; required if cursor is set

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Create account shipping

This endpoint is for creating a new account shipping. The current system state will be used for the data to be imported. Further changes on projects or groups will not affect that shipping.

only accessible with permission : "ManageAccounts"

fully accessible with permission : "ManageAccounts"

header Parameters
Session
required
string

JWT

Request Body schema: application/json

shipping config

object (model.ShippingConfig)
title
string

Responses

Request samples

Content type
application/json
{
  • "config": {
    },
  • "title": "string"
}

Response samples

Content type
application/json
{
  • "id": "string",
  • "lastModified": 0,
  • "objectType": "Account",
  • "process": {
    },
  • "projectIds": [
    ],
  • "status": "Pending",
  • "title": "string"
}

Get account shipping

This endpoint returns an account shipping in admin representation by given id.

only accessible with permission : "ManageAccounts"

fully accessible with permission : "ManageAccounts"

path Parameters
id
required
string

Shipping ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "id": "string",
  • "lastModified": 0,
  • "objectType": "Account",
  • "process": {
    },
  • "projectIds": [
    ],
  • "status": "Pending",
  • "title": "string"
}

Start account shipping process

This endpoint is for starting the process of an account shipping. To start the processing there must be at least one data chunk.

only accessible with permission : "ManageAccounts"

fully accessible with permission : "ManageAccounts"

path Parameters
id
required
string

Shipping ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "status": "ok"
}

Add account shipping data

This endpoint is for adding new account shipping data.

Note: This endpoint does not prevent sending not permitted null values for "image" "title" "ssoIdentity" and "ssoProviderId". null values will be ignored in that case.

only accessible with permission : "ManageAccounts"

fully accessible with permission : "ManageAccounts"

path Parameters
id
required
string

Shipping ID

header Parameters
Session
required
string

JWT

Request Body schema: application/json

account data to ship; max 100 elements are permitted per request

Array
accessRead
string <optional>
Enum: "Any" "User"

Default for new accounts: "Any"

addToGroups
Array of strings <optional>

group titles must match regex /^([^,\s]|[^,\s][^,]*[^,\s])$/

email
string
firstName
string <optional>
image
string <optional>

use empty string for removing image

lastName
string <optional>
mailLanguage
string or null <optional>

format: IETF BCP 47; for null the email will be sent for the default language of the system

Array of objects (model.AccountMetaData)
ownAccess
string <optional>
Enum: "Read" "Write" "Delete" "Create" "changeProof"

Delete (includes) Write (includes) Read

password
string <optional>

must be empty if sso is set

product
string <optional>
Enum: "App" "Cms"

Default: "App"

salutation
string <optional>
Enum: "Mr" "Ms"
sendMail
boolean <optional>

Default: false

ssoIdentity
string <optional>

must be empty if password is set; must be set if ssoProviderId is set; use empty string for removing ssoIdentity

ssoProviderId
string <optional>

must be empty if password is set; must be set if ssoIdentity is set; use empty string for removing ssoProviderId

title
string <optional>

use empty string for removing title

Responses

Request samples

Content type
application/json
[
  • {
    }
]

Response samples

Content type
application/json
[
  • {
    }
]

Get shipping

This endpoint returns a shipping in admin representation by given id.

only accessible with permission : "ManageAccounts"

fully accessible with permission : "ManageAccounts"

path Parameters
id
required
string

Shipping ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "id": "string",
  • "lastModified": 0,
  • "objectType": "Account",
  • "process": {
    },
  • "projectIds": [
    ],
  • "status": "Pending",
  • "title": "string"
}

Stream (Admin)

Get stream list for project

This endpoint returns a list of all streams for the requested project without technical configuration parameters. If a limit is set, a cursor for this endpoint may be created to iterate over all streams.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Project ID

query Parameters
cursor
string

id of the cursor used for pagination; required if page is set

limit
integer

amount of results per page (1 ... 100)

page
integer

current page index of the cursor used for pagination; required if cursor is set

header Parameters
Session
required
string

JWT

Accept-Language
string

client language(s)

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Create stream

This endpoint is for creating a new stream.

Currently 3Q live streams are supported only due this endpoint.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

header Parameters
Session
required
string

JWT

Request Body schema: application/json

Stream to create

object <optional>

Default: {"any": "Read", "user": "Read", "accounts": {}, "groups": {}}

altText
string
placeholder
string or null

media id

projectId
string
title
string

Responses

Request samples

Content type
application/json
{
  • "access": {
    },
  • "altText": "string",
  • "placeholder": "string",
  • "projectId": "string",
  • "title": "string"
}

Response samples

Content type
application/json
{
  • "access": {
    },
  • "accessEditAllowed": true,
  • "altText": "string",
  • "id": "string",
  • "inputKey": "string",
  • "inputUrls": [
    ],
  • "placeholder": "string",
  • "projectId": "string",
  • "title": "string"
}

Get stream

This endpoint returns a stream in administrative representation by given id.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Stream ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "access": {
    },
  • "accessEditAllowed": true,
  • "altText": "string",
  • "id": "string",
  • "inputKey": "string",
  • "inputUrls": [
    ],
  • "placeholder": "string",
  • "projectId": "string",
  • "title": "string"
}

Delete stream

This endpoint is for deleting a single stream.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Stream ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "status": "ok"
}

Update stream

This endpoint is for updating specific data of an existing stream.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Stream ID

header Parameters
Session
required
string

JWT

Request Body schema: application/json

stream data to be updated

altText
string
placeholder
string or null

media id

title
string

Responses

Request samples

Content type
application/json
{
  • "altText": "string",
  • "placeholder": "string",
  • "title": "string"
}

Response samples

Content type
application/json
{
  • "access": {
    },
  • "accessEditAllowed": true,
  • "altText": "string",
  • "id": "string",
  • "inputKey": "string",
  • "inputUrls": [
    ],
  • "placeholder": "string",
  • "projectId": "string",
  • "title": "string"
}

Get stream access configuration

This endpoint returns the access configuration for the requested stream.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Stream ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "access": {
    },
  • "accessEditAllowed": true
}

Update stream access configuration

This endpoint updates the access configuration for the requested stream. Only the changes should be transmitted due this endpoint.

only accessible with permission : "ManageContent" "ManageProjects"

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Stream ID

header Parameters
Session
required
string

JWT

Request Body schema: application/json

changed access rights

object

accountId to operation; null for operation removes access

any
string or null
Enum: "Read" "Write" "Delete" "Create" "changeProof"

Delete (includes) Write (includes) Read; null for operation removes access

object

groupId to operation; null for operation removes access

user
string or null
Enum: "Read" "Write" "Delete" "Create" "changeProof"

Delete (includes) Write (includes) Read; null for operation removes access

Responses

Request samples

Content type
application/json
{
  • "accounts": {
    },
  • "any": "Read",
  • "groups": {
    },
  • "user": "Read"
}

Response samples

Content type
application/json
{
  • "accounts": {
    },
  • "any": "Read",
  • "groups": {
    },
  • "user": "Read"
}

Stream (Default)

Get stream

This endpoint returns a stream in default representation by given id.

accessible without permission

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Stream ID

header Parameters
Session
string

JWT

Responses

Response samples

Content type
application/json
{
  • "altText": "string",
  • "id": "string",
  • "output": {
    },
  • "placeholder": "string",
  • "projectId": "string",
  • "title": "string",
  • "translations": [
    ]
}

Get stream viewer count

This endpoint returns the amount of current viewers for a stream.

accessible without permission

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Stream ID

header Parameters
Session
string

JWT

Responses

Response samples

Content type
application/json
{
  • "viewerCount": 0
}

Set stream viewer

This endpoint should be called periodically (every 5 min) as long as a person is viewing a stream. It returns the amount of current viewers for a stream.

accessible without permission

fully accessible with permission : "ManageContent" "ManageProjects"

path Parameters
id
required
string

Stream ID

header Parameters
User-Identification
string

uid to handle user specific content without session

Session
string

JWT

Responses

Response samples

Content type
application/json
{
  • "viewerCount": 0
}

Util

Check csp of url

This endpoint is for checking Content-Security-Policy of an url to get information about showing inside an iframe is possible or should be better opened in new tab. See: https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Content-Security-Policy for more information.

header Parameters
Session
string

JWT

Request Body schema: application/json

url to be checked

url
string

Responses

Request samples

Content type
application/json
{
  • "url": "string"
}

Response samples

Content type
application/json
{
  • "linkBehavior": "Internal"
}

Webhook

Call webhook

This endpoint triggers a demo call to webhook by given ID

only accessible with permission : "ManageConfiguration"

fully accessible with permission : "ManageConfiguration"

path Parameters
id
required
string

Webhook ID

header Parameters
Session
required
string

JWT

Request Body schema: application/json

webhook action to be called

action
string
Enum: "Account.Create" "Account.Profile.Update" "Shipping.Finish" "Party.Reaction.Create" "Party.Reaction.Update" "Party.Reaction.Delete"

Responses

Request samples

Content type
application/json
{
  • "action": "Account.Create"
}

Response samples

Content type
application/json
{
  • "action": "Account.Create",
  • "headers": {
    },
  • "url": "string"
}

Get all webhooks

This endpoint returns all webhooks. If a limit is set, a cursor for this endpoint may be created to iterate over all webhooks.

only accessible with permission : "ManageConfiguration"

fully accessible with permission : "ManageConfiguration"

query Parameters
cursor
string

id of the cursor used for pagination; required if page is set

limit
integer

amount of results per page (1 ... 100)

page
integer

current page index of the cursor used for pagination; required if cursor is set

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Create webhook

This endpoint creates a new webhook.

only accessible with permission : "ManageConfiguration"

fully accessible with permission : "ManageConfiguration"

header Parameters
Session
required
string

JWT

Request Body schema: application/json

webhook to create

actionKey
string or null
actions
Array of strings or null (model.WebhookAction)
Enum: "Account.Create" "Account.Profile.Update" "Shipping.Finish" "Party.Reaction.Create" "Party.Reaction.Update" "Party.Reaction.Delete"

relates to attachAction null for listening for all actions

attachAction
string
Enum: "None" "Url" "Header"
enabled
boolean
object
requestMethod
string
title
string
url
string

Responses

Request samples

Content type
application/json
{
  • "actionKey": "string",
  • "actions": [
    ],
  • "attachAction": "None",
  • "enabled": true,
  • "headers": {
    },
  • "requestMethod": "string",
  • "title": "string",
  • "url": "string"
}

Response samples

Content type
application/json
{
  • "actionKey": "string",
  • "actions": [
    ],
  • "attachAction": "None",
  • "enabled": true,
  • "headers": {
    },
  • "id": "string",
  • "requestMethod": "string",
  • "title": "string",
  • "url": "string"
}

Get webhook

This endpoint returns a webhook by given id.

only accessible with permission : "ManageConfiguration"

fully accessible with permission : "ManageConfiguration"

path Parameters
id
required
string

Webhook ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "actionKey": "string",
  • "actions": [
    ],
  • "attachAction": "None",
  • "enabled": true,
  • "headers": {
    },
  • "id": "string",
  • "requestMethod": "string",
  • "title": "string",
  • "url": "string"
}

Delete webhook

This endpoint is for deleting a single webhook.

only accessible with permission : "ManageConfiguration"

fully accessible with permission : "ManageConfiguration"

path Parameters
id
required
string

Webhook ID

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
{
  • "status": "ok"
}

Update webhook

This endpoint updates a webhook by given id.

only accessible with permission : "ManageConfiguration"

fully accessible with permission : "ManageConfiguration"

path Parameters
id
required
string

Webhook ID

header Parameters
Session
required
string

JWT

Request Body schema: application/json

webhook information to be updated

actionKey
string or null
actions
Array of strings or null (model.WebhookAction)
Enum: "Account.Create" "Account.Profile.Update" "Shipping.Finish" "Party.Reaction.Create" "Party.Reaction.Update" "Party.Reaction.Delete"

relates to attachAction null for listening for all actions

attachAction
string
Enum: "None" "Url" "Header"
enabled
boolean
object
requestMethod
string
title
string
url
string

Responses

Request samples

Content type
application/json
{
  • "actionKey": "string",
  • "actions": [
    ],
  • "attachAction": "None",
  • "enabled": true,
  • "headers": {
    },
  • "requestMethod": "string",
  • "title": "string",
  • "url": "string"
}

Response samples

Content type
application/json
{
  • "actionKey": "string",
  • "actions": [
    ],
  • "attachAction": "None",
  • "enabled": true,
  • "headers": {
    },
  • "id": "string",
  • "requestMethod": "string",
  • "title": "string",
  • "url": "string"
}

Get webhook logs

This endpoint returns the logs of a webhook by given id. If a limit is set, a cursor for this endpoint may be created to iterate over all webhook logs.

only accessible with permission : "ManageConfiguration"

fully accessible with permission : "ManageConfiguration"

path Parameters
id
required
string

Webhook ID

query Parameters
cursor
string

id of the cursor used for pagination; required if page is set

limit
integer

amount of results per page (1 ... 100)

page
integer

current page index of the cursor used for pagination; required if cursor is set

header Parameters
Session
required
string

JWT

Responses

Response samples

Content type
application/json
[
  • {
    }
]