PIIPE API

Documentation of PIIPE API.
More information: https://openapi-generator.tech
Contact Info: team@openapitools.org
Version: 1.0.0
BasePath:/api/v1
All rights reserved
http://apache.org/licenses/LICENSE-2.0.html

Access

  1. HTTP Bearer Token authentication (JWT access token)

Methods

[ Jump to Models ]

Table of Contents

Comments

Community

Configuration

Entities

FrontpageMagazine

Navigation

Notifications

OverviewPages

User

Comments

Up
delete /comment/{cid}
Delete a comment. (commentCidDelete)

Path parameters

cid (required)
Path Parameter — The comment ID. default: null

Responses

204

Deletion successful.

403

Forbidden

Up
patch /comment/{cid}
Edit a comment (Note: this endpoint doesn't have the prefix /api/v1 in the base URL). (commentCidPatch)

Edit a comment.

To like/unlike a comment, use the endpoint /piipe_flags/flag and pass the following body:

{"flag_id": "comments_like", "entity_type": "comment", "entity_id": CID, "action": "flag"}

Where CID is the comment ID, action can be either "flag" or "unflag" and entity_type can be either "comment" or "discussion_comments".

To report a comment, use the same body as above with "flag_id": "comment_report" (example: {"flag_id": "comment_report", "entity_type": "comment", "entity_id": CID, "action": "flag"}).

Path parameters

cid (required)
Path Parameter — The comment ID. default: null

Consumes

This API call consumes the following media types via the Content-Type request header:

Request body

Comment-Request Comment-Request (required)
Body Parameter — Request body for editing a comment.

Return type

Comment

Example data

Content-Type: application/json
{
  "created" : "01.01.2025",
  "subject" : "My comment",
  "author" : {
    "uid" : 100,
    "name" : "John Doe",
    "picture" : {
      "alt" : "image alt text",
      "url" : "https://example.com/example_image.jpg"
    }
  },
  "flags" : {
    "like" : {
      "flagged" : true,
      "count" : 3
    },
    "report" : {
      "flagged" : true,
      "count" : 2,
      "flagged_by_current_user" : false
    }
  },
  "answers" : [ null, null ],
  "pid" : "42",
  "answerCount" : 4,
  "addressee" : "public",
  "isCommentOwner" : true,
  "permissions" : {
    "edit" : true,
    "report" : true,
    "delete" : false
  },
  "fields" : {
    "comment_body" : {
      "format" : "comment_editor",
      "value" : "This is a comment"
    },
    "subject" : {
      "value" : "My comment"
    }
  },
  "cid" : 123,
  "changed" : "01.01.2025"
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Comment has been updated successfully Comment

400

Bad request

403

Access denied

Up
post /comment
Create a new comment (Note: this endpoint doesn't have the prefix /api/v1 in the base URL). (commentPost)

Consumes

This API call consumes the following media types via the Content-Type request header:

Request body

_comment_post_request _comment_post_request (required)
Body Parameter

Return type

Comment

Example data

Content-Type: application/json
{
  "created" : "01.01.2025",
  "subject" : "My comment",
  "author" : {
    "uid" : 100,
    "name" : "John Doe",
    "picture" : {
      "alt" : "image alt text",
      "url" : "https://example.com/example_image.jpg"
    }
  },
  "flags" : {
    "like" : {
      "flagged" : true,
      "count" : 3
    },
    "report" : {
      "flagged" : true,
      "count" : 2,
      "flagged_by_current_user" : false
    }
  },
  "answers" : [ null, null ],
  "pid" : "42",
  "answerCount" : 4,
  "addressee" : "public",
  "isCommentOwner" : true,
  "permissions" : {
    "edit" : true,
    "report" : true,
    "delete" : false
  },
  "fields" : {
    "comment_body" : {
      "format" : "comment_editor",
      "value" : "This is a comment"
    },
    "subject" : {
      "value" : "My comment"
    }
  },
  "cid" : 123,
  "changed" : "01.01.2025"
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

201

Comment created successfully Comment

400

Bad request (validation failure or subject too long)

403

Access denied (no permission to create comment)

422

Unprocessable entity (invalid structure)

500

Server error

Up
get /piipe_comments/{cid}
Get a comment. (piipeCommentsCidGet)

Path parameters

cid (required)
Path Parameter — Comment ID. default: null

Return type

Comment

Example data

Content-Type: application/json
{
  "created" : "01.01.2025",
  "subject" : "My comment",
  "author" : {
    "uid" : 100,
    "name" : "John Doe",
    "picture" : {
      "alt" : "image alt text",
      "url" : "https://example.com/example_image.jpg"
    }
  },
  "flags" : {
    "like" : {
      "flagged" : true,
      "count" : 3
    },
    "report" : {
      "flagged" : true,
      "count" : 2,
      "flagged_by_current_user" : false
    }
  },
  "answers" : [ null, null ],
  "pid" : "42",
  "answerCount" : 4,
  "addressee" : "public",
  "isCommentOwner" : true,
  "permissions" : {
    "edit" : true,
    "report" : true,
    "delete" : false
  },
  "fields" : {
    "comment_body" : {
      "format" : "comment_editor",
      "value" : "This is a comment"
    },
    "subject" : {
      "value" : "My comment"
    }
  },
  "cid" : 123,
  "changed" : "01.01.2025"
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

The requested comment Comment

400

Bad request

404

Not found

Up
get /piipe_comments/list
List comments / load answers (piipeCommentsListGet)
Lists root comments (or top-level discussion threads) with initial answers, or when cid & answer_page are provided returns paged answers for a specific comment.

Query parameters

page (optional)
Query Parameter — Page index for pagination. default: 0
sort_dir (optional)
Query Parameter — Sort direction. default: DESC
sort_by (optional)
Query Parameter — Sort criterion. default: null
entity_id (required)
Query Parameter — ID of the commented entity (node, discussion, etc.). default: null
comment_type (required)
Query Parameter — Comment type machine name. default: null
nid (optional)
Query Parameter — Node ID (required when targeting a discussion in a node, and requires comment_type to be "discussion_comments"). default: null
gid (optional)
Query Parameter — Community ID (required when targeting a discussion in a community, and requires comment_type to be "discussion_comments"). default: null
cid (optional)
Query Parameter — Comment ID whose answers should be loaded and paged (requires answer_page). default: null
answer_page (optional)
Query Parameter — Page index for answers (requires cid). default: null
exclude (optional)
Query Parameter — JSON encoded structure of already loaded comment IDs keyed by parent. default: null

Return type

Comments-List-Response

Example data

Content-Type: application/json
{
  "comments" : [ {
    "created" : "01.01.2025",
    "subject" : "My comment",
    "author" : {
      "uid" : 100,
      "name" : "John Doe",
      "picture" : {
        "alt" : "image alt text",
        "url" : "https://example.com/example_image.jpg"
      }
    },
    "flags" : {
      "like" : {
        "flagged" : true,
        "count" : 3
      },
      "report" : {
        "flagged" : true,
        "count" : 2,
        "flagged_by_current_user" : false
      }
    },
    "answers" : [ null, null ],
    "pid" : "42",
    "answerCount" : 4,
    "addressee" : "public",
    "isCommentOwner" : true,
    "permissions" : {
      "edit" : true,
      "report" : true,
      "delete" : false
    },
    "fields" : {
      "comment_body" : {
        "format" : "comment_editor",
        "value" : "This is a comment"
      },
      "subject" : {
        "value" : "My comment"
      }
    },
    "cid" : 123,
    "changed" : "01.01.2025"
  }, {
    "created" : "01.01.2025",
    "subject" : "My comment",
    "author" : {
      "uid" : 100,
      "name" : "John Doe",
      "picture" : {
        "alt" : "image alt text",
        "url" : "https://example.com/example_image.jpg"
      }
    },
    "flags" : {
      "like" : {
        "flagged" : true,
        "count" : 3
      },
      "report" : {
        "flagged" : true,
        "count" : 2,
        "flagged_by_current_user" : false
      }
    },
    "answers" : [ null, null ],
    "pid" : "42",
    "answerCount" : 4,
    "addressee" : "public",
    "isCommentOwner" : true,
    "permissions" : {
      "edit" : true,
      "report" : true,
      "delete" : false
    },
    "fields" : {
      "comment_body" : {
        "format" : "comment_editor",
        "value" : "This is a comment"
      },
      "subject" : {
        "value" : "My comment"
      }
    },
    "cid" : 123,
    "changed" : "01.01.2025"
  } ],
  "nextAnswers" : [ {
    "created" : "01.01.2025",
    "subject" : "My comment",
    "author" : {
      "uid" : 100,
      "name" : "John Doe",
      "picture" : {
        "alt" : "image alt text",
        "url" : "https://example.com/example_image.jpg"
      }
    },
    "flags" : {
      "like" : {
        "flagged" : true,
        "count" : 3
      },
      "report" : {
        "flagged" : true,
        "count" : 2,
        "flagged_by_current_user" : false
      }
    },
    "answers" : [ null, null ],
    "pid" : "42",
    "answerCount" : 4,
    "addressee" : "public",
    "isCommentOwner" : true,
    "permissions" : {
      "edit" : true,
      "report" : true,
      "delete" : false
    },
    "fields" : {
      "comment_body" : {
        "format" : "comment_editor",
        "value" : "This is a comment"
      },
      "subject" : {
        "value" : "My comment"
      }
    },
    "cid" : 123,
    "changed" : "01.01.2025"
  }, {
    "created" : "01.01.2025",
    "subject" : "My comment",
    "author" : {
      "uid" : 100,
      "name" : "John Doe",
      "picture" : {
        "alt" : "image alt text",
        "url" : "https://example.com/example_image.jpg"
      }
    },
    "flags" : {
      "like" : {
        "flagged" : true,
        "count" : 3
      },
      "report" : {
        "flagged" : true,
        "count" : 2,
        "flagged_by_current_user" : false
      }
    },
    "answers" : [ null, null ],
    "pid" : "42",
    "answerCount" : 4,
    "addressee" : "public",
    "isCommentOwner" : true,
    "permissions" : {
      "edit" : true,
      "report" : true,
      "delete" : false
    },
    "fields" : {
      "comment_body" : {
        "format" : "comment_editor",
        "value" : "This is a comment"
      },
      "subject" : {
        "value" : "My comment"
      }
    },
    "cid" : 123,
    "changed" : "01.01.2025"
  } ],
  "count" : 10,
  "thread_permission" : true,
  "title" : "Community Discussion",
  "comment_status" : 2,
  "administrators" : [ {
    "name" : "John Doe",
    "url" : "user/10"
  }, {
    "name" : "John Doe",
    "url" : "user/10"
  } ],
  "changed" : "01.01.2025"
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Comments list or paged answers Comments-List-Response

400

Bad request

401

Unauthorized

403

Forbidden

500

Server error

Up
post /piipe_comments/media
Upload media (chunked) (piipeCommentsMediaPost)
Chunked upload endpoint creating File & Media entities. Returns partial status until final chunk.

Consumes

This API call consumes the following media types via the Content-Type request header:

Request body

_piipe_comments_media_post_request _piipe_comments_media_post_request (required)
Body Parameter

Return type

_piipe_comments_media_post_200_response

Example data

Content-Type: application/json
{
  "is_last" : false
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Upload state or final media reference _piipe_comments_media_post_200_response

Up
post /piipe_comments/mention
Get user mention suggestions (piipeCommentsMentionPost)
Returns up to 25 users whose display name begins with the provided text. If duplicate display names exist, the email is appended.

Consumes

This API call consumes the following media types via the Content-Type request header:

Request body

_piipe_comments_mention_post_request _piipe_comments_mention_post_request (required)
Body Parameter

Return type

array[Mention-User]

Example data

Content-Type: application/json
[ {
  "name" : "John",
  "link" : "/user/42",
  "id" : "@John",
  "userId" : [ {
    "value" : 42
  }, {
    "value" : 42
  } ]
}, {
  "name" : "John",
  "link" : "/user/42",
  "id" : "@John",
  "userId" : [ {
    "value" : 42
  }, {
    "value" : 42
  } ]
} ]

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Array of mentionable users

Up
get /piipe_comments/thread-trace/{cid}
Get thread trace for a comment (piipeCommentsThreadTraceCidGet)
Returns the chain from a comment to its root plus sibling context.

Path parameters

cid (required)
Path Parameter — Comment ID. default: null

Return type

Thread-Trace-Response

Example data

Content-Type: application/json
{
  "threads" : {
    "created" : "01.01.2025",
    "subject" : "My comment",
    "author" : {
      "uid" : 100,
      "name" : "John Doe",
      "picture" : {
        "alt" : "image alt text",
        "url" : "https://example.com/example_image.jpg"
      }
    },
    "flags" : {
      "like" : {
        "flagged" : true,
        "count" : 3
      },
      "report" : {
        "flagged" : true,
        "count" : 2,
        "flagged_by_current_user" : false
      }
    },
    "answers" : [ null, null ],
    "pid" : "42",
    "answerCount" : 4,
    "addressee" : "public",
    "isCommentOwner" : true,
    "permissions" : {
      "edit" : true,
      "report" : true,
      "delete" : false
    },
    "fields" : {
      "comment_body" : {
        "format" : "comment_editor",
        "value" : "This is a comment"
      },
      "subject" : {
        "value" : "My comment"
      }
    },
    "cid" : 123,
    "changed" : "01.01.2025"
  },
  "cids" : {
    "1" : [ 2, 3 ]
  }
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Thread trace result Thread-Trace-Response

400

Invalid comment ID

404

Comment not found

Community

Up
delete /community/{gid}
Delete a community by ID (communityGidDelete)

Path parameters

gid (required)
Path Parameter — Community ID default: null

Responses

204

Community deleted successfully

403

User is not permitted to delete this community

404

Community not found

Up
get /community/{gid}
Get community details by ID (communityGidGet)

Path parameters

gid (required)
Path Parameter — Community ID default: null

Return type

Community-Info

Example data

Content-Type: application/json
{
  "thumbnail" : "/system/files/styles/media_library/private/medialibrary/image.jpg",
  "creator" : "John Doe",
  "community_visibility" : 0,
  "created" : "01.01.2025",
  "description" : "This is community description.",
  "rules" : "Some rules.",
  "members_count" : 10,
  "title" : "HR",
  "did" : "12",
  "admins" : {
    "key" : {
      "thumbnail" : {
        "alt" : "image alt text",
        "url" : "https://example.com/example_image.jpg"
      },
      "name" : "John Doe"
    }
  }
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Community details Community-Info

400

Invalid Community ID

404

Community not found

403

Access denied

Up
patch /community/joining_request/{gid}
Update or withdraw a joining request (communityJoiningRequestGidPatch)

Path parameters

gid (required)
Path Parameter — Community ID default: null

Consumes

This API call consumes the following media types via the Content-Type request header:

Request body

_community_joining_request__gid__patch_request _community_joining_request__gid__patch_request (required)
Body Parameter

Return type

Integer

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Joining request updated or withdrawn successfully Integer

403

Access denied

400

Bad request

404

Not found

Up
post /community/joining_request
Create a new joining request for a community (communityJoiningRequestPost)

Consumes

This API call consumes the following media types via the Content-Type request header:

Request body

_community_joining_request_post_request _community_joining_request_post_request (required)
Body Parameter

Return type

Integer

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Joining request created successfully Integer

400

Bad request

404

Community not found

Up
get /community/list
Get communities list. (communityListGet)
Returns communities visible to the current user. Supports pagination, sorting, filtering and request-state scoping.

Query parameters

page (optional)
Query Parameter — Zero-based page index. Each page contains 9 communities. default: 0
sort_by (optional)
Query Parameter — Field to sort by. default: title
sort_dir (optional)
Query Parameter — Sort direction. default: ASC
search (optional)
Query Parameter — Fulltext search term. default: null
requests (optional)
Query Parameter — If true with filters[tab]=own, shows communities the user has pending join requests for. default: false
filters[tab] (optional)
Query Parameter — Tab context. own = memberships (or pending requests if requests=true). all = discoverable communities excluding ones already joined or requested. default: null

Return type

_community_list_get_200_response

Example data

Content-Type: application/json
{
  "communities" : [ {
    "thumbnail" : {
      "alt" : "image alt text",
      "url" : "https://example.com/example_image.jpg"
    },
    "gid" : 0,
    "visibility" : 6,
    "is_member" : true,
    "is_last_admin" : true,
    "edit_access" : true,
    "members" : 1,
    "join_request" : true,
    "description" : "description",
    "title" : "HR"
  }, {
    "thumbnail" : {
      "alt" : "image alt text",
      "url" : "https://example.com/example_image.jpg"
    },
    "gid" : 0,
    "visibility" : 6,
    "is_member" : true,
    "is_last_admin" : true,
    "edit_access" : true,
    "members" : 1,
    "join_request" : true,
    "description" : "description",
    "title" : "HR"
  } ]
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Return communities list. _community_list_get_200_response

Up
get /community/members/{gid}
Get the list of members in a community. (communityMembersGidGet)

Path parameters

gid (required)
Path Parameter — The community identifier. default: null

Query parameters

page (optional)
Query Parameter — The page number. default: null
sort_by (optional)
Query Parameter — Sorting criteria. default: null
sort_dir (optional)
Query Parameter — Sorting direction. default: null
search (optional)
Query Parameter — Search a member by name. default: null
requests (optional)
Query Parameter — Whether to return only the members who requested to join. 0 for false, 1 for true. default: null

Return type

_community_members__gid__get_200_response

Example data

Content-Type: application/json
{
  "members" : [ {
    "uid" : 0,
    "memberSince" : "05/02/2024",
    "thumbnail" : {
      "alt" : "image alt text",
      "url" : "https://example.com/example_image.jpg"
    },
    "mail" : "someone@example.com",
    "communityRoleId" : "community_member",
    "name" : "Clara",
    "communityRole" : "Member"
  }, {
    "uid" : 0,
    "memberSince" : "05/02/2024",
    "thumbnail" : {
      "alt" : "image alt text",
      "url" : "https://example.com/example_image.jpg"
    },
    "mail" : "someone@example.com",
    "communityRoleId" : "community_member",
    "name" : "Clara",
    "communityRole" : "Member"
  } ],
  "adminCount" : 1,
  "count" : 10
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Returen members list. _community_members__gid__get_200_response

Up
patch /community/members/{gid}
Update community member status or role (communityMembersGidPatch)
Perform actions such as join, leave, remove, or assignRole for a community member. If the community is closed (not public), use instead the endpoint community/joining_request to let user request for joining the community, and the endpoint community/joining_request/{gid} to approve/reject or withdraw request.

Path parameters

gid (required)
Path Parameter — The community group ID. default: null

Consumes

This API call consumes the following media types via the Content-Type request header:

Request body

_community_members__gid__patch_request _community_members__gid__patch_request (required)
Body Parameter

Return type

Object

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Action performed successfully. Object

400

Invalid action or bad request.

403

Permission denied.

404

Community or user not found.

Up
post /community
Create a new community (communityPost)

Consumes

This API call consumes the following media types via the Content-Type request header:

Request body

_community_post_request _community_post_request (required)
Body Parameter

Responses

200

Community created successfully

403

No permission to create a community

Up
get /community/settings/{gid}
Get community settings. (communitySettingsGidGet)
Returns general community settings fields (labels, types, required state, values, picture information, and other community-level data).

Path parameters

gid (required)
Path Parameter — The ID of the community. default: null

Return type

map[CommunityField]

Example data

Content-Type: application/json
{
  "gid" : {
    "label" : "ID",
    "type" : "integer",
    "required" : false,
    "value" : 14
  },
  "uuid" : {
    "label" : "UUID",
    "type" : "uuid",
    "required" : false,
    "value" : "a94b5d1f-1f04-40ee-8129-f5de192937d8"
  },
  "langcode" : {
    "label" : "Sprache",
    "type" : "language",
    "required" : false,
    "value" : "en"
  },
  "uid" : {
    "label" : "Created by",
    "type" : "entity_reference",
    "required" : false,
    "value" : [ {
      "target_id" : 112,
      "target_type" : "user",
      "target_uuid" : "acddabfb-91a3-4c01-af18-bf977c88a77e",
      "url" : "/user/112"
    } ]
  },
  "title" : {
    "label" : "Titel",
    "type" : "string",
    "required" : true,
    "value" : "HR"
  },
  "type" : {
    "label" : "Typ",
    "type" : "string",
    "required" : false,
    "value" : null
  },
  "created" : {
    "label" : "Created",
    "type" : "created",
    "required" : false,
    "value" : "30.04.2024"
  },
  "changed" : {
    "label" : "Geändert",
    "type" : "changed",
    "required" : false,
    "value" : "30.04.2024"
  },
  "default_langcode" : {
    "label" : "Standardsprache",
    "type" : "boolean",
    "required" : false,
    "value" : true
  },
  "path" : {
    "label" : "Pfad",
    "type" : "path",
    "required" : false,
    "value" : {
      "alias" : "/hr",
      "pid" : 99,
      "langcode" : "en"
    }
  },
  "status" : {
    "label" : "Status",
    "type" : "boolean",
    "required" : false,
    "value" : true
  },
  "public" : {
    "label" : "Öffentlich",
    "type" : "boolean",
    "required" : false,
    "value" : true
  },
  "description" : {
    "label" : "Beschreibung",
    "type" : "string",
    "required" : false,
    "value" : "Human Resources Group"
  },
  "members" : {
    "label" : "Mitglieder",
    "type" : "entity_reference",
    "required" : false,
    "value" : [ {
      "target_id" : 21,
      "target_type" : "community_member",
      "target_uuid" : "66a575fb-9dce-4f79-826a-ed80eb5bc20b",
      "url" : "/community_member/21?community=14&group=14"
    }, {
      "target_id" : 25,
      "target_type" : "community_member",
      "target_uuid" : "dc186a71-4dea-4991-9bf3-4705f239790c",
      "url" : "/community_member/25?community=14&group=14"
    } ]
  },
  "community_picture" : {
    "label" : "Picture",
    "type" : "image",
    "required" : false,
    "default" : {
      "url" : "/themes/contrib/piipe_backend/images/icons/media/picture-placeholder.svg",
      "alt" : "Default picture for community HR"
    },
    "value" : {
      "url" : "/system/files/styles/thumbnail/private/community/14/community-picture/hr.webp?h=abc&itok=def",
      "alt" : "Picture for community HR"
    }
  },
  "joining_requests" : {
    "label" : "Beitrittsanfragen",
    "type" : "entity_reference",
    "required" : false,
    "value" : [ ]
  }
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Community settings object.

Up
patch /community/settings/{gid}
Update community settings. (communitySettingsGidPatch)
Updates editable community-level settings (for example title, picture, links, and other community fields). User-specific settings are managed via /community/settings/{gid}/user.

Path parameters

gid (required)
Path Parameter — The ID of the community. default: null

Consumes

This API call consumes the following media types via the Content-Type request header:

Request body

request_body map[CommunityField] (required)
Body Parameter

Return type

map[CommunityField]

Example data

Content-Type: application/json
{
  "gid" : {
    "label" : "ID",
    "type" : "integer",
    "required" : false,
    "value" : 14
  },
  "uuid" : {
    "label" : "UUID",
    "type" : "uuid",
    "required" : false,
    "value" : "a94b5d1f-1f04-40ee-8129-f5de192937d8"
  },
  "langcode" : {
    "label" : "Sprache",
    "type" : "language",
    "required" : false,
    "value" : "en"
  },
  "uid" : {
    "label" : "Created by",
    "type" : "entity_reference",
    "required" : false,
    "value" : [ {
      "target_id" : 112,
      "target_type" : "user",
      "target_uuid" : "acddabfb-91a3-4c01-af18-bf977c88a77e",
      "url" : "/user/112"
    } ]
  },
  "title" : {
    "label" : "Titel",
    "type" : "string",
    "required" : true,
    "value" : "HR"
  },
  "type" : {
    "label" : "Typ",
    "type" : "string",
    "required" : false,
    "value" : null
  },
  "created" : {
    "label" : "Created",
    "type" : "created",
    "required" : false,
    "value" : "30.04.2024"
  },
  "changed" : {
    "label" : "Geändert",
    "type" : "changed",
    "required" : false,
    "value" : "30.04.2024"
  },
  "default_langcode" : {
    "label" : "Standardsprache",
    "type" : "boolean",
    "required" : false,
    "value" : true
  },
  "path" : {
    "label" : "Pfad",
    "type" : "path",
    "required" : false,
    "value" : {
      "alias" : "/hr",
      "pid" : 99,
      "langcode" : "en"
    }
  },
  "status" : {
    "label" : "Status",
    "type" : "boolean",
    "required" : false,
    "value" : true
  },
  "public" : {
    "label" : "Öffentlich",
    "type" : "boolean",
    "required" : false,
    "value" : true
  },
  "description" : {
    "label" : "Beschreibung",
    "type" : "string",
    "required" : false,
    "value" : "Human Resources Group"
  },
  "members" : {
    "label" : "Mitglieder",
    "type" : "entity_reference",
    "required" : false,
    "value" : [ {
      "target_id" : 21,
      "target_type" : "community_member",
      "target_uuid" : "66a575fb-9dce-4f79-826a-ed80eb5bc20b",
      "url" : "/community_member/21?community=14&group=14"
    }, {
      "target_id" : 25,
      "target_type" : "community_member",
      "target_uuid" : "dc186a71-4dea-4991-9bf3-4705f239790c",
      "url" : "/community_member/25?community=14&group=14"
    } ]
  },
  "community_picture" : {
    "label" : "Picture",
    "type" : "image",
    "required" : false,
    "default" : {
      "url" : "/themes/contrib/piipe_backend/images/icons/media/picture-placeholder.svg",
      "alt" : "Default picture for community HR"
    },
    "value" : {
      "url" : "/system/files/styles/thumbnail/private/community/14/community-picture/hr.webp?h=abc&itok=def",
      "alt" : "Picture for community HR"
    }
  },
  "joining_requests" : {
    "label" : "Beitrittsanfragen",
    "type" : "entity_reference",
    "required" : false,
    "value" : [ ]
  }
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Updated community settings object.

400

Bad request.

403

Forbidden – user has no permission.

500

Internal server error (e.g. could not create directory).

Up
get /community/settings/{gid}/user
Get community user settings. (communitySettingsGidUserGet)
Returns user-specific settings for the current user in the specified community.

Path parameters

gid (required)
Path Parameter — The ID of the community. default: null

Return type

CommunityUserSettings

Example data

Content-Type: application/json
{
  "community_notifications" : [ {
    "system" : true,
    "mail" : true,
    "id" : 0,
    "label" : "label",
    "mandatory" : true,
    "push" : true
  }, {
    "system" : true,
    "mail" : true,
    "id" : 0,
    "label" : "label",
    "mandatory" : true,
    "push" : true
  } ]
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Current user-specific settings for this community. CommunityUserSettings

400

Invalid community ID.

403

Forbidden - user is not authenticated or has no access to this community.

404

Community not found.

Up
patch /community/settings/{gid}/user
Update community user settings. (communitySettingsGidUserPatch)
Updates user-specific settings for the current user in the specified community.

Path parameters

gid (required)
Path Parameter — The ID of the community. default: null

Consumes

This API call consumes the following media types via the Content-Type request header:

Request body

CommunityUserSettingsPatchRequest CommunityUserSettingsPatchRequest (required)
Body Parameter

Return type

CommunityUserSettings

Example data

Content-Type: application/json
{
  "community_notifications" : [ {
    "system" : true,
    "mail" : true,
    "id" : 0,
    "label" : "label",
    "mandatory" : true,
    "push" : true
  }, {
    "system" : true,
    "mail" : true,
    "id" : 0,
    "label" : "label",
    "mandatory" : true,
    "push" : true
  } ]
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Updated current user-specific settings for this community. CommunityUserSettings

400

Invalid payload (for example malformed user settings data, or invalid notification values for the currently supported notification settings payload).

403

Forbidden - user is not authenticated or has no access to this community.

404

Community not found.

Configuration

Up
get /birthday_calendar_filters
Get birthday calendar filters. (birthdayCalendarFiltersGet)

Return type

_birthday_calendar_filters_get_200_response

Example data

Content-Type: application/json
{
  "location_filter" : [ {
    "name" : "Berlin",
    "id" : 0
  }, {
    "name" : "Berlin",
    "id" : 0
  } ]
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Return birthday calendar filters. _birthday_calendar_filters_get_200_response

Up
get /box_pages/frontend/boxes/reorder
Get reorder settings in dynamic box pages. (boxPagesFrontendBoxesReorderGet)
Reorder boxes as they appeare in a dynamic box page.

Query parameters

machine_name (optional)
Query Parameter — The box page machine name. default: null

Return type

array[Box-Page-Reorder-Settings]

Example data

Content-Type: application/json
[ {
  "author" : "John Doe",
  "weight" : 6,
  "bid" : 0,
  "title" : "Accessibility",
  "type" : "Content box",
  "changed" : "12/04/2023"
}, {
  "author" : "John Doe",
  "weight" : 6,
  "bid" : 0,
  "title" : "Accessibility",
  "type" : "Content box",
  "changed" : "12/04/2023"
} ]

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Return reorder settings.

Up
patch /box_pages/frontend/boxes/reorder
Apply reorder settings in dynamic box pages. (boxPagesFrontendBoxesReorderPatch)
Reorder boxes as they appeare in a dynamic box page.

Consumes

This API call consumes the following media types via the Content-Type request header:

Request body

_box_pages_frontend_boxes_reorder_patch_request _box_pages_frontend_boxes_reorder_patch_request (required)
Body Parameter

Responses

200

successful operation.

Up
patch /box_pages/my_page_add
Add/remove a node to/from my page. (boxPagesMyPageAddPatch)
Adding or removing nodes can only be done on nodes which are contained in boxes of type "content box".

Consumes

This API call consumes the following media types via the Content-Type request header:

Request body

_box_pages_my_page_add_patch_request _box_pages_my_page_add_patch_request (required)
Body Parameter

Return type

_box_pages_my_page_add_patch_200_response

Example data

Content-Type: application/json
{
  "text" : "Add to my page",
  "status" : true
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Return the new button label and status. _box_pages_my_page_add_patch_200_response

400

Bad Request.

404

Box not found.

Up
get /bulletin/config
Get the configuration of bulletin board. (bulletinConfigGet)

Return type

array[Bulletin-Config]

Example data

Content-Type: application/json
[ {
  "types" : [ {
    "id" : "offer",
    "name" : "Offer"
  }, {
    "id" : "search",
    "name" : "Search"
  } ],
  "consent_text" : "It is confirmed that for the media posted on the intranet, the regulations on rights of use have been taken into account in accordance with the Terms of Use and Privacy Policy.",
  "breadcrumbRoots" : [ {
    "text" : "Services",
    "route" : "/services"
  } ],
  "permissions" : [ {
    "create" : true
  } ],
  "language" : "en",
  "categories" : [ {
    "id" : "267",
    "name" : "Cars, Motorbikes"
  }, {
    "id" : "272",
    "name" : "Clothing"
  }, {
    "id" : "271",
    "name" : "Hobby"
  } ]
}, {
  "types" : [ {
    "id" : "offer",
    "name" : "Offer"
  }, {
    "id" : "search",
    "name" : "Search"
  } ],
  "consent_text" : "It is confirmed that for the media posted on the intranet, the regulations on rights of use have been taken into account in accordance with the Terms of Use and Privacy Policy.",
  "breadcrumbRoots" : [ {
    "text" : "Services",
    "route" : "/services"
  } ],
  "permissions" : [ {
    "create" : true
  } ],
  "language" : "en",
  "categories" : [ {
    "id" : "267",
    "name" : "Cars, Motorbikes"
  }, {
    "id" : "272",
    "name" : "Clothing"
  }, {
    "id" : "271",
    "name" : "Hobby"
  } ]
} ]

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Return bulletin board configuration.

Up
get /employee_directory/config
Get the configuration of employee directory. (employeeDirectoryConfigGet)

Return type

array[Employees-Config]

Example data

Content-Type: application/json
[ {
  "uid" : 1,
  "alphabet_counted" : {
    "A" : 3,
    "B" : 1,
    "C" : 1,
    "D" : 1,
    "E" : 0
  },
  "columns" : [ {
    "filter" : [ ],
    "frontend_label" : "",
    "field_label" : "Position",
    "name" : "field_position",
    "weight" : 0,
    "type" : "text",
    "delete" : "Löschen"
  }, {
    "filter" : [ ],
    "frontend_label" : "",
    "field_label" : "Position",
    "name" : "field_position",
    "weight" : 0,
    "type" : "text",
    "delete" : "Löschen"
  } ],
  "language" : "en",
  "dropdowns" : [ {
    "field_location" : [ {
      "tid" : 48,
      "label" : "Berlin"
    }, {
      "tid" : 211,
      "label" : "München"
    }, {
      "tid" : 277,
      "label" : "Paris"
    }, {
      "tid" : 361,
      "label" : "Rosenberg"
    }, {
      "tid" : 47,
      "label" : "Saarbrücken"
    }, {
      "tid" : 278,
      "label" : "Trier"
    } ]
  }, {
    "field_location" : [ {
      "tid" : 48,
      "label" : "Berlin"
    }, {
      "tid" : 211,
      "label" : "München"
    }, {
      "tid" : 277,
      "label" : "Paris"
    }, {
      "tid" : 361,
      "label" : "Rosenberg"
    }, {
      "tid" : 47,
      "label" : "Saarbrücken"
    }, {
      "tid" : 278,
      "label" : "Trier"
    } ]
  } ],
  "hierarchical_sorting" : [ {
    "click_field" : "field_organizational_unit",
    "sorting_field" : "field_team_leader"
  }, {
    "click_field" : "field_organizational_unit",
    "sorting_field" : "field_team_leader"
  } ]
}, {
  "uid" : 1,
  "alphabet_counted" : {
    "A" : 3,
    "B" : 1,
    "C" : 1,
    "D" : 1,
    "E" : 0
  },
  "columns" : [ {
    "filter" : [ ],
    "frontend_label" : "",
    "field_label" : "Position",
    "name" : "field_position",
    "weight" : 0,
    "type" : "text",
    "delete" : "Löschen"
  }, {
    "filter" : [ ],
    "frontend_label" : "",
    "field_label" : "Position",
    "name" : "field_position",
    "weight" : 0,
    "type" : "text",
    "delete" : "Löschen"
  } ],
  "language" : "en",
  "dropdowns" : [ {
    "field_location" : [ {
      "tid" : 48,
      "label" : "Berlin"
    }, {
      "tid" : 211,
      "label" : "München"
    }, {
      "tid" : 277,
      "label" : "Paris"
    }, {
      "tid" : 361,
      "label" : "Rosenberg"
    }, {
      "tid" : 47,
      "label" : "Saarbrücken"
    }, {
      "tid" : 278,
      "label" : "Trier"
    } ]
  }, {
    "field_location" : [ {
      "tid" : 48,
      "label" : "Berlin"
    }, {
      "tid" : 211,
      "label" : "München"
    }, {
      "tid" : 277,
      "label" : "Paris"
    }, {
      "tid" : 361,
      "label" : "Rosenberg"
    }, {
      "tid" : 47,
      "label" : "Saarbrücken"
    }, {
      "tid" : 278,
      "label" : "Trier"
    } ]
  } ],
  "hierarchical_sorting" : [ {
    "click_field" : "field_organizational_unit",
    "sorting_field" : "field_team_leader"
  }, {
    "click_field" : "field_organizational_unit",
    "sorting_field" : "field_team_leader"
  } ]
} ]

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Return employee directory configuration.

Up
get /scssadmin
Get SCSS variables. (scssadminGet)

Return type

map[String, array[_scssadmin_get_200_response_value_inner]]

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

SCSS variables.

Entities

Up
get /box/{bid}/{view_mode}
Get a box in a view mode. (boxBidViewModeGet)
The view mode should be specified in the query parameter view_mode.

Path parameters

bid (required)
Path Parameter — Box ID. default: null
view_mode (required)
Path Parameter — Retreive box data as it appears in the specified view mode. default: null

Return type

Box

Example data

Content-Type: application/json
{
  "entity_type" : "box",
  "box_type" : "content_box",
  "id" : 0,
  "content" : {
    "summary" : "In the video series 'ChatGPT - briefly explained', Aljoscha Burchardt from the German Research Center for Artificial Intelligence (DFKI) explains the technology behind the AI chatbot and discusses its influence on various aspects of our lives.",
    "entity_type" : "node",
    "node_type" : "content_page",
    "id" : 42,
    "title" : {
      "text" : "This is a node title."
    },
    "header_media" : {
      "owner" : "John Doe",
      "entity_type" : "media",
      "file" : {
        "alt" : "image alt text",
        "url" : "https://example.com/example_image.jpg"
      },
      "media_type" : "image",
      "description" : "Image description",
      "id" : 0,
      "source" : {
        "link_type" : "external",
        "url_text" : "Link",
        "link_text" : "Press to go to website",
        "url" : "https://example.com"
      },
      "type" : "image"
    }
  }
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Return box data. Box

400

Invalid view_mode value.

404

Box ID could not be resolved.

Up
get /node/{nid}/{view_mode}
Get a node in a view mode. (nodeNidViewModeGet)
The view mode should be specified in the query parameter view_mode.

Path parameters

nid (required)
Path Parameter — Node ID. default: null
view_mode (required)
Path Parameter — Retreive node data as it appears in the specified view mode. default: null

Return type

Node-View-Mode

Example data

Content-Type: application/json
{
  "summary" : "In the video series 'ChatGPT - briefly explained', Aljoscha Burchardt from the German Research Center for Artificial Intelligence (DFKI) explains the technology behind the AI chatbot and discusses its influence on various aspects of our lives.",
  "entity_type" : "node",
  "node_type" : "content_page",
  "authored_by" : {
    "id" : 0,
    "text" : "text",
    "user_text" : "user_text"
  },
  "my_page_button" : {
    "active" : true,
    "id" : 6,
    "text" : "Add to my page",
    "status" : true
  },
  "id" : 42,
  "title" : {
    "text" : "This is a node title."
  },
  "content" : [ {
    "block_name" : "core/paragraph",
    "inner_blocks" : [ ],
    "html" : "html"
  }, {
    "block_name" : "core/paragraph",
    "inner_blocks" : [ ],
    "html" : "html"
  } ],
  "kicker" : "AI & digitization",
  "header_media" : {
    "owner" : "John Doe",
    "entity_type" : "media",
    "file" : {
      "alt" : "image alt text",
      "url" : "https://example.com/example_image.jpg"
    },
    "media_type" : "image",
    "description" : "Image description",
    "id" : 0,
    "source" : {
      "link_type" : "external",
      "url_text" : "Link",
      "link_text" : "Press to go to website",
      "url" : "https://example.com"
    },
    "type" : "image"
  }
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Return node data. Node-View-Mode

400

Invalid view_mode value.

404

Node ID could not be resolved.

Up
post /piipe_flags/flag
Flag/unflag an entity. (piipeFlagsFlagPost)
The entity (e.g. node, comment) should be marked with a flag in order to be flagged/unflagged.

Consumes

This API call consumes the following media types via the Content-Type request header:

Request body

_piipe_flags_flag_post_request _piipe_flags_flag_post_request (required)
Body Parameter

Return type

Flag-Status

Example data

Content-Type: application/json
{
  "flag_id" : "content_flag_like",
  "entity_type" : "node",
  "flagged" : true,
  "count" : 50,
  "entity_id" : 1
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

The flag new status. Flag-Status

400

Missing body parameter or flag action cannot be performed.

403

The user can't perform action on flag.

404

The requested flag cannot be found.

Up
patch /poll
Vote/cancel vote in a poll. (pollPatch)
There are two possible actions (vote/cancel a vote). The action has to be specified in the request body.

Consumes

This API call consumes the following media types via the Content-Type request header:

Request body

_poll_patch_request _poll_patch_request (required)
Body Parameter

Return type

Poll-Block

Example data

Content-Type: application/json
{
  "total_votes" : 4,
  "question" : "Which ice cream flavor do you like best?",
  "cancel_vote_allow" : false,
  "voted" : false,
  "id" : 0,
  "choices" : [ {
    "vote_percentage" : 50,
    "id" : 6,
    "text" : "Chocolate",
    "vote_count" : 2
  }, {
    "vote_percentage" : 50,
    "id" : 6,
    "text" : "Chocolate",
    "vote_count" : 2
  } ]
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Return the updated version of a poll. Poll-Block

400

Bad Request.

404

Poll not found.

Up
get /social_icons/{nid}
Get a node's social icons. (socialIconsNidGet)

Path parameters

nid (required)
Path Parameter — Node ID. default: null

Return type

Social-Icons

Example data

Content-Type: application/json
{
  "comments" : {
    "count" : 10
  },
  "rocks" : {
    "flag_id" : "content_flag_rocks",
    "entity_type" : "node",
    "flagged" : true,
    "count" : 50,
    "entity_id" : 1
  },
  "like" : {
    "flag_id" : "content_flag_like",
    "entity_type" : "node",
    "flagged" : true,
    "count" : 50,
    "entity_id" : 1
  },
  "heart" : {
    "flag_id" : "content_flag_heart",
    "entity_type" : "node",
    "flagged" : true,
    "count" : 50,
    "entity_id" : 1
  },
  "views" : {
    "count" : 100
  }
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Return social icons data of a node. Social-Icons

400

Invalid nid value.

403

The user doesn't have permission to access the requested node.

404

Node ID could not be resolved.

FrontpageMagazine

Up
get /frontpage
Returns the current list of frontpage sections. (frontpageGet)
Each section includes a list of components and their configuration.

Return type

array[Section]

Example data

Content-Type: application/json
[ {
  "components" : [ {
    "type" : "frontpage_slider",
    "uuid" : "wy64mm78-m4ks-nrk4-z5mm-cjrfvb9iqnfq"
  }, {
    "type" : "frontpage_slider",
    "uuid" : "wy64mm78-m4ks-nrk4-z5mm-cjrfvb9iqnfq"
  } ],
  "background_color" : "#fffff",
  "title" : "News"
}, {
  "components" : [ {
    "type" : "frontpage_slider",
    "uuid" : "wy64mm78-m4ks-nrk4-z5mm-cjrfvb9iqnfq"
  }, {
    "type" : "frontpage_slider",
    "uuid" : "wy64mm78-m4ks-nrk4-z5mm-cjrfvb9iqnfq"
  } ],
  "background_color" : "#fffff",
  "title" : "News"
} ]

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

successful operation.

Up
get /frontpage/{uuid}
Returns the frontpage component referenced by uuid. (frontpageUuidGet)
Each frontpage component has a distinct structure and is identified throgh a unique id.

Path parameters

uuid (required)
Path Parameter — uuid of frontpage component to return. default: null

Query parameters

field_magazine_channel (optional)
Query Parameter — Filter results by magazine channel. Pass a facet item_id from the sub_facets of a magazine_category_filter_box component to restrict search_results to that channel. default: null

Return type

Concrete-Component

Example data

Content-Type: application/json
{
  "additional_data" : {
    "additional_data_2" : "Concrete_Component_additional_data_additional_data_2",
    "additional_data_1" : "Concrete_Component_additional_data_additional_data_1"
  },
  "data" : [ {
    "summary" : "In the video series 'ChatGPT - briefly explained', Aljoscha Burchardt from the German Research Center for Artificial Intelligence (DFKI) explains the technology behind the AI chatbot and discusses its influence on various aspects of our lives.",
    "entity_type" : "node",
    "node_type" : "content_page",
    "id" : 42,
    "title" : {
      "text" : "This is a node title."
    },
    "kicker" : "AI & digitization",
    "header_media" : {
      "owner" : "John Doe",
      "entity_type" : "media",
      "file" : {
        "alt" : "image alt text",
        "url" : "https://example.com/example_image.jpg"
      },
      "media_type" : "image",
      "description" : "Image description",
      "id" : 0,
      "source" : {
        "link_type" : "external",
        "url_text" : "Link",
        "link_text" : "Press to go to website",
        "url" : "https://example.com"
      },
      "type" : "image"
    }
  }, {
    "summary" : "In the video series 'ChatGPT - briefly explained', Aljoscha Burchardt from the German Research Center for Artificial Intelligence (DFKI) explains the technology behind the AI chatbot and discusses its influence on various aspects of our lives.",
    "entity_type" : "node",
    "node_type" : "content_page",
    "id" : 42,
    "title" : {
      "text" : "This is a node title."
    },
    "kicker" : "AI & digitization",
    "header_media" : {
      "owner" : "John Doe",
      "entity_type" : "media",
      "file" : {
        "alt" : "image alt text",
        "url" : "https://example.com/example_image.jpg"
      },
      "media_type" : "image",
      "description" : "Image description",
      "id" : 0,
      "source" : {
        "link_type" : "external",
        "url_text" : "Link",
        "link_text" : "Press to go to website",
        "url" : "https://example.com"
      },
      "type" : "image"
    }
  } ],
  "type" : "frontpage_slider",
  "title" : "Frontpage Slider",
  "empty" : {
    "text" : "There is currently no news to display."
  }
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

successful operation. Concrete-Component

404

Component not found.

Up
get /magazine
Returns the current list of magazine sections. (magazineGet)
Each section includes a list of components and their configuration.

Return type

array[Section]

Example data

Content-Type: application/json
[ {
  "components" : [ {
    "type" : "frontpage_slider",
    "uuid" : "wy64mm78-m4ks-nrk4-z5mm-cjrfvb9iqnfq"
  }, {
    "type" : "frontpage_slider",
    "uuid" : "wy64mm78-m4ks-nrk4-z5mm-cjrfvb9iqnfq"
  } ],
  "background_color" : "#fffff",
  "title" : "News"
}, {
  "components" : [ {
    "type" : "frontpage_slider",
    "uuid" : "wy64mm78-m4ks-nrk4-z5mm-cjrfvb9iqnfq"
  }, {
    "type" : "frontpage_slider",
    "uuid" : "wy64mm78-m4ks-nrk4-z5mm-cjrfvb9iqnfq"
  } ],
  "background_color" : "#fffff",
  "title" : "News"
} ]

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

successful operation.

Up
get /magazine/{uuid}
Returns the magazine component referenced by uuid. (magazineUuidGet)
Each magazine component has a distinct structure and is identified throgh a unique id.

Path parameters

uuid (required)
Path Parameter — uuid of magazine component to return. default: null

Query parameters

field_magazine_channel (optional)
Query Parameter — Filter results by magazine channel. Pass a facet item_id from the sub_facets of a magazine_category_filter_box component to restrict search_results to that channel. default: null

Return type

Concrete-Component

Example data

Content-Type: application/json
{
  "additional_data" : {
    "additional_data_2" : "Concrete_Component_additional_data_additional_data_2",
    "additional_data_1" : "Concrete_Component_additional_data_additional_data_1"
  },
  "data" : [ {
    "summary" : "In the video series 'ChatGPT - briefly explained', Aljoscha Burchardt from the German Research Center for Artificial Intelligence (DFKI) explains the technology behind the AI chatbot and discusses its influence on various aspects of our lives.",
    "entity_type" : "node",
    "node_type" : "content_page",
    "id" : 42,
    "title" : {
      "text" : "This is a node title."
    },
    "kicker" : "AI & digitization",
    "header_media" : {
      "owner" : "John Doe",
      "entity_type" : "media",
      "file" : {
        "alt" : "image alt text",
        "url" : "https://example.com/example_image.jpg"
      },
      "media_type" : "image",
      "description" : "Image description",
      "id" : 0,
      "source" : {
        "link_type" : "external",
        "url_text" : "Link",
        "link_text" : "Press to go to website",
        "url" : "https://example.com"
      },
      "type" : "image"
    }
  }, {
    "summary" : "In the video series 'ChatGPT - briefly explained', Aljoscha Burchardt from the German Research Center for Artificial Intelligence (DFKI) explains the technology behind the AI chatbot and discusses its influence on various aspects of our lives.",
    "entity_type" : "node",
    "node_type" : "content_page",
    "id" : 42,
    "title" : {
      "text" : "This is a node title."
    },
    "kicker" : "AI & digitization",
    "header_media" : {
      "owner" : "John Doe",
      "entity_type" : "media",
      "file" : {
        "alt" : "image alt text",
        "url" : "https://example.com/example_image.jpg"
      },
      "media_type" : "image",
      "description" : "Image description",
      "id" : 0,
      "source" : {
        "link_type" : "external",
        "url_text" : "Link",
        "link_text" : "Press to go to website",
        "url" : "https://example.com"
      },
      "type" : "image"
    }
  } ],
  "type" : "frontpage_slider",
  "title" : "Frontpage Slider",
  "empty" : {
    "text" : "There is currently no news to display."
  }
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

successful operation. Concrete-Component

404

Component not found.

Navigation

Up
get /menu/{menu_name}
Get menu items. (menuMenuNameGet)
The following menus can be accessed by authenticated users: [Main navigation, News Tab Menu, User account menu, Footer].

Path parameters

menu_name (required)
Path Parameter — Menu name. default: null

Return type

array[Menu-Link]

Example data

Content-Type: application/json
[ {
  "link_type" : "external",
  "subtree" : [ ],
  "route_name" : "box_pages.services",
  "link" : "link",
  "title" : "Profile",
  "icon_id" : "fa-facebook"
}, {
  "link_type" : "external",
  "subtree" : [ ],
  "route_name" : "box_pages.services",
  "link" : "link",
  "title" : "Profile",
  "icon_id" : "fa-facebook"
} ]

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Return Menu items.

403

Access denied.

404

Menu could not be resolved.

Up
get /piipe_toolbar/config
Get default toolbar items. (piipeToolbarConfigGet)
Use the toolbar items from this endpoint. The set of items can be extended by defining custom items (endpoint "/piipe_toolbar/custom_objects"), and their settings can be overridden (endpoint "/piipe_toolbar/settings").

Return type

map[Toolbar_Default_Items_value]

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Return the set of default toolbar items.

Up
get /piipe_toolbar/custom_objects
Get custom toolbar items. (piipeToolbarCustomObjectsGet)
Users can define their own toolbar items to extend the set of default toolbar items (endpoint "/piipe_toolbar/config"). For example, the user can add a new link inside an existing section.

Return type

map[Toolbar-Custom-Item]

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Return the set of custom toolbar items.

Up
patch /piipe_toolbar/custom_objects
Manage custom toolbar item. (piipeToolbarCustomObjectsPatch)
Update/delete custom toolbar items defined by the user. If a deletion action is to be performed on a folder toolbar item, then this will have the effect of deleting all toolbar items included in that folder.

Consumes

This API call consumes the following media types via the Content-Type request header:

Request body

_piipe_toolbar_custom_objects_patch_request _piipe_toolbar_custom_objects_patch_request (required)
Body Parameter

Responses

200

Action was performed successfully.

Up
post /piipe_toolbar/custom_objects
Create custom toolbar item. (piipeToolbarCustomObjectsPost)
Lets the user create a custom toolbar item.

Consumes

This API call consumes the following media types via the Content-Type request header:

Request body

_piipe_toolbar_custom_objects_post_request _piipe_toolbar_custom_objects_post_request (optional)
Body Parameter

Responses

200

Toolbar item was created successfully.

Up
get /piipe_toolbar/settings
Get toolbar items settings overrides. (piipeToolbarSettingsGet)
Users can override the default settings of default toolbar items (endpoint "/piipe_toolbar/config"). For example, the user can hide a hidable default link, or change the default source and target languages in a dictionary.

Return type

map[Toolbar-Settings-Object]

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Return the set of custom toolbar items.

Up
patch /piipe_toolbar/settings
Manage toolbar item settings. (piipeToolbarSettingsPatch)
Lets the user update/delete toolbar item settings.

Consumes

This API call consumes the following media types via the Content-Type request header:

Request body

_piipe_toolbar_settings_patch_request _piipe_toolbar_settings_patch_request (optional)
Body Parameter

Responses

200

Toolbar item settings was changed successfully.

Up
post /piipe_toolbar/settings
Add toolbar item settings. (piipeToolbarSettingsPost)
Lets the user add toolbar item settings.

Consumes

This API call consumes the following media types via the Content-Type request header:

Request body

_piipe_toolbar_settings_post_request _piipe_toolbar_settings_post_request (optional)
Body Parameter

Responses

200

Toolbar item settings was added successfully.

Notifications

Up
get /notifications
Retrieve user notifications (notificationsGet)
Get a paginated list of notifications for the current user

Query parameters

page (optional)
Query Parameter — Page number for pagination default: 0

Return type

_notifications_get_200_response

Example data

Content-Type: application/json
{
  "unread_count" : 1,
  "messages" : [ {
    "additional_data" : {
      "route_1" : "entity.node.canonical",
      "route_2" : "entity.node.canonical",
      "notification_type" : "social_reaction",
      "node_id" : "123",
      "user_id" : "45",
      "comment_id" : "678",
      "commented_entity_type" : "node",
      "commented_entity_id" : "123",
      "linked_entity_id" : "123"
    },
    "referenced_entity_id" : 6,
    "image_url" : "image_url",
    "mid" : 0,
    "description" : "description",
    "time" : "time",
    "text" : "text",
    "type" : "content_creation",
    "referenced_entity_type" : "node",
    "status" : true,
    "info" : "info"
  }, {
    "additional_data" : {
      "route_1" : "entity.node.canonical",
      "route_2" : "entity.node.canonical",
      "notification_type" : "social_reaction",
      "node_id" : "123",
      "user_id" : "45",
      "comment_id" : "678",
      "commented_entity_type" : "node",
      "commented_entity_id" : "123",
      "linked_entity_id" : "123"
    },
    "referenced_entity_id" : 6,
    "image_url" : "image_url",
    "mid" : 0,
    "description" : "description",
    "time" : "time",
    "text" : "text",
    "type" : "content_creation",
    "referenced_entity_type" : "node",
    "status" : true,
    "info" : "info"
  } ]
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Successful response _notifications_get_200_response

403

Forbidden

Up
patch /notifications
Perform actions on notifications (notificationsPatch)
Update, mark, or delete notifications

Consumes

This API call consumes the following media types via the Content-Type request header:

Request body

_notifications_patch_request _notifications_patch_request (required)
Body Parameter

Responses

204

Successful action, no content

400

Bad request

403

Forbidden

Up
post /register_device_token
Register a device token for a specific app. (registerDeviceTokenPost)
The device token is needed for sending push notifications to the app.

Consumes

This API call consumes the following media types via the Content-Type request header:

Request body

_register_device_token_post_request _register_device_token_post_request (optional)
Body Parameter

Return type

String

Example data

Content-Type: application/json
"The requested device token is already registered. User, creation time and language associated with that device token have been updated."

Example data

Content-Type: application/json
"Device token was successfully registered."

Example data

Content-Type: application/json
{
  "message" : "Attribute 'token' is missing."
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Device token already exists. Data associated with the device token has been updated. String

201

Device token was successfully registered. String

400

Bad request. _register_device_token_post_400_response

Up
delete /register_device_token/{token}
Delete a registered device token. (registerDeviceTokenTokenDelete)

Path parameters

token (required)
Path Parameter — The device token to be deleted. default: null

Example data

Content-Type: application/json
{
  "message" : "You are not allowed to delete this device token."
}

Example data

Content-Type: application/json
{
  "message" : "The requested device token cannot be found."
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

204

Deletion successful.

403

Access denied. _register_device_token__token__delete_403_response

404

Not found. _register_device_token__token__delete_404_response

OverviewPages

Up
post /api/v1/piipe_picture_gallery/create
Create a new gallery post (apiV1PiipePictureGalleryCreatePost)

Consumes

This API call consumes the following media types via the Content-Type request header:

Request body

_api_v1_piipe_picture_gallery_create_post_request _api_v1_piipe_picture_gallery_create_post_request (required)
Body Parameter

Return type

_api_v1_piipe_picture_gallery_create_post_200_response

Example data

Content-Type: application/json
{
  "item" : {
    "date" : "1739461059",
    "flag" : {
      "like_count" : "2",
      "rock_flagged" : false,
      "rock_count" : "1",
      "heart_count" : "2",
      "heart_flagged" : true,
      "like_flagged" : true
    },
    "hashtags" : [ {
      "name" : "relatable",
      "id" : "496"
    }, {
      "name" : "relatable",
      "id" : "496"
    } ],
    "author" : {
      "langcode" : "Germany",
      "name" : "John Doe",
      "picture" : {
        "alt" : "Profile picture for user John Doe",
        "url" : "/system/files/styles/thumbnail/private/medialibrary/profile_image.jpg?h=cc71e594&itok=yAsmmMts"
      }
    },
    "permissions" : {
      "edit" : true,
      "delete" : true
    },
    "description" : "This is a description text.",
    "id" : "1",
    "title" : "This is a post title",
    "url" : "/system/files/styles/picture_gallery/private/picture_gallery/pexels-diiefao-2258357.jpg?itok=LVC9QA64"
  },
  "is_last" : true
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Gallery post creation result _api_v1_piipe_picture_gallery_create_post_200_response

Up
get /birthday_calendar
Get birthday calendar content. (birthdayCalendarGet)
Get list of birthday entries of a specific month.

Query parameters

pageNo (optional)
Query Parameter — Pager for the content. default: null
activeMonthIndex (optional)
Query Parameter — Month filter . default: null
location (optional)
Query Parameter — Location filter. default: null

Return type

_birthday_calendar_get_200_response

Example data

Content-Type: application/json
{
  "DATE_1" : [ {
    "field_position_value" : "Developer",
    "user_picture" : "https://example.com/image.jpg",
    "field_location_value" : "Berlin",
    "field_birthday_value" : "04. Februar",
    "name" : "John Doe",
    "user_profile_link" : "/user/1",
    "entity_id" : 0
  }, {
    "field_position_value" : "Developer",
    "user_picture" : "https://example.com/image.jpg",
    "field_location_value" : "Berlin",
    "field_birthday_value" : "04. Februar",
    "name" : "John Doe",
    "user_profile_link" : "/user/1",
    "entity_id" : 0
  } ],
  "DATE_2" : [ {
    "field_position_value" : "Developer",
    "user_picture" : "https://example.com/image.jpg",
    "field_location_value" : "Berlin",
    "field_birthday_value" : "04. Februar",
    "name" : "John Doe",
    "user_profile_link" : "/user/1",
    "entity_id" : 0
  }, {
    "field_position_value" : "Developer",
    "user_picture" : "https://example.com/image.jpg",
    "field_location_value" : "Berlin",
    "field_birthday_value" : "04. Februar",
    "name" : "John Doe",
    "user_profile_link" : "/user/1",
    "entity_id" : 0
  } ]
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Return list of birthday entries. _birthday_calendar_get_200_response

Up
get /birthday_calendar/recent_birthday/{type}
Get birthday calendar recent content. (birthdayCalendarRecentBirthdayTypeGet)
Get list of birthday entries of either today or tomorrow.

Path parameters

type (required)
Path Parameter — Filter of recent Birthdays (either today or tomorrow). default: null

Return type

array[_birthday_calendar_recent_birthday__type__get_200_response_inner]

Example data

Content-Type: application/json
[ {
  "birthday" : "1995-04-15",
  "field_position_value" : "Developer",
  "user_picture" : "https://example.com/image.jpg",
  "name" : "John Doe",
  "user_profile_link" : "/user/1",
  "id" : 0
}, {
  "birthday" : "1995-04-15",
  "field_position_value" : "Developer",
  "user_picture" : "https://example.com/image.jpg",
  "name" : "John Doe",
  "user_profile_link" : "/user/1",
  "id" : 0
} ]

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Return list of birthday entries.

Up
get /box_pages/{page_name}
Get a box page content. (boxPagesPageNameGet)
Static and dynamic (user specific) box pages can be retreived through this endpoint.

Path parameters

page_name (required)
Path Parameter — Box page name. default: null

Query parameters

view_mode (optional)
Query Parameter — Retreive boxes data in the box page as they appear in the specified view mode. If the parameter is not included, the "box" view mode will be used. (list view mode is not yet implemented) default: null

Return type

_box_pages__page_name__get_200_response

Example data

Content-Type: application/json
{
  "page_type" : "static",
  "page_title" : "Company",
  "uncategorized" : [ {
    "boxes" : [ {
      "entity_type" : "box",
      "box_type" : "content_box",
      "id" : 0,
      "content" : {
        "summary" : "In the video series 'ChatGPT - briefly explained', Aljoscha Burchardt from the German Research Center for Artificial Intelligence (DFKI) explains the technology behind the AI chatbot and discusses its influence on various aspects of our lives.",
        "entity_type" : "node",
        "node_type" : "content_page",
        "id" : 42,
        "title" : {
          "text" : "This is a node title."
        },
        "header_media" : {
          "owner" : "John Doe",
          "entity_type" : "media",
          "file" : {
            "alt" : "image alt text",
            "url" : "https://example.com/example_image.jpg"
          },
          "media_type" : "image",
          "description" : "Image description",
          "id" : 0,
          "source" : {
            "link_type" : "external",
            "url_text" : "Link",
            "link_text" : "Press to go to website",
            "url" : "https://example.com"
          },
          "type" : "image"
        }
      }
    }, {
      "entity_type" : "box",
      "box_type" : "content_box",
      "id" : 0,
      "content" : {
        "summary" : "In the video series 'ChatGPT - briefly explained', Aljoscha Burchardt from the German Research Center for Artificial Intelligence (DFKI) explains the technology behind the AI chatbot and discusses its influence on various aspects of our lives.",
        "entity_type" : "node",
        "node_type" : "content_page",
        "id" : 42,
        "title" : {
          "text" : "This is a node title."
        },
        "header_media" : {
          "owner" : "John Doe",
          "entity_type" : "media",
          "file" : {
            "alt" : "image alt text",
            "url" : "https://example.com/example_image.jpg"
          },
          "media_type" : "image",
          "description" : "Image description",
          "id" : 0,
          "source" : {
            "link_type" : "external",
            "url_text" : "Link",
            "link_text" : "Press to go to website",
            "url" : "https://example.com"
          },
          "type" : "image"
        }
      }
    } ],
    "name" : "Health"
  }, {
    "boxes" : [ {
      "entity_type" : "box",
      "box_type" : "content_box",
      "id" : 0,
      "content" : {
        "summary" : "In the video series 'ChatGPT - briefly explained', Aljoscha Burchardt from the German Research Center for Artificial Intelligence (DFKI) explains the technology behind the AI chatbot and discusses its influence on various aspects of our lives.",
        "entity_type" : "node",
        "node_type" : "content_page",
        "id" : 42,
        "title" : {
          "text" : "This is a node title."
        },
        "header_media" : {
          "owner" : "John Doe",
          "entity_type" : "media",
          "file" : {
            "alt" : "image alt text",
            "url" : "https://example.com/example_image.jpg"
          },
          "media_type" : "image",
          "description" : "Image description",
          "id" : 0,
          "source" : {
            "link_type" : "external",
            "url_text" : "Link",
            "link_text" : "Press to go to website",
            "url" : "https://example.com"
          },
          "type" : "image"
        }
      }
    }, {
      "entity_type" : "box",
      "box_type" : "content_box",
      "id" : 0,
      "content" : {
        "summary" : "In the video series 'ChatGPT - briefly explained', Aljoscha Burchardt from the German Research Center for Artificial Intelligence (DFKI) explains the technology behind the AI chatbot and discusses its influence on various aspects of our lives.",
        "entity_type" : "node",
        "node_type" : "content_page",
        "id" : 42,
        "title" : {
          "text" : "This is a node title."
        },
        "header_media" : {
          "owner" : "John Doe",
          "entity_type" : "media",
          "file" : {
            "alt" : "image alt text",
            "url" : "https://example.com/example_image.jpg"
          },
          "media_type" : "image",
          "description" : "Image description",
          "id" : 0,
          "source" : {
            "link_type" : "external",
            "url_text" : "Link",
            "link_text" : "Press to go to website",
            "url" : "https://example.com"
          },
          "type" : "image"
        }
      }
    } ],
    "name" : "Health"
  } ],
  "categories" : [ {
    "boxes" : [ {
      "entity_type" : "box",
      "box_type" : "content_box",
      "id" : 0,
      "content" : {
        "summary" : "In the video series 'ChatGPT - briefly explained', Aljoscha Burchardt from the German Research Center for Artificial Intelligence (DFKI) explains the technology behind the AI chatbot and discusses its influence on various aspects of our lives.",
        "entity_type" : "node",
        "node_type" : "content_page",
        "id" : 42,
        "title" : {
          "text" : "This is a node title."
        },
        "header_media" : {
          "owner" : "John Doe",
          "entity_type" : "media",
          "file" : {
            "alt" : "image alt text",
            "url" : "https://example.com/example_image.jpg"
          },
          "media_type" : "image",
          "description" : "Image description",
          "id" : 0,
          "source" : {
            "link_type" : "external",
            "url_text" : "Link",
            "link_text" : "Press to go to website",
            "url" : "https://example.com"
          },
          "type" : "image"
        }
      }
    }, {
      "entity_type" : "box",
      "box_type" : "content_box",
      "id" : 0,
      "content" : {
        "summary" : "In the video series 'ChatGPT - briefly explained', Aljoscha Burchardt from the German Research Center for Artificial Intelligence (DFKI) explains the technology behind the AI chatbot and discusses its influence on various aspects of our lives.",
        "entity_type" : "node",
        "node_type" : "content_page",
        "id" : 42,
        "title" : {
          "text" : "This is a node title."
        },
        "header_media" : {
          "owner" : "John Doe",
          "entity_type" : "media",
          "file" : {
            "alt" : "image alt text",
            "url" : "https://example.com/example_image.jpg"
          },
          "media_type" : "image",
          "description" : "Image description",
          "id" : 0,
          "source" : {
            "link_type" : "external",
            "url_text" : "Link",
            "link_text" : "Press to go to website",
            "url" : "https://example.com"
          },
          "type" : "image"
        }
      }
    } ],
    "name" : "Health"
  }, {
    "boxes" : [ {
      "entity_type" : "box",
      "box_type" : "content_box",
      "id" : 0,
      "content" : {
        "summary" : "In the video series 'ChatGPT - briefly explained', Aljoscha Burchardt from the German Research Center for Artificial Intelligence (DFKI) explains the technology behind the AI chatbot and discusses its influence on various aspects of our lives.",
        "entity_type" : "node",
        "node_type" : "content_page",
        "id" : 42,
        "title" : {
          "text" : "This is a node title."
        },
        "header_media" : {
          "owner" : "John Doe",
          "entity_type" : "media",
          "file" : {
            "alt" : "image alt text",
            "url" : "https://example.com/example_image.jpg"
          },
          "media_type" : "image",
          "description" : "Image description",
          "id" : 0,
          "source" : {
            "link_type" : "external",
            "url_text" : "Link",
            "link_text" : "Press to go to website",
            "url" : "https://example.com"
          },
          "type" : "image"
        }
      }
    }, {
      "entity_type" : "box",
      "box_type" : "content_box",
      "id" : 0,
      "content" : {
        "summary" : "In the video series 'ChatGPT - briefly explained', Aljoscha Burchardt from the German Research Center for Artificial Intelligence (DFKI) explains the technology behind the AI chatbot and discusses its influence on various aspects of our lives.",
        "entity_type" : "node",
        "node_type" : "content_page",
        "id" : 42,
        "title" : {
          "text" : "This is a node title."
        },
        "header_media" : {
          "owner" : "John Doe",
          "entity_type" : "media",
          "file" : {
            "alt" : "image alt text",
            "url" : "https://example.com/example_image.jpg"
          },
          "media_type" : "image",
          "description" : "Image description",
          "id" : 0,
          "source" : {
            "link_type" : "external",
            "url_text" : "Link",
            "link_text" : "Press to go to website",
            "url" : "https://example.com"
          },
          "type" : "image"
        }
      }
    } ],
    "name" : "Health"
  } ],
  "page_description" : "Company overview page"
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Return box page content. _box_pages__page_name__get_200_response

400

Invalid box page view mode.

404

The requested box page does not exist.

Up
get /document_search
Document Search site content. (documentSearchGet)

Query parameters

search_api_fulltext (optional)
Query Parameter — The search term. If an empty string is provided or the query parameter is not added to the request, the whole website content will be seen as valid search results. default: null
sort_by (optional)
Query Parameter — Sort search results by relevance or publishing date. default: null
page (optional)
Query Parameter — Pager for search results. default: null
f (optional)
Query Parameter — Facets filters. When facets should be used to filter the search results, they have to be added as array items of this query parameter: a facet will filter should have the form f[INDEX]=FACET_ID:VALUE where INDEX is an index number for the filters array (starting from zero). For example, to search users that live in Berlin (ID = 45), the facets "type" and "location" have to be added to the array in the following manner: /search?f[0]=type:user&f[1]=location:45. The order of filters in the array has no effect. default: null

Return type

DocumentSearch

Example data

Content-Type: application/json
{
  "sub_facets" : {
    "facet_id" : "location",
    "label" : "Location",
    "items" : [ {
      "item_id" : 45,
      "count" : 10,
      "label" : "Berlin"
    }, {
      "item_id" : 45,
      "count" : 10,
      "label" : "Berlin"
    } ]
  },
  "search_results" : [ {
    "summary" : "summary",
    "last_updated" : "09.09.2025",
    "documents" : "https://example.com/example_file.pdf",
    "title" : {
      "is_link" : true,
      "text" : "text"
    },
    "tags" : {
      "label" : "Tags",
      "value" : [ "value", "value" ]
    },
    "entity_type" : "node",
    "node_type" : "document",
    "topic" : {
      "label" : "Topic",
      "value" : [ "value", "value" ]
    },
    "links" : {
      "link_type" : "external",
      "link_text" : "Demodokument",
      "url" : "https://example.com"
    },
    "location" : {
      "label" : "Location",
      "value" : [ "value", "value" ]
    },
    "id" : 0,
    "excerpt" : "",
    "organizational_unit" : {
      "label" : "Organizational Unit",
      "value" : [ "value", "value" ]
    },
    "document_type" : "document_type"
  }, {
    "summary" : "summary",
    "last_updated" : "09.09.2025",
    "documents" : "https://example.com/example_file.pdf",
    "title" : {
      "is_link" : true,
      "text" : "text"
    },
    "tags" : {
      "label" : "Tags",
      "value" : [ "value", "value" ]
    },
    "entity_type" : "node",
    "node_type" : "document",
    "topic" : {
      "label" : "Topic",
      "value" : [ "value", "value" ]
    },
    "links" : {
      "link_type" : "external",
      "link_text" : "Demodokument",
      "url" : "https://example.com"
    },
    "location" : {
      "label" : "Location",
      "value" : [ "value", "value" ]
    },
    "id" : 0,
    "excerpt" : "",
    "organizational_unit" : {
      "label" : "Organizational Unit",
      "value" : [ "value", "value" ]
    },
    "document_type" : "document_type"
  } ]
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Return search results. DocumentSearch

400

A query parameter is invalid.

Up
get /employee_directory/employees
Get the employees. (employeeDirectoryEmployeesGet)

Query parameters

page (optional)
Query Parameter — The page. default: null
search (optional)
Query Parameter — Seach term. default: null
fetch_mode (optional)
Query Parameter — Possible are 'favorites' or 'all'. default: null
hierarchical_sort (optional)
Query Parameter — Sort priorized by field name. default: null
sort_by (optional)
Query Parameter — Sort order, possible values are 'firstname', 'lastname' and 'hierarchy'. default: null
sort_dir (optional)
Query Parameter — ASC or DESC. default: null

Return type

array[Employees]

Example data

Content-Type: application/json
[ {
  "uid" : 1,
  "mail" : "someone@example.com",
  "flagged" : true,
  "name" : "Clara",
  "picture" : {
    "alt" : "image alt text",
    "url" : "https://example.com/example_image.jpg"
  }
}, {
  "uid" : 1,
  "mail" : "someone@example.com",
  "flagged" : true,
  "name" : "Clara",
  "picture" : {
    "alt" : "image alt text",
    "url" : "https://example.com/example_image.jpg"
  }
} ]

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Return notifications.

Up
get /employee_jubilees
Get employee jubilees overview page content. (employeeJubileesGet)
Get a list of current employee jubilees.

Query parameters

page (optional)
Query Parameter — Pager for the content. default: null
organizational_unit (optional)
Query Parameter — The person's organizational unit. default: null

Return type

_employee_jubilees_get_200_response

Example data

Content-Type: application/json
{
  "employee_jubilees" : ""
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Return employee jubilees list. _employee_jubilees_get_200_response

400

Invalid page value.

Up
post /event/bookmark
Toggle bookmark state for an event. (eventBookmarkPost)
Adds or removes a bookmark for the authenticated user on the specified event.

Consumes

This API call consumes the following media types via the Content-Type request header:

Request body

Event-Bookmark-Request Event-Bookmark-Request (required)
Body Parameter

Return type

Event-Bookmark-Response

Example data

Content-Type: application/json
{
  "success" : true,
  "is_bookmarked" : true,
  "message" : "Event bookmarked successfully."
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Bookmark toggled successfully. Event-Bookmark-Response

400

Missing or invalid request data.

403

Authentication required.

404

Event not found.

Up
delete /event/{nid}/registrations
Delete a registration for a user. (eventNidRegistrationsDelete)
Removes a registration for the specified user on an event. A user can remove their own registration; elevated permissions allow removing other users.

Path parameters

nid (required)
Path Parameter — Event node ID. default: null

Query parameters

uid (required)
Query Parameter — User ID whose registration should be removed. default: null

Return type

Event-Registration-Delete-Response

Example data

Content-Type: application/json
{
  "success" : true
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Registration removed successfully. Event-Registration-Delete-Response

400

Missing or invalid user ID.

403

Access denied. The current user cannot remove this registration.

404

Event not found or registration does not exist.

Up
get /event/{nid}/registrations/download
Download event registrations as CSV. (eventNidRegistrationsDownloadGet)
Exports participant registrations for an event as a CSV file.

Path parameters

nid (required)
Path Parameter — Event node ID. default: null

Return type

File

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

CSV export generated successfully. File

403

Access denied. The current user cannot download registrations for this event.

404

Event not found.

Up
get /event/{nid}/registrations
Get registrations for an event. (eventNidRegistrationsGet)
Returns participant registrations for a specific event, including requester capabilities for download and deletion.

Path parameters

nid (required)
Path Parameter — Event node ID. default: null

Return type

Event-Registrations-Response

Example data

Content-Type: application/json
{
  "total" : 12,
  "registrations" : [ {
    "uid" : 27,
    "registeredAtTimestamp" : 1777289100,
    "note" : "Will arrive 10 minutes early.",
    "thumbnail" : {
      "key" : ""
    },
    "flaggingId" : 145,
    "name" : "Jane Doe",
    "registeredAt" : "27.04.2026 - 10:45",
    "email" : "jane.doe@example.com"
  }, {
    "uid" : 27,
    "registeredAtTimestamp" : 1777289100,
    "note" : "Will arrive 10 minutes early.",
    "thumbnail" : {
      "key" : ""
    },
    "flaggingId" : 145,
    "name" : "Jane Doe",
    "registeredAt" : "27.04.2026 - 10:45",
    "email" : "jane.doe@example.com"
  } ],
  "canDownload" : true,
  "canDelete" : true
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Successful operation. Event-Registrations-Response

403

Access denied. The user cannot view registrations for this event.

404

Event not found.

Up
post /event/{nid}/registrations
Register current user for an event. (eventNidRegistrationsPost)
Creates a registration for the authenticated user, optionally including a note.

Path parameters

nid (required)
Path Parameter — Event node ID. default: null

Consumes

This API call consumes the following media types via the Content-Type request header:

Request body

Event-Registration-Create-Request Event-Registration-Create-Request (optional)
Body Parameter

Return type

Event-Registration-Upsert-Response

Example data

Content-Type: application/json
{
  "alreadyRegistered" : true,
  "flaggingId" : 145
}

Example data

Content-Type: application/json
{
  "alreadyRegistered" : true,
  "flaggingId" : 145
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

The user is already registered for this event. Event-Registration-Upsert-Response

201

Registration created successfully. Event-Registration-Upsert-Response

400

Bad request (for example registration disabled or event full).

403

Access denied. Authentication and permission checks failed.

404

Event not found or registration flag configuration missing.

Up
get /event/{type}
Get event data by type. (eventTypeGet)

Returns event data based on the type path parameter. Supports retrieving events (all or user-specific), event types, event categories, event settings, and calendar events.

Path parameters

type (required)
Path Parameter — The type of event data to retrieve. default: null

Query parameters

filter (optional)
Query Parameter — Filter events by status. Only applies to all and my types. default: overview
event_type (optional)
Query Parameter — Filter by event type term ID. Pass all or omit for no filter. Applies to all, my, and calendar types. default: null
event_category (optional)
Query Parameter — Filter by event category term ID. Pass all or omit for no filter. Applies to all, my, and calendar types. default: null
ongoing_offset (optional)
Query Parameter — Pagination offset for ongoing events. Only applies to all and my types. default: 0
upcoming_offset (optional)
Query Parameter — Pagination offset for upcoming events. Only applies to all and my types. default: 0
past_offset (optional)
Query Parameter — Pagination offset for past events. Only applies to all and my types. default: 0
year (optional)
Query Parameter — The year for calendar view. Required when type is calendar. Must be between 2025 and 2100. default: null
month (optional)
Query Parameter — The month for calendar view. Required when type is calendar. Must be between 1 and 12. default: null
bookmarked_only (optional)
Query Parameter — When true, only returns bookmarked events for the current user. Only applies to calendar type. default: false

Return type

_event__type__get_200_response

Example data

Content-Type: application/json
{
  "grouped" : true,
  "ongoing" : {
    "total" : 0,
    "offset" : 0,
    "limit" : 8,
    "has_more" : true,
    "events" : [ {
      "end_date" : "2000-01-23T04:56:07.000+00:00",
      "summary" : "Join us for the annual company summit...",
      "formatted_date_time" : "Monday, 15. June 2026, 09:00 - 17:00",
      "image_url" : "/sites/default/files/styles/boxes_16_9/public/event.jpg",
      "registration_status" : "registered",
      "title" : "Annual Company Summit",
      "event_category" : {
        "label" : "Sports",
        "tid" : 7
      },
      "url" : "/en/events/annual-company-summit",
      "event_type" : "Conference",
      "is_bookmarked" : true,
      "location" : [ "Berlin", "Munich" ],
      "is_all_day" : true,
      "id" : 42,
      "start_date" : "2000-01-23T04:56:07.000+00:00",
      "date_parts" : {
        "is_range" : true,
        "start" : {
          "month" : "Jun",
          "day" : "15"
        },
        "end" : {
          "month" : "Jun",
          "day" : "15"
        }
      }
    }, {
      "end_date" : "2000-01-23T04:56:07.000+00:00",
      "summary" : "Join us for the annual company summit...",
      "formatted_date_time" : "Monday, 15. June 2026, 09:00 - 17:00",
      "image_url" : "/sites/default/files/styles/boxes_16_9/public/event.jpg",
      "registration_status" : "registered",
      "title" : "Annual Company Summit",
      "event_category" : {
        "label" : "Sports",
        "tid" : 7
      },
      "url" : "/en/events/annual-company-summit",
      "event_type" : "Conference",
      "is_bookmarked" : true,
      "location" : [ "Berlin", "Munich" ],
      "is_all_day" : true,
      "id" : 42,
      "start_date" : "2000-01-23T04:56:07.000+00:00",
      "date_parts" : {
        "is_range" : true,
        "start" : {
          "month" : "Jun",
          "day" : "15"
        },
        "end" : {
          "month" : "Jun",
          "day" : "15"
        }
      }
    } ]
  },
  "past" : {
    "total" : 0,
    "offset" : 0,
    "limit" : 8,
    "has_more" : true,
    "events" : [ {
      "end_date" : "2000-01-23T04:56:07.000+00:00",
      "summary" : "Join us for the annual company summit...",
      "formatted_date_time" : "Monday, 15. June 2026, 09:00 - 17:00",
      "image_url" : "/sites/default/files/styles/boxes_16_9/public/event.jpg",
      "registration_status" : "registered",
      "title" : "Annual Company Summit",
      "event_category" : {
        "label" : "Sports",
        "tid" : 7
      },
      "url" : "/en/events/annual-company-summit",
      "event_type" : "Conference",
      "is_bookmarked" : true,
      "location" : [ "Berlin", "Munich" ],
      "is_all_day" : true,
      "id" : 42,
      "start_date" : "2000-01-23T04:56:07.000+00:00",
      "date_parts" : {
        "is_range" : true,
        "start" : {
          "month" : "Jun",
          "day" : "15"
        },
        "end" : {
          "month" : "Jun",
          "day" : "15"
        }
      }
    }, {
      "end_date" : "2000-01-23T04:56:07.000+00:00",
      "summary" : "Join us for the annual company summit...",
      "formatted_date_time" : "Monday, 15. June 2026, 09:00 - 17:00",
      "image_url" : "/sites/default/files/styles/boxes_16_9/public/event.jpg",
      "registration_status" : "registered",
      "title" : "Annual Company Summit",
      "event_category" : {
        "label" : "Sports",
        "tid" : 7
      },
      "url" : "/en/events/annual-company-summit",
      "event_type" : "Conference",
      "is_bookmarked" : true,
      "location" : [ "Berlin", "Munich" ],
      "is_all_day" : true,
      "id" : 42,
      "start_date" : "2000-01-23T04:56:07.000+00:00",
      "date_parts" : {
        "is_range" : true,
        "start" : {
          "month" : "Jun",
          "day" : "15"
        },
        "end" : {
          "month" : "Jun",
          "day" : "15"
        }
      }
    } ]
  },
  "upcoming" : {
    "total" : 0,
    "offset" : 0,
    "limit" : 8,
    "has_more" : true,
    "events" : [ {
      "end_date" : "2000-01-23T04:56:07.000+00:00",
      "summary" : "Join us for the annual company summit...",
      "formatted_date_time" : "Monday, 15. June 2026, 09:00 - 17:00",
      "image_url" : "/sites/default/files/styles/boxes_16_9/public/event.jpg",
      "registration_status" : "registered",
      "title" : "Annual Company Summit",
      "event_category" : {
        "label" : "Sports",
        "tid" : 7
      },
      "url" : "/en/events/annual-company-summit",
      "event_type" : "Conference",
      "is_bookmarked" : true,
      "location" : [ "Berlin", "Munich" ],
      "is_all_day" : true,
      "id" : 42,
      "start_date" : "2000-01-23T04:56:07.000+00:00",
      "date_parts" : {
        "is_range" : true,
        "start" : {
          "month" : "Jun",
          "day" : "15"
        },
        "end" : {
          "month" : "Jun",
          "day" : "15"
        }
      }
    }, {
      "end_date" : "2000-01-23T04:56:07.000+00:00",
      "summary" : "Join us for the annual company summit...",
      "formatted_date_time" : "Monday, 15. June 2026, 09:00 - 17:00",
      "image_url" : "/sites/default/files/styles/boxes_16_9/public/event.jpg",
      "registration_status" : "registered",
      "title" : "Annual Company Summit",
      "event_category" : {
        "label" : "Sports",
        "tid" : 7
      },
      "url" : "/en/events/annual-company-summit",
      "event_type" : "Conference",
      "is_bookmarked" : true,
      "location" : [ "Berlin", "Munich" ],
      "is_all_day" : true,
      "id" : 42,
      "start_date" : "2000-01-23T04:56:07.000+00:00",
      "date_parts" : {
        "is_range" : true,
        "start" : {
          "month" : "Jun",
          "day" : "15"
        },
        "end" : {
          "month" : "Jun",
          "day" : "15"
        }
      }
    } ]
  }
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Event data for the requested type. The response shape depends on type and filter:

_event__type__get_200_response

400

Invalid parameter value. Possible causes:

403

Access denied. The current user lacks the access content permission.

Up
get /events
Get a events page content. (eventsGet)
Sends current and upcoming events.

Query parameters

page (optional)
Query Parameter — News page name. default: null

Return type

Events-Page

Example data

Content-Type: application/json
{
  "ongoing" : [ {
    "summary" : "Digital Workplace bedeutet mehr, als nur Technologie ...",
    "event_date_month" : "Apr.",
    "entity_type" : "node",
    "node_type" : "event",
    "event_start_date_full" : "Dienstag, 30. April 2024 - 00:00",
    "id" : 42,
    "title" : {
      "text" : "This is a node title."
    },
    "event_date_day" : "09",
    "header_media" : {
      "owner" : "John Doe",
      "entity_type" : "media",
      "file" : {
        "alt" : "image alt text",
        "url" : "https://example.com/example_image.jpg"
      },
      "media_type" : "image",
      "description" : "Image description",
      "id" : 0,
      "source" : {
        "link_type" : "external",
        "url_text" : "Link",
        "link_text" : "Press to go to website",
        "url" : "https://example.com"
      },
      "type" : "image"
    },
    "kicker" : "Dachzeile"
  }, {
    "summary" : "Digital Workplace bedeutet mehr, als nur Technologie ...",
    "event_date_month" : "Apr.",
    "entity_type" : "node",
    "node_type" : "event",
    "event_start_date_full" : "Dienstag, 30. April 2024 - 00:00",
    "id" : 42,
    "title" : {
      "text" : "This is a node title."
    },
    "event_date_day" : "09",
    "header_media" : {
      "owner" : "John Doe",
      "entity_type" : "media",
      "file" : {
        "alt" : "image alt text",
        "url" : "https://example.com/example_image.jpg"
      },
      "media_type" : "image",
      "description" : "Image description",
      "id" : 0,
      "source" : {
        "link_type" : "external",
        "url_text" : "Link",
        "link_text" : "Press to go to website",
        "url" : "https://example.com"
      },
      "type" : "image"
    },
    "kicker" : "Dachzeile"
  } ],
  "expired" : [ {
    "summary" : "Digital Workplace bedeutet mehr, als nur Technologie ...",
    "event_date_month" : "Apr.",
    "entity_type" : "node",
    "node_type" : "event",
    "event_start_date_full" : "Dienstag, 30. April 2024 - 00:00",
    "id" : 42,
    "title" : {
      "text" : "This is a node title."
    },
    "event_date_day" : "09",
    "header_media" : {
      "owner" : "John Doe",
      "entity_type" : "media",
      "file" : {
        "alt" : "image alt text",
        "url" : "https://example.com/example_image.jpg"
      },
      "media_type" : "image",
      "description" : "Image description",
      "id" : 0,
      "source" : {
        "link_type" : "external",
        "url_text" : "Link",
        "link_text" : "Press to go to website",
        "url" : "https://example.com"
      },
      "type" : "image"
    },
    "kicker" : "Dachzeile"
  }, {
    "summary" : "Digital Workplace bedeutet mehr, als nur Technologie ...",
    "event_date_month" : "Apr.",
    "entity_type" : "node",
    "node_type" : "event",
    "event_start_date_full" : "Dienstag, 30. April 2024 - 00:00",
    "id" : 42,
    "title" : {
      "text" : "This is a node title."
    },
    "event_date_day" : "09",
    "header_media" : {
      "owner" : "John Doe",
      "entity_type" : "media",
      "file" : {
        "alt" : "image alt text",
        "url" : "https://example.com/example_image.jpg"
      },
      "media_type" : "image",
      "description" : "Image description",
      "id" : 0,
      "source" : {
        "link_type" : "external",
        "url_text" : "Link",
        "link_text" : "Press to go to website",
        "url" : "https://example.com"
      },
      "type" : "image"
    },
    "kicker" : "Dachzeile"
  } ],
  "description" : "You can find all events on this event overview page",
  "title" : "Events",
  "upcoming" : [ {
    "summary" : "Digital Workplace bedeutet mehr, als nur Technologie ...",
    "event_date_month" : "Apr.",
    "entity_type" : "node",
    "node_type" : "event",
    "event_start_date_full" : "Dienstag, 30. April 2024 - 00:00",
    "id" : 42,
    "title" : {
      "text" : "This is a node title."
    },
    "event_date_day" : "09",
    "header_media" : {
      "owner" : "John Doe",
      "entity_type" : "media",
      "file" : {
        "alt" : "image alt text",
        "url" : "https://example.com/example_image.jpg"
      },
      "media_type" : "image",
      "description" : "Image description",
      "id" : 0,
      "source" : {
        "link_type" : "external",
        "url_text" : "Link",
        "link_text" : "Press to go to website",
        "url" : "https://example.com"
      },
      "type" : "image"
    },
    "kicker" : "Dachzeile"
  }, {
    "summary" : "Digital Workplace bedeutet mehr, als nur Technologie ...",
    "event_date_month" : "Apr.",
    "entity_type" : "node",
    "node_type" : "event",
    "event_start_date_full" : "Dienstag, 30. April 2024 - 00:00",
    "id" : 42,
    "title" : {
      "text" : "This is a node title."
    },
    "event_date_day" : "09",
    "header_media" : {
      "owner" : "John Doe",
      "entity_type" : "media",
      "file" : {
        "alt" : "image alt text",
        "url" : "https://example.com/example_image.jpg"
      },
      "media_type" : "image",
      "description" : "Image description",
      "id" : 0,
      "source" : {
        "link_type" : "external",
        "url_text" : "Link",
        "link_text" : "Press to go to website",
        "url" : "https://example.com"
      },
      "type" : "image"
    },
    "kicker" : "Dachzeile"
  } ]
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Return news page content. Events-Page

400

Invalid page value.

404

The requested events overview page does not exist.

Up
get /magazine_topic/{topic}
Get a topic overview page content. (magazineTopicTopicGet)
Displays a list of content that are related to one of the magazine topics.

Path parameters

topic (required)
Path Parameter — Topic name. default: null

Return type

_magazine_topic__topic__get_200_response

Example data

Content-Type: application/json
{
  "articles" : [ {
    "summary" : "In the video series 'ChatGPT - briefly explained', Aljoscha Burchardt from the German Research Center for Artificial Intelligence (DFKI) explains the technology behind the AI chatbot and discusses its influence on various aspects of our lives.",
    "entity_type" : "node",
    "node_type" : "article",
    "magazine_channel" : "Marketing",
    "id" : 42,
    "title" : {
      "text" : "This is a node title."
    },
    "header_media" : {
      "owner" : "John Doe",
      "entity_type" : "media",
      "file" : {
        "alt" : "image alt text",
        "url" : "https://example.com/example_image.jpg"
      },
      "media_type" : "image",
      "description" : "Image description",
      "id" : 0,
      "source" : {
        "link_type" : "external",
        "url_text" : "Link",
        "link_text" : "Press to go to website",
        "url" : "https://example.com"
      },
      "type" : "image"
    }
  }, {
    "summary" : "In the video series 'ChatGPT - briefly explained', Aljoscha Burchardt from the German Research Center for Artificial Intelligence (DFKI) explains the technology behind the AI chatbot and discusses its influence on various aspects of our lives.",
    "entity_type" : "node",
    "node_type" : "article",
    "magazine_channel" : "Marketing",
    "id" : 42,
    "title" : {
      "text" : "This is a node title."
    },
    "header_media" : {
      "owner" : "John Doe",
      "entity_type" : "media",
      "file" : {
        "alt" : "image alt text",
        "url" : "https://example.com/example_image.jpg"
      },
      "media_type" : "image",
      "description" : "Image description",
      "id" : 0,
      "source" : {
        "link_type" : "external",
        "url_text" : "Link",
        "link_text" : "Press to go to website",
        "url" : "https://example.com"
      },
      "type" : "image"
    }
  } ]
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Return topic overview page content. _magazine_topic__topic__get_200_response

404

The requested topic overview page does not exist.

Up
get /new_colleagues
Get new colleagues overview page content. (newColleaguesGet)
Get a list of new colleagues.

Query parameters

page (optional)
Query Parameter — Pager for the content. default: null

Return type

_new_colleagues_get_200_response

Example data

Content-Type: application/json
{
  "new_colleagues" : [ {
    "entity_type" : "user",
    "user_type" : "user",
    "user_picture" : {
      "alt" : "image alt text",
      "url" : "https://example.com/example_image.jpg"
    },
    "name" : "John Doe",
    "location" : "Berlin",
    "id" : 0,
    "department" : "HR",
    "organizational_unit" : "Marketing",
    "employed_since" : "01.01.1970"
  }, {
    "entity_type" : "user",
    "user_type" : "user",
    "user_picture" : {
      "alt" : "image alt text",
      "url" : "https://example.com/example_image.jpg"
    },
    "name" : "John Doe",
    "location" : "Berlin",
    "id" : 0,
    "department" : "HR",
    "organizational_unit" : "Marketing",
    "employed_since" : "01.01.1970"
  } ]
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Return new colleagues list. _new_colleagues_get_200_response

400

Invalid page value.

Up
get /news_menu
Get news menu. (newsMenuGet)
There are 4 standard news pages: [news, corporate_news, my_news, mandatory_news].

Return type

array[News-Menu-Item]

Example data

Content-Type: application/json
[ {
  "label" : "All News",
  "id" : "news"
}, {
  "label" : "All News",
  "id" : "news"
} ]

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Return news menu.

Up
get /news/{news_page}
Get a news page content. (newsNewsPageGet)
There are 4 standard news pages: [news, corporate_news, my_news, mandatory_news].

Path parameters

news_page (required)
Path Parameter — News page name. default: null

Query parameters

news_channel (optional)
Query Parameter — Filter the news channel based on the news channel identifier. default: null
page (optional)
Query Parameter — Pager for the content. default: null

Return type

News-Page

Example data

Content-Type: application/json
{
  "news" : [ {
    "summary" : "Digital Workplace bedeutet mehr, als nur Technologie ...",
    "entity_type" : "node",
    "node_type" : "content_page",
    "corporate_news_channel" : "corporate_news_channel",
    "id" : 42,
    "news_channel" : "news_channel",
    "title" : {
      "text" : "This is a node title."
    },
    "published_at" : "04.09.2023",
    "header_media" : {
      "owner" : "John Doe",
      "entity_type" : "media",
      "file" : {
        "alt" : "image alt text",
        "url" : "https://example.com/example_image.jpg"
      },
      "media_type" : "image",
      "description" : "Image description",
      "id" : 0,
      "source" : {
        "link_type" : "external",
        "url_text" : "Link",
        "link_text" : "Press to go to website",
        "url" : "https://example.com"
      },
      "type" : "image"
    }
  }, {
    "summary" : "Digital Workplace bedeutet mehr, als nur Technologie ...",
    "entity_type" : "node",
    "node_type" : "content_page",
    "corporate_news_channel" : "corporate_news_channel",
    "id" : 42,
    "news_channel" : "news_channel",
    "title" : {
      "text" : "This is a node title."
    },
    "published_at" : "04.09.2023",
    "header_media" : {
      "owner" : "John Doe",
      "entity_type" : "media",
      "file" : {
        "alt" : "image alt text",
        "url" : "https://example.com/example_image.jpg"
      },
      "media_type" : "image",
      "description" : "Image description",
      "id" : 0,
      "source" : {
        "link_type" : "external",
        "url_text" : "Link",
        "link_text" : "Press to go to website",
        "url" : "https://example.com"
      },
      "type" : "image"
    }
  } ],
  "news_channel_filter" : [ {
    "name" : "Marketing",
    "id" : 0
  }, {
    "name" : "Marketing",
    "id" : 0
  } ]
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Return news page content. News-Page

400

Invalid page or news channel value.

404

The requested news overview page does not exist.

Up
get /piipe_picture_gallery
Get picture gallery posts (piipePictureGalleryGet)
Returns a paginated list of picture gallery posts.

Query parameters

page (optional)
Query Parameter — The page number for pagination (0-based). default: null
filters[tags] (optional)
Query Parameter — Filter posts by tag IDs (comma-separated). default: null
filters[author] (optional)
Query Parameter — Filter posts by author user ID. default: null
sort_by (optional)
Query Parameter — Sort posts by field. Allowed values: created, popularity. default: null
sort_dir (optional)
Query Parameter — Sort direction. Allowed values: ASC, DESC. default: null

Return type

array[Picture-Gallery-Post]

Example data

Content-Type: application/json
[ {
  "date" : "1739461059",
  "flag" : {
    "like_count" : "2",
    "rock_flagged" : false,
    "rock_count" : "1",
    "heart_count" : "2",
    "heart_flagged" : true,
    "like_flagged" : true
  },
  "hashtags" : [ {
    "name" : "relatable",
    "id" : "496"
  }, {
    "name" : "relatable",
    "id" : "496"
  } ],
  "author" : {
    "langcode" : "Germany",
    "name" : "John Doe",
    "picture" : {
      "alt" : "Profile picture for user John Doe",
      "url" : "/system/files/styles/thumbnail/private/medialibrary/profile_image.jpg?h=cc71e594&itok=yAsmmMts"
    }
  },
  "permissions" : {
    "edit" : true,
    "delete" : true
  },
  "description" : "This is a description text.",
  "id" : "1",
  "title" : "This is a post title",
  "url" : "/system/files/styles/picture_gallery/private/picture_gallery/pexels-diiefao-2258357.jpg?itok=LVC9QA64"
}, {
  "date" : "1739461059",
  "flag" : {
    "like_count" : "2",
    "rock_flagged" : false,
    "rock_count" : "1",
    "heart_count" : "2",
    "heart_flagged" : true,
    "like_flagged" : true
  },
  "hashtags" : [ {
    "name" : "relatable",
    "id" : "496"
  }, {
    "name" : "relatable",
    "id" : "496"
  } ],
  "author" : {
    "langcode" : "Germany",
    "name" : "John Doe",
    "picture" : {
      "alt" : "Profile picture for user John Doe",
      "url" : "/system/files/styles/thumbnail/private/medialibrary/profile_image.jpg?h=cc71e594&itok=yAsmmMts"
    }
  },
  "permissions" : {
    "edit" : true,
    "delete" : true
  },
  "description" : "This is a description text.",
  "id" : "1",
  "title" : "This is a post title",
  "url" : "/system/files/styles/picture_gallery/private/picture_gallery/pexels-diiefao-2258357.jpg?itok=LVC9QA64"
} ]

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

A list of picture gallery posts.

400

Invalid request parameters.

403

Access denied.

Up
patch /piipe_picture_gallery
Edit or delete a gallery post (piipePictureGalleryPatch)

To flag a gallery post, make a POST request to /piipe_flags/flag and pass the following parameters to the body:

{
  "flag_id": "gallery_post_FLAG",
  "entity_type": "gallery_post",
  "entity_id": "ID",
  "action": "flag"
}

where FLAG is one of [like, rock, heart] and ID is the gallery post ID.

Consumes

This API call consumes the following media types via the Content-Type request header:

Request body

_piipe_picture_gallery_patch_request _piipe_picture_gallery_patch_request (required)
Body Parameter

Return type

_piipe_picture_gallery_patch_200_response

Example data

Content-Type: application/json
{
  "is_last" : true
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Edit or delete result _piipe_picture_gallery_patch_200_response

Up
get /room_search
Room Search site content. (roomSearchGet)

Query parameters

search_api_fulltext (optional)
Query Parameter — The search term. If an empty string is provided or the query parameter is not added to the request, the whole website content will be seen as valid search results. default: null
f (optional)
Query Parameter — Facets filters. When facets should be used to filter the search results, they have to be added as array items of this query parameter: a facet will filter should have the form f[INDEX]=FACET_ID:VALUE where INDEX is an index number for the filters array (starting from zero). For example, to search users that live in Berlin (ID = 45), the facets "type" and "location" have to be added to the array in the following manner: /search?f[0]=type:user&f[1]=location:45. The order of filters in the array has no effect. default: null

Return type

RoomSearch

Example data

Content-Type: application/json
{
  "sub_facets" : {
    "facet_id" : "location",
    "label" : "Location",
    "items" : [ {
      "item_id" : 45,
      "count" : 10,
      "label" : "Berlin"
    }, {
      "item_id" : 45,
      "count" : 10,
      "label" : "Berlin"
    } ]
  },
  "search_results" : [ {
    "last_updated" : "2000-01-23",
    "entity_type" : "node",
    "node_type" : "room",
    "location" : [ {
      "id" : "277",
      "text" : "Paris"
    }, {
      "id" : "277",
      "text" : "Paris"
    } ],
    "id" : "1788",
    "title" : {
      "is_link" : true,
      "text" : "Search: Room"
    },
    "excerpt" : "",
    "number_of_seats" : {
      "label" : "Seats",
      "value" : 4
    },
    "header_media" : {
      "owner" : "John Doe",
      "entity_type" : "media",
      "file" : {
        "alt" : "image alt text",
        "url" : "https://example.com/example_image.jpg"
      },
      "media_type" : "image",
      "description" : "Image description",
      "id" : 0,
      "source" : {
        "link_type" : "external",
        "url_text" : "Link",
        "link_text" : "Press to go to website",
        "url" : "https://example.com"
      },
      "type" : "image"
    }
  }, {
    "last_updated" : "2000-01-23",
    "entity_type" : "node",
    "node_type" : "room",
    "location" : [ {
      "id" : "277",
      "text" : "Paris"
    }, {
      "id" : "277",
      "text" : "Paris"
    } ],
    "id" : "1788",
    "title" : {
      "is_link" : true,
      "text" : "Search: Room"
    },
    "excerpt" : "",
    "number_of_seats" : {
      "label" : "Seats",
      "value" : 4
    },
    "header_media" : {
      "owner" : "John Doe",
      "entity_type" : "media",
      "file" : {
        "alt" : "image alt text",
        "url" : "https://example.com/example_image.jpg"
      },
      "media_type" : "image",
      "description" : "Image description",
      "id" : 0,
      "source" : {
        "link_type" : "external",
        "url_text" : "Link",
        "link_text" : "Press to go to website",
        "url" : "https://example.com"
      },
      "type" : "image"
    }
  } ]
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Return search results. RoomSearch

400

A query parameter is invalid.

Up
get /search
Search site content. (searchGet)
Search for content that contains a specific term, and filter and sort the search results. The query parameters defined in this endpoint are exactly the same as the ones used in the search page on the web (/search/content), so if you make a search on the web and copy the all query parameters and use them in this endpoint, you should get the exact same search results.

Query parameters

keys (optional)
Query Parameter — The search term. If an empty string is provided or the query parameter is not added to the request, the whole website content will be seen as valid search results. default: null
field_archive (optional)
Query Parameter — Filter archived content. [1 for normal content, 2 for archived content] default: null
sort_by (optional)
Query Parameter — Sort search results by relevance or publishing date. default: null
page (optional)
Query Parameter — Pager for search results. default: null
f (optional)
Query Parameter — Facets filters. When facets should be used to filter the search results, they have to be added as array items of this query parameter: a facet will filter should have the form f[INDEX]=FACET_ID:VALUE where INDEX is an index number for the filters array (starting from zero). For example, to search users that live in Berlin (ID = 45), the facets "type" and "location" have to be added to the array in the following manner: /search?f[0]=type:user&f[1]=location:45. The order of filters in the array has no effect. default: null

Return type

Search

Example data

Content-Type: application/json
{
  "sub_facets" : {
    "facet_id" : "location",
    "label" : "Location",
    "items" : [ {
      "item_id" : 45,
      "count" : 10,
      "label" : "Berlin"
    }, {
      "item_id" : 45,
      "count" : 10,
      "label" : "Berlin"
    } ]
  },
  "main_facet" : {
    "facet_id" : "type",
    "label" : "Type",
    "items" : [ {
      "label" : "Content",
      "item_id" : "node",
      "count" : 10
    } ]
  },
  "search_results" : [ {
    "node_type" : "content_page",
    "entity_type" : "node",
    "node_type_label" : "Content Page",
    "id" : 0,
    "excerpt" : "… some random text … *(here the word \"random\" was searched)*",
    "title" : "This is a node title.",
    "published_at" : "31.01.2025"
  }, {
    "node_type" : "content_page",
    "entity_type" : "node",
    "node_type_label" : "Content Page",
    "id" : 0,
    "excerpt" : "… some random text … *(here the word \"random\" was searched)*",
    "title" : "This is a node title.",
    "published_at" : "31.01.2025"
  } ],
  "result_count" : 100
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Return search results. Search

400

A query parameter is invalid.

Up
get /tags/{page}
Tags page content. (tagsPageGet)

Path parameters

page (required)
Path Parameter — The requested overview page. default: null

Query parameters

search_api_fulltext (optional)
Query Parameter — The search term. If an empty string is provided or the query parameter is not added to the request, all tags will be seen as valid search results. default: null
search_api_fulltext_1 (optional)
Query Parameter — Sort search results. [1: Most Used Tags, 2: Recent Tags, 3: Alphabetically Sorted] default: null

Return type

_tags__page__get_200_response

Example data

Content-Type: application/json
{
  "tags" : [ {
    "entity_type" : "taxonomy_term",
    "name" : "Neocosmo",
    "id" : 42,
    "taxonomy_term_type" : "news_channel"
  }, {
    "entity_type" : "taxonomy_term",
    "name" : "Neocosmo",
    "id" : 42,
    "taxonomy_term_type" : "news_channel"
  } ]
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Return tags overview page content. _tags__page__get_200_response

400

A query parameter is invalid.

Up
get /taxonomy_page/{tid}
Get taxonomy page content. (taxonomyPageTidGet)
Get content related to a taxonomy term.

Path parameters

tid (required)
Path Parameter — The taxonomy term id. default: null

Query parameters

page (optional)
Query Parameter — Pager for the content. default: null

Return type

_taxonomy_page__tid__get_200_response

Example data

Content-Type: application/json
{
  "data" : [ {
    "summary" : "In the video series 'ChatGPT - briefly explained', Aljoscha Burchardt from the German Research Center for Artificial Intelligence (DFKI) explains the technology behind the AI chatbot and discusses its influence on various aspects of our lives.",
    "entity_type" : "node",
    "node_type" : "content_page",
    "magazine_channel" : "magazine_channel",
    "id" : 42,
    "title" : {
      "text" : "This is a node title."
    },
    "published_at" : "04.09.2023",
    "header_media" : {
      "owner" : "John Doe",
      "entity_type" : "media",
      "file" : {
        "alt" : "image alt text",
        "url" : "https://example.com/example_image.jpg"
      },
      "media_type" : "image",
      "description" : "Image description",
      "id" : 0,
      "source" : {
        "link_type" : "external",
        "url_text" : "Link",
        "link_text" : "Press to go to website",
        "url" : "https://example.com"
      },
      "type" : "image"
    }
  }, {
    "summary" : "In the video series 'ChatGPT - briefly explained', Aljoscha Burchardt from the German Research Center for Artificial Intelligence (DFKI) explains the technology behind the AI chatbot and discusses its influence on various aspects of our lives.",
    "entity_type" : "node",
    "node_type" : "content_page",
    "magazine_channel" : "magazine_channel",
    "id" : 42,
    "title" : {
      "text" : "This is a node title."
    },
    "published_at" : "04.09.2023",
    "header_media" : {
      "owner" : "John Doe",
      "entity_type" : "media",
      "file" : {
        "alt" : "image alt text",
        "url" : "https://example.com/example_image.jpg"
      },
      "media_type" : "image",
      "description" : "Image description",
      "id" : 0,
      "source" : {
        "link_type" : "external",
        "url_text" : "Link",
        "link_text" : "Press to go to website",
        "url" : "https://example.com"
      },
      "type" : "image"
    }
  } ],
  "title" : "Marketing"
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Return taxonomy page content. _taxonomy_page__tid__get_200_response

400

Invalid page value.

404

Taxonomy term ID could not be resolved.

Up
get /vehicle_search
Room Search site content. (vehicleSearchGet)

Query parameters

search_api_fulltext (optional)
Query Parameter — The search term. If an empty string is provided or the query parameter is not added to the request, the whole website content will be seen as valid search results. default: null
f (optional)
Query Parameter — Facets filters. When facets should be used to filter the search results, they have to be added as array items of this query parameter: a facet will filter should have the form f[INDEX]=FACET_ID:VALUE where INDEX is an index number for the filters array (starting from zero). For example, to search users that live in Berlin (ID = 45), the facets "type" and "location" have to be added to the array in the following manner: /search?f[0]=type:user&f[1]=location:45. The order of filters in the array has no effect. default: null

Return type

VehicleSearch

Example data

Content-Type: application/json
{
  "sub_facets" : [ {
    "facet_id" : "location",
    "label" : "Location",
    "items" : [ {
      "item_id" : 45,
      "count" : 10,
      "label" : "Berlin"
    }, {
      "item_id" : 45,
      "count" : 10,
      "label" : "Berlin"
    } ]
  }, {
    "facet_id" : "location",
    "label" : "Location",
    "items" : [ {
      "item_id" : 45,
      "count" : 10,
      "label" : "Berlin"
    }, {
      "item_id" : 45,
      "count" : 10,
      "label" : "Berlin"
    } ]
  } ],
  "search_results" : [ {
    "last_updated" : "2000-01-23",
    "entity_type" : "node",
    "node_type" : "vehicle",
    "location" : {
      "label" : "Location",
      "value" : [ {
        "id" : "48",
        "text" : "Berlin"
      }, {
        "id" : "48",
        "text" : "Berlin"
      } ]
    },
    "model" : {
      "label" : "Year of Construction",
      "value" : "2020"
    },
    "id" : "1305",
    "year_of_construction" : {
      "label" : "Year of Construction",
      "value" : "2020"
    },
    "fuel_type" : {
      "label" : "Fuel type",
      "value" : {
        "id" : "462",
        "text" : "Gasoline"
      }
    },
    "title" : {
      "is_link" : true,
      "text" : "Yamaha Bike"
    },
    "excerpt" : "",
    "header_media" : {
      "owner" : "John Doe",
      "entity_type" : "media",
      "file" : {
        "alt" : "image alt text",
        "url" : "https://example.com/example_image.jpg"
      },
      "media_type" : "image",
      "description" : "Image description",
      "id" : 0,
      "source" : {
        "link_type" : "external",
        "url_text" : "Link",
        "link_text" : "Press to go to website",
        "url" : "https://example.com"
      },
      "type" : "image"
    }
  }, {
    "last_updated" : "2000-01-23",
    "entity_type" : "node",
    "node_type" : "vehicle",
    "location" : {
      "label" : "Location",
      "value" : [ {
        "id" : "48",
        "text" : "Berlin"
      }, {
        "id" : "48",
        "text" : "Berlin"
      } ]
    },
    "model" : {
      "label" : "Year of Construction",
      "value" : "2020"
    },
    "id" : "1305",
    "year_of_construction" : {
      "label" : "Year of Construction",
      "value" : "2020"
    },
    "fuel_type" : {
      "label" : "Fuel type",
      "value" : {
        "id" : "462",
        "text" : "Gasoline"
      }
    },
    "title" : {
      "is_link" : true,
      "text" : "Yamaha Bike"
    },
    "excerpt" : "",
    "header_media" : {
      "owner" : "John Doe",
      "entity_type" : "media",
      "file" : {
        "alt" : "image alt text",
        "url" : "https://example.com/example_image.jpg"
      },
      "media_type" : "image",
      "description" : "Image description",
      "id" : 0,
      "source" : {
        "link_type" : "external",
        "url_text" : "Link",
        "link_text" : "Press to go to website",
        "url" : "https://example.com"
      },
      "type" : "image"
    }
  } ]
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Return search results. VehicleSearch

400

A query parameter is invalid.

Up
get /videos
Get a videos page content. (videosGet)

Query parameters

page (optional)
Query Parameter — The page number for pagination. default: null

Return type

_videos_get_200_response

Example data

Content-Type: application/json
{
  "data" : [ {
    "summary" : "This is video description.",
    "entity_type" : "node",
    "node_type" : "magazine_video_article",
    "id" : 42,
    "title" : {
      "text" : "This is a node title."
    },
    "header_media" : ""
  }, {
    "summary" : "This is video description.",
    "entity_type" : "node",
    "node_type" : "magazine_video_article",
    "id" : 42,
    "title" : {
      "text" : "This is a node title."
    },
    "header_media" : ""
  } ],
  "title" : "Videos"
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Return videos page content. _videos_get_200_response

400

Invalid page value.

Up
get /wiki_overview
Get wiki overview content. (wikiOverviewGet)
Returns overview information (title, description) plus exported wiki category entities.

Return type

_wiki_overview_get_200_response

Example data

Content-Type: application/json
{
  "data" : [ {
    "image" : "",
    "entity_type" : "taxonomy_term",
    "name" : "Social Media Marketing",
    "description" : "Social media marketing wiki",
    "id" : 42,
    "taxonomy_term_type" : "news_channel"
  }, {
    "image" : "",
    "entity_type" : "taxonomy_term",
    "name" : "Social Media Marketing",
    "description" : "Social media marketing wiki",
    "id" : 42,
    "taxonomy_term_type" : "news_channel"
  } ],
  "description" : "description",
  "title" : "title"
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Successful response with wiki overview data _wiki_overview_get_200_response

Up
get /wiki_term_overview/{term_id}
Get wiki term overview content. (wikiTermOverviewTermIdGet)
Returns term overview information (title, description) plus exported wiki category entities.

Path parameters

term_id (required)
Path Parameter — Taxonomy term ID. default: null

Query parameters

search_api_fulltext (optional)
Query Parameter — Optional search keywords. default: null

Return type

_wiki_term_overview__term_id__get_200_response

Example data

Content-Type: application/json
{
  "data" : [ {
    "entity_type" : "node",
    "node_type" : "wiki_content",
    "id" : 42,
    "title" : {
      "text" : "This is a node title."
    }
  }, {
    "entity_type" : "node",
    "node_type" : "wiki_content",
    "id" : 42,
    "title" : {
      "text" : "This is a node title."
    }
  } ],
  "title" : "Social media marketing wiki"
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Successful response with wiki overview data _wiki_term_overview__term_id__get_200_response

User

Up
post /openid_connect_login/{oidc_client_name}
Authenticate/register a user through OpenID Connect. (openidConnectLoginOidcClientNamePost)
Log in/create a user by exchanging an id token and access token recieved from a successful logging in to an OIDC Provider.

Path parameters

oidc_client_name (required)
Path Parameter — The machine name of the configured OIDC client a user want to login through (a list of available clients can be found under the path "/admin/config/people/openid-connect"). default: null

Consumes

This API call consumes the following media types via the Content-Type request header:

Request body

_openid_connect_login__oidc_client_name__post_request _openid_connect_login__oidc_client_name__post_request (required)
Body Parameter

Return type

Login

Example data

Content-Type: application/json
{
  "access_token" : "access_token",
  "refresh_token" : "refresh_token",
  "tfa_skips_allowed" : 0,
  "jwt_token" : "jwt_token",
  "csrf_token" : "csrf_token",
  "logout_token" : "logout_token",
  "user" : "{}"
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Authentication was successful. Login

201

A new account was created and awaits approval from administrator.

400

id_token/access token are missing/invalid, the user email is used/blocked or the path parameter oidc_client_name does not correspond to any configured OIDC client.

403

User could not be authenticed.

Up
get /refresh_token
Generate a new access token using a refresh token. (refreshTokenGet)

When an access token has expired, use a refresh token to generate a new access token as well as a new refresh token.

Note: The refresh token must be used in the the 'Authorization' header to authorize against this endpoint. Trying to use the refresh token to authorize against any other endpoint will fail. The same argument is valid for the access token the other way around.

Request headers

security (required)
Header Parameter — default: null format: uuid

Return type

_refresh_token_get_200_response

Example data

Content-Type: application/json
{
  "access_token" : "access_token",
  "refresh_token" : "refresh_token",
  "jwt_token" : "jwt_token"
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Return newly generated tokens. _refresh_token_get_200_response

401

Unauthorized.

Up
post /user/code_register
Register user with initial credentials. (userCodeRegisterPost)
The user is expected to be provided with a username and an initial password that can be reset. This API can be used to either only validate the credentials, or to set a new password and complete user registration.

Consumes

This API call consumes the following media types via the Content-Type request header:

Request body

_user_code_register_post_request _user_code_register_post_request (required)
Body Parameter

Return type

Login

Example data

Content-Type: application/json
{
  "access_token" : "access_token",
  "refresh_token" : "refresh_token",
  "tfa_skips_allowed" : 0,
  "jwt_token" : "jwt_token",
  "csrf_token" : "csrf_token",
  "logout_token" : "logout_token",
  "user" : "{}"
}

Example data

Content-Type: application/json
{
  "message" : "Validation failed.",
  "errors" : {
    "mail" : "This value is not a valid email address.",
    "pass" : "This value is too short. It should have 8 characters or more."
  }
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

successful operation. Login

400

Bad request. For validation failures, returns a structured violations payload. User-Code-Register-Validation-Error

403

Access denied.

404

Not found.

Up
get /user-login-check
Get the login status of a user by the JWT token. (userLoginCheckGet)
Returns an object with the status of the user. If logged run it returns the user object additionally

Query parameters

_format (required)
Query Parameter — The format of the returend user login data. default: null

Return type

Login-Check

Example data

Content-Type: application/json
{
  "result" : true,
  "user" : "{}"
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Return news page content. Login-Check

Up
post /user-login
Log in to the app. (userLoginPost)

Authenticate with username and password.

Response flows:

Consumes

This API call consumes the following media types via the Content-Type request header:

Request body

_user_login_post_request _user_login_post_request (required)
Body Parameter

Query parameters

_format (required)
Query Parameter — The format of the returned user login data. default: null

Return type

Login

Example data

Content-Type: application/json
{
  "access_token" : "access_token",
  "refresh_token" : "refresh_token",
  "tfa_skips_allowed" : 0,
  "jwt_token" : "jwt_token",
  "csrf_token" : "csrf_token",
  "logout_token" : "logout_token",
  "user" : "{}"
}

Example data

Content-Type: application/json
{
  "allowed_methods" : [ "tfa_totp" ],
  "expires_at" : 1743342000,
  "challenge_token" : "a3f1c2d4e5b6...",
  "auth_state" : "challenge_required"
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Login successful. Returns JWT tokens and user object. Login

202

Two-factor authentication required. Submit the challenge_token and a one-time code to /user-login/tfa to complete the login. _user_login_post_202_response

400

User already logged in or missing username/password.

401

Invalid credentials.

Up
post /user-login/tfa
Complete two-factor authentication. (userLoginTfaPost)
Submit a challenge_token (received from POST /user-login) together with the one-time code from the user's second-factor device. On success, the login is finalized and JWT tokens and user object are returned.

Consumes

This API call consumes the following media types via the Content-Type request header:

Request body

_user_login_tfa_post_request _user_login_tfa_post_request (required)
Body Parameter

Query parameters

_format (required)
Query Parameter — default: null

Return type

Login

Example data

Content-Type: application/json
{
  "access_token" : "access_token",
  "refresh_token" : "refresh_token",
  "tfa_skips_allowed" : 0,
  "jwt_token" : "jwt_token",
  "csrf_token" : "csrf_token",
  "logout_token" : "logout_token",
  "user" : "{}"
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Second factor verified. Returns JWT tokens and user object. Login

400

Missing or empty required field (challenge_token, code).

401

Invalid challenge token or invalid second-factor code.

410

Challenge has expired. Restart the login flow to receive a new challenge.

429

Too many failed second-factor attempts. Check the Retry-After response header.

Up
post /user-logout
Log out of the app. (userLogoutPost)
Log out a user by sending the current access token and refresh token to invalidate them.

Consumes

This API call consumes the following media types via the Content-Type request header:

Request body

_user_logout_post_request _user_logout_post_request (required)
Body Parameter

Responses

204

successful operation.

400

Missing/invalid tokens.

401

User not authenticated.

403

Cannot invalidate tokens of another user.

Up
post /user/logout
Log out via session-based authentication. (userLogoutPost_1)
Session-based logout endpoint. Invalidates the current session. Requires the per-session logout token supplied by /user_session endpoint. Pass _format=json to receive a JSON response instead of an HTML redirect.

Query parameters

token (required)
Query Parameter — The logout token issued for the current session. default: null
_format (optional)
Query Parameter — Response format. default: null

Responses

204

Successfully logged out (JSON format requested).

302

Successfully logged out, redirected to the front page (no _format given).

403

Invalid or missing logout token.

Up
get /user_profile/edit/{uid}
Get user profile edit form data. (userProfileEditUidGet)

Returns edit form data for a user profile. The response shape depends on the API version:

Path parameters

uid (required)
Path Parameter — The user ID. default: null

Return type

_user_profile_edit__uid__get_200_response

Example data

Content-Type: application/json
{
  "image" : {
    "settings" : {
      "min_height" : 200,
      "min_width" : 200
    },
    "default" : {
      "alt" : "Default user picture for user superadmin",
      "url" : "/themes/contrib/piipe_backend/images/icons/user/user.svg"
    },
    "value" : {
      "alt" : "image alt text",
      "url" : "https://example.com/example_image.jpg"
    }
  },
  "profile" : {
    "fields" : {
      "key" : {
        "parent" : "organization_data",
        "title_required" : 1,
        "private" : false,
        "edit" : "1",
        "weight" : "-26",
        "label" : "Country",
        "type" : "entity_reference",
        "machine_name" : "field_country",
        "click" : "0",
        "delete" : "Delete",
        "required" : true,
        "selection_limit" : 3,
        "protocol_type" : "protocol_type",
        "hide" : "0",
        "depth" : "1",
        "multi_select" : 0,
        "new_tab" : "0",
        "options" : {
          "46" : "Germany",
          "60" : "France"
        },
        "private_for_others" : true,
        "taxonomy_link" : "1",
        "id" : "field_country",
        "placeholder" : {
          "text" : "text",
          "title" : "title",
          "uri" : "uri"
        },
        "value" : "46"
      }
    },
    "sections" : {
      "key" : {
        "parent" : "none",
        "edit" : 0,
        "weight" : "-27",
        "label" : "Organization data",
        "type" : "section",
        "machine_name" : "organization_data",
        "click" : 0,
        "delete" : "Delete",
        "protocol_type" : "protocol_type",
        "hide" : 0,
        "depth" : "0",
        "new_tab" : 0,
        "private_for_others" : true,
        "id" : "organization_data",
        "taxonomy_link" : 0
      }
    }
  }
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Successful operation. _user_profile_edit__uid__get_200_response

400

Unsupported API version.

403

Permission denied. Users can only access their own edit data unless they have the 'administer users' permission.

Up
patch /user_profile/edit/{uid}
Edit user profile. (userProfileEditUidPatch)

Updates a user's profile fields and/or profile image. The response depends on the API version:

Path parameters

uid (required)
Path Parameter — The user ID. default: null

Consumes

This API call consumes the following media types via the Content-Type request header:

Request body

_user_profile_edit__uid__patch_request _user_profile_edit__uid__patch_request (required)
Body Parameter

Return type

_user_profile_edit__uid__patch_200_response

Example data

Content-Type: application/json
{
  "image" : {
    "value" : {
      "alt" : "image alt text",
      "url" : "https://example.com/example_image.jpg"
    }
  },
  "org_chart" : {
    "supervisor_id" : "260",
    "supervisor" : "The boss",
    "users" : [ {
      "uid" : "1",
      "name" : "Super Admin-Schmidt",
      "subordinates" : [ {
        "uid" : "4",
        "name" : "Katharina XYZ"
      }, {
        "uid" : "4",
        "name" : "Katharina XYZ"
      } ]
    }, {
      "uid" : "1",
      "name" : "Super Admin-Schmidt",
      "subordinates" : [ {
        "uid" : "4",
        "name" : "Katharina XYZ"
      }, {
        "uid" : "4",
        "name" : "Katharina XYZ"
      } ]
    } ]
  },
  "profile" : {
    "field_topic" : [ {
      "label" : "Saarbrücken",
      "url" : "/taxonomy/term/47"
    }, {
      "label" : "Saarbrücken",
      "url" : "/taxonomy/term/47"
    } ],
    "field_location" : [ {
      "label" : "Saarbrücken",
      "url" : "/taxonomy/term/47"
    }, {
      "label" : "Saarbrücken",
      "url" : "/taxonomy/term/47"
    } ],
    "field_organizational_unit" : [ {
      "label" : "Saarbrücken",
      "url" : "/taxonomy/term/47"
    }, {
      "label" : "Saarbrücken",
      "url" : "/taxonomy/term/47"
    } ],
    "fields" : {
      "key" : {
        "parent" : "organization_data",
        "edit" : "1",
        "weight" : "-26",
        "label" : "Country",
        "type" : "entity_reference",
        "machine_name" : "field_country",
        "click" : "0",
        "delete" : "Delete",
        "selection_limit" : 3,
        "protocol_type" : "protocol_type",
        "hide" : "0",
        "depth" : "1",
        "multi_select" : 0,
        "new_tab" : "0",
        "options" : {
          "46" : "Germany",
          "60" : "France"
        },
        "private_for_others" : true,
        "taxonomy_link" : "1",
        "id" : "field_country",
        "value" : "46"
      }
    },
    "sections" : {
      "key" : {
        "parent" : "none",
        "edit" : 0,
        "weight" : "-27",
        "label" : "Organization data",
        "type" : "section",
        "machine_name" : "organization_data",
        "click" : 0,
        "delete" : "Delete",
        "protocol_type" : "protocol_type",
        "hide" : 0,
        "depth" : "0",
        "new_tab" : 0,
        "private_for_others" : true,
        "id" : "organization_data",
        "taxonomy_link" : 0
      }
    },
    "private_fields" : [ "private_fields", "private_fields" ]
  }
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Successful operation. Returns the updated user profile. _user_profile_edit__uid__patch_200_response

400

Bad request. Possible causes:

403

Permission denied.

Up
get /user_profile/{uid}
Get user profile. (userProfileUidGet)

Returns the user profile for the given user ID. The response shape depends on the API version prefix used in the URL:

Path parameters

uid (required)
Path Parameter — The user ID. default: null

Return type

_user_profile__uid__get_200_response

Example data

Content-Type: application/json
{
  "image" : {
    "value" : {
      "alt" : "image alt text",
      "url" : "https://example.com/example_image.jpg"
    }
  },
  "org_chart" : {
    "supervisor_id" : "260",
    "supervisor" : "The boss",
    "users" : [ {
      "uid" : "1",
      "name" : "Super Admin-Schmidt",
      "subordinates" : [ {
        "uid" : "4",
        "name" : "Katharina XYZ"
      }, {
        "uid" : "4",
        "name" : "Katharina XYZ"
      } ]
    }, {
      "uid" : "1",
      "name" : "Super Admin-Schmidt",
      "subordinates" : [ {
        "uid" : "4",
        "name" : "Katharina XYZ"
      }, {
        "uid" : "4",
        "name" : "Katharina XYZ"
      } ]
    } ]
  },
  "profile" : {
    "field_topic" : [ {
      "label" : "Saarbrücken",
      "url" : "/taxonomy/term/47"
    }, {
      "label" : "Saarbrücken",
      "url" : "/taxonomy/term/47"
    } ],
    "field_location" : [ {
      "label" : "Saarbrücken",
      "url" : "/taxonomy/term/47"
    }, {
      "label" : "Saarbrücken",
      "url" : "/taxonomy/term/47"
    } ],
    "field_organizational_unit" : [ {
      "label" : "Saarbrücken",
      "url" : "/taxonomy/term/47"
    }, {
      "label" : "Saarbrücken",
      "url" : "/taxonomy/term/47"
    } ],
    "fields" : {
      "key" : {
        "parent" : "organization_data",
        "edit" : "1",
        "weight" : "-26",
        "label" : "Country",
        "type" : "entity_reference",
        "machine_name" : "field_country",
        "click" : "0",
        "delete" : "Delete",
        "selection_limit" : 3,
        "protocol_type" : "protocol_type",
        "hide" : "0",
        "depth" : "1",
        "multi_select" : 0,
        "new_tab" : "0",
        "options" : {
          "46" : "Germany",
          "60" : "France"
        },
        "private_for_others" : true,
        "taxonomy_link" : "1",
        "id" : "field_country",
        "value" : "46"
      }
    },
    "sections" : {
      "key" : {
        "parent" : "none",
        "edit" : 0,
        "weight" : "-27",
        "label" : "Organization data",
        "type" : "section",
        "machine_name" : "organization_data",
        "click" : 0,
        "delete" : "Delete",
        "protocol_type" : "protocol_type",
        "hide" : 0,
        "depth" : "0",
        "new_tab" : 0,
        "private_for_others" : true,
        "id" : "organization_data",
        "taxonomy_link" : 0
      }
    },
    "private_fields" : [ "private_fields", "private_fields" ]
  },
  "details" : {
    "own_page" : true,
    "username" : "superadmin"
  }
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Successful operation. _user_profile__uid__get_200_response

400

Unsupported API version.

403

Access denied.

Up
post /user/register
Register a new user (Note: this endpoint doesn't have the prefix /api/v1 in the base URL). (userRegisterPost)
Create a new user account.

Consumes

This API call consumes the following media types via the Content-Type request header:

Request body

_user_register_post_request _user_register_post_request (required)
Body Parameter

Query parameters

_format (required)
Query Parameter — The format of the returend user login data. default: null

Responses

200

successful operation.

Up
get /user_session
Create a Drupal session for the authenticated user. (userSessionGet)
Finalizes a Drupal web session for the currently authenticated user and returns CSRF and logout tokens required for cookie-based session actions.

Return type

_user_session_get_200_response

Example data

Content-Type: application/json
{
  "csrf_token" : "1234567890abcdef1234567890abcdef",
  "logout_token" : "1234567890abcdef1234567890abcdef"
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Session tokens generated successfully. _user_session_get_200_response

401

User is not authenticated.

403

Authenticated user is blocked or inactive.

404

Authenticated user account cannot be loaded.

Up
get /user_settings
Get user settings. (userSettingsGet)
Each setting has a unique identifier that has to be passed in the patch request.

Return type

array[User-Settings]

Example data

Content-Type: application/json
[ {
  "description" : "On this page you will find all settings to customize the system to your personal needs.",
  "section" : [ {
    "section_id" : "language_location",
    "section_elements" : [ {
      "settings_id" : "UserSettingsElementLanguage",
      "data" : {
        "current_language" : "en",
        "label" : "Language",
        "language_options" : [ {
          "name" : "English",
          "id" : "en"
        }, {
          "name" : "English",
          "id" : "en"
        } ]
      },
      "description" : "Here you can set the language on Piipe Workplace. The language settings affect Piipe Workplace' content including News Channels.",
      "title" : "title"
    }, {
      "settings_id" : "UserSettingsElementLanguage",
      "data" : {
        "current_language" : "en",
        "label" : "Language",
        "language_options" : [ {
          "name" : "English",
          "id" : "en"
        }, {
          "name" : "English",
          "id" : "en"
        } ]
      },
      "description" : "Here you can set the language on Piipe Workplace. The language settings affect Piipe Workplace' content including News Channels.",
      "title" : "title"
    } ],
    "title" : "Language and location"
  }, {
    "section_id" : "language_location",
    "section_elements" : [ {
      "settings_id" : "UserSettingsElementLanguage",
      "data" : {
        "current_language" : "en",
        "label" : "Language",
        "language_options" : [ {
          "name" : "English",
          "id" : "en"
        }, {
          "name" : "English",
          "id" : "en"
        } ]
      },
      "description" : "Here you can set the language on Piipe Workplace. The language settings affect Piipe Workplace' content including News Channels.",
      "title" : "title"
    }, {
      "settings_id" : "UserSettingsElementLanguage",
      "data" : {
        "current_language" : "en",
        "label" : "Language",
        "language_options" : [ {
          "name" : "English",
          "id" : "en"
        }, {
          "name" : "English",
          "id" : "en"
        } ]
      },
      "description" : "Here you can set the language on Piipe Workplace. The language settings affect Piipe Workplace' content including News Channels.",
      "title" : "title"
    } ],
    "title" : "Language and location"
  } ],
  "title" : "Settings"
}, {
  "description" : "On this page you will find all settings to customize the system to your personal needs.",
  "section" : [ {
    "section_id" : "language_location",
    "section_elements" : [ {
      "settings_id" : "UserSettingsElementLanguage",
      "data" : {
        "current_language" : "en",
        "label" : "Language",
        "language_options" : [ {
          "name" : "English",
          "id" : "en"
        }, {
          "name" : "English",
          "id" : "en"
        } ]
      },
      "description" : "Here you can set the language on Piipe Workplace. The language settings affect Piipe Workplace' content including News Channels.",
      "title" : "title"
    }, {
      "settings_id" : "UserSettingsElementLanguage",
      "data" : {
        "current_language" : "en",
        "label" : "Language",
        "language_options" : [ {
          "name" : "English",
          "id" : "en"
        }, {
          "name" : "English",
          "id" : "en"
        } ]
      },
      "description" : "Here you can set the language on Piipe Workplace. The language settings affect Piipe Workplace' content including News Channels.",
      "title" : "title"
    } ],
    "title" : "Language and location"
  }, {
    "section_id" : "language_location",
    "section_elements" : [ {
      "settings_id" : "UserSettingsElementLanguage",
      "data" : {
        "current_language" : "en",
        "label" : "Language",
        "language_options" : [ {
          "name" : "English",
          "id" : "en"
        }, {
          "name" : "English",
          "id" : "en"
        } ]
      },
      "description" : "Here you can set the language on Piipe Workplace. The language settings affect Piipe Workplace' content including News Channels.",
      "title" : "title"
    }, {
      "settings_id" : "UserSettingsElementLanguage",
      "data" : {
        "current_language" : "en",
        "label" : "Language",
        "language_options" : [ {
          "name" : "English",
          "id" : "en"
        }, {
          "name" : "English",
          "id" : "en"
        } ]
      },
      "description" : "Here you can set the language on Piipe Workplace. The language settings affect Piipe Workplace' content including News Channels.",
      "title" : "title"
    } ],
    "title" : "Language and location"
  } ],
  "title" : "Settings"
} ]

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Return user settings.

Up
patch /user_settings
Apply user setting. (userSettingsPatch)
Each setting have a certain request body structure.

Consumes

This API call consumes the following media types via the Content-Type request header:

Request body

_user_settings_patch_request _user_settings_patch_request (required)
Body Parameter

Responses

200

successful operation.

400

Bad request.

404

Not found.

Models

[ Jump to Methods ]

Table of Contents

  1. Article-Teaser -
  2. Authored-By -
  3. Birthday-Item -
  4. Birthday-Item-Base -
  5. Birthday_Widget_inner -
  6. Box -
  7. Box-Base -
  8. Box-Page -
  9. Box-Page-Reorder-Settings -
  10. Bulletin-Config -
  11. Bulletin_Config_breadcrumbRoots_inner -
  12. Bulletin_Config_permissions_inner -
  13. Bulletin_Config_types_inner -
  14. Comment -
  15. Comment-Request -
  16. Comment_Request_comment_body_inner -
  17. Comment_Request_comment_type_inner -
  18. Comment_Request_entity_type_inner -
  19. Comment_Request_field_name_inner -
  20. Comment_author -
  21. Comment_fields -
  22. Comment_fields_comment_body -
  23. Comment_fields_subject -
  24. Comment_flags -
  25. Comment_flags_like -
  26. Comment_flags_like_count -
  27. Comment_flags_report -
  28. Comment_permissions -
  29. Comments-List-Response -
  30. Comments_List_Response_administrators_inner -
  31. Community -
  32. Community-Info -
  33. Community-Member -
  34. CommunityField -
  35. CommunityField_default -
  36. CommunityField_value -
  37. CommunityField_value_oneOf_inner -
  38. CommunityMemberAssignRole -
  39. CommunityMemberJoin -
  40. CommunityMemberLeave -
  41. CommunityMemberRemove -
  42. CommunityNotification -
  43. CommunityNotificationPatchItem -
  44. CommunityNotification_id -
  45. CommunityUserSettings -
  46. CommunityUserSettingsPatchRequest -
  47. Community_Info_admins_value -
  48. Component -
  49. Concrete-Component -
  50. Concrete_Component_additional_data -
  51. Concrete_Component_additional_data_additional_data_1 -
  52. Concrete_Component_additional_data_additional_data_2 -
  53. Concrete_Component_data -
  54. Concrete_Component_empty -
  55. Content -
  56. Content-Box -
  57. Content-V2 -
  58. Content_Box_allOf_content -
  59. Context-Box -
  60. Context-Reference-Change-Block -
  61. Context_Box_allOf_contextual_content -
  62. Context_Box_allOf_contextual_content_content -
  63. Context_Box_allOf_contextual_content_context_items -
  64. Context_Reference_Change_Block_options_inner -
  65. Corporate_News_Block_inner -
  66. Country-Location-Settings-PATCH -
  67. Country-Settings -
  68. Country_Settings_country_options_inner -
  69. DeleteAllMessages -
  70. DeleteSelectedMessages -
  71. DeleteSingleMessage -
  72. DocumentResult -
  73. DocumentResult_links -
  74. DocumentResult_location -
  75. DocumentResult_organizational_unit -
  76. DocumentResult_tags -
  77. DocumentResult_title -
  78. DocumentResult_topic -
  79. DocumentSearch -
  80. DocumentSearch_search_results_inner -
  81. DocumentSearch_sub_facets -
  82. Dossier_Widget_inner -
  83. Dynamic-Box-Page -
  84. Dynamic_Box_Page_allOf_reorder -
  85. Employee_Jubilees_inner -
  86. Employees -
  87. Employees-Config -
  88. Employees_Config_columns_inner -
  89. Employees_Config_dropdowns_inner -
  90. Employees_Config_dropdowns_inner_field_location_inner -
  91. Employees_Config_hierarchical_sorting_inner -
  92. Entity-Title -
  93. EntityReferenceItem -
  94. Entity_Title_title -
  95. Event-Available-Categories -
  96. Event-Bookmark-Request -
  97. Event-Bookmark-Response -
  98. Event-Category-Reference -
  99. Event-Date-Parts -
  100. Event-Date-Segment -
  101. Event-Flat-Response -
  102. Event-Group-Category -
  103. Event-Grouped-Response -
  104. Event-Registration-Create-Request -
  105. Event-Registration-Delete-Response -
  106. Event-Registration-Item -
  107. Event-Registration-Upsert-Response -
  108. Event-Registrations-Response -
  109. Event-Resource-Item -
  110. Event-Settings-Response -
  111. Event-Term-Option -
  112. Event_Settings_Response_category_colors_value -
  113. Event_Settings_Response_visible_tabs -
  114. Event_Term_Option_value -
  115. Events-Page -
  116. File -
  117. Flag-Status -
  118. Frontpage-component-types -
  119. Header-Media -
  120. Header-Media-Base -
  121. Highlight_Widget_Magazine_inner -
  122. Image -
  123. ImageValue -
  124. Language-Settings -
  125. Language-Settings-PATCH -
  126. Language_Settings_language_options_inner -
  127. Link -
  128. Link-Box -
  129. Link-Box-List -
  130. Link-Type -
  131. Location-Settings -
  132. Location_Settings_location_options_inner -
  133. Login -
  134. Login-Check -
  135. Magazine-Category-Filter-Box -
  136. Magazine-Facts-And-Figures-Link -
  137. Magazine-Facts-And-Figures-Widget -
  138. Magazine_Category_Filter_Box_search_results_inner -
  139. Magazine_Collage_Widget_inner -
  140. Magazine_Contact_Person_Widget_inner -
  141. MarkReadAllMessages -
  142. MarkReadMessages -
  143. MarkSingleMessage -
  144. MarkUnreadAllMessages -
  145. Mention-User -
  146. Mention_User_userId_inner -
  147. Menu-Link -
  148. Most-Read-And-Most-Recent -
  149. Most-Read-And-Most-Recent-Item -
  150. Most-Read-Magazine-2-Item -
  151. My-Page-Settings -
  152. My-Page-Settings-PATCH -
  153. My_Content_Widget_inner -
  154. New-Colleagues-Item -
  155. New_Colleagues_inner -
  156. New_Employees_Block_inner -
  157. News-Mandatory-And-Subscribed-Block -
  158. News-Menu-Item -
  159. News-Page -
  160. News_Block_inner -
  161. News_Page_news_channel_filter_inner -
  162. Node-Base -
  163. Node-Base-Extended -
  164. Node-Box-View -
  165. Node-Default -
  166. Node-Event-Widget -
  167. Node-Events-Box-View -
  168. Node-News-Box-View -
  169. Node-Sitemap-List-View -
  170. Node-Slider -
  171. Node-Teaser -
  172. Node-Type -
  173. Node-View-Mode -
  174. Node_Base_allOf_title -
  175. Node_Default_allOf_content -
  176. Node_Default_allOf_my_page_button -
  177. Notification -
  178. Notification-Additional-Data -
  179. Notifications-Settings -
  180. Notifications-Settings-PATCH -
  181. Notifications_Settings_header -
  182. Notifications_Settings_notifications_inner -
  183. Person-Widget-Item -
  184. Picture-Gallery-Post -
  185. Picture_Gallery_Post_author -
  186. Picture_Gallery_Post_author_picture -
  187. Picture_Gallery_Post_flag -
  188. Picture_Gallery_Post_hashtags_inner -
  189. Picture_Gallery_Post_permissions -
  190. Poll-Block -
  191. Poll_Block_choices_inner -
  192. Press_Article_Widget_inner -
  193. Press_Article_Widget_inner_allOf_press_categories -
  194. RoomResult -
  195. RoomResult_location_inner -
  196. RoomResult_number_of_seats -
  197. RoomResult_title -
  198. RoomSearch -
  199. Search -
  200. Search-Facet -
  201. Search-Result-Excerpt -
  202. Search-Result-Node -
  203. Search-Result-User -
  204. Search_Facet_items_inner -
  205. Search_Facet_items_inner_item_id -
  206. Search_main_facet -
  207. Search_search_results_inner -
  208. Search_sub_facets -
  209. Section -
  210. Simple-Image -
  211. Social-Icons -
  212. Social_Icons_comments -
  213. Social_Icons_heart -
  214. Social_Icons_like -
  215. Social_Icons_rocks -
  216. Social_Icons_views -
  217. Static-Box-Page -
  218. Static_Box_Page_allOf_categories -
  219. Status-Message-Time-Settings -
  220. Status-Message-Time-Settings-PATCH -
  221. Subscriptions-Settings-PATCH -
  222. Subscriptions_Settings_inner -
  223. Taxonomy-Term -
  224. Taxonomy-Term-Base -
  225. Term -
  226. Thread-Trace-Response -
  227. Thumbnail -
  228. Toolbar-Custom-Item -
  229. Toolbar-Custom-Item-Link-Payload -
  230. Toolbar-Item-Base -
  231. Toolbar-Item-Dictionary -
  232. Toolbar-Item-Dictionary-Payload -
  233. Toolbar-Item-Link -
  234. Toolbar-Item-Link-Payload -
  235. Toolbar-Item-Section -
  236. Toolbar-Item-Section-Base -
  237. Toolbar-Item-Subsection -
  238. Toolbar-Settings-Object -
  239. Toolbar-Settings-Object-Dictionary -
  240. Toolbar_Default_Items_value -
  241. UpdateMessageStatus -
  242. Upload-Completed -
  243. Upload-In-Progress -
  244. User-Base -
  245. User-Code-Register-Validation-Error -
  246. User-Profile-Details -
  247. User-Profile-Edit-Field -
  248. User-Profile-Edit-Image -
  249. User-Profile-Edit-Patch-V1 -
  250. User-Profile-Edit-V1 -
  251. User-Profile-Edit-V1-Profile -
  252. User-Profile-Edit-V2 -
  253. User-Profile-Edit-V2-Profile -
  254. User-Profile-Edit-V2-Section -
  255. User-Profile-Field-Base -
  256. User-Profile-Image -
  257. User-Profile-Org-Chart -
  258. User-Profile-Org-Chart-User -
  259. User-Profile-Section-Base -
  260. User-Profile-Term-Link -
  261. User-Profile-V1 -
  262. User-Profile-V1-Profile -
  263. User-Profile-V2 -
  264. User-Profile-V2-Field -
  265. User-Profile-V2-Profile -
  266. User-Profile-V2-Section -
  267. User-Settings -
  268. User-Settings-Element -
  269. User-Settings-Section -
  270. User_Profile_Edit_Field_allOf_placeholder -
  271. User_Profile_Edit_Image_default -
  272. User_Profile_Edit_Image_settings -
  273. User_Profile_Field_Base_value -
  274. User_Profile_Org_Chart_User_subordinates_inner -
  275. User_Settings_Element_data -
  276. VehicleResult -
  277. VehicleResult_fuel_type -
  278. VehicleResult_fuel_type_value -
  279. VehicleResult_location -
  280. VehicleResult_location_value_inner -
  281. VehicleResult_model -
  282. VehicleResult_title -
  283. VehicleSearch -
  284. Video-Teaser -
  285. Vocabulary -
  286. Who-s-new-Widget -
  287. _api_v1_piipe_picture_gallery_create_post_200_response -
  288. _api_v1_piipe_picture_gallery_create_post_request -
  289. _api_v1_piipe_picture_gallery_create_post_request_chunk -
  290. _birthday_calendar_filters_get_200_response -
  291. _birthday_calendar_filters_get_200_response_location_filter_inner -
  292. _birthday_calendar_get_200_response -
  293. _birthday_calendar_recent_birthday__type__get_200_response_inner -
  294. _box_pages__page_name__get_200_response -
  295. _box_pages_frontend_boxes_reorder_patch_request -
  296. _box_pages_my_page_add_patch_200_response -
  297. _box_pages_my_page_add_patch_request -
  298. _comment_post_request -
  299. _comment_post_request_allOf_entity_id_inner -
  300. _comment_post_request_allOf_field_subject_long_inner -
  301. _comment_post_request_allOf_pid_inner -
  302. _community_joining_request__gid__patch_request -
  303. _community_joining_request_post_request -
  304. _community_list_get_200_response -
  305. _community_members__gid__get_200_response -
  306. _community_members__gid__patch_request -
  307. _community_post_request -
  308. _community_post_request_community_picture -
  309. _community_post_request_community_picture_value -
  310. _community_post_request_community_picture_value_file -
  311. _employee_jubilees_get_200_response -
  312. _employee_jubilees_get_200_response_employee_jubilees_allOf_inner -
  313. _event__type__get_200_response -
  314. _event__type__get_event_type_parameter -
  315. _magazine_topic__topic__get_200_response -
  316. _new_colleagues_get_200_response -
  317. _notifications_get_200_response -
  318. _notifications_patch_request -
  319. _openid_connect_login__oidc_client_name__post_request -
  320. _piipe_comments_media_post_200_response -
  321. _piipe_comments_media_post_request -
  322. _piipe_comments_media_post_request_chunk -
  323. _piipe_comments_mention_post_request -
  324. _piipe_flags_flag_post_request -
  325. _piipe_picture_gallery_patch_200_response -
  326. _piipe_picture_gallery_patch_200_response_oneOf -
  327. _piipe_picture_gallery_patch_request -
  328. _piipe_picture_gallery_patch_request_chunk -
  329. _piipe_picture_gallery_patch_request_chunk_post_data -
  330. _piipe_toolbar_custom_objects_patch_request -
  331. _piipe_toolbar_custom_objects_patch_request_objectsToBeUpdated_inner -
  332. _piipe_toolbar_custom_objects_post_request -
  333. _piipe_toolbar_settings_patch_request -
  334. _piipe_toolbar_settings_patch_request_objectsToBeUpdated_inner -
  335. _piipe_toolbar_settings_post_request -
  336. _poll_patch_request -
  337. _poll_patch_request_oneOf -
  338. _poll_patch_request_oneOf_1 -
  339. _refresh_token_get_200_response -
  340. _register_device_token__token__delete_403_response -
  341. _register_device_token__token__delete_404_response -
  342. _register_device_token_post_400_response -
  343. _register_device_token_post_request -
  344. _scssadmin_get_200_response_value_inner -
  345. _tags__page__get_200_response -
  346. _taxonomy_page__tid__get_200_response -
  347. _user_code_register_post_request -
  348. _user_login_post_202_response -
  349. _user_login_post_request -
  350. _user_login_tfa_post_request -
  351. _user_logout_post_request -
  352. _user_profile__uid__get_200_response -
  353. _user_profile_edit__uid__get_200_response -
  354. _user_profile_edit__uid__patch_200_response -
  355. _user_profile_edit__uid__patch_request -
  356. _user_profile_edit__uid__patch_request_changes -
  357. _user_profile_edit__uid__patch_request_changes_editData -
  358. _user_profile_edit__uid__patch_request_changes_editData_image -
  359. _user_profile_edit__uid__patch_request_changes_editData_image_value -
  360. _user_profile_edit__uid__patch_request_changes_editData_image_value_file -
  361. _user_profile_edit__uid__patch_request_changes_editData_profile -
  362. _user_profile_edit__uid__patch_request_changes_editData_profile_fields_value -
  363. _user_profile_edit__uid__patch_request_changes_editData_profile_fields_value_value -
  364. _user_profile_edit__uid__patch_request_changes_editData_profile_fields_value_value_oneOf -
  365. _user_register_post_request -
  366. _user_register_post_request_field_firstname_inner -
  367. _user_register_post_request_field_lastname_inner -
  368. _user_register_post_request_mail_inner -
  369. _user_register_post_request_name_inner -
  370. _user_session_get_200_response -
  371. _user_settings_patch_request -
  372. _videos_get_200_response -
  373. _wiki_overview_get_200_response -
  374. _wiki_overview_get_200_response_data_inner -
  375. _wiki_term_overview__term_id__get_200_response -
  376. _wiki_term_overview__term_id__get_200_response_data_inner -

Article-Teaser - Up

title
id
Integer Node identifier.
entity_type
Enum:
node
node_type
Enum:
article
summary
String The node summary.
header_media
magazine_channel
String The magazine channel.

Authored-By - Up

id
Integer User identifier (link).
text
String Full text of author and publish date.
user_text
String User name.

Birthday-Item - Up

entity_id
Integer User id.
field_birthday_value
String Person birthday.
user_picture
URI Person thumbnail. format: uri
name
String Person name.
field_position_value
String Person position.
field_location_value
String Person location.
user_profile_link
String Internal link to user profile page.

Birthday-Item-Base - Up

entity_id
Integer User id.
field_birthday_value
String Person birthday.
user_picture
URI Person thumbnail. format: uri
name
String Person name.

Birthday_Widget_inner - Up

id
Integer User identifier.
entity_type
String Entity type.
Enum:
user
user_type
String The user type (currently there is only one user type).
Enum:
user
firstname
String Person first name.
lastname
String Person last name.
birthday
String Person birthday.
user_picture

Box - Up

id
Integer Box identifier
entity_type
Enum:
box
box_type
Enum:
content_box
context_box
linkbox
content
contextual_content
title
box_image
box_link
description

Box-Base - Up

id
Integer Box identifier
entity_type
Enum:
box
box_type
Enum:
content_box
context_box
linkbox

Box-Page - Up

page_type
Enum:
static
dynamic
page_title
page_description

Box-Page-Reorder-Settings - Up

bid
Integer Box ID.
title
String Box title.
type
String Box type.
author
String Box author.
changed
String Last change date of the box.
weight
Integer Box weight.

Bulletin-Config - Up

types
array[Bulletin_Config_types_inner] The array of post types.
categories (optional)
array[Bulletin_Config_types_inner] The array of taxonomy categories a post can have.
language
String The current user language.
breadcrumbRoots
permissions
consent_text
String The text of consent to display.

Bulletin_Config_breadcrumbRoots_inner - Up

text (optional)
route (optional)

Bulletin_Config_permissions_inner - Up

create (optional)

Bulletin_Config_types_inner - Up

id (optional)
name (optional)

Comment - Up

cid (optional)
Integer Comment ID.
answerCount (optional)
Integer Amount of answers to this comment.
changed (optional)
String Date of comment's last change.
created (optional)
String Comment creation date.
subject (optional)
String Comment subject.
author (optional)
pid (optional)
String Parent comment ID (only for answers).
fields (optional)
permissions (optional)
isCommentOwner (optional)
Boolean Whether the current user owns this comment.
flags (optional)
addressee (optional)
String Visibility marker. [public: Public, content_author: The comment is only visible for the author of the conent, personal: The comment is only visible for the author of the comment as a note]
Enum:
public
content_author
personal
answers (optional)

Comment-Request - Up

entity_type
array[Comment_Request_entity_type_inner] Type of entity containing the comment.
comment_type
field_name
array[Comment_Request_field_name_inner] The referencing field name on parent entity. (node:comment, discussion:field_comments)
subject
comment_body

Comment_Request_comment_body_inner - Up

value (optional)
String HTML body content. If the body contains a mention to another user, an anchor tag should surround the user name like in the example, using the same tag attributes. This is important to save the text in the database so that the mention works on the web as well.
format (optional)
String Text format identifier
Enum:
comment_editor

Comment_Request_comment_type_inner - Up

target_id (optional)
Enum:
comment
discussion_comments

Comment_Request_entity_type_inner - Up

value (optional)
Enum:
node
discussion

Comment_Request_field_name_inner - Up

value (optional)
Enum:
field_comments
comment

Comment_author - Up

Comment author.
picture (optional)
name (optional)
String Author name.
uid (optional)
Integer User ID

Comment_fields - Up

Structured field values on the comment.
comment_body (optional)
subject (optional)

Comment_fields_comment_body - Up

value (optional)
String HTML-formatted body value.
format (optional)
String Text format/mode.
Enum:
comment_editor

Comment_fields_subject - Up

value (optional)
String Comment subject value

Comment_flags - Up

like (optional)
report (optional)

Comment_flags_like - Up

count (optional)
flagged (optional)
Boolean Whether the current user liked the comment.

Comment_flags_like_count - Up

Number of likes (can appear as string or integer).

Comment_flags_report - Up

Report flag information.
flagged_by_current_user (optional)
Boolean Whether the current user has reported the comment.
count (optional)
Integer Number of report flaggings. This is only included for users with report management access.
flagged (optional)
Boolean Whether the comment has at least one report. This is only included for users with report management access.

Comment_permissions - Up

edit (optional)
Boolean Whether the user is allowed to edit comment.
delete (optional)
Boolean Whether the user is allowed to delete comment.
report (optional)
Boolean Whether the current user can report the comment.

Comments-List-Response - Up

count (optional)
Integer Amount of comments (answers of comments are not included)
comment_status (optional)
Integer Whether comments are allowed on this entity: 0 = no, 1 = closed (read only), 2 = open (read/write). The value could also be a boolean "false" when comments are disabled on an entity.
thread_permission (optional)
Boolean Whther creating new threads is allowed (in discussions only).
title (optional)
String Discussion title (in discussions only).
administrators (optional)
changed (optional)
String Date of discussion's last change.
comments (optional)
array[Comment] List of comments.
nextAnswers (optional)
array[Comment] List of comment additional answers (only when specifying cid and answer_page query parameters).

Comments_List_Response_administrators_inner - Up

url (optional)
String User url.
name (optional)
String User name.

Community - Up

gid
Integer The community identifier.
edit_access
Boolean Whether the current user can edit this community.
visibility
Integer The visiblity of this community for the current user. [0: User can join, 1: User cannot join but can still see the community, 2: User can neither join nor see the community]
Enum:
0
1
2
title
String The community title.
members
Integer The members count in this community.
is_member
Boolean Whether the current user has already joined the community.
description
String The community description.
thumbnail
join_request
Boolean Whether the current user has a pending join request.
is_last_admin
Boolean Whether the current user is the last admin of this community. This property is used when this last admin wants to leave the community, a different dialog is shown to the admin.

Community-Info - Up

community_visibility (optional)
Integer The visiblity of this community for the current user. [0: User can join, 1: User cannot join but can still see the community, 2: User can neither join nor see the community]
Enum:
0
1
2
did (optional)
String Discussion ID (if available).
thumbnail (optional)
String Thumbnail url.
title (optional)
String The community title.
description (optional)
String The community description.
rules (optional)
String The community description.
creator (optional)
String The community creator name.
created (optional)
String The community creation date.
admins (optional)
map[String, Community_Info_admins_value] The community admins (keys are user IDs).
members_count (optional)
Integer The community members count.

Community-Member - Up

uid
Integer The user identifier.
name
String The user name.
mail
String The user E-mail.
memberSince
String The date when the user joined the community.
thumbnail
communityRole
String The community role name.
communityRoleId
String The community role ID.
Enum:
community_admin
community_member
community_moderator

CommunityField - Up

label
type
String Drupal field type or semantic type (e.g. "integer", "uuid", "image", "entity_reference", "created", "boolean").
required
value (optional)
default (optional)

CommunityField_default - Up

url
alt

CommunityField_value - Up

url
alt

CommunityField_value_oneOf_inner - Up

target_id (optional)
target_type (optional)
target_uuid (optional)
url (optional)

CommunityMemberAssignRole - Up

action
Enum:
assignRole
uid
Integer User ID to assign the role to.
role
String Role to assign.
Enum:
community_admin
community_member
community_moderator

CommunityMemberJoin - Up

action
Enum:
join
uid
Integer User ID joining the community.

CommunityMemberLeave - Up

action
Enum:
leave
uid
Integer User ID leaving the community.

CommunityMemberRemove - Up

action
Enum:
remove
uid
Integer User ID to remove from the community.

CommunityNotification - Up

id
label
String Localized notification label.
mandatory
Boolean Whether notification channels are mandatory.
system (optional)
Boolean Current system channel subscription state. Present only when system channel is available.
mail (optional)
Boolean Current mail channel subscription state. Present only when mail channel is available.
push (optional)
Boolean Current push channel subscription state. Present only when push channel is available.

CommunityNotificationPatchItem - Up

id
system (optional)
Boolean Desired system channel subscription state. If omitted, the current system channel state is unchanged.
mail (optional)
Boolean Desired mail channel subscription state. If omitted, the current mail channel state is unchanged.
push (optional)
Boolean Desired push channel subscription state. If omitted, the current push channel state is unchanged.

CommunityNotification_id - Up

Notification identifier.

CommunityUserSettings - Up

community_notifications
array[CommunityNotification] Notification settings for the current user. Additional user-specific community settings may be added as new properties in this object over time.

CommunityUserSettingsPatchRequest - Up

community_notifications
array[CommunityNotificationPatchItem] List of notification setting items to update. Additional user-specific settings payload properties may be supported in the future.

Community_Info_admins_value - Up

name (optional)
String The admin name.
thumbnail (optional)

Component - Up

uuid
type

Concrete-Component - Up

type
title
String The default title.
data
empty
additional_data (optional)

Concrete_Component_additional_data - Up

Any additional data the component wants to offer. It can contain any arbitrary number of subproperties and these can be of any type.
additional_data_1 (optional)
additional_data_2 (optional)

Concrete_Component_additional_data_additional_data_1 - Up

An Example of additional data.

Concrete_Component_additional_data_additional_data_2 - Up

Another example of additional data.

Concrete_Component_data - Up

id
Integer Box identifier
voted
question
choices
total_votes (optional)
cancel_vote_allow (optional)
options
current_option
Integer Current context (Taxonomy term) identifier.
vocabulary
entity_type
Enum:
box
box_type
Enum:
content_box
context_box
linkbox
content
contextual_content
title
box_image
box_link
description
latest (optional)
array[Most-Read-And-Most-Recent-Item] Nodes sorted by most recently published.
most_read (optional)
array[Most-Read-And-Most-Recent-Item] Nodes sorted by most viewed.
search_results
array[Magazine_Category_Filter_Box_search_results_inner] List of article nodes matching the active channel filter.
sub_facets
array[Search-Facet] Available magazine channel filters.
number
String Highlight number shown by the widget.
fact
String Supporting fact text.
link (optional)

Concrete_Component_empty - Up

This property includes what should be displayed when the 'data' property is empty (is null). When 'data' is not empty, then the property 'empty' is null. Currently only the 'text' sub property is available, but there could be other properties in future endpoints.
text (optional)
String The text that should be displayed in case the component doesn't contain any results.

Content - Up

A single Gutenberg block item in the v1 content array.

In v1, every block exposes its content as a rendered HTML string (html) plus a flat set of block-type-specific keys (e.g. description, file_name, url, type, id, gemstone_title) placed directly at the top level alongside block_name and inner_blocks.

block_name
String The gutenberg block name.
html
String The rendered HTML for the gutenberg block.
inner_blocks
array[Content] Array of 'Content' items (circular reference is not yet implemented by swagger).

Content-Box - Up

id
Integer Box identifier
entity_type
Enum:
box
box_type
Enum:
content_box
context_box
linkbox
content

Content-V2 - Up

A single Gutenberg block item in the v2 content array.

Key structural change from v1:

Both versions share the same block_name / inner_blocks envelope and the same recursive nesting model. The piipe/column wrapper block is transparent in v2 — its inner blocks are merged directly into the parent level.

block_name
String The gutenberg block name.
attributes
map[String, oas_any_type_not_mapped] Block-specific data. The shape of this object depends on block_name. Common keys across many block types include text (normalised text content) and url. Block types that embed other entities (e.g. piipe/linked-content-item, piipe/distribution-box-item) include a nested node object exported in the relevant view mode.
inner_blocks
array[Content-V2] Array of 'Content-V2' items (circular reference is not yet implemented by swagger).

Content_Box_allOf_content - Up

title
id
Integer Node identifier.
entity_type
Enum:
node
node_type
Enum:
anniversary_page
content_page
corporate_news
department_page
document
dossier
event
page
list_element
article
magazine_video_article
memorial_page
news
press_review
room
http_error_page
webform
wiki_content
summary
String The node summary.
header_media
children
array[Object] Array of Node-Sitemap-List-View items (circular reference is not yet implemented by swagger)

Context-Box - Up

id
Integer Box identifier
entity_type
Enum:
box
box_type
Enum:
content_box
context_box
linkbox
contextual_content

Context-Reference-Change-Block - Up

options
current_option
Integer Current context (Taxonomy term) identifier.
vocabulary

Context_Box_allOf_contextual_content - Up

vocabulary
context_items

Context_Box_allOf_contextual_content_content - Up

title
id
Integer Node identifier.
entity_type
Enum:
node
node_type
Enum:
anniversary_page
content_page
corporate_news
department_page
document
dossier
event
page
list_element
article
magazine_video_article
memorial_page
news
press_review
room
http_error_page
webform
wiki_content
summary
String The node summary.
header_media
children
array[Object] Array of Node-Sitemap-List-View items (circular reference is not yet implemented by swagger)

Context_Box_allOf_contextual_content_context_items - Up

id
Integer Context (taxonomy term) identifier.
content

Context_Reference_Change_Block_options_inner - Up

id
Integer Taxonomy term idetifier.
option
String The context term name.

Corporate_News_Block_inner - Up

title
id
Integer Node identifier.
entity_type
Enum:
node
node_type
Enum:
anniversary_page
content_page
corporate_news
department_page
document
dossier
event
page
list_element
article
magazine_video_article
memorial_page
news
press_review
room
http_error_page
webform
wiki_content
summary
String The node summary.
header_media

Country-Location-Settings-PATCH - Up

settings_id
String The country/location settings identifier.
Enum:
UserSettingsElementLocation
settings_type
String The vocabulary type.
Enum:
location
country
option_id
Integer The term identifier.

Country-Settings - Up

label
String country settings label.
current_country
Integer The current country (taxonomy term) identifier.
country_options

Country_Settings_country_options_inner - Up

id
Integer The country (taxonomy term) identifier.
name
String The country name.

DeleteAllMessages - Up

action
Enum:
delete_all_messages

DeleteSelectedMessages - Up

action
Enum:
delete_selected_messages
ids

DeleteSingleMessage - Up

action
Enum:
delete_single_message
mid

DocumentResult - Up

id
Integer Node identifier.
entity_type
Enum:
node
node_type
Enum:
document
document_type
String From "Document type" vocabulary. Eg. pdf, Text.
documents
URI The file url. format: uri
links
location
organizational_unit
tags
topic
title
summary
last_updated
String Document last modification date.
excerpt

DocumentResult_links - Up

link_text (optional)
link_type (optional)
Enum:
internal
external
url (optional)
URI format: uri

DocumentResult_location - Up

value (optional)
array[String] Array of strings from "Location" vocabulary.
label (optional)

DocumentResult_organizational_unit - Up

value (optional)
array[String] Array of strings from "Organizational unit" vocabulary.
label (optional)

DocumentResult_tags - Up

value (optional)
array[String] Array of strings from "Tags" vocabulary
label (optional)

DocumentResult_title - Up

is_link (optional)
text (optional)
String Title of the document.

DocumentResult_topic - Up

value (optional)
array[String] Array of strings from "Topic" vocabulary.
label (optional)

DocumentSearch - Up

search_results
sub_facets

DocumentSearch_search_results_inner - Up

id
Integer Node identifier.
entity_type
Enum:
node
node_type
Enum:
document
document_type
String From "Document type" vocabulary. Eg. pdf, Text.
documents
URI The file url. format: uri
links
location
organizational_unit
tags
topic
title
summary
last_updated
String Document last modification date.
excerpt

DocumentSearch_sub_facets - Up

label
String The facet label.
facet_id
String The facet id. (can be used in the query parameter "f" to filter results)
items

Dossier_Widget_inner - Up

title
id
Integer Node identifier.
entity_type
Enum:
node
node_type
Enum:
dossier
header_media
summary

Dynamic-Box-Page - Up

page_type
Enum:
static
dynamic
page_title
page_description
boxes
reorder

Dynamic_Box_Page_allOf_reorder - Up

Reorder settings labels.
button
String Button label.
save_button
String Save button label.
cancel_button
String Cancel button label.
bid
String Box ID label.
title
String Title label.
type
String Type label.
author
String Author label.
changed
String Changed label.
weight
String Weight label.

Employee_Jubilees_inner - Up

id
Integer User identifier.
entity_type
String Entity type.
Enum:
user
user_type
String The user type (currently there is only one user type).
Enum:
user
name
String User display name.
organizational_unit
String The user's organizational unit.
user_picture

Employees - Up

uid
Integer The user identifier.
name
String The user name.
mail
String The user E-mail.
picture
flagged
Boolean True if the user was liked.

Employees-Config - Up

language
String The current user language.
columns
array[Employees_Config_columns_inner] The array of user fields with necessary data.
dropdowns
alphabet_counted
Object The array of letters with their count.
uid
Integer The user identifier.
hierarchical_sorting
array[Employees_Config_hierarchical_sorting_inner] The array of information about click filter.

Employees_Config_columns_inner - Up

frontend_label (optional)
type (optional)
weight (optional)
name (optional)
field_label (optional)
filter (optional)
delete (optional)

Employees_Config_dropdowns_inner - Up

field_location (optional)

Employees_Config_dropdowns_inner_field_location_inner - Up

tid (optional)
label (optional)

Employees_Config_hierarchical_sorting_inner - Up

sorting_field (optional)
click_field (optional)

Entity-Title - Up

title

EntityReferenceItem - Up

target_id (optional)
target_type (optional)
target_uuid (optional)
url (optional)

Entity_Title_title - Up

text
String Entity title.
is_link
Boolean True if the title should be a link to the entity.

Event-Available-Categories - Up

Indicates which tab categories contain at least one result for the current filters.
ongoing
upcoming
past

Event-Bookmark-Request - Up

event_id
Integer Event node ID.

Event-Bookmark-Response - Up

success
message
String Status message indicating whether bookmark was added or removed.
is_bookmarked
Boolean Current bookmark state after the toggle operation.

Event-Category-Reference - Up

Taxonomy term reference for the event category field.
tid (optional)
label (optional)

Event-Date-Parts - Up

Structured date parts for UI display. Present when a start date exists.
start
end (optional)
is_range
Boolean True when start and end fall on different days.

Event-Date-Segment - Up

A single date segment with day and abbreviated month.
day
String Day of the month without leading zero.
month
String Abbreviated month name, locale-aware.

Event-Flat-Response - Up

Response for type=all|my with filter=ongoing|upcoming|past. A single paginated list.
events
has_more
offset
limit
available_categories

Event-Group-Category - Up

Events for one tab category (ongoing, upcoming, or past) in the overview response.
events
total
Integer Always 0; rely on has_more for pagination.
offset
Integer The offset used for this page.
limit
Integer Maximum events returned per request.
has_more
Boolean True when more events are available beyond the current page.

Event-Grouped-Response - Up

Response for type=all|my with filter=overview. Events are split into three tab categories.
grouped
Boolean Always true for overview responses.
ongoing
upcoming
past

Event-Registration-Create-Request - Up

Request payload to register the current user for an event.
note (optional)
String Optional note attached to the registration.

Event-Registration-Delete-Response - Up

success

Event-Registration-Item - Up

A single participant registration row for an event.
uid
name
email
String Email is only populated when the requester can download registrations.
thumbnail (optional)
map[String, oas_any_type_not_mapped] User thumbnail payload from user defaults service.
registeredAt
String Human-readable registration timestamp.
registeredAtTimestamp
Integer Unix timestamp used for sorting.
note
flaggingId

Event-Registration-Upsert-Response - Up

Response returned when creating a registration or when it already exists.
alreadyRegistered
Boolean True if a registration already existed for the current user.
flaggingId
Integer Flagging entity ID representing the registration.

Event-Registrations-Response - Up

Registration list and capability flags for an event.
registrations
canDownload
Boolean Whether the current user can download registrations as CSV.
canDelete
Boolean Whether the current user can remove registrations.
total
Integer Number of registrations returned.

Event-Resource-Item - Up

A single event card as returned by the event resource endpoint.
id
Integer Node ID.
title
start_date (optional)
Date ISO 8601 local datetime (no timezone suffix). format: date-time
end_date (optional)
Date format: date-time
date_parts (optional)
formatted_date_time (optional)
String Human-readable, locale-aware date/time interval.
url
String Relative path to the event detail page.
summary (optional)
String Truncated plain-text summary (max 120 chars).
location (optional)
image_url (optional)
String Relative URL of the image styled at boxes_16_9.
event_type (optional)
String Name of the event type taxonomy term.
event_category (optional)
is_bookmarked (optional)
Boolean Whether the current user has bookmarked this event.
is_all_day (optional)
Boolean True for full-day events or events running 00:00–23:59.
registration_status (optional)
String registered when the current user is registered, otherwise null.
Enum:
registered

Event-Settings-Response - Up

Response for type=settings. Contains display configuration for the event module.
title
String Page title, translated to the current interface language.
description
String Introductory description, translated to the current interface language.
my_events_tab
Boolean Whether the My Events tab is enabled site-wide.
can_create_events
Boolean Whether the current user has the create event content permission.
enable_calendar_view
Boolean Whether the calendar view toggle is enabled.
default_view_mode
Enum:
grid
list
eventsPerPage
placeholderImage
String Relative path to the fallback placeholder image.
category_colors
map[String, Event_Settings_Response_category_colors_value] Map of category term IDs to their configured color and label.
default_category_color (optional)
String Fallback hex color for categories without an explicit color.
visible_tabs
hide_image
Boolean True when the header image field is disabled in the event_card view display.
hide_summary
Boolean True when the summary field is disabled in the event_card view display.

Event-Term-Option - Up

A selectable filter option for event type or event category dropdowns.
value
label
vocabulary (optional)
String Taxonomy vocabulary machine name. Only present on non-"all" options.

Event_Settings_Response_category_colors_value - Up

color (optional)
label (optional)

Event_Settings_Response_visible_tabs - Up

Which filter tabs are enabled in the admin configuration.
overview (optional)
ongoing (optional)
upcoming (optional)
past (optional)

Event_Term_Option_value - Up

Term ID, or "all" for the catch-all entry.

Events-Page - Up

title
String Title to the events page
description
String Description of the events page
ongoing
upcoming
expired

File - Up

id
Integer The media identifier.
entity_type
String The entity type.
Enum:
media
media_type
String The media type.
Enum:
video
remote_video
remote_video_url
audio
document
file
URI The file url. format: uri
type
String The media type (redundent to media_type).
Enum:
video
remote_video
audio
document
thumbnail_url (optional)
URI The file thumbnail url. format: uri
media_video_file (optional)
URI The video url (this attribute is the same as 'file' and is present only for backwards compatiblity). format: uri
transcript (optional)
String The video or audio transcript text.
subtitles_url (optional)
URI The subtitles file. "vtt" is the only supported format. format: uri
subtitle_language (optional)
String the subtitles language code.
Enum:
en
de

Flag-Status - Up

flag_id
String The flag ID.
entity_type
String The entity type.
entity_id
Integer The entity ID.
flagged
Boolean The entity's flag status (flagged/unflagged).
count
Integer The amount of users who flagged the entity.

Frontpage-component-types - Up

A name that identifies the component.

Header-Media - Up

id
Integer The media identifier.
entity_type
String The entity type.
Enum:
media
media_type
String The media type.
Enum:
video
remote_video
remote_video_url
audio
document
file
URI The file url. format: uri
description (optional)
String The image description.
owner (optional)
String The image owner
source (optional)
type
String The media type.
Enum:
image
video
remote_video
audio
document
thumbnail_url (optional)
URI The file thumbnail url. format: uri
media_video_file (optional)
URI The video url (this attribute is the same as 'file' and is present only for backwards compatiblity). format: uri
transcript (optional)
String The video or audio transcript text.
subtitles_url (optional)
URI The subtitles file. "vtt" is the only supported format. format: uri
subtitle_language (optional)
String the subtitles language code.
Enum:
en
de

Header-Media-Base - Up

id
Integer The media identifier.
entity_type
String The entity type.
Enum:
media

Highlight_Widget_Magazine_inner - Up

title
id
Integer Node identifier.
entity_type
Enum:
node
node_type
Enum:
article
summary
String The node summary.
header_media

Image - Up

id
Integer The media identifier.
entity_type
String The entity type.
Enum:
media
media_type
String The media type.
Enum:
image
file
description (optional)
String The image description.
owner (optional)
String The image owner
source (optional)
type
String The media type.
Enum:
image

ImageValue - Up

url
alt

Language-Settings - Up

label
String Language settings label.
current_language
language_options

Language-Settings-PATCH - Up

settings_id
String The language settings identifier.
Enum:
UserSettingsElementLanguage
id
String The language identifier.

Language_Settings_language_options_inner - Up

id
name
String Language name.

Link - Up

link_text
String a link text that is clickable. If url_text property is not null, then this will act as a title for the link (not clickable).
url_text
String if this property is not null, this text will act as a clickable link.
url
URI Link url. If this property is null, that means the link_text property will be the url, but it will not be clickable. format: uri
link_type (optional)

Link-Box - Up

id
Integer Box identifier
entity_type
Enum:
box
box_type
Enum:
content_box
context_box
linkbox
title
box_image
box_link
description

Link-Box-List - Up

id
Integer Box identifier
entity_type
Enum:
box
box_type
Enum:
content_box
context_box
linkbox
title
box_link

Link-Type - Up

The link type.

Location-Settings - Up

label
String location settings label.
current_location
Integer The current location (taxonomy term) identifier.
location_options

Location_Settings_location_options_inner - Up

id
Integer The location (taxonomy term) identifier.
name
String The location name.

Login - Up

user
Object The logged in user.
tfa_skips_allowed (optional)
Integer Remaining number of login skips allowed before TFA setup is required. This property is only present when TFA is enabled and the user has not yet completed the second factor setup.
csrf_token
String A csrf token (This property is deprecated and will be an empty string. To create a new session and acquire a csrf token, use /user_session endpoint).
logout_token
String A logout token (This property is deprecated and will be an empty string. To create a new session and acquire a logout token, use /user_session endpoint).
jwt_token
String A jwt token to authorize resource requests.
access_token
String A jwt token to authorize resource requests (it has the exact same value as jwt_token, but the property was introduced for compatibility reasons, and jwt_token is planned for deprecation in the future).
refresh_token
String A jwt refresh token to generate new access tokens.

Login-Check - Up

result (optional)
Boolean User is already logged in
user (optional)
Object The logged in user.

Magazine-Category-Filter-Box - Up

Results can be filtered by passing a facet item_id to the query parameter 'field_magazine_channel' on the /frontpage/{uuid} or /magazine/{uuid} endpoints. (This component includes two additional properties called 'header' and 'footer' in the parent scheme 'Concrete-Component' inside the property called 'additional_data'.)
search_results
array[Magazine_Category_Filter_Box_search_results_inner] List of article nodes matching the active channel filter.
sub_facets
array[Search-Facet] Available magazine channel filters.

Magazine-Facts-And-Figures-Link - Up

text
String Link label.
link_type
route_name (optional)
String Drupal route name for internal links.
url (optional)
URI Absolute URL for external links. format: uri

Magazine-Facts-And-Figures-Widget - Up

(This component includes two additional properties called 'header' and 'footer' in the parent scheme 'Concrete-Component' inside the property called 'additional_data'. These properties are of type strings and include any html that should be displayed in the header or footer areas of the component.)
number
String Highlight number shown by the widget.
fact
String Supporting fact text.
link (optional)

Magazine_Category_Filter_Box_search_results_inner - Up

title
id
Integer Node identifier.
entity_type
Enum:
node
node_type
Enum:
article
summary
String The node summary.
header_media
magazine_channel
String The magazine channel.
published_at
String Publish date.
hearts_count
Integer The number of hearts this article has received.

Magazine_Collage_Widget_inner - Up

title
id
Integer Node identifier.
entity_type
Enum:
node
node_type
Enum:
article
summary
String The node summary.
header_media
magazine_channel
String The magazine channel.
hearts_count
Integer Number of hearts this article has received.
views_count
Integer Total view count for this article.

Magazine_Contact_Person_Widget_inner - Up

id
Integer User identifier.
entity_type
String Entity type.
Enum:
user
user_type
String The user type (currently there is only one user type).
Enum:
user
user_picture
name
department

MarkReadAllMessages - Up

action
Enum:
mark_read_all_messages

MarkReadMessages - Up

action
Enum:
mark_read_messages
ids

MarkSingleMessage - Up

action
Enum:
mark_single_message
mid

MarkUnreadAllMessages - Up

action
Enum:
mark_unread_all_messages

Mention-User - Up

name (optional)
String User display name.
id (optional)
String Identifier for mention ("@" + display name)
userId (optional)
link (optional)
String Link to user.

Mention_User_userId_inner - Up

value (optional)

Menu-Link - Up

title
String The menu label.
link_type
link
String The mune link url.
icon_id
String The icon identifier if the menu item has one.
route_name (optional)
String The route name identifier as defined by Drupal.
subtree

Most-Read-And-Most-Recent - Up

(This component includes two additional properties called 'header' and 'footer' in the parent scheme 'Concrete-Component' inside the property called 'additional_data'. The 'data' property is an object whose keys are the active sort types. Each value is an array of node items.)
latest (optional)
array[Most-Read-And-Most-Recent-Item] Nodes sorted by most recently published.
most_read (optional)
array[Most-Read-And-Most-Recent-Item] Nodes sorted by most viewed.

Most-Read-And-Most-Recent-Item - Up

title
id
Integer Node identifier.
entity_type
Enum:
node
node_type
Enum:
anniversary_page
content_page
corporate_news
department_page
document
dossier
event
page
list_element
article
magazine_video_article
memorial_page
news
press_review
room
http_error_page
webform
wiki_content
summary
String Node summary.
published_at
String Publish date.
views_count
Integer Total number of views for this node.
kicker
String The node kicker.

Most-Read-Magazine-2-Item - Up

title
id
Integer Node identifier.
entity_type
Enum:
node
node_type
Enum:
article
created
String Node creation date.
summary
String The node summary.

My-Page-Settings - Up

label
String The title field label.
my_page_title
String The current choosen title.
save_button
String The save button label.
delete_all_button
String The delete all button label.

My-Page-Settings-PATCH - Up

settings_id
String The language settings identifier.
Enum:
UserSettingsElementMyPage
action
String The action to perform.
Enum:
save
delete_all
my_page_title (optional)
String The new name of "My Page". (This property is required only when the action is "save")

My_Content_Widget_inner - Up

title
id
Integer Node identifier.
entity_type
Enum:
node
node_type
Enum:
anniversary_page
content_page
corporate_news
department_page
document
dossier
event
page
list_element
article
magazine_video_article
memorial_page
news
press_review
room
http_error_page
webform
wiki_content
marker
String A marker that indicates if a content is new, updated or read.
Enum:
read
new
updated
marker_string
String The marker string that should be displayed.
type
String The content type.
terms
array[Term] A list of terms that categorizes this content.

New-Colleagues-Item - Up

id
Integer User identifier.
entity_type
String Entity type.
Enum:
user
user_type
String The user type (currently there is only one user type).
Enum:
user
department (optional)
String Person department.
organizational_unit
String Person organizational unit.
location (optional)
String Person location.
name
String Person name.
employed_since
String Date of employment.
user_picture

New_Colleagues_inner - Up

id
Integer User identifier.
entity_type
String Entity type.
Enum:
user
user_type
String The user type (currently there is only one user type).
Enum:
user
department (optional)
String Person department.
organizational_unit (optional)
String Person organizational unit.
location (optional)
String Person location.
firstname
String Person first name.
lastname
String Person last name.
title
String Person title.
user_picture

New_Employees_Block_inner - Up

node_type
Enum:
anniversary_page
content_page
corporate_news
department_page
document
dossier
event
page
list_element
article
magazine_video_article
memorial_page
news
press_review
room
http_error_page
webform
wiki_content
entity_type
Enum:
node
user_image
user_name
String The user full name.
user_organizational_unit
String The user organizational unit.

News-Mandatory-And-Subscribed-Block - Up

News-Menu-Item - Up

label
String The news menu item label.
id
String The news page identifier.
Enum:
news
corporate_news
my_news
mandatory_news

News-Page - Up

news
news_channel_filter
array[News_Page_news_channel_filter_inner] Filter the news pages based on the news channel.

News_Block_inner - Up

title
id
Integer Node identifier.
entity_type
Enum:
node
node_type
Enum:
news
news_channel
summary
published_at
String A publish date

News_Page_news_channel_filter_inner - Up

id
Integer News channel (term) id.
name
String News channel name.

Node-Base - Up

title
id
Integer Node identifier.
entity_type
Enum:
node

Node-Base-Extended - Up

title
id
Integer Node identifier.
entity_type
Enum:
node
node_type
Enum:
anniversary_page
content_page
corporate_news
department_page
document
dossier
event
page
list_element
article
magazine_video_article
memorial_page
news
press_review
room
http_error_page
webform
wiki_content

Node-Box-View - Up

title
id
Integer Node identifier.
entity_type
Enum:
node
node_type
Enum:
anniversary_page
content_page
corporate_news
department_page
document
dossier
event
page
list_element
article
magazine_video_article
memorial_page
news
press_review
room
http_error_page
webform
wiki_content
summary
String The node summary.
header_media

Node-Default - Up

title
id
Integer Node identifier.
entity_type
Enum:
node
node_type
Enum:
anniversary_page
content_page
corporate_news
department_page
document
dossier
event
page
list_element
article
magazine_video_article
memorial_page
news
press_review
room
http_error_page
webform
wiki_content
authored_by
kicker
String The node kicker.
summary
String The node summary.
header_media
content
array[Node_Default_allOf_content]

Array of Gutenberg blocks that make up the node body.

The item structure differs by API version:

  • v1 — each item follows the Content schema: a top-level html field holds rendered HTML and block-specific keys are spread flat alongside block_name and inner_blocks.
  • v2 — each item follows the Content-V2 schema: the html field is removed and all block-specific data is consolidated into a single attributes object.
my_page_button

Node-Event-Widget - Up

title
id
Integer Node identifier.
entity_type
Enum:
node
node_type (optional)
Enum:
event
event_start_date_full
String Start full date.
event_date_month
String Event month part.
event_date_day
String Event day part.

Node-Events-Box-View - Up

title
id
Integer Node identifier.
entity_type
Enum:
node
node_type
Enum:
corporate_news
news
header_media
summary
String The node summary.
kicker (optional)
String The node kicker.
event_start_date_full (optional)
String Start date.
event_date_month (optional)
String Month of the date.
event_date_day (optional)
String Day of the date.

Node-News-Box-View - Up

title
id
Integer Node identifier.
entity_type
Enum:
node
node_type
Enum:
corporate_news
news
corporate_news_channel (optional)
String Corporate news channel.
news_channel (optional)
String News channel.
header_media
summary
String The node summary.
published_at
String Publish date.

Node-Sitemap-List-View - Up

title
id
Integer Node identifier.
entity_type
Enum:
node
node_type
Enum:
anniversary_page
content_page
corporate_news
department_page
document
dossier
event
page
list_element
article
magazine_video_article
memorial_page
news
press_review
room
http_error_page
webform
wiki_content
children
array[Object] Array of Node-Sitemap-List-View items (circular reference is not yet implemented by swagger)

Node-Slider - Up

title
id
Integer Node identifier.
entity_type
Enum:
node
node_type
Enum:
anniversary_page
content_page
corporate_news
department_page
document
dossier
event
page
list_element
article
magazine_video_article
memorial_page
news
press_review
room
http_error_page
webform
wiki_content
summary
String The node summary.
kicker
String The node kicker.
header_media

Node-Teaser - Up

title
id
Integer Node identifier.
entity_type
Enum:
node
node_type
Enum:
anniversary_page
content_page
corporate_news
department_page
document
dossier
event
page
list_element
article
magazine_video_article
memorial_page
news
press_review
room
http_error_page
webform
wiki_content
summary
String The node summary.
header_media
published_at (optional)
String Publish date.
magazine_channel (optional)
String Magazine channel.

Node-Type - Up

node_type
Enum:
anniversary_page
content_page
corporate_news
department_page
document
dossier
event
page
list_element
article
magazine_video_article
memorial_page
news
press_review
room
http_error_page
webform
wiki_content

Node-View-Mode - Up

title
id
Integer Node identifier.
entity_type
Enum:
node
node_type
Enum:
event
authored_by
kicker
String The node kicker.
summary
String The node summary.
header_media
content
array[Node_Default_allOf_content]

Array of Gutenberg blocks that make up the node body.

The item structure differs by API version:

  • v1 — each item follows the Content schema: a top-level html field holds rendered HTML and block-specific keys are spread flat alongside block_name and inner_blocks.
  • v2 — each item follows the Content-V2 schema: the html field is removed and all block-specific data is consolidated into a single attributes object.
my_page_button
corporate_news_channel (optional)
String Corporate news channel.
news_channel (optional)
String News channel.
published_at
String Publish date.
children
array[Object] Array of Node-Sitemap-List-View items (circular reference is not yet implemented by swagger)
event_start_date_full
String Start full date.
event_date_month
String Event month part.
event_date_day
String Event day part.

Node_Base_allOf_title - Up

text (optional)

Node_Default_allOf_content - Up

block_name
String The gutenberg block name.
html
String The rendered HTML for the gutenberg block.
inner_blocks
array[Content-V2] Array of 'Content-V2' items (circular reference is not yet implemented by swagger).
attributes
map[String, oas_any_type_not_mapped] Block-specific data. The shape of this object depends on block_name. Common keys across many block types include text (normalised text content) and url. Block types that embed other entities (e.g. piipe/linked-content-item, piipe/distribution-box-item) include a nested node object exported in the relevant view mode.

Node_Default_allOf_my_page_button - Up

active
Boolean True if the button is displayed and the node can be added to "my page".
status (optional)
Boolean True if the node was already added to "my page"
id (optional)
Integer The box identifier, that contains the node.
text (optional)
String The button label.

Notification - Up

mid
Integer The notification (message) id.
type
String The notification type.
Enum:
content_creation
social_reaction
reply_comment
comment
content_versioning_reminder
status
Boolean Whether the notification was read.
referenced_entity_id
Integer The entity id which the notification references.
referenced_entity_type
String The entity type which the notification references (currently only nodes).
Enum:
node
time
String The time on which the notification was posted.
info
String The notification message (includes HTML).
text
String The notification message (without HTML).
description (optional)
String Additional description or summary of the notification content.
image_url (optional)
String URL of an image associated with the notification, if available.
additional_data

Notification-Additional-Data - Up

Additional metadata for the notification message. The set of keys depends on the notification template and available referenced entities. Route names are exposed as numbered flat keys (route_1, route_2, route_3, …) — one per link found in the rendered notification text, in document order. The number of route keys is variable and unbounded.
notification_type
String Message template machine name.
route_1 (optional)
String Route name of the first link found in the rendered notification text.
route_2 (optional)
String Route name of the second link found in the rendered notification text. Further links produce route_3, route_4, etc.
node_id (optional)
String Referenced node ID (legacy compatibility key).
user_id (optional)
String Referenced user ID (legacy compatibility key).
comment_id (optional)
String Referenced comment ID (legacy compatibility key).
commented_entity_type (optional)
String Comment host entity type (legacy compatibility key).
commented_entity_id (optional)
String Comment host entity ID (legacy compatibility key).
linked_entity_id (optional)
String Referenced linked entity ID (legacy compatibility key).

Notifications-Settings - Up

header
notifications

Notifications-Settings-PATCH - Up

settings_id
String The notification settings identifier.
Enum:
UserSettingsElementNotifications:subscriptionsplugin:notifications
id
Integer The notification identifier.
type
String The type of notification subscription.
Enum:
mail
system
push

Notifications_Settings_header - Up

mail
String The mail column label.
system
String The system column label.
push (optional)
String The push column label. Present only when push notifications are available.

Notifications_Settings_notifications_inner - Up

label
String The notification name
id
Integer The notification identifier.
mandatory
Boolean Whether the notification subscription is mandatory.
mail
Boolean Whether the user wants to be notified through email.
system
Boolean Whether the user wants to be notified through the system.
push (optional)
Boolean Whether the user wants to be notified through push. Present only when push notifications are available.

Person-Widget-Item - Up

id
Integer Term ID.
entity_type
Enum:
taxonomy_term
taxonomy_term_type
Enum:
person
firstname
String First name of the person.
lastname
String Last name of the person.
description (optional)
String Short biography or description.
titel (optional)
String Academic or honorary title.
person_position (optional)
String Job position or role of the person.
person_image (optional)

Picture-Gallery-Post - Up

author (optional)
flag (optional)
hashtags (optional)
title (optional)
description (optional)
date (optional)
url (optional)
String The post image url.
id (optional)
String The post ID.
permissions (optional)

Picture_Gallery_Post_author - Up

name (optional)
langcode (optional)
String User's country.
picture (optional)

Picture_Gallery_Post_author_picture - Up

User profile image.
url (optional)
alt (optional)

Picture_Gallery_Post_flag - Up

like_count (optional)
like_flagged (optional)
Boolean Whether the current user has liked the post.
rock_count (optional)
rock_flagged (optional)
Boolean Whether the current user has rocked the post.
heart_count (optional)
heart_flagged (optional)
Boolean Whether the current user has hearted the post.

Picture_Gallery_Post_hashtags_inner - Up

id (optional)
name (optional)

Picture_Gallery_Post_permissions - Up

Whether the user is able to delete or edit the post.
delete (optional)
edit (optional)

Poll-Block - Up

id
voted
question
choices
total_votes (optional)
cancel_vote_allow (optional)

Poll_Block_choices_inner - Up

id
text
vote_count (optional)
vote_percentage (optional)

Press_Article_Widget_inner - Up

title
id
Integer Node identifier.
entity_type
Enum:
node
node_type
Enum:
press_article
links
press_categories
summary
String Press article summary.
published_at
String Publish date.

Press_Article_Widget_inner_allOf_press_categories - Up

id
Integer Term ID.
entity_type
Enum:
taxonomy_term
taxonomy_term_type
String Taxonomy term type.
image (optional)
Object Category image payload when available.

RoomResult - Up

id
entity_type
node_type
header_media
location
number_of_seats
title
last_updated
date format: date
excerpt

RoomResult_location_inner - Up

id (optional)
text (optional)

RoomResult_number_of_seats - Up

value (optional)
label (optional)

RoomResult_title - Up

is_link (optional)
text (optional)

RoomSearch - Up

search_results
sub_facets

Search - Up

search_results
result_count
Integer Total search results count.
main_facet
sub_facets

Search-Facet - Up

label
String The facet label.
facet_id
String The facet id. (can be used in the query parameter "f" to filter results)
items

Search-Result-Excerpt - Up

excerpt
String The parts of content text, where the search term appears in.

Search-Result-Node - Up

node_type
Enum:
anniversary_page
content_page
corporate_news
department_page
document
dossier
event
page
list_element
article
magazine_video_article
memorial_page
news
press_review
room
http_error_page
webform
wiki_content
excerpt
String The parts of content text, where the search term appears in.
node_type_label
String The node type label.
id
Integer Node identifier.
title
String Node title.
entity_type
Enum:
node
published_at
String The node publishing date.

Search-Result-User - Up

id
Integer User identifier.
entity_type
String Entity type.
Enum:
user
user_type
String The user type (currently there is only one user type).
Enum:
user
excerpt
String The parts of content text, where the search term appears in.
organizational_unit
String Person organizational unit.
location
String Person location.
position
String Person position.
name
String Person name.
room
String Person room name.
user_picture

Search_Facet_items_inner - Up

item_id
label
String The facet item label.
count
Integer The amount of content found that reference this facet item.

Search_Facet_items_inner_item_id - Up

The facet item id. (can be used in the query parameter "f" to filter results)

Search_main_facet - Up

label
facet_id
Enum:
type
items

Search_search_results_inner - Up

node_type
Enum:
anniversary_page
content_page
corporate_news
department_page
document
dossier
event
page
list_element
article
magazine_video_article
memorial_page
news
press_review
room
http_error_page
webform
wiki_content
excerpt
String The parts of content text, where the search term appears in.
node_type_label
String The node type label.
id
Integer User identifier.
title
String Node title.
entity_type
String Entity type.
Enum:
user
published_at
String The node publishing date.
user_type
String The user type (currently there is only one user type).
Enum:
user
organizational_unit
String Person organizational unit.
location
String Person location.
position
String Person position.
name
String Person name.
room
String Person room name.
user_picture

Search_sub_facets - Up

Facets specific to the chosen type in the main_facet property. Some types don't have any facets, so this property can by empty.
label
String The facet label.
facet_id
String The facet id. (can be used in the query parameter "f" to filter results)
items

Section - Up

title
background_color
String Section background hex color if available.
components

Simple-Image - Up

alt
url
URI format: uri

Social-Icons - Up

like
heart
rocks
comments
views

Social_Icons_comments - Up

count
Integer The comments count of a node.

Social_Icons_heart - Up

flag_id
Enum:
content_flag_heart
entity_type
String The entity type.
entity_id
Integer The entity ID.
flagged
Boolean The entity's flag status (flagged/unflagged).
count
Integer The amount of users who flagged the entity.

Social_Icons_like - Up

flag_id
Enum:
content_flag_like
entity_type
String The entity type.
entity_id
Integer The entity ID.
flagged
Boolean The entity's flag status (flagged/unflagged).
count
Integer The amount of users who flagged the entity.

Social_Icons_rocks - Up

flag_id
Enum:
content_flag_rocks
entity_type
String The entity type.
entity_id
Integer The entity ID.
flagged
Boolean The entity's flag status (flagged/unflagged).
count
Integer The amount of users who flagged the entity.

Social_Icons_views - Up

count
Integer The amount of users who viewed the node.

Static-Box-Page - Up

page_type
Enum:
static
dynamic
page_title
page_description
categories
uncategorized

Static_Box_Page_allOf_categories - Up

name
boxes

Status-Message-Time-Settings - Up

status_message_time
Integer The current set amount of milliseconds.
options
map[String, String] Mapping from available milliseconds options to their text reperesentation.

Status-Message-Time-Settings-PATCH - Up

settings_id
String The notification settings identifier.
Enum:
userSettingsElementStatusMessageTimeSelect
status_message_time
Integer Amount of milliseconds to set.

Subscriptions-Settings-PATCH - Up

settings_id
String The subscription settings identifier.
Enum:
UserSettingsElementTaxonomy:subscriptionsplugin:taxonomy:TAXONOMY_TERM
id
Integer The subscription identifier.

Subscriptions_Settings_inner - Up

label
String Subsribtion label.
id
Integer The subscribtion (taxonomy term) identifier.
checked
Boolean Flag whether the subsribtion is activated.
mandatory
Boolean Flag whether the subsription is mandatory and cannot be altered.

Taxonomy-Term - Up

id
Integer Term ID.
entity_type
Enum:
taxonomy_term
taxonomy_term_type
String Taxonomy term type.
name
String The term name.

Taxonomy-Term-Base - Up

id
Integer Term ID.
entity_type
Enum:
taxonomy_term
taxonomy_term_type
String Taxonomy term type.

Term - Up

id
Integer Taxonomy term identifier (link).
text

Thread-Trace-Response - Up

threads (optional)
cids (optional)
map[String, array[Integer]] A mapping of comment IDs to their answers IDs, resulting in a tree structure.

Thumbnail - Up

id
Integer Media identifier.
entity_type
Enum:
media
media_type
Enum:
image
thumbnail

Toolbar-Custom-Item - Up

id
Integer The custom toolbar item id.
uid
Integer The user id who created this toolbar item.
weight
Integer A weight to determine the item position in the toolbar.
status
Integer Status of the custom toolbar item.
Enum:
0
1
name
String The displayed name.
parent
String ID of the parent item, used to form the toolbar in a tree structure. The ID could be a machine name of a default toolbar item, or a numeric ID of a custom toolbar item.
type
String The custom toolbar type.
Enum:
link
folder
payload
String The custom toolbar item data. This data is in form of a serialized JSON object, and it differs depending on the 'type' property: Type 'folder' has an empty array as its payload data "[]", and the type 'link' has payload data as described in the schema 'Toolbar-Custom-Item-Link-Payload'.

Toolbar-Custom-Item-Link-Payload - Up

path
URI The link URI. format: uri
new_tab (optional)
Integer Whether to open the link in a new tab.
Enum:
0
1

Toolbar-Item-Base - Up

The base of a toolbar item.
name
String The displayed name.
weight
Integer A weight to determine the item position in the toolbar.
parent
String Machine name of the parent item, used to form the toolbar in a tree structure.
depth
Integer The item's level in the tree structure.
machine_name
String The machine name.
type
String The item type. It can be one of the following: [link, dictionary, section, subsection]
payload
String The item data. This data is in form of a serialized JSON object, and it differs depending on the 'type' property: Types 'section' and 'subsection' have an empty array as their payload data "[]", and the types 'link' and 'dictionary' have payload data as described in the schemas 'Toolbar-Item-Link-Payload' and 'Toolbar-Item-Dictionary-Payload' respectively.
user_disable
Integer Whether the user can disable the item from the settings.
Enum:
0
1

Toolbar-Item-Dictionary - Up

name
String The displayed name.
weight
Integer A weight to determine the item position in the toolbar.
parent
String Machine name of the parent item, used to form the toolbar in a tree structure.
depth
Integer The item's level in the tree structure.
machine_name
String The machine name.
type
Enum:
dictionary
payload
oas_any_type_not_mapped Dictionary item data in form of a serialized JSON object. See the schema "Toolbar-Item-Dictionary-Payload".
user_disable
Integer Whether the user can disable the item from the settings.
Enum:
0
1

Toolbar-Item-Dictionary-Payload - Up

dictionaries
map[String, String] The available dictioneries. This object consists of keys and values (associative array, mapping or dictionary). The keys are the name of dictionaries and values are either the same dictionary name or 0 for disabled. For example {"google": "google"} means the google dictionary is enabled, while {"google": 0} means it's disabled. Dictionaries names can be seen in the enum.
Enum:
default_service
String The default selected dictionary to be used.
deepl_endpoint
URI The DeepL endpoint to be used to make translation requests. format: URI
DICTIONARY_languages
map[String, String] Language codes that are supported in DICTIONARY, where DICTIONARY is one of the dictionary names defined in the property "dictionaries". For example {"en": "en"}
default_DICTIONARY_source_lang
String The default selected source language code for DICTIONARY, where DICTIONARY is one of the dictionary names defined in the property "dictionaries".
default_DICTIONARY_target_lang
String The default selected target language code for DICTIONARY, where DICTIONARY is one of the dictionary names defined in the property "dictionaries".

Toolbar-Item-Link - Up

name
String The displayed name.
weight
Integer A weight to determine the item position in the toolbar.
parent
String Machine name of the parent item, used to form the toolbar in a tree structure.
depth
Integer The item's level in the tree structure.
machine_name
String The machine name.
type
Enum:
link
payload
oas_any_type_not_mapped Link configuration data in form of a serialized JSON object. See the schema "Toolbar-Item-Link-Payload".
user_disable
Integer Whether the user can disable the item from the settings.
Enum:
0
1

Toolbar-Item-Link-Payload - Up

path
URI The link URI format: uri
icon (optional)
Integer The icon ID
new_tab (optional)
Integer Whether the link should be opened in a new tab.
Enum:
0
1
context (optional)
String (currently not functional)
sensitive_link (optional)
Integer Whether the link contains sensitive information.
Enum:
0
1
confirm_question (optional)
String The confirmation question to be displayed before opening a sensitive link.

Toolbar-Item-Section - Up

name
String The displayed name.
weight
Integer A weight to determine the item position in the toolbar.
parent
String Machine name of the parent item, used to form the toolbar in a tree structure.
depth
Integer The item's level in the tree structure.
machine_name
String The machine name.
type
Enum:
section
payload
user_disable
Integer Whether the user can disable the item from the settings.
Enum:
0
1
icons_only
Integer Whether items should only use their assigned icons.
Enum:
0
1
subsections_expanded
Integer Whether the subsections have the expanded state.
Enum:
0
1
section_expanded
Integer Whether the section has the expanded state.
Enum:
0
1
lead_only
Integer Whether the section can only be viewed by team leaders / managers.
Enum:
0
1

Toolbar-Item-Section-Base - Up

name
String The displayed name.
weight
Integer A weight to determine the item position in the toolbar.
parent
String Machine name of the parent item, used to form the toolbar in a tree structure.
depth
Integer The item's level in the tree structure.
machine_name
String The machine name.
type
String The item type. It can be one of the following: [link, dictionary, section, subsection]
payload
user_disable
Integer Whether the user can disable the item from the settings.
Enum:
0
1
icons_only
Integer Whether items should only use their assigned icons.
Enum:
0
1
subsections_expanded
Integer Whether the subsections have the expanded state.
Enum:
0
1
section_expanded
Integer Whether the section has the expanded state.
Enum:
0
1
lead_only
Integer Whether the section can only be viewed by team leaders / managers.
Enum:
0
1

Toolbar-Item-Subsection - Up

name
String The displayed name.
weight
Integer A weight to determine the item position in the toolbar.
parent
String Machine name of the parent item, used to form the toolbar in a tree structure.
depth
Integer The item's level in the tree structure.
machine_name
String The machine name.
type
Enum:
subsection
payload
user_disable
Integer Whether the user can disable the item from the settings.
Enum:
0
1
icons_only
Integer Whether items should only use their assigned icons.
Enum:
0
1
subsections_expanded
Integer Whether the subsections have the expanded state.
Enum:
0
1
section_expanded
Integer Whether the section has the expanded state.
Enum:
0
1
lead_only
Integer Whether the section can only be viewed by team leaders / managers.
Enum:
0
1

Toolbar-Settings-Object - Up

id
Integer The toolbar settings item ID.
machine_name
String The machine name of a default toolbar item, which its settings should be overriden.
uid
Integer The user ID who added the settings item.
weight
Integer A weight to determine the item position.
status
Integer Whether to show or hide the default toolbar item.
Enum:
0
1
selection
String Settings data for certain toolbar items. This data is in form of a serialized JSON object, and it differs depending on the toolbar item type: Type 'dictionary' has settings data as described in the schema 'Toolbar-Settings-Object-Dictionary'. Other toolbar item types have an empty array as their settings data "[]"

Toolbar-Settings-Object-Dictionary - Up

langFrom
String The source language code selected by the user.
langTo
String The target language code selected by the user.
service
String The dictionary to override its settings.

Toolbar_Default_Items_value - Up

name
String The displayed name.
weight
Integer A weight to determine the item position in the toolbar.
parent
String Machine name of the parent item, used to form the toolbar in a tree structure.
depth
Integer The item's level in the tree structure.
machine_name
String The machine name.
type
Enum:
section
subsection
link
dictionary
payload
oas_any_type_not_mapped Dictionary item data in form of a serialized JSON object. See the schema "Toolbar-Item-Dictionary-Payload".
user_disable
Integer Whether the user can disable the item from the settings.
Enum:
0
1
icons_only
Integer Whether items should only use their assigned icons.
Enum:
0
1
subsections_expanded
Integer Whether the subsections have the expanded state.
Enum:
0
1
section_expanded
Integer Whether the section has the expanded state.
Enum:
0
1
lead_only
Integer Whether the section can only be viewed by team leaders / managers.
Enum:
0
1

UpdateMessageStatus - Up

action
Enum:
update_message_status
mid
status

Upload-Completed - Up

is_last (optional)
Boolean If true, this was the last chunk, and the whole file was uploaded successfully.
url (optional)
String URL of the uploaded file.
type (optional)
String Uploaded file type.
file_name (optional)
String Generated file name.

Upload-In-Progress - Up

is_last (optional)
Boolean If false, send the next chunk.

User-Base - Up

id
Integer User identifier.
entity_type
String Entity type.
Enum:
user
user_type
String The user type (currently there is only one user type).
Enum:
user

User-Code-Register-Validation-Error - Up

Validation error payload returned when user entity validation fails during code registration.
message
errors
map[String, String] Map of violating property paths to plain-text error messages.

User-Profile-Details - Up

username
own_page
Boolean Whether the authenticated user is viewing their own profile.

User-Profile-Edit-Field - Up

A profile field as returned by the edit endpoint GET. Extends the base field definition with edit-specific properties: private, required, and optionally placeholder and title_required.

Note on options format: for entity_reference (taxonomy) fields, options is an array of { value, label } objects ordered by weight then name. For list_string and language reference fields it is a keyed object (ID → label) as in User-Profile-Field-Base.

label
private_for_others (optional)
Boolean Whether this field is marked as private when viewed by others.
edit (optional)
String '1' if the field is editable.
hide (optional)
String '1' if the field should be hidden on the profile page.
protocol_type (optional)
taxonomy_link (optional)
String '1' if the field value should link to its taxonomy term page.
weight
type
String The Drupal field type.
Enum:
string
string_long
entity_reference
datetime
link
list_string
role
pseudo_email
image
parent
String Machine name of the parent section.
depth
id
machine_name
click (optional)
new_tab (optional)
delete (optional)
multi_select (optional)
Integer 1 if the field supports multiple values, 0 otherwise.
selection_limit (optional)
Integer Maximum number of values when multi_select is 1. Null for unlimited or single-value fields.
value (optional)
options (optional)
map[String, String] Available options for entity_reference or list_string fields, keyed by term/option ID.
private (optional)
Boolean Whether the current user has marked this field as private.
required (optional)
Boolean Whether this field is required by the Drupal field configuration.
placeholder (optional)
title_required (optional)
Integer Whether the link title is required. 0 = optional, 1 = required, 2 = disabled. Present only for link fields.

User-Profile-Edit-Image - Up

Image data returned by the edit endpoint. Includes the current picture, a fallback default, and optional dimension constraints.
value (optional)
default (optional)
settings (optional)

User-Profile-Edit-Patch-V1 - Up

PATCH response for edit endpoint API version 1. Returns the updated profile in the same structure as the user profile helper output. Does not include a details object.
image
org_chart
profile

User-Profile-Edit-V1 - Up

Edit endpoint GET response for API version 1.
image
profile

User-Profile-Edit-V1-Profile - Up

Profile data shape for edit endpoint GET v1. Sections and fields are separate keyed objects.
sections (optional)
map[String, User-Profile-Section-Base] Profile sections keyed by machine name.
fields (optional)
map[String, User-Profile-Edit-Field] Profile fields keyed by machine name.

User-Profile-Edit-V2 - Up

Edit endpoint GET response for API version 2.
image
profile

User-Profile-Edit-V2-Profile - Up

Profile data shape for edit endpoint GET v2. Sections are ordered by weight and each section contains its fields.
sections
array[User-Profile-Edit-V2-Section] Ordered list of profile sections, each containing its fields.

User-Profile-Edit-V2-Section - Up

A profile section in the edit endpoint v2 response with fields nested inside, ordered by weight.
label
private_for_others (optional)
protocol_type (optional)
weight
type
Enum:
section
parent
Enum:
none
depth
id
machine_name
edit (optional)
hide (optional)
click (optional)
new_tab (optional)
taxonomy_link (optional)
delete (optional)
fields
array[User-Profile-Edit-Field] Fields belonging to this section, ordered by weight.

User-Profile-Field-Base - Up

A single profile field. Shared properties for both v1 and v2.
label
private_for_others (optional)
Boolean Whether this field is marked as private when viewed by others.
edit (optional)
String '1' if the field is editable.
hide (optional)
String '1' if the field should be hidden on the profile page.
protocol_type (optional)
taxonomy_link (optional)
String '1' if the field value should link to its taxonomy term page.
weight
type
String The Drupal field type.
Enum:
string
string_long
entity_reference
datetime
link
list_string
role
pseudo_email
image
parent
String Machine name of the parent section.
depth
id
machine_name
click (optional)
new_tab (optional)
delete (optional)
multi_select (optional)
Integer 1 if the field supports multiple values, 0 otherwise.
selection_limit (optional)
Integer Maximum number of values when multi_select is 1. Null for unlimited or single-value fields.
value (optional)
options (optional)
map[String, String] Available options for entity_reference or list_string fields, keyed by term/option ID.

User-Profile-Image - Up

value

User-Profile-Org-Chart - Up

supervisor
String Display name of the supervisor. Empty string or null when there is no supervisor.
supervisor_id
String The supervisor ID value from the user field.
users

User-Profile-Org-Chart-User - Up

uid
name
subordinates

User-Profile-Section-Base - Up

A profile section that groups related fields.
label
private_for_others (optional)
protocol_type (optional)
weight
type
Enum:
section
parent
Enum:
none
depth
id
machine_name
edit (optional)
hide (optional)
click (optional)
new_tab (optional)
taxonomy_link (optional)
delete (optional)

User-Profile-Term-Link - Up

label
url
String Path to the term page or its custom redirect URL.

User-Profile-V1 - Up

User profile response for API version 1.
details
image
org_chart
profile

User-Profile-V1-Profile - Up

private_fields
array[String] List of field machine names the user has marked private.
sections
map[String, User-Profile-Section-Base] Profile sections keyed by machine name.
fields
map[String, User-Profile-Field-Base] Profile fields keyed by machine name.
field_location (optional)
array[User-Profile-Term-Link] Pre-resolved taxonomy links for the location field.
field_topic (optional)
array[User-Profile-Term-Link] Pre-resolved taxonomy links for the topic field.
field_organizational_unit (optional)
array[User-Profile-Term-Link] Pre-resolved taxonomy links for the organizational unit field.

User-Profile-V2 - Up

User profile response for API version 2.
details
image
org_chart
profile

User-Profile-V2-Field - Up

label
private_for_others (optional)
Boolean Whether this field is marked as private when viewed by others.
edit (optional)
String '1' if the field is editable.
hide (optional)
String '1' if the field should be hidden on the profile page.
protocol_type (optional)
taxonomy_link (optional)
String '1' if the field value should link to its taxonomy term page.
weight
type
String The Drupal field type.
Enum:
string
string_long
entity_reference
datetime
link
list_string
role
pseudo_email
image
parent
String Machine name of the parent section.
depth
id
machine_name
click (optional)
new_tab (optional)
delete (optional)
multi_select (optional)
Integer 1 if the field supports multiple values, 0 otherwise.
selection_limit (optional)
Integer Maximum number of values when multi_select is 1. Null for unlimited or single-value fields.
value (optional)
options (optional)
map[String, String] Available options for entity_reference or list_string fields, keyed by term/option ID.
route_name (optional)
map[String, String] Drupal route names for linked entity reference values, keyed by taxonomy term ID.

User-Profile-V2-Profile - Up

private_fields
array[String] List of field machine names the user has marked private.
sections
array[User-Profile-V2-Section] Ordered list of profile sections, each containing its fields.

User-Profile-V2-Section - Up

label
private_for_others (optional)
protocol_type (optional)
weight
type
Enum:
section
parent
Enum:
none
depth
id
machine_name
edit (optional)
hide (optional)
click (optional)
new_tab (optional)
taxonomy_link (optional)
delete (optional)
fields
array[User-Profile-V2-Field] Ordered list of fields belonging to this section.

User-Settings - Up

title
String User settings page title.
description
String User settings page description.
section (optional)

User-Settings-Element - Up

settings_id
String The settings element identifier.
Enum:
UserSettingsElementLanguage
UserSettingsElementLocation
UserSettingsElementMyPage
UserSettingsElementTaxonomy:subscriptionsplugin:taxonomy:TAXONOMY_TERM
UserSettingsElementNotifications:subscriptionsplugin:notifications
title
String The settings element title.
description
String The settings element description.
data

User-Settings-Section - Up

section_id
String The settings section identifier.
Enum:
language_location
my_page
subscriptions
title
String The settings section tilte.
section_elements

User_Profile_Edit_Field_allOf_placeholder - Up

Placeholder text from the form display widget settings. Present only for text and link fields.
text (optional)
String Placeholder for text fields.
uri (optional)
String Placeholder URL for link fields.
title (optional)
String Placeholder title for link fields.

User_Profile_Edit_Image_default - Up

Fallback image shown when no profile picture is set or after deletion.
url
String URL to the default image.
alt
String Alt text for the default image.

User_Profile_Edit_Image_settings - Up

Image dimension constraints from the user_picture field configuration. Present only when a minimum resolution is configured.
min_width (optional)
Integer Minimum required image width in pixels.
min_height (optional)
Integer Minimum required image height in pixels.

User_Profile_Field_Base_value - Up

The field value. Shape depends on the field type:

title (optional)
uri (optional)

User_Profile_Org_Chart_User_subordinates_inner - Up

uid
name

User_Settings_Element_data - Up

label
String The title field label.
current_language
language_options
current_country
Integer The current country (taxonomy term) identifier.
country_options
current_location
Integer The current location (taxonomy term) identifier.
location_options
my_page_title
String The current choosen title.
save_button
String The save button label.
delete_all_button
String The delete all button label.
header
notifications
status_message_time
Integer The current set amount of milliseconds.
options
map[String, String] Mapping from available milliseconds options to their text reperesentation.

VehicleResult - Up

id
entity_type
node_type
fuel_type
header_media
location
model
year_of_construction
title
last_updated
date format: date
excerpt

VehicleResult_fuel_type - Up

value (optional)
label (optional)

VehicleResult_fuel_type_value - Up

id (optional)
text (optional)

VehicleResult_location - Up

value (optional)
label (optional)

VehicleResult_location_value_inner - Up

id (optional)
text (optional)

VehicleResult_model - Up

value (optional)
label (optional)

VehicleResult_title - Up

is_link (optional)
text (optional)

VehicleSearch - Up

search_results
sub_facets

Video-Teaser - Up

title
id
Integer Node identifier.
entity_type
Enum:
node
node_type
Enum:
magazine_video_article
summary
String Video summary.
header_media

Vocabulary - Up

Vocabulary of a context.

Who-s-new-Widget - Up

(This component includes two additional properties called 'header' and 'footer' in the parent scheme 'Concrete-Component' inside the property called 'additional_data'. These properties are of type strings and include any html that should be display in the header or footer areas of the component.)

_api_v1_piipe_picture_gallery_create_post_200_response - Up

is_last (optional)
Boolean Whether this is the last chunk of data.
item (optional)

_api_v1_piipe_picture_gallery_create_post_request - Up

type
String Post type.
Enum:
default
chunk

_api_v1_piipe_picture_gallery_create_post_request_chunk - Up

name (optional)
String File name with extention.
data (optional)
String Base64 encoded data for this chunk
is_last (optional)
Boolean Whether this chunk is the last one.
post_data (optional)

_birthday_calendar_filters_get_200_response - Up

location_filter

_birthday_calendar_filters_get_200_response_location_filter_inner - Up

id
Integer Location id.
name
String Lacation name.

_birthday_calendar_get_200_response - Up

Each object is a date which contains a list of birthday entries. For example, instead of the name "DATE_1" the object will be named "26. October".
DATE_1
DATE_2

_birthday_calendar_recent_birthday__type__get_200_response_inner - Up

id
Integer User id.
birthday (optional)
String Person birthday.
user_picture
URI Person thumbnail. format: uri
name
String Person name.
field_position_value
String Person position.
user_profile_link
String Internal link to user profile page.

_box_pages__page_name__get_200_response - Up

page_type
Enum:
static
dynamic
page_title
page_description
categories
uncategorized
boxes
reorder

_box_pages_frontend_boxes_reorder_patch_request - Up

action
String The action type.
Enum:
update
machine_name
String The box page machine name.
boxes

_box_pages_my_page_add_patch_200_response - Up

text
String The button label
status
Boolean True if the node is added to my page.

_box_pages_my_page_add_patch_request - Up

action
String The action to perform on node.
Enum:
add
remove
id
Integer The box id which contain the node that needs to be added/removed.

_comment_post_request - Up

Request body for creating a comment.
entity_type
array[Comment_Request_entity_type_inner] Type of entity containing the comment.
comment_type
field_name
array[Comment_Request_field_name_inner] The referencing field name on parent entity. (node:comment, discussion:field_comments)
subject
comment_body
entity_id (optional)
array[_comment_post_request_allOf_entity_id_inner] ID of entity containing the comment (either a node ID or a discussion ID).
field_subject_long (optional)
array[_comment_post_request_allOf_field_subject_long_inner] Optional long subject (validated length)
pid (optional)
array[_comment_post_request_allOf_pid_inner] Parent comment ID (for replies)

_comment_post_request_allOf_entity_id_inner - Up

target_id (optional)

_comment_post_request_allOf_field_subject_long_inner - Up

value (optional)

_comment_post_request_allOf_pid_inner - Up

target_id (optional)

_community_joining_request__gid__patch_request - Up

jid (optional)
Integer Joining request ID
gid (optional)
Integer Community ID
uid (optional)
Integer User ID (for changeStatus)
action (optional)
String Action to perform
Enum:
changeStatus
withdrawRequest
status (optional)
Integer New status (for changeStatus, 1 to accept and 2 to reject joining request)

_community_joining_request_post_request - Up

gid (optional)
String Community ID
uid (optional)
String User ID

_community_list_get_200_response - Up

communities

_community_members__gid__get_200_response - Up

members
count
Integer Community members count (including admins)
adminCount
Integer Community admins count

_community_members__gid__patch_request - Up

action
Enum:
assignRole
uid
Integer User ID to assign the role to.
role
String Role to assign.
Enum:
community_admin
community_member
community_moderator

_community_post_request - Up

name (optional)
String The community title.
type (optional)
Integer The community visibility type. [0: Users can join, 1: Users cannot join but can still see the community, 2: Users can neither join nor see the community]
description (optional)
String The community description.
descriptionFormat (optional)
String Text format.
Enum:
plain_text
discussionTitle (optional)
String The dicussion title if available.
community_picture (optional)

_community_post_request_community_picture - Up

value (optional)

_community_post_request_community_picture_value - Up

file (optional)

_community_post_request_community_picture_value_file - Up

name (optional)
String The file name including format.
data (optional)
String Base64-encoded image string (without the base64 indicator prefix, i.e "data:image/jpeg;base64,").

_employee_jubilees_get_200_response - Up

employee_jubilees

_employee_jubilees_get_200_response_employee_jubilees_allOf_inner - Up

employed_since
String Date of employment.

_event__type__get_200_response - Up

grouped
Boolean Always true for overview responses.
ongoing
upcoming
past
events
has_more
offset
limit
available_categories
title
String Page title, translated to the current interface language.
description
String Introductory description, translated to the current interface language.
my_events_tab
Boolean Whether the My Events tab is enabled site-wide.
can_create_events
Boolean Whether the current user has the create event content permission.
enable_calendar_view
Boolean Whether the calendar view toggle is enabled.
default_view_mode
Enum:
grid
list
eventsPerPage
placeholderImage
String Relative path to the fallback placeholder image.
category_colors
map[String, Event_Settings_Response_category_colors_value] Map of category term IDs to their configured color and label.
default_category_color (optional)
String Fallback hex color for categories without an explicit color.
visible_tabs
hide_image
Boolean True when the header image field is disabled in the event_card view display.
hide_summary
Boolean True when the summary field is disabled in the event_card view display.

_event__type__get_event_type_parameter - Up

_magazine_topic__topic__get_200_response - Up

articles

_new_colleagues_get_200_response - Up

new_colleagues

_notifications_get_200_response - Up

messages (optional)
unread_count (optional)

_notifications_patch_request - Up

action
Enum:
mark_read_messages
mid
status
ids

_openid_connect_login__oidc_client_name__post_request - Up

id_token
access_token

_piipe_comments_media_post_200_response - Up

is_last (optional)
Boolean If true, this was the last chunk, and the whole file was uploaded successfully.
url (optional)
String URL of the uploaded file.
type (optional)
String Uploaded file type.
file_name (optional)
String Generated file name.

_piipe_comments_media_post_request - Up

chunk
gid (optional)
Integer Optional community ID

_piipe_comments_media_post_request_chunk - Up

name
String File name with extention. If the file uploaded is chunked, the suffix ".part" should be added after the extention.
data
String Base64 encoded data for this chunk
is_last
Boolean Whether this chunk is the last one.

_piipe_comments_mention_post_request - Up

text
String Partial user display name prefix to search for.

_piipe_flags_flag_post_request - Up

flag_id
String The flag ID.
entity_type
String The entity type.
entity_id
Integer The entity ID.
action
String The action to perform on the flag.
Enum:
flag
unflag

_piipe_picture_gallery_patch_200_response - Up

is_last (optional)
Boolean Whether this is the last chunk of data. (Only in edit action)

_piipe_picture_gallery_patch_200_response_oneOf - Up

is_last (optional)
Boolean Whether this is the last chunk of data. (Only in edit action)

_piipe_picture_gallery_patch_request - Up

action
String Action to perfom.
Enum:
edit
delete
id
Integer Gallery post ID.
chunk (optional)

_piipe_picture_gallery_patch_request_chunk - Up

name (optional)
String File name with extention.
data (optional)
String Base64 encoded data for this chunk
is_last (optional)
Boolean Whether this chunk is the last one.
post_data (optional)

_piipe_picture_gallery_patch_request_chunk_post_data - Up

title (optional)
String Post title.
description (optional)
String Post description.
tags (optional)
array[Integer] Post tags.

_piipe_toolbar_custom_objects_patch_request - Up

action
String The action to perform on custom toolbar items.
Enum:
update
delete
objectsToBeUpdated (optional)
array[_piipe_toolbar_custom_objects_patch_request_objectsToBeUpdated_inner] The list of custom toolbar items. This property is required only when the property "action" has the value "update".
type (optional)
String Type of toolbar item. This property is required only when the property "action" has the value "delete".
Enum:
folder
link
id (optional)
Integer The custom toolbar item ID. This property is required only when the property "action" has the value "delete".

_piipe_toolbar_custom_objects_patch_request_objectsToBeUpdated_inner - Up

id
Integer The custom toolbar item id.
uid
Integer The user id who created this toolbar item.
weight
Integer A weight to determine the item position in the toolbar.
status
Integer Status of the custom toolbar item.
Enum:
0
1
name
String The displayed name.
parent
String ID of the parent item, used to form the toolbar in a tree structure. The ID could be a machine name of a default toolbar item, or a numeric ID of a custom toolbar item.
type
String The custom toolbar type.
Enum:
link
folder
payload
oas_any_type_not_mapped The custom toolbar item data. In contrast to the GET request, here the payload should be sent as an actual JSON object and not a serialized one. See the description In the GET request to see how the payload is structured for each toolbar item type.

_piipe_toolbar_custom_objects_post_request - Up

id
uid
Integer The user id who created this toolbar item.
weight
Integer A weight to determine the item position in the toolbar.
status
Integer Status of the custom toolbar item.
Enum:
0
1
name
String The displayed name.
parent
String ID of the parent item, used to form the toolbar in a tree structure. The ID could be a machine name of a default toolbar item, or a numeric ID of a custom toolbar item.
type
String The custom toolbar type.
Enum:
link
folder
payload
oas_any_type_not_mapped The custom toolbar item data. In contrast to the GET request, here the payload should be sent as an actual JSON object and not a serialized one. See the description In the GET request to see how the payload is structured for each toolbar item type.

_piipe_toolbar_settings_patch_request - Up

action
String The action to perform on toolbar items settings.
Enum:
update
delete
objectsToBeUpdated (optional)
array[_piipe_toolbar_settings_patch_request_objectsToBeUpdated_inner] The list of custom toolbar items. This property is required only when the property "action" has the value "update".

_piipe_toolbar_settings_patch_request_objectsToBeUpdated_inner - Up

id
Integer The toolbar settings item ID.
machine_name
String The machine name of a default toolbar item, which its settings should be overriden.
uid
Integer The user ID who added the settings item.
weight
Integer A weight to determine the item position.
status
Integer Whether to show or hide the default toolbar item.
Enum:
0
1
selection
oas_any_type_not_mapped Settings data for certain toolbar items. In contrast to the GET request, here the settings data should be sent as an actual JSON object and not a serialized one. See the description In the GET request to see how the payload is structured for each toolbar item type.

_piipe_toolbar_settings_post_request - Up

id
machine_name
String The machine name of a default toolbar item, which its settings should be overriden.
uid
Integer The user ID who added the settings item.
weight
Integer A weight to determine the item position.
status
Integer Whether to show or hide the default toolbar item.
Enum:
0
1
selection
oas_any_type_not_mapped Settings data for certain toolbar items. In contrast to the GET request, here the settings data should be sent as an actual JSON object and not a serialized one. See the description In the GET request to see how the payload is structured for each toolbar item type.

_poll_patch_request - Up

action
id
Integer poll id
choice
Integer choice id

_poll_patch_request_oneOf - Up

action
id
Integer poll id
choice
Integer choice id

_poll_patch_request_oneOf_1 - Up

action
id
Integer poll id

_refresh_token_get_200_response - Up

jwt_token
String A new jwt access token.
access_token (optional)
String A new jwt access token (it has the exact same value as jwt_token, but the property was introduced for compatibility reasons, and jwt_token is planned for depriction in the future).
refresh_token
String A new jwt refresh token.

_register_device_token__token__delete_403_response - Up

message
String The error description.
Enum:
You are not allowed to delete this device token.

_register_device_token__token__delete_404_response - Up

message
String The error description.
Enum:
The requested device token cannot be found.

_register_device_token_post_400_response - Up

message
String The error description.
Enum:
Attribute 'token' is missing.
Attribute 'network' is missing.
The language code LANGUAGE_CODE is not a valid language code.

_register_device_token_post_request - Up

token
String The device token.
network
String The push notification service to which the device token belongs ("apns" for IOS and "fcm" for android).
Enum:
apns
fcm

_scssadmin_get_200_response_value_inner - Up

name
String Variable machine name.
type
String Variable type.
description
String Variable description.
value
String Variable value.
ref
String A reference to the variable from which the value came from.

_tags__page__get_200_response - Up

tags

_taxonomy_page__tid__get_200_response - Up

title
String The taxonomy term label.
data

_user_code_register_post_request - Up

username
String The user name.
password_old
String The inital password given to the user.
action
String The action to perform. "validate" is used to only validate the given credentials (username, password_old, email (optional)). "register" is used to first validate the given credentials, and then set a new password and email and logs in the user.
Enum:
validate
register
consent
Boolean Must be true to confirm the user consent for registration.
email (optional)
String The user's email (optional). format: email
password_new (optional)
String The new password

_user_login_post_202_response - Up

auth_state (optional)
Enum:
challenge_required
challenge_token (optional)
String Opaque token identifying this login challenge. Valid for 5 minutes.
expires_at (optional)
Integer Unix timestamp when the challenge token expires.
allowed_methods (optional)
array[String] Plugin IDs of the TFA validation methods available for this user.
Enum:

_user_login_post_request - Up

username
String The users name.
password
String The users password.

_user_login_tfa_post_request - Up

challenge_token
String The challenge token returned by POST /user-login.
code
String The one-time code from the user's second-factor device (e.g. TOTP).
method (optional)
String Optional. The plugin ID of the TFA method to use. When omitted, all allowed methods for the challenge are tried in order.

_user_logout_post_request - Up

access_token
String The current access token.
refresh_token
String The refresh token.

_user_profile__uid__get_200_response - Up

details
image
org_chart
profile

_user_profile_edit__uid__get_200_response - Up

image
profile

_user_profile_edit__uid__patch_200_response - Up

image
org_chart
profile
details

_user_profile_edit__uid__patch_request - Up

changes

_user_profile_edit__uid__patch_request_changes - Up

editData
privateFields (optional)
array[String] The current list of field machine names the user has marked as private. Used by the server to determine whether to insert or remove a privacy record for each submitted field.

_user_profile_edit__uid__patch_request_changes_editData - Up

profile (optional)
image (optional)

_user_profile_edit__uid__patch_request_changes_editData_image - Up

value

_user_profile_edit__uid__patch_request_changes_editData_image_value - Up

action
String The action to perform on the profile image.
Enum:
create
delete
file (optional)

_user_profile_edit__uid__patch_request_changes_editData_image_value_file - Up

Required when action is 'create'.
name
String Image file name with extension.
data
String Base64-encoded image data (without the data URI prefix, e.g. "data:image/jpeg;base64,").

_user_profile_edit__uid__patch_request_changes_editData_profile - Up

fields (optional)
map[String, _user_profile_edit__uid__patch_request_changes_editData_profile_fields_value]

Keyed by field machine name. Each entry must include a value key with the new value and optionally a private boolean.

Fields whose edit flag is 0 in the module config are silently skipped — submitting them does not cause an error.

_user_profile_edit__uid__patch_request_changes_editData_profile_fields_value - Up

value
private (optional)
Boolean Whether to mark this field as private. Only processed when the field's hide flag is enabled in the module config; otherwise silently ignored.

_user_profile_edit__uid__patch_request_changes_editData_profile_fields_value_value - Up

The new field value. Shape depends on field type:

title (optional)
uri (optional)

_user_profile_edit__uid__patch_request_changes_editData_profile_fields_value_value_oneOf - Up

title (optional)
uri (optional)

_user_register_post_request - Up

name
field_firstname
field_lastname
mail

_user_register_post_request_field_firstname_inner - Up

value (optional)

_user_register_post_request_field_lastname_inner - Up

value (optional)

_user_register_post_request_mail_inner - Up

value (optional)

_user_register_post_request_name_inner - Up

value (optional)

_user_session_get_200_response - Up

csrf_token
String CSRF token.
logout_token
String CSRF token bound to the logout route.

_user_settings_patch_request - Up

settings_id
String The notification settings identifier.
Enum:
userSettingsElementStatusMessageTimeSelect
id
Integer The notification identifier.
settings_type
String The vocabulary type.
Enum:
location
country
option_id
Integer The term identifier.
action
String The action to perform.
Enum:
save
delete_all
my_page_title (optional)
String The new name of "My Page". (This property is required only when the action is "save")
type
String The type of notification subscription.
Enum:
mail
system
push
status_message_time
Integer Amount of milliseconds to set.

_videos_get_200_response - Up

title
String The page title.
data

_wiki_overview_get_200_response - Up

title
description (optional)
data

_wiki_overview_get_200_response_data_inner - Up

id
Integer Term ID.
entity_type
Enum:
taxonomy_term
taxonomy_term_type
String Taxonomy term type.
description (optional)
String Wiki category description.
image (optional)
name (optional)
String Wiki category name.

_wiki_term_overview__term_id__get_200_response - Up

title
String Wiki category name.
data

_wiki_term_overview__term_id__get_200_response_data_inner - Up

title
id
Integer Node identifier.
entity_type
Enum:
node
node_type