curl --request POST \
--url https://cool.jobmojito.com/functions/v1/portal-configuration-update \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"documents": [
{
"kind": "branding",
"format": "jobmojito.portal-site",
"version": 1
}
],
"merchant_id": "28106cba-1c27-4e53-b149-32113e5e8e31",
"publish": false,
"dry_run": false
}
'import requests
url = "https://cool.jobmojito.com/functions/v1/portal-configuration-update"
payload = {
"documents": [
{
"kind": "branding",
"format": "jobmojito.portal-site",
"version": 1
}
],
"merchant_id": "28106cba-1c27-4e53-b149-32113e5e8e31",
"publish": False,
"dry_run": False
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
documents: [{kind: 'branding', format: 'jobmojito.portal-site', version: 1}],
merchant_id: '28106cba-1c27-4e53-b149-32113e5e8e31',
publish: false,
dry_run: false
})
};
fetch('https://cool.jobmojito.com/functions/v1/portal-configuration-update', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://cool.jobmojito.com/functions/v1/portal-configuration-update",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'documents' => [
[
'kind' => 'branding',
'format' => 'jobmojito.portal-site',
'version' => 1
]
],
'merchant_id' => '28106cba-1c27-4e53-b149-32113e5e8e31',
'publish' => false,
'dry_run' => false
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://cool.jobmojito.com/functions/v1/portal-configuration-update"
payload := strings.NewReader("{\n \"documents\": [\n {\n \"kind\": \"branding\",\n \"format\": \"jobmojito.portal-site\",\n \"version\": 1\n }\n ],\n \"merchant_id\": \"28106cba-1c27-4e53-b149-32113e5e8e31\",\n \"publish\": false,\n \"dry_run\": false\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://cool.jobmojito.com/functions/v1/portal-configuration-update")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"documents\": [\n {\n \"kind\": \"branding\",\n \"format\": \"jobmojito.portal-site\",\n \"version\": 1\n }\n ],\n \"merchant_id\": \"28106cba-1c27-4e53-b149-32113e5e8e31\",\n \"publish\": false,\n \"dry_run\": false\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://cool.jobmojito.com/functions/v1/portal-configuration-update")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"documents\": [\n {\n \"kind\": \"branding\",\n \"format\": \"jobmojito.portal-site\",\n \"version\": 1\n }\n ],\n \"merchant_id\": \"28106cba-1c27-4e53-b149-32113e5e8e31\",\n \"publish\": false,\n \"dry_run\": false\n}"
response = http.request(request)
puts response.read_body{
"merchant_id": "28106cba-1c27-4e53-b149-32113e5e8e31",
"dry_run": true,
"documents": [
{
"index": 0,
"kind": "branding",
"summary": [
"3 colour(s)",
"style \"minimal\"",
"portal name"
],
"warnings": [
"<string>"
]
}
],
"changes": {
"merchant_fields": [
"homepage_name",
"template_colors.c_primary",
"interview_homepage_texts.de"
],
"pages_created": [
"our-history"
],
"pages_updated": [
"about",
"_support"
],
"pages_unchanged": [
"<string>"
],
"theme_css": true,
"published": true,
"portal": "interview",
"page_changes": [
{
"portal": "interview",
"slug": "<string>",
"action": "create",
"published": true
}
],
"brands": [
{
"tag": "<string>",
"action": "create"
}
],
"css_files": [
{
"brand": "<string>",
"path": "<string>",
"action": "create"
}
],
"style_settings": true,
"stylesheets_published": [
{
"portal": "interview",
"brand": "<string>"
}
]
}
}{
"error": "Field is required.",
"name": "interview_result_id"
}{
"error": "Field is required.",
"name": "interview_result_id"
}{
"error": "Field is required.",
"name": "interview_result_id"
}{
"error": "<string>",
"name": "documents",
"errors": [
"documents[0]: style must be \"bold\" or \"minimal\", got \"dark\".",
"documents[1].pages[0]: slug \"jobs\" is not allowed (reserved)"
]
}{
"error": "<string>",
"name": "write",
"failures": [
"<string>"
],
"applied": {
"merchant_fields": [
"homepage_name",
"template_colors.c_primary",
"interview_homepage_texts.de"
],
"pages_created": [
"our-history"
],
"pages_updated": [
"about",
"_support"
],
"pages_unchanged": [
"<string>"
],
"theme_css": true,
"published": true,
"portal": "interview",
"page_changes": [
{
"portal": "interview",
"slug": "<string>",
"action": "create",
"published": true
}
],
"brands": [
{
"tag": "<string>",
"action": "create"
}
],
"css_files": [
{
"brand": "<string>",
"path": "<string>",
"action": "create"
}
],
"style_settings": true,
"stylesheets_published": [
{
"portal": "interview",
"brand": "<string>"
}
]
}
}Update the portal configuration (branding, portals, brands, pages)
Imports portal configuration documents in one call: branding (portal name, style, colours, logos, e-mail sender name, speech term boosting), the interview portal (languages, home texts, support / application-tracking / interview-completed texts), the coaching portal (vertical, feature toggles, labels, coaching plan, catalogue start directory, languages, home blocks), brands (the sub-brands of the company, with logos, privacy notice and style settings) and portal sites (pages in every language with their blocks, menu, footer, the theme CSS, the style settings and CSS files). Document formats: https://developer.jobmojito.com/cookbooks/portal-branding/branding, https://developer.jobmojito.com/cookbooks/portal-branding/interview-portal, https://developer.jobmojito.com/cookbooks/portal-branding/coaching-portal, https://developer.jobmojito.com/cookbooks/portal-branding/portal-pages. Read the current configuration with portal-configuration-get first: it returns these same documents, so you can edit them and send them back. Fields a document omits keep their value. Run with dry_run: true to preview the summary, warnings and changes, then repeat without it to apply. Validation is all-or-nothing: if any document has an error nothing is written and the 422 lists every error. Pages land as drafts unless publish is true; the support / tracking / completion / signed-in home texts of the portal documents always land as drafts of those built-in pages.
curl --request POST \
--url https://cool.jobmojito.com/functions/v1/portal-configuration-update \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"documents": [
{
"kind": "branding",
"format": "jobmojito.portal-site",
"version": 1
}
],
"merchant_id": "28106cba-1c27-4e53-b149-32113e5e8e31",
"publish": false,
"dry_run": false
}
'import requests
url = "https://cool.jobmojito.com/functions/v1/portal-configuration-update"
payload = {
"documents": [
{
"kind": "branding",
"format": "jobmojito.portal-site",
"version": 1
}
],
"merchant_id": "28106cba-1c27-4e53-b149-32113e5e8e31",
"publish": False,
"dry_run": False
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
documents: [{kind: 'branding', format: 'jobmojito.portal-site', version: 1}],
merchant_id: '28106cba-1c27-4e53-b149-32113e5e8e31',
publish: false,
dry_run: false
})
};
fetch('https://cool.jobmojito.com/functions/v1/portal-configuration-update', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://cool.jobmojito.com/functions/v1/portal-configuration-update",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'documents' => [
[
'kind' => 'branding',
'format' => 'jobmojito.portal-site',
'version' => 1
]
],
'merchant_id' => '28106cba-1c27-4e53-b149-32113e5e8e31',
'publish' => false,
'dry_run' => false
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://cool.jobmojito.com/functions/v1/portal-configuration-update"
payload := strings.NewReader("{\n \"documents\": [\n {\n \"kind\": \"branding\",\n \"format\": \"jobmojito.portal-site\",\n \"version\": 1\n }\n ],\n \"merchant_id\": \"28106cba-1c27-4e53-b149-32113e5e8e31\",\n \"publish\": false,\n \"dry_run\": false\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://cool.jobmojito.com/functions/v1/portal-configuration-update")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"documents\": [\n {\n \"kind\": \"branding\",\n \"format\": \"jobmojito.portal-site\",\n \"version\": 1\n }\n ],\n \"merchant_id\": \"28106cba-1c27-4e53-b149-32113e5e8e31\",\n \"publish\": false,\n \"dry_run\": false\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://cool.jobmojito.com/functions/v1/portal-configuration-update")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"documents\": [\n {\n \"kind\": \"branding\",\n \"format\": \"jobmojito.portal-site\",\n \"version\": 1\n }\n ],\n \"merchant_id\": \"28106cba-1c27-4e53-b149-32113e5e8e31\",\n \"publish\": false,\n \"dry_run\": false\n}"
response = http.request(request)
puts response.read_body{
"merchant_id": "28106cba-1c27-4e53-b149-32113e5e8e31",
"dry_run": true,
"documents": [
{
"index": 0,
"kind": "branding",
"summary": [
"3 colour(s)",
"style \"minimal\"",
"portal name"
],
"warnings": [
"<string>"
]
}
],
"changes": {
"merchant_fields": [
"homepage_name",
"template_colors.c_primary",
"interview_homepage_texts.de"
],
"pages_created": [
"our-history"
],
"pages_updated": [
"about",
"_support"
],
"pages_unchanged": [
"<string>"
],
"theme_css": true,
"published": true,
"portal": "interview",
"page_changes": [
{
"portal": "interview",
"slug": "<string>",
"action": "create",
"published": true
}
],
"brands": [
{
"tag": "<string>",
"action": "create"
}
],
"css_files": [
{
"brand": "<string>",
"path": "<string>",
"action": "create"
}
],
"style_settings": true,
"stylesheets_published": [
{
"portal": "interview",
"brand": "<string>"
}
]
}
}{
"error": "Field is required.",
"name": "interview_result_id"
}{
"error": "Field is required.",
"name": "interview_result_id"
}{
"error": "Field is required.",
"name": "interview_result_id"
}{
"error": "<string>",
"name": "documents",
"errors": [
"documents[0]: style must be \"bold\" or \"minimal\", got \"dark\".",
"documents[1].pages[0]: slug \"jobs\" is not allowed (reserved)"
]
}{
"error": "<string>",
"name": "write",
"failures": [
"<string>"
],
"applied": {
"merchant_fields": [
"homepage_name",
"template_colors.c_primary",
"interview_homepage_texts.de"
],
"pages_created": [
"our-history"
],
"pages_updated": [
"about",
"_support"
],
"pages_unchanged": [
"<string>"
],
"theme_css": true,
"published": true,
"portal": "interview",
"page_changes": [
{
"portal": "interview",
"slug": "<string>",
"action": "create",
"published": true
}
],
"brands": [
{
"tag": "<string>",
"action": "create"
}
],
"css_files": [
{
"brand": "<string>",
"path": "<string>",
"action": "create"
}
],
"style_settings": true,
"stylesheets_published": [
{
"portal": "interview",
"brand": "<string>"
}
]
}
}Authorizations
Supabase JWT — Authorization: Bearer <token>.
Body
1 to 20 documents, applied in order (a later document wins where two set the same thing). Every field a document omits keeps its current value; languages are only ever added, never removed.
1 - 20 elementsShow child attributes
Show child attributes
Optional merchant to configure. Admins and sub-merchant operators only; other callers always use their token's merchant.
"28106cba-1c27-4e53-b149-32113e5e8e31"
Optional: lock the call to one document type, as one admin import tab does. Every document must then be that type (portal-site accepts both portal-site and portal-page formats), and a document that declares neither kind nor format is read as this type with a warning. Without it, every document must declare its own kind or format.
branding, interview-portal, coaching-portal, brands, portal-site Where portal-site pages and theme CSS go: interview (candidate-facing interview / careers portal) or consumer (coaching portal). Default: the portal-site document's own portal, else interview. A document made for the other portal is imported here with a warning.
interview, consumer Also publish the imported pages and theme CSS (live at once, as the admin's "Publish after import"). Default false: pages land as drafts the company reviews in the admin. Style settings and CSS files in the documents are built into a stylesheet per brand and published too, by the same build as portal-css-publish: the files a document names go live, the others stay as last published. Built-in page drafts produced by interview-portal / coaching-portal documents are never published. With page versions switched on, only a company owner or admin may publish.
Validate and report what would change (summary, warnings, changes) without writing anything. Use it to preview an import before applying it.
Response
Documents validated and (unless dry_run) applied.