logo
API docs by Redocly

Cohesivo SaaS REST API

Download OpenAPI specification:Download as YAMLDownload as JSON

Section

Resource 'Section' operations.

Get Sections

Returns a list of all Sections.

header Parameters
If-None-Match
string

ETag

Responses

Response samples

Content type
{
  • "SectionList": {
    }
}

Create new Section

Creates a new Section.

header Parameters
X-CSRF-Token
required
string

The CSRF Token needed on all unsafe HTTP methods with session.

Request Body schema:
optional

The Section input schema encoded in XML or JSON format.

required
object (SectionInput)

Responses

Request samples

Content type
{
  • "SectionInput": {
    }
}

Response samples

Content type
{
  • "Section": {
    }
}

Get Section

Returns the Section by given Section ID.

path Parameters
sectionId
required
string

SectionLoadByIdController identifier

header Parameters
If-None-match
string

ETag

Responses

Response samples

Content type
{
  • "Section": {
    }
}

Delete Section

The given Section is deleted.

path Parameters
sectionId
required
string

SectionDeleteController identifier

header Parameters
X-CSRF-Token
required
string

The CSRF Token needed on all unsafe HTTP methods with session.

Responses

Update a Section

Updates a Section. PATCH or POST with header X-HTTP-Method-Override PATCH.

path Parameters
sectionId
required
string

SectionUpdateController identifier

header Parameters
X-CSRF-Token
required
string

The CSRF Token needed on all unsafe HTTP methods with session.

If-Match
required
string

ETag

Request Body schema:
optional

The Section input schema encoded in XML or JSON.

required
object (SectionInput)

Responses

Request samples

Content type
{
  • "SectionInput": {
    }
}

Response samples

Content type
{
  • "Section": {
    }
}

Objects

Resource 'Objects' operations.

Load content by remote ID

Loads content item for a given remote ID.

query Parameters
remoteId
required
string

Remote ID of the content item.

Responses

Create content item

Creates a draft assigned to the authenticated user. If a different user ID is given in the input, the draft is assigned to the given user but this action requires special permissions for the authenticated user (this is useful for content staging where the transfer process does not have to authenticate with the user who created the content item in the source server). The user needs to publish the content item if it should be visible.

header Parameters
X-CSRF-Token
required
string

The CSRF Token needed on all unsafe HTTP methods with session.

Request Body schema:
optional

The ContentCreate schema encoded in XML or JSON format.

required
object (ContentCreate)

This class is used for creating a new content item.

Responses

Request samples

Content type
{
  • "ContentCreate": {
    }
}

Response samples

Content type
{
  • "Content": {
    }
}

Load content

Loads the content item for the given ID. Depending on the Accept header the current version is embedded (i.e. the current published version or if it does not exist, the draft of the authenticated user).

  • Content - If set, all information for the content item including the embedded current version is returned in XML or JSON format.
  • ContentInfo - If set, all information for the content item (excluding the current version) is returned in XML or JSON format.
path Parameters
contentId
required
integer

ContentLoadByIdController identifier

header Parameters
If-None-Match
string

If the provided ETag matches the current ETag then a "304 Not Modified" is returned. The ETag changes if the meta data has changed, this happens also if there is a new published version.

Responses

Response samples

Content type
{
  • "Content": {
    }
}

Delete Content

Deletes content item. If content item has multiple Locations, all of them will be deleted via delete a subtree.

path Parameters
contentId
required
string

ContentDeleteController identifier

header Parameters
X-CSRF-Token
required
string

The CSRF Token needed on all unsafe HTTP methods with session.

Responses

Update content

This method updates the content metadata which is independent from a version. PATCH or POST with header X-HTTP-Method-Override PATCH.

path Parameters
contentId
required
string

ContentMetadataUpdateController identifier

header Parameters
X-CSRF-Token
required
string

The CSRF Token needed on all unsafe HTTP methods with session.

If-match
required
string

Causes to patch only if the specified ETag is the current one. Otherwise a 412 is returned.

Request Body schema:
optional

The ContentUpdate schema encoded in XML or JSON format.

required
object (ContentInfo)

This class provides all version independent information of the content item.

Responses

Request samples

Content type
{
  • "ContentInfo": {
    }
}

Response samples

Content type
{
  • "ContentInfo": {
    }
}

Get current version

Redirects to the current version of the content item.

path Parameters
contentId
required
string

ContentCurrentVersionRedirectController identifier

Responses

Response samples

Content type
{
  • "Version": {
    }
}

Create a draft from current version

The system creates a new draft as a copy of the current version. COPY or POST with header X-HTTP-Method-Override COPY.

path Parameters
contentId
required
string

ContentDraftCreateFromCurrentVersionController identifier

header Parameters
X-CSRF-Token
required
string

The CSRF Token needed on all unsafe HTTP methods with session.

Responses

Response samples

Content type
{
  • "Version": {
    }
}

Hide content item

Makes or keep the content item invisible

path Parameters
contentId
required
string

ContentHideController identifier

header Parameters
X-CSRF-Token
required
string

The CSRF Token needed on all unsafe HTTP methods with session.

Responses

Get Locations for content item

Loads all Locations for the given content item.

path Parameters
contentId
required
string

LocationForContentListController identifier

header Parameters
If-None-Match
string

ETag

Responses

Response samples

Content type
{
  • "LocationList": {
    }
}

Create new Location for content item

Creates a new Location for the given content item.

path Parameters
contentId
required
string

LocationCreateController identifier

header Parameters
X-CSRF-Token
required
string

The CSRF Token needed on all unsafe HTTP methods with session.

Request Body schema:
optional

The LocationCreate schema encoded in XML or JSON format.

required
object (LocationCreate)

Responses

Request samples

Content type
{
  • "LocationCreate": {
    }
}

Response samples

Content type
{
  • "Location": {
    }
}

Get Object states of content item

Returns the Object states of a content item

path Parameters
contentId
required
string

ObjectStatesForContentListController identifier

header Parameters
If-None-Match
string

ETag

Responses

Response samples

Content type
{
  • "ContentObjectStates": {
    }
}

Set Object states of content item

Updates Object states of a content item. An Object state in the input overrides the state of the Object state group. PATCH or POST with header X-HTTP-Method-Override PATCH.

path Parameters
contentId
required
string

ObjectStatesForContentUpdateController identifier

header Parameters
X-CSRF-Token
required
string

The CSRF Token needed on all unsafe HTTP methods with session.

If-Match
required
string

ETag

Request Body schema:
optional

The content item Object states input schema encoded in XML or JSON format.

required
object (ContentObjectStates)

Represents a list of object states.

Responses

Request samples

Content type
{
  • "ContentObjectStates": {
    }
}

Response samples

Content type
{
  • "ContentObjectStates": {
    }
}

Load Relations of content item

Redirects to the Relations of the current version.

path Parameters
contentId
required
string

ContentCurrentVersionRelationsRedirectController identifier

Responses

Reveal content item

Makes or keep the content item visible

path Parameters
contentId
required
string

ContentRevealController identifier

header Parameters
X-CSRF-Token
required
string

The CSRF Token needed on all unsafe HTTP methods with session.

Responses

Delete translation (permanently)

Permanently deletes a translation from all versions of a content item.

path Parameters
contentId
required
string

ContentTranslationDeleteController identifier

languageCode
required
string

ContentTranslationDeleteController identifier

header Parameters
X-CSRF-Token
required
string

The CSRF Token needed on all unsafe HTTP methods with session.

Responses

List versions

Returns a list of all versions of the content item. This method does not include fields and relations in the version elements of the response.

path Parameters
contentId
required
string

ContentVersionsListController identifier

Responses

Response samples

Content type
{
  • "VersionList": {
    }
}

Load version

Loads a specific version of a content item. This method returns Fields and relations.

path Parameters
contentId
required
string

ContentInVersionLoadController identifier

versionNo
required
string

ContentInVersionLoadController identifier

header Parameters
If-None-Match
string

Only return the version if the given ETag is the not current one, otherwise a 304 is returned.

Responses

Response samples

Content type
{
  • "Version": {
    }
}

Create a draft from a version

The system creates a new draft as a copy of the given version. COPY or POST with header X-HTTP-Method-Override COPY.

path Parameters
contentId
required
string

ContentDraftCreateFromVersionController identifier

versionNo
required
string

ContentDraftCreateFromVersionController identifier

header Parameters
X-CSRF-Token
required
string

The CSRF Token needed on all unsafe HTTP methods with session.

Responses

Response samples

Content type
{
  • "Version": {
    }
}

Delete content version

Deletes the content version.

path Parameters
contentId
required
string

ContentVersionDeleteController identifier

versionNo
required
string

ContentVersionDeleteController identifier

header Parameters
X-CSRF-Token
required
string

The CSRF Token needed on all unsafe HTTP methods with session.

Responses

Update version

A specific draft is updated. PATCH or POST with header X-HTTP-Method-Override PATCH.

path Parameters
contentId
required
string

ContentVersionUpdateController identifier

versionNo
required
string

ContentVersionUpdateController identifier

header Parameters
X-CSRF-Token
required
string

The CSRF Token needed on all unsafe HTTP methods with session.

If-match
required
string

Performs the patch only if the specified ETag is the current one.

Request Body schema:
optional

The VersionUpdate schema encoded in XML or JSON format.

required
object (VersionUpdate)

This class is used to update a content version.

Responses

Request samples

Content type
{
  • "VersionUpdate": {
    }
}

Response samples

Content type
{
  • "Version": {
    }
}

Load Relations of content item version

Loads the Relations of the given version.

path Parameters
contentId
required
string

ContentVersionsRelationsListController identifier

versionNo
required
string

ContentVersionsRelationsListController identifier

Responses

Response samples

Content type
{
  • "Relations": {
    }
}

Create new Relation

Creates a new Relation of type COMMON for the given draft.

path Parameters
contentId
required
string

ContentRelationCreateController identifier

versionNo
required
string

ContentRelationCreateController identifier

header Parameters
X-CSRF-Token
required
string

The CSRF Token needed on all unsafe HTTP methods with session.

Request Body schema:
optional

The RelationCreate schema encoded in XML or JSON format.

required
object (RelationCreate)

Responses

Request samples

Content type
{
  • "RelationCreate": {
    }
}

Response samples

Content type
{
  • "Relation": {
    }
}

Load Relation

Loads a Relation for the given content item.

path Parameters
contentId
required
string

ContentVersionRelationLoadByIdController identifier

versionNo
required
string

ContentVersionRelationLoadByIdController identifier

relationId
required
string

ContentVersionRelationLoadByIdController identifier

Responses

Response samples

Content type
{
  • "Relation": {
    }
}

Delete Relation

Deletes a Relation of the given draft.

path Parameters
contentId
required
string

ContentVersionRelationDeleteController identifier

versionNo
required
string

ContentVersionRelationDeleteController identifier

relationId
required
string

ContentVersionRelationDeleteController identifier

header Parameters
X-CSRF-Token
required
string

The CSRF Token needed on all unsafe HTTP methods with session.

Responses

Delete translation from version draft

Removes a translation from a version draft.

path Parameters
contentId
required
string

ContentDraftTranslationDeleteController identifier

versionNo
required
string

ContentDraftTranslationDeleteController identifier

languageCode
required
string

ContentDraftTranslationDeleteController identifier

header Parameters
X-CSRF-Token
required
string

The CSRF Token needed on all unsafe HTTP methods with session.

Responses

Type Groups

Resource 'Type Groups' operations.

Get content type groups

Returns a list of all content type groups. If an identifier is provided, loads the content type group for this identifier.

Responses

Response samples

Content type
{
  • "ContentTypeGroupList": {
    }
}

Create content type group

Creates a new content type group.

header Parameters
X-CSRF-Token
required
string

The CSRF Token needed on all unsafe HTTP methods with session.

Request Body schema:
optional

The content type group input schema encoded in XML or JSON.

ContentTypeGroupInput
required
object (ContentTypeGroupInput)

Responses

Request samples

Content type
{
  • "ContentTypeGroupInput": {
    }
}

Response samples

Content type
{
  • "ContentTypeGroup": {
    }
}

Get content type group

Returns the content type group with provided ID.

path Parameters
contentTypeGroupId
required
string

ContentTypeGroupLoadByIdController identifier

header Parameters
If-None-Match
string

ETag

Responses

Response samples

Content type
{
  • "ContentTypeList": {
    }
}

Delete content type group

Deletes the provided content type group.

path Parameters
contentTypeGroupId
required
string

ContentTypeGroupDeleteController identifier

header Parameters
X-CSRF-Token
required
string

The CSRF Token needed on all unsafe HTTP methods with session.

Responses

Update content type group

Updates a content type group. PATCH or POST with header X-HTTP-Method-Override PATCH.

path Parameters
contentTypeGroupId
required
string

ContentTypeGroupUpdateController identifier

header Parameters
X-CSRF-Token
required
string

The CSRF Token needed on all unsafe HTTP methods with session.

If-Match
required
string

ETag causes patching only if the specified ETag is the current one. Otherwise a 412 is returned.

Request Body schema:
optional

The content type group input schema encoded in XML or JSON format.

ContentTypeGroupInput
required
object (ContentTypeGroupInput)

Responses

Request samples

Content type
{
  • "ContentTypeGroupInput": {
    }
}

Response samples

Content type
{
  • "ContentTypeGroup": {
    }
}

List content types for group

Returns a list of content types in the provided group.

path Parameters
contentTypeGroupId
required
string

ContentTypeListForGroupController identifier

Responses

Response samples

Content type
{
  • "ContentTypeList": {
    }
}

Create content type

Creates a new content type draft in the given content type group.

path Parameters
contentTypeGroupId
required
string

ContentTypeCreateController identifier

header Parameters
X-CSRF-Token
required
string

The CSRF Token needed on all unsafe HTTP methods with session.

Request Body schema:
optional

The content type Create schema encoded in XML or JSON format.

required
object (ContentTypeCreate)

This class is used to create a content type.

Responses

Request samples

Content type
{
  • "ContentTypeCreate": {
    }
}

Response samples

Content type
{
  • "ContentType": {
    }
}

Type

Resource 'Type' operations.

List content types

Returns a list of content types.

Responses

Response samples

Content type
{
  • "ContentTypeList": {
    }
}

Filter content types

Executes a query and returns a View including the results. The View input reflects the criteria model of the public PHP API.

header Parameters
X-CSRF-Token
required
string

The CSRF Token needed on all unsafe HTTP methods with session.

Request Body schema:
optional

The view input in XML or JSON format.

required
object (ContentTypeViewInput)

This class represents a content type view input.

Responses

Request samples

Content type
{
  • "ViewInput": {
    }
}

Response samples

Content type
{
  • "ContentTypeList": {
    }
}

Get content type

Returns the content type with the provided ID.

path Parameters
contentTypeId
required
string

ContentTypeLoadByIdController identifier

header Parameters
If-None-Match
string

ETag

Responses

Response samples

Content type
{
  • "ContentType": {
    }
}

Create Draft

Creates a draft and updates it with the given data.

path Parameters
contentTypeId
required
string

ContentTypeDraftCreateController identifier

header Parameters
X-CSRF-Token
required
string

The CSRF Token needed on all unsafe HTTP methods with session.

Request Body schema:
optional

The content type Update schema encoded in XML or JSON format.

required
object (ContentTypeUpdate)

This class is used to update a content type.

Responses

Request samples

Content type
{
  • "ContentTypeUpdate": {
    }
}

Response samples

Content type
{
  • "ContentTypeInfo": {
    }
}

Delete content type

Deletes the provided content type.

path Parameters
contentTypeId
required
string

ContentTypeDeleteController identifier

header Parameters
X-CSRF-Token
required
string

The CSRF Token needed on all unsafe HTTP methods with session.

Responses

Get content type draft

Returns the draft of the content type with the provided ID.

path Parameters
contentTypeId
required
string

ContentTypeDraftLoadController identifier

Responses

Response samples

Content type
{
  • "ContentType": {
    }
}

Delete content type draft

Deletes the provided content type draft.

path Parameters
contentTypeId
required
string

ContentTypeDraftDeleteController identifier

header Parameters
X-CSRF-Token
required
string

The CSRF Token needed on all unsafe HTTP methods with session.

Responses

Update content type draft

Updates metadata of a draft. This method does not handle Field definitions. PATCH or POST with header X-HTTP-Method-Override PATCH.

path Parameters
contentTypeId
required
string

ContentTypeDraftUpdateController identifier

header Parameters
X-CSRF-Token
required
string

The CSRF Token needed on all unsafe HTTP methods with session.

Request Body schema:
optional

The content type update schema encoded in XML or JSON format.

required
object (ContentTypeUpdate)

This class is used to update a content type.

Responses

Request samples

Content type
{
  • "ContentTypeUpdate": {
    }
}

Response samples

Content type
{
  • "ContentTypeInfo": {
    }
}

Get Draft Field definition list

Returns all Field definitions of the provided content type Draft.

path Parameters
contentTypeId
required
string

ContentTypeDraftFieldDefinitionListController identifier

Responses

Response samples

Content type
{
  • "FieldDefinitions": {
    }
}

Add content type Draft Field definition

Creates a new Field definition for the given content type.

path Parameters
contentTypeId
required
string

ContentTypeDraftFieldDefinitionAddController identifier

header Parameters
X-CSRF-Token
required
string

The CSRF Token needed on all unsafe HTTP methods with session.

Request Body schema:
optional

The Field Definition Create schema encoded in XML or JSON format.

required
object (FieldDefinitionCreate)

Responses

Request samples

Content type
{
  • "FieldDefinitionCreate": {
    }
}

Response samples

Content type
{
  • "FieldDefinition": {
    }
}

Get content type Draft Field definition

Returns the Field definition by the given ID.

path Parameters
contentTypeId
required
string

ContentTypeDraftFieldDefinitionLoadByIdController identifier

fieldDefinitionId
required
string

ContentTypeDraftFieldDefinitionLoadByIdController identifier

Responses

Response samples

Content type
{
  • "FieldDefinition": {
    }
}

Delete content type Draft Field definition

Deletes the provided Field definition.

path Parameters
contentTypeId
required
string

ContentTypeDraftFieldDefinitionDeleteController identifier

fieldDefinitionId
required
string

ContentTypeDraftFieldDefinitionDeleteController identifier

header Parameters
X-CSRF-Token
required
string

The CSRF Token needed on all unsafe HTTP methods with session.

Responses

Update content type Draft Field definition

Updates the attributes of a Field definition.

path Parameters
contentTypeId
required
string

ContentTypeDraftFieldDefinitionUpdateController identifier

fieldDefinitionId
required
string

ContentTypeDraftFieldDefinitionUpdateController identifier

header Parameters
X-CSRF-Token
required
string

The CSRF Token needed on all unsafe HTTP methods with session.

Request Body schema:
optional

The Field definition update schema encoded in XML or JSON format.

required
object (FieldDefinitionUpdate)

Responses

Request samples

Content type
{
  • "FieldDefinitionUpdate": {
    }
}

Response samples

Content type
{
  • "FieldDefinition": {
    }
}

Get Field definition list

Returns all Field definitions of the provided content type.

path Parameters
contentTypeId
required
string

ContentTypeFieldDefinitionListController identifier

Responses

Response samples

Content type
{
  • "FieldDefinitions": {
    }
}

Get Field definition

Returns the Field definition by the given ID.

path Parameters
contentTypeId
required
string

ContentTypeFieldDefinitionLoadByIdController identifier

fieldDefinitionId
required
string

ContentTypeFieldDefinitionLoadByIdController identifier

Responses

Response samples

Content type
{
  • "FieldDefinition": {
    }
}

Get groups of content type

Returns the content type group to which content type belongs to.

path Parameters
contentTypeId
required
string

ContentTypeGroupListController identifier

Responses

Response samples

Content type
{
  • "ContentTypeGroupRefList": {
    }
}

Link group to content type

Links a content type group to the content type and returns the updated group list.

path Parameters
contentTypeId
required
string

ContentTypeLinkToGroupController identifier

query Parameters
group
required
string

Destination content type group URI; for example with content type group 4: ?group=/api/ibexa/v2/content/typegroups/4

header Parameters
X-CSRF-Token
required
string

The CSRF Token needed on all unsafe HTTP methods with session.

Responses

Response samples

Content type
{
  • "ContentTypeGroupRefList": {
    }
}

Unlink group from content type

Removes the given group from the content type and returns the updated group list.

path Parameters
contentTypeId
required
string

ContentTypeUnlinkFromGroupController identifier

id
required
string

ContentTypeUnlinkFromGroupController identifier

header Parameters
X-CSRF-Token
required
string

The CSRF Token needed on all unsafe HTTP methods with session.

Responses

Response samples

Content type
{
  • "ContentTypeGroupRefList": {
    }
}

User

Resource 'User' operations.

Load current User

Loads the current user.

header Parameters
Accept
required
string

If set, the User is returned in XML or JSON format.

Responses

Response samples

Content type
<?xml version="1.0" encoding="UTF-8"?>
<UserList media-type="application/vnd.ibexa.api.UserList+xml" href="/api/ibexa/v2/user/users">
    <User media-type="application/vnd.ibexa.api.User+xml" href="/api/ibexa/v2/user/users/79" id="79" remoteId="bcf0764b417f05af21852a1f03fb1f13">
        <ContentType media-type="application/vnd.ibexa.api.ContentType+xml" href="/api/ibexa/v2/content/types/4"/>
        <name>Jose Vargas</name>
        <Versions media-type="application/vnd.ibexa.api.VersionList+xml" href="/api/ibexa/v2/content/objects/79/versions"/>
        <Section media-type="application/vnd.ibexa.api.Section+xml" href="/api/ibexa/v2/content/sections/2"/>
        <MainLocation media-type="application/vnd.ibexa.api.Location+xml" href="/api/ibexa/v2/content/locations/1/5/12/79"/>
        <Locations media-type="application/vnd.ibexa.api.LocationList+xml" href="/api/ibexa/v2/content/objects/79/locations"/>
        <Groups media-type="application/vnd.ibexa.api.UserGroupRefList+xml" href="/api/ibexa/v2/user/users/79/groups"/>
        <Owner media-type="application/vnd.ibexa.api.User+xml" href="/api/ibexa/v2/user/users/10"/>
        <publishDate>2021-06-29T08:23:42+00:00</publishDate>
        <lastModificationDate>2021-06-29T08:23:42+00:00</lastModificationDate>
        <mainLanguageCode>eng-GB</mainLanguageCode>
        <alwaysAvailable>true</alwaysAvailable>
        <Version media-type="application/vnd.ibexa.api.Version+xml" href="/api/ibexa/v2/content/objects/79/versions/1">
            <VersionInfo>
                <id>547</id>
                <versionNo>1</versionNo>
                <status>PUBLISHED</status>
                <modificationDate>2021-06-29T08:23:42+00:00</modificationDate>
                <Creator media-type="application/vnd.ibexa.api.User+xml" href="/api/ibexa/v2/user/users/10"/>
                <creationDate>2021-06-29T08:23:42+00:00</creationDate>
                <initialLanguageCode>eng-GB</initialLanguageCode>
                <languageCodes>eng-GB</languageCodes>
                <VersionTranslationInfo media-type="application/vnd.ibexa.api.VersionTranslationInfo+xml">
                    <Language>
                        <languageCode>eng-GB</languageCode>
                    </Language>
                </VersionTranslationInfo>
                <names>
                    <value languageCode="eng-GB">Jose Vargas</value>
                </names>
                <Content media-type="application/vnd.ibexa.api.ContentInfo+xml" href="/api/ibexa/v2/content/objects/79"/>
            </VersionInfo>
            <Fields>
                <field>
                    <id>342</id>
                    <fieldDefinitionIdentifier>first_name</fieldDefinitionIdentifier>
                    <languageCode>eng-GB</languageCode>
                    <fieldTypeIdentifier>ibexa_string</fieldTypeIdentifier>
                    <fieldValue>Jose</fieldValue>
                </field>
                <field>
                    <id>343</id>
                    <fieldDefinitionIdentifier>last_name</fieldDefinitionIdentifier>
                    <languageCode>eng-GB</languageCode>
                    <fieldTypeIdentifier>ibexa_string</fieldTypeIdentifier>
                    <fieldValue>Vargas</fieldValue>
                </field>
                <field>
                    <id>344</id>
                    <fieldDefinitionIdentifier>user_account</fieldDefinitionIdentifier>
                    <languageCode>eng-GB</languageCode>
                    <fieldTypeIdentifier>ibexa_user</fieldTypeIdentifier>
                    <fieldValue>
                        <value key="hasStoredLogin">true</value>
                        <value key="contentId">79</value>
                        <value key="login">josevargas</value>
                        <value key="email">aa@bb.cc</value>
                        <value key="passwordUpdatedAt">1624955022</value>
                        <value key="enabled">true</value>
                        <value key="maxLogin">0</value>
                        <value key="plainPassword"/>
                    </fieldValue>
                </field>
                <field>
                    <id>345</id>
                    <fieldDefinitionIdentifier>signature</fieldDefinitionIdentifier>
                    <languageCode>eng-GB</languageCode>
                    <fieldTypeIdentifier>ibexa_text</fieldTypeIdentifier>
                    <fieldValue/>
                </field>
                <field>
                    <id>346</id>
                    <fieldDefinitionIdentifier>image</fieldDefinitionIdentifier>
                    <languageCode>eng-GB</languageCode>
                    <fieldTypeIdentifier>ibexa_image</fieldTypeIdentifier>
                    <fieldValue/>
                </field>
            </Fields>
            <Relations media-type="application/vnd.ibexa.api.RelationList+xml" href="/api/ibexa/v2/content/objects/79/versions/1/relations"/>
            <Thumbnail media-type="application/vnd.ibexa.api.Thumbnail+xml">
                <resource>/bundles/ezplatformadminui/img/ez-icons.svg#user</resource>
                <width></width>
                <height></height>
                <mimeType>image/svg+xml</mimeType>
            </Thumbnail>
        </Version>
        <login>josevargas</login>
        <email>aa@bb.cc</email>
        <enabled>true</enabled>
        <UserGroups media-type="application/vnd.ibexa.api.UserGroupList+xml" href="/api/ibexa/v2/user/users/79/groups"/>
        <Roles media-type="application/vnd.ibexa.api.RoleAssignmentList+xml" href="/api/ibexa/v2/user/users/79/roles"/>
    </User>
</UserList>

List Users

Load Users either for a given remote ID or Role.

header Parameters
Accept
required
string

UserList - If set, the User list is returned in XML or JSON format. UserRefList - If set, the link list of Users is returned in XML or JSON format.

Responses

Response samples

Content type
<?xml version="1.0" encoding="UTF-8"?>
<UserList media-type="application/vnd.ibexa.api.UserList+xml" href="/api/ibexa/v2/user/users">
    <User media-type="application/vnd.ibexa.api.User+xml" href="/api/ibexa/v2/user/users/79" id="79" remoteId="bcf0764b417f05af21852a1f03fb1f13">
        <ContentType media-type="application/vnd.ibexa.api.ContentType+xml" href="/api/ibexa/v2/content/types/4"/>
        <name>Jose Vargas</name>
        <Versions media-type="application/vnd.ibexa.api.VersionList+xml" href="/api/ibexa/v2/content/objects/79/versions"/>
        <Section media-type="application/vnd.ibexa.api.Section+xml" href="/api/ibexa/v2/content/sections/2"/>
        <MainLocation media-type="application/vnd.ibexa.api.Location+xml" href="/api/ibexa/v2/content/locations/1/5/12/79"/>
        <Locations media-type="application/vnd.ibexa.api.LocationList+xml" href="/api/ibexa/v2/content/objects/79/locations"/>
        <Groups media-type="application/vnd.ibexa.api.UserGroupRefList+xml" href="/api/ibexa/v2/user/users/79/groups"/>
        <Owner media-type="application/vnd.ibexa.api.User+xml" href="/api/ibexa/v2/user/users/10"/>
        <publishDate>2021-06-29T08:23:42+00:00</publishDate>
        <lastModificationDate>2021-06-29T08:23:42+00:00</lastModificationDate>
        <mainLanguageCode>eng-GB</mainLanguageCode>
        <alwaysAvailable>true</alwaysAvailable>
        <Version media-type="application/vnd.ibexa.api.Version+xml" href="/api/ibexa/v2/content/objects/79/versions/1">
            <VersionInfo>
                <id>547</id>
                <versionNo>1</versionNo>
                <status>PUBLISHED</status>
                <modificationDate>2021-06-29T08:23:42+00:00</modificationDate>
                <Creator media-type="application/vnd.ibexa.api.User+xml" href="/api/ibexa/v2/user/users/10"/>
                <creationDate>2021-06-29T08:23:42+00:00</creationDate>
                <initialLanguageCode>eng-GB</initialLanguageCode>
                <languageCodes>eng-GB</languageCodes>
                <VersionTranslationInfo media-type="application/vnd.ibexa.api.VersionTranslationInfo+xml">
                    <Language>
                        <languageCode>eng-GB</languageCode>
                    </Language>
                </VersionTranslationInfo>
                <names>
                    <value languageCode="eng-GB">Jose Vargas</value>
                </names>
                <Content media-type="application/vnd.ibexa.api.ContentInfo+xml" href="/api/ibexa/v2/content/objects/79"/>
            </VersionInfo>
            <Fields>
                <field>
                    <id>342</id>
                    <fieldDefinitionIdentifier>first_name</fieldDefinitionIdentifier>
                    <languageCode>eng-GB</languageCode>
                    <fieldTypeIdentifier>ibexa_string</fieldTypeIdentifier>
                    <fieldValue>Jose</fieldValue>
                </field>
                <field>
                    <id>343</id>
                    <fieldDefinitionIdentifier>last_name</fieldDefinitionIdentifier>
                    <languageCode>eng-GB</languageCode>
                    <fieldTypeIdentifier>ibexa_string</fieldTypeIdentifier>
                    <fieldValue>Vargas</fieldValue>
                </field>
                <field>
                    <id>344</id>
                    <fieldDefinitionIdentifier>user_account</fieldDefinitionIdentifier>
                    <languageCode>eng-GB</languageCode>
                    <fieldTypeIdentifier>ibexa_user</fieldTypeIdentifier>
                    <fieldValue>
                        <value key="hasStoredLogin">true</value>
                        <value key="contentId">79</value>
                        <value key="login">josevargas</value>
                        <value key="email">aa@bb.cc</value>
                        <value key="passwordUpdatedAt">1624955022</value>
                        <value key="enabled">true</value>
                        <value key="maxLogin">0</value>
                        <value key="plainPassword"/>
                    </fieldValue>
                </field>
                <field>
                    <id>345</id>
                    <fieldDefinitionIdentifier>signature</fieldDefinitionIdentifier>
                    <languageCode>eng-GB</languageCode>
                    <fieldTypeIdentifier>ibexa_text</fieldTypeIdentifier>
                    <fieldValue/>
                </field>
                <field>
                    <id>346</id>
                    <fieldDefinitionIdentifier>image</fieldDefinitionIdentifier>
                    <languageCode>eng-GB</languageCode>
                    <fieldTypeIdentifier>ibexa_image</fieldTypeIdentifier>
                    <fieldValue/>
                </field>
            </Fields>
            <Relations media-type="application/vnd.ibexa.api.RelationList+xml" href="/api/ibexa/v2/content/objects/79/versions/1/relations"/>
            <Thumbnail media-type="application/vnd.ibexa.api.Thumbnail+xml">
                <resource>/bundles/ezplatformadminui/img/ez-icons.svg#user</resource>
                <width></width>
                <height></height>
                <mimeType>image/svg+xml</mimeType>
            </Thumbnail>
        </Version>
        <login>josevargas</login>
        <email>aa@bb.cc</email>
        <enabled>true</enabled>
        <UserGroups media-type="application/vnd.ibexa.api.UserGroupList+xml" href="/api/ibexa/v2/user/users/79/groups"/>
        <Roles media-type="application/vnd.ibexa.api.RoleAssignmentList+xml" href="/api/ibexa/v2/user/users/79/roles"/>
    </User>
</UserList>

Verify Users

Verifies if there are Users matching given filter.

Responses

Load User

Loads User with the given ID.

path Parameters
userId
required
string

UserLoadByIdController identifier

header Parameters
Accept
required
string

If set, the User is returned in XML or JSON format.

If-None-Match
required
string

ETag

Responses

Response samples

Content type
<?xml version="1.0" encoding="UTF-8"?>
<UserList media-type="application/vnd.ibexa.api.UserList+xml" href="/api/ibexa/v2/user/users">
    <User media-type="application/vnd.ibexa.api.User+xml" href="/api/ibexa/v2/user/users/79" id="79" remoteId="bcf0764b417f05af21852a1f03fb1f13">
        <ContentType media-type="application/vnd.ibexa.api.ContentType+xml" href="/api/ibexa/v2/content/types/4"/>
        <name>Jose Vargas</name>
        <Versions media-type="application/vnd.ibexa.api.VersionList+xml" href="/api/ibexa/v2/content/objects/79/versions"/>
        <Section media-type="application/vnd.ibexa.api.Section+xml" href="/api/ibexa/v2/content/sections/2"/>
        <MainLocation media-type="application/vnd.ibexa.api.Location+xml" href="/api/ibexa/v2/content/locations/1/5/12/79"/>
        <Locations media-type="application/vnd.ibexa.api.LocationList+xml" href="/api/ibexa/v2/content/objects/79/locations"/>
        <Groups media-type="application/vnd.ibexa.api.UserGroupRefList+xml" href="/api/ibexa/v2/user/users/79/groups"/>
        <Owner media-type="application/vnd.ibexa.api.User+xml" href="/api/ibexa/v2/user/users/10"/>
        <publishDate>2021-06-29T08:23:42+00:00</publishDate>
        <lastModificationDate>2021-06-29T08:23:42+00:00</lastModificationDate>
        <mainLanguageCode>eng-GB</mainLanguageCode>
        <alwaysAvailable>true</alwaysAvailable>
        <Version media-type="application/vnd.ibexa.api.Version+xml" href="/api/ibexa/v2/content/objects/79/versions/1">
            <VersionInfo>
                <id>547</id>
                <versionNo>1</versionNo>
                <status>PUBLISHED</status>
                <modificationDate>2021-06-29T08:23:42+00:00</modificationDate>
                <Creator media-type="application/vnd.ibexa.api.User+xml" href="/api/ibexa/v2/user/users/10"/>
                <creationDate>2021-06-29T08:23:42+00:00</creationDate>
                <initialLanguageCode>eng-GB</initialLanguageCode>
                <languageCodes>eng-GB</languageCodes>
                <VersionTranslationInfo media-type="application/vnd.ibexa.api.VersionTranslationInfo+xml">
                    <Language>
                        <languageCode>eng-GB</languageCode>
                    </Language>
                </VersionTranslationInfo>
                <names>
                    <value languageCode="eng-GB">Jose Vargas</value>
                </names>
                <Content media-type="application/vnd.ibexa.api.ContentInfo+xml" href="/api/ibexa/v2/content/objects/79"/>
            </VersionInfo>
            <Fields>
                <field>
                    <id>342</id>
                    <fieldDefinitionIdentifier>first_name</fieldDefinitionIdentifier>
                    <languageCode>eng-GB</languageCode>
                    <fieldTypeIdentifier>ibexa_string</fieldTypeIdentifier>
                    <fieldValue>Jose</fieldValue>
                </field>
                <field>
                    <id>343</id>
                    <fieldDefinitionIdentifier>last_name</fieldDefinitionIdentifier>
                    <languageCode>eng-GB</languageCode>
                    <fieldTypeIdentifier>ibexa_string</fieldTypeIdentifier>
                    <fieldValue>Vargas</fieldValue>
                </field>
                <field>
                    <id>344</id>
                    <fieldDefinitionIdentifier>user_account</fieldDefinitionIdentifier>
                    <languageCode>eng-GB</languageCode>
                    <fieldTypeIdentifier>ibexa_user</fieldTypeIdentifier>
                    <fieldValue>
                        <value key="hasStoredLogin">true</value>
                        <value key="contentId">79</value>
                        <value key="login">josevargas</value>
                        <value key="email">aa@bb.cc</value>
                        <value key="passwordUpdatedAt">1624955022</value>
                        <value key="enabled">true</value>
                        <value key="maxLogin">0</value>
                        <value key="plainPassword"/>
                    </fieldValue>
                </field>
                <field>
                    <id>345</id>
                    <fieldDefinitionIdentifier>signature</fieldDefinitionIdentifier>
                    <languageCode>eng-GB</languageCode>
                    <fieldTypeIdentifier>ibexa_text</fieldTypeIdentifier>
                    <fieldValue/>
                </field>
                <field>
                    <id>346</id>
                    <fieldDefinitionIdentifier>image</fieldDefinitionIdentifier>
                    <languageCode>eng-GB</languageCode>
                    <fieldTypeIdentifier>ibexa_image</fieldTypeIdentifier>
                    <fieldValue/>
                </field>
            </Fields>
            <Relations media-type="application/vnd.ibexa.api.RelationList+xml" href="/api/ibexa/v2/content/objects/79/versions/1/relations"/>
            <Thumbnail media-type="application/vnd.ibexa.api.Thumbnail+xml">
                <resource>/bundles/ezplatformadminui/img/ez-icons.svg#user</resource>
                <width></width>
                <height></height>
                <mimeType>image/svg+xml</mimeType>
            </Thumbnail>
        </Version>
        <login>josevargas</login>
        <email>aa@bb.cc</email>
        <enabled>true</enabled>
        <UserGroups media-type="application/vnd.ibexa.api.UserGroupList+xml" href="/api/ibexa/v2/user/users/79/groups"/>
        <Roles media-type="application/vnd.ibexa.api.RoleAssignmentList+xml" href="/api/ibexa/v2/user/users/79/roles"/>
    </User>
</UserList>

Delete User

Deletes the given User.

path Parameters
userId
required
string

UserDeleteController identifier

Responses

Update User

Updates a User.

path Parameters
userId
required
string

UserUpdateController identifier

header Parameters
Accept
required
string

If set, the updated User is returned in XML or JSON format.

Content-Type
required
string

The UserUpdate schema encoded in XML or JSON format.

If-Match
required
string

Performs a PATCH only if the specified ETag is the current one.

Request Body schema:
optional

The updated UserUpdateController resource

login
required
string
email
string
password
string
enabled
boolean
maxLogin
integer
ContentUpdate
any

The update structure for the profile content.

ContentMetadataUpdate
any

The update structure for the profile metadata.

Responses

Request samples

Content type
<?xml version="1.0" encoding="UTF-8"?>
<UserUpdate>
  <login>josevargas</login>
  <enabled>false</enabled>
</UserUpdate>

Response samples

Content type
<?xml version="1.0" encoding="UTF-8"?>
<User media-type="application/vnd.ibexa.api.User+xml" href="/api/ibexa/v2/user/users/79" id="79" remoteId="bcf0764b417f05af21852a1f03fb1f13">
    <ContentType media-type="application/vnd.ibexa.api.ContentType+xml" href="/api/ibexa/v2/content/types/4"/>
    <name>Jose Vargas</name>
    <Versions media-type="application/vnd.ibexa.api.VersionList+xml" href="/api/ibexa/v2/content/objects/79/versions"/>
    <Section media-type="application/vnd.ibexa.api.Section+xml" href="/api/ibexa/v2/content/sections/2"/>
    <MainLocation media-type="application/vnd.ibexa.api.Location+xml" href="/api/ibexa/v2/content/locations/1/5/12/79"/>
    <Locations media-type="application/vnd.ibexa.api.LocationList+xml" href="/api/ibexa/v2/content/objects/79/locations"/>
    <Groups media-type="application/vnd.ibexa.api.UserGroupRefList+xml" href="/api/ibexa/v2/user/users/79/groups"/>
    <Owner media-type="application/vnd.ibexa.api.User+xml" href="/api/ibexa/v2/user/users/10"/>
    <publishDate>2021-06-29T08:23:42+00:00</publishDate>
    <lastModificationDate>2021-07-29T11:45:07+00:00</lastModificationDate>
    <mainLanguageCode>eng-GB</mainLanguageCode>
    <alwaysAvailable>true</alwaysAvailable>
    <Version media-type="application/vnd.ibexa.api.Version+xml" href="/api/ibexa/v2/content/objects/79/versions/6">
        <VersionInfo>
            <id>609</id>
            <versionNo>6</versionNo>
            <status>PUBLISHED</status>
            <modificationDate>2021-07-29T11:45:07+00:00</modificationDate>
            <Creator media-type="application/vnd.ibexa.api.User+xml" href="/api/ibexa/v2/user/users/14"/>
            <creationDate>2021-07-29T11:45:07+00:00</creationDate>
            <initialLanguageCode>eng-GB</initialLanguageCode>
            <languageCodes>eng-GB</languageCodes>
            <VersionTranslationInfo media-type="application/vnd.ibexa.api.VersionTranslationInfo+xml">
                <Language>
                    <languageCode>eng-GB</languageCode>
                </Language>
            </VersionTranslationInfo>
            <names>
                <value languageCode="eng-GB">Jose Vargas</value>
            </names>
            <Content media-type="application/vnd.ibexa.api.ContentInfo+xml" href="/api/ibexa/v2/content/objects/79"/>
        </VersionInfo>
        <Fields>
            <field>
                <id>342</id>
                <fieldDefinitionIdentifier>first_name</fieldDefinitionIdentifier>
                <languageCode>eng-GB</languageCode>
                <fieldTypeIdentifier>ibexa_string</fieldTypeIdentifier>
                <fieldValue>Jose</fieldValue>
            </field>
            <field>
                <id>343</id>
                <fieldDefinitionIdentifier>last_name</fieldDefinitionIdentifier>
                <languageCode>eng-GB</languageCode>
                <fieldTypeIdentifier>ibexa_string</fieldTypeIdentifier>
                <fieldValue>Vargas</fieldValue>
            </field>
            <field>
                <id>344</id>
                <fieldDefinitionIdentifier>user_account</fieldDefinitionIdentifier>
                <languageCode>eng-GB</languageCode>
                <fieldTypeIdentifier>ibexa_user</fieldTypeIdentifier>
                <fieldValue>
                    <value key="hasStoredLogin">true</value>
                    <value key="contentId">79</value>
                    <value key="login">josevargas</value>
                    <value key="email">aa@bb.cc</value>
                    <value key="passwordUpdatedAt"/>
                    <value key="enabled">false</value>
                    <value key="maxLogin">0</value>
                    <value key="plainPassword"/>
                </fieldValue>
            </field>
            <field>
                <id>345</id>
                <fieldDefinitionIdentifier>signature</fieldDefinitionIdentifier>
                <languageCode>eng-GB</languageCode>
                <fieldTypeIdentifier>ibexa_text</fieldTypeIdentifier>
                <fieldValue/>
            </field>
            <field>
                <id>346</id>
                <fieldDefinitionIdentifier>image</fieldDefinitionIdentifier>
                <languageCode>eng-GB</languageCode>
                <fieldTypeIdentifier>ibexa_image</fieldTypeIdentifier>
                <fieldValue/>
            </field>
        </Fields>
        <Relations media-type="application/vnd.ibexa.api.RelationList+xml" href="/api/ibexa/v2/content/objects/79/versions/6/relations"/>
        <Thumbnail media-type="application/vnd.ibexa.api.Thumbnail+xml">
            <resource>/bundles/ezplatformadminui/img/ez-icons.svg#user</resource>
            <width></width>
            <height></height>
            <mimeType>image/svg+xml</mimeType>
        </Thumbnail>
    </Version>
    <login>josevargas</login>
    <email>aa@bb.cc</email>
    <enabled>false</enabled>
    <UserGroups media-type="application/vnd.ibexa.api.UserGroupList+xml" href="/api/ibexa/v2/user/users/79/groups"/>
    <Roles media-type="application/vnd.ibexa.api.RoleAssignmentList+xml" href="/api/ibexa/v2/user/users/79/roles"/>
</User>

Load user drafts

Loads user's drafts

path Parameters
userId
required
string

UserDraftListController identifier

header Parameters
Accept
required
string

If set, the version list is returned in XML or JSON format.

Responses

Response samples

Content type
No sample

Load Groups of User

Returns a list of User Groups the User belongs to. The returned list includes the resources for unassigning a User Group if the User is in multiple groups.

path Parameters
userId
required
string

UserGroupsOfUserListController identifier

header Parameters
Accept
required
string

If set, the link list of User Groups is returned in XML or JSON format.

Responses

Response samples

Content type
<?xml version="1.0" encoding="UTF-8"?>
<UserGroupRefList media-type="application/vnd.ibexa.api.UserGroupRefList+xml" href="/api/ibexa/v2/user/users/115/groups">
    <UserGroup media-type="application/vnd.ibexa.api.UserGroup+xml" href="/api/ibexa/v2/user/groups/1/5/12">
        <unassign href="/api/ibexa/v2/user/users/79/groups/12" method="DELETE"/>
    </UserGroup>
    <UserGroup media-type="application/vnd.ibexa.api.UserGroup+xml" href="/api/ibexa/v2/user/groups/1/5/13">
        <unassign href="/api/ibexa/v2/user/users/115/groups/13" method="DELETE"/>
    </UserGroup>
</UserGroupRefList>

Assign User Group

Assigns the User to a User Group.

path Parameters
userId
required
string

UserAssignToUserGroupController identifier

header Parameters
Accept
required
string

If set, the link list of User Groups is returned in XML or JSON format.

Responses

Response samples

Content type
<?xml version="1.0" encoding="UTF-8"?>
<UserGroupRefList media-type="application/vnd.ibexa.api.UserGroupRefList+xml" href="/api/ibexa/v2/user/users/115/groups">
    <UserGroup media-type="application/vnd.ibexa.api.UserGroup+xml" href="/api/ibexa/v2/user/groups/1/5/12">
        <unassign href="/api/ibexa/v2/user/users/79/groups/12" method="DELETE"/>
    </UserGroup>
    <UserGroup media-type="application/vnd.ibexa.api.UserGroup+xml" href="/api/ibexa/v2/user/groups/1/5/13">
        <unassign href="/api/ibexa/v2/user/users/115/groups/13" method="DELETE"/>
    </UserGroup>
</UserGroupRefList>

Unassign User Group

Unassigns the User from a User Group.

path Parameters
userId
required
string

UserUnassignFromUserGroupController identifier

groupId
required
string

UserUnassignFromUserGroupController identifier

header Parameters
Accept
required
string

If set, the link list of User Groups is returned in XML or JSON format.

Responses

Response samples

Content type
<?xml version="1.0" encoding="UTF-8"?>
<UserGroupRefList media-type="application/vnd.ibexa.api.UserGroupRefList+xml" href="/api/ibexa/v2/user/users/115/groups">
    <UserGroup media-type="application/vnd.ibexa.api.UserGroup+xml" href="/api/ibexa/v2/user/groups/1/5/12">
        <unassign href="/api/ibexa/v2/user/users/79/groups/12" method="DELETE"/>
    </UserGroup>
    <UserGroup media-type="application/vnd.ibexa.api.UserGroup+xml" href="/api/ibexa/v2/user/groups/1/5/13">
        <unassign href="/api/ibexa/v2/user/users/115/groups/13" method="DELETE"/>
    </UserGroup>
</UserGroupRefList>

Load Roles for User

Returns a list of all Roles assigned to the given User.

path Parameters
userId
required
string

RoleAssignmentForUserListController identifier

Responses

Response samples

Content type
{
  • "RoleAssignmentList": {
    }
}

Assign Role to User

Assigns a Role to a user.

path Parameters
userId
required
string

RoleAssignToUserController identifier

header Parameters
X-CSRF-Token
required
string

The CSRF Token needed on all unsafe HTTP methods with session.

Request Body schema:
optional

The RoleAssignInput schema encoded in XML or JSON format.

required
object (RoleAssignInput)

This class represents a Role assign input.

Responses

Request samples

Content type
{
  • "RoleAssignInput": {
    }
}

Response samples

Content type
{
  • "RoleAssignmentList": {
    }
}

Load User Role Assignment

Returns a Role assignment to the given User.

path Parameters
userId
required
string

RoleAssignmentForUserLoadByIdController identifier

roleId
required
string

RoleAssignmentForUserLoadByIdController identifier

Responses

Response samples

Content type
{
  • "RoleAssignment": {
    }
}

Unassign Role from User

The given Role is removed from the user.

path Parameters
userId
required
string

RoleUnassignFromUserController identifier

roleId
required
string

RoleUnassignFromUserController identifier

header Parameters
X-CSRF-Token
required
string

The CSRF Token needed on all unsafe HTTP methods with session.

Responses

Response samples

Content type
{
  • "RoleAssignmentList": {
    }
}

View user segments

Return user's segment list.

path Parameters
userId
required
string

UserSegmentListController identifier

Responses

Response samples

Content type
{
  • "UserSegmentList": {
    }
}

Assign Segments to User

Assigns Segments from payload to User given by ID.

path Parameters
userId
required
string

UserSegmentAssignController identifier

header Parameters
X-CSRF-Token
required
string

The CSRF token. Used for POST, PATCH and DELETE requests.

Request Body schema:
optional

The UserSegmentAssignInput schema encoded in XML or JSON format.

required
object (UserSegmentAssignInput)

Responses

Request samples

Content type
{
  • "UserSegmentAssignInput": {
    }
}

Unassign Segment from User

The Segment designated by its identifier is unassigned from the User given by ID.

path Parameters
userId
required
string

UserSegmentUnassignController identifier

segmentIdentifier
required
string

UserSegmentUnassignController identifier

header Parameters
X-CSRF-Token
required
string

The CSRF token. Used for POST, PATCH and DELETE requests.

Responses

User Group

Resource 'User Group' operations.

Load User Groups

Loads User Groups for either an an ID or a remote ID or a Role.

header Parameters
Accept
required
string

UserGroupList - If set, the User Group List is returned in XML or JSON format. UserGroupRefList - If set, the link list of User Group is returned in XML or JSON format.

Responses

Response samples

Content type
<?xml version="1.0" encoding="UTF-8"?>
<UserGroupList media-type="application/vnd.ibexa.api.UserGroupList+xml" href="/api/ibexa/v2/user/groups">
    <UserGroup media-type="application/vnd.ibexa.api.UserGroup+xml" href="/api/ibexa/v2/user/groups/1/5/13/15" id="14" remoteId="1bb4fe25487f05527efa8bfd394cecc7">
        <ContentType media-type="application/vnd.ibexa.api.ContentType+xml" href="/api/ibexa/v2/content/types/4"/>
        <name>Administrator User</name>
        <Versions media-type="application/vnd.ibexa.api.VersionList+xml" href="/api/ibexa/v2/content/objects/14/versions"/>
        <Section media-type="application/vnd.ibexa.api.Section+xml" href="/api/ibexa/v2/content/sections/2"/>
        <MainLocation media-type="application/vnd.ibexa.api.Location+xml" href="/api/ibexa/v2/content/locations/1/5/13/15"/>
        <Locations media-type="application/vnd.ibexa.api.LocationList+xml" href="/api/ibexa/v2/content/objects/14/locations"/>
        <Owner media-type="application/vnd.ibexa.api.User+xml" href="/api/ibexa/v2/user/users/14"/>
        <publishDate>2002-10-06T16:13:50+00:00</publishDate>
        <lastModificationDate>2011-03-25T14:07:04+00:00</lastModificationDate>
        <mainLanguageCode>eng-GB</mainLanguageCode>
        <alwaysAvailable>true</alwaysAvailable>
        <Version media-type="application/vnd.ibexa.api.Version+xml" href="/api/ibexa/v2/content/objects/14/versions/3">
            <VersionInfo>
                <id>499</id>
                <versionNo>3</versionNo>
                <status>PUBLISHED</status>
                <modificationDate>2011-03-25T14:07:04+00:00</modificationDate>
                <Creator media-type="application/vnd.ibexa.api.User+xml" href="/api/ibexa/v2/user/users/14"/>
                <creationDate>2011-03-25T14:03:03+00:00</creationDate>
                <initialLanguageCode>eng-GB</initialLanguageCode>
                <languageCodes>eng-GB</languageCodes>
                <VersionTranslationInfo media-type="application/vnd.ibexa.api.VersionTranslationInfo+xml">
                    <Language>
                        <languageCode>eng-GB</languageCode>
                    </Language>
                </VersionTranslationInfo>
                <names>
                    <value languageCode="eng-GB">Administrator User</value>
                </names>
                <Content media-type="application/vnd.ibexa.api.ContentInfo+xml" href="/api/ibexa/v2/content/objects/14"/>
            </VersionInfo>
            <Fields>
                <field>
                    <id>28</id>
                    <fieldDefinitionIdentifier>first_name</fieldDefinitionIdentifier>
                    <languageCode>eng-GB</languageCode>
                    <fieldTypeIdentifier>ibexa_string</fieldTypeIdentifier>
                    <fieldValue>Administrator</fieldValue>
                </field>
                <field>
                    <id>29</id>
                    <fieldDefinitionIdentifier>last_name</fieldDefinitionIdentifier>
                    <languageCode>eng-GB</languageCode>
                    <fieldTypeIdentifier>ibexa_string</fieldTypeIdentifier>
                    <fieldValue>User</fieldValue>
                </field>
                <field>
                    <id>30</id>
                    <fieldDefinitionIdentifier>user_account</fieldDefinitionIdentifier>
                    <languageCode>eng-GB</languageCode>
                    <fieldTypeIdentifier>ibexa_user</fieldTypeIdentifier>
                    <fieldValue>
                        <value key="hasStoredLogin">true</value>
                        <value key="contentId">14</value>
                        <value key="login">admin</value>
                        <value key="email">admin@link.invalid</value>
                        <value key="passwordUpdatedAt"/>
                        <value key="enabled">true</value>
                        <value key="maxLogin">10</value>
                        <value key="plainPassword"/>
                    </fieldValue>
                </field>
                <field>
                    <id>178</id>
                    <fieldDefinitionIdentifier>signature</fieldDefinitionIdentifier>
                    <languageCode>eng-GB</languageCode>
                    <fieldTypeIdentifier>ibexa_text</fieldTypeIdentifier>
                    <fieldValue/>
                </field>
                <field>
                    <id>180</id>
                    <fieldDefinitionIdentifier>image</fieldDefinitionIdentifier>
                    <languageCode>eng-GB</languageCode>
                    <fieldTypeIdentifier>ibexa_image</fieldTypeIdentifier>
                    <fieldValue/>
                </field>
            </Fields>
            <Relations media-type="application/vnd.ibexa.api.RelationList+xml" href="/api/ibexa/v2/content/objects/14/versions/3/relations"/>
            <Thumbnail media-type="application/vnd.ibexa.api.Thumbnail+xml">
                <resource>/bundles/ezplatformadminui/img/ez-icons.svg#user</resource>
                <width></width>
                <height></height>
                <mimeType>image/svg+xml</mimeType>
            </Thumbnail>
        </Version>
        <ParentUserGroup media-type="application/vnd.ibexa.api.UserGroup+xml" href="/api/ibexa/v2/user/groups/1/5/13"/>
        <Subgroups media-type="application/vnd.ibexa.api.UserGroupList+xml" href="/api/ibexa/v2/user/groups/1/5/13/15/subgroups"/>
        <Users media-type="application/vnd.ibexa.api.UserList+xml" href="/api/ibexa/v2/user/groups/1/5/13/15/users"/>
        <Roles media-type="application/vnd.ibexa.api.RoleAssignmentList+xml" href="/api/ibexa/v2/user/groups/1/5/13/15/roles"/>
    </UserGroup>
</UserGroupList>

Get root User Group

Redirects to the root User Group.

Responses

Create a top level User Group

Creates a top level User Group under the root. To create a child group under a parent group use '/user/groups/{path}/subgroups'.

header Parameters
Accept
required
string

If set, the new User Group is returned in XML or JSON format.

Content-Type
required
string

The UserGroupCreate schema encoded in XML or JSON format.

Request Body schema:
optional

The new UserGroupCreateController resource

mainLanguageCode
required
string
remoteId
required
string
required
object (Fields)

Responses

Request samples

Content type
<?xml version="1.0" encoding="UTF-8"?>
<UserGroupCreate>
  <mainLanguageCode>eng-GB</mainLanguageCode>
  <remoteId>remoteId-qwert098</remoteId>
  <fields>
    <field>
      <fieldDefinitionIdentifier>name</fieldDefinitionIdentifier>
      <languageCode>eng-GB</languageCode>
      <fieldValue>UserGroup</fieldValue>
    </field>
    <field>
      <fieldDefinitionIdentifier>description</fieldDefinitionIdentifier>
      <languageCode>eng-GB</languageCode>
      <fieldValue>This is the description of the user group</fieldValue>
    </field>
  </fields>
</UserGroupCreate>

Response samples

Content type
<?xml version="1.0" encoding="UTF-8"?>
<UserGroup media-type="application/vnd.ibexa.api.UserGroup+xml" href="/api/ibexa/v2/user/groups/1/5/79" id="85" remoteId="remoteId-qwert098">
    <ContentType media-type="application/vnd.ibexa.api.ContentType+xml" href="/api/ibexa/v2/content/types/3"/>
    <name>UserGroup2</name>
    <Versions media-type="application/vnd.ibexa.api.VersionList+xml" href="/api/ibexa/v2/content/objects/85/versions"/>
    <Section media-type="application/vnd.ibexa.api.Section+xml" href="/api/ibexa/v2/content/sections/2"/>
    <MainLocation media-type="application/vnd.ibexa.api.Location+xml" href="/api/ibexa/v2/content/locations/1/5/79"/>
    <Locations media-type="application/vnd.ibexa.api.LocationList+xml" href="/api/ibexa/v2/content/objects/85/locations"/>
    <Owner media-type="application/vnd.ibexa.api.User+xml" href="/api/ibexa/v2/user/users/14"/>
    <publishDate>2021-08-09T09:03:35+00:00</publishDate>
    <lastModificationDate>2021-08-09T09:03:35+00:00</lastModificationDate>
    <mainLanguageCode>eng-GB</mainLanguageCode>
    <alwaysAvailable>true</alwaysAvailable>
    <Version media-type="application/vnd.ibexa.api.Version+xml" href="/api/ibexa/v2/content/objects/85/versions/1">
        <VersionInfo>
            <id>576</id>
            <versionNo>1</versionNo>
            <status>PUBLISHED</status>
            <modificationDate>2021-08-09T09:03:35+00:00</modificationDate>
            <Creator media-type="application/vnd.ibexa.api.User+xml" href="/api/ibexa/v2/user/users/14"/>
            <creationDate>2021-08-09T09:03:35+00:00</creationDate>
            <initialLanguageCode>eng-GB</initialLanguageCode>
            <languageCodes>eng-GB</languageCodes>
            <VersionTranslationInfo media-type="application/vnd.ibexa.api.VersionTranslationInfo+xml">
                <Language>
                    <languageCode>eng-GB</languageCode>
                </Language>
            </VersionTranslationInfo>
            <names>
                <value languageCode="eng-GB">UserGroup2</value>
            </names>
            <Content media-type="application/vnd.ibexa.api.ContentInfo+xml" href="/api/ibexa/v2/content/objects/85"/>
        </VersionInfo>
        <Fields>
            <field>
                <id>380</id>
                <fieldDefinitionIdentifier>name</fieldDefinitionIdentifier>
                <languageCode>eng-GB</languageCode>
                <fieldTypeIdentifier>ibexa_string</fieldTypeIdentifier>
                <fieldValue>UserGroup2</fieldValue>
            </field>
            <field>
                <id>381</id>
                <fieldDefinitionIdentifier>description</fieldDefinitionIdentifier>
                <languageCode>eng-GB</languageCode>
                <fieldTypeIdentifier>ibexa_string</fieldTypeIdentifier>
                <fieldValue>This is the description of the user group</fieldValue>
            </field>
        </Fields>
        <Relations media-type="application/vnd.ibexa.api.RelationList+xml" href="/api/ibexa/v2/content/objects/85/versions/1/relations"/>
        <Thumbnail media-type="application/vnd.ibexa.api.Thumbnail+xml">
            <resource>/bundles/ezplatformadminui/img/ez-icons.svg#user_group</resource>
            <width></width>
            <height></height>
            <mimeType>image/svg+xml</mimeType>
        </Thumbnail>
    </Version>
    <ParentUserGroup media-type="application/vnd.ibexa.api.UserGroup+xml" href="/api/ibexa/v2/user/groups/1/5"/>
    <Subgroups media-type="application/vnd.ibexa.api.UserGroupList+xml" href="/api/ibexa/v2/user/groups/1/5/79/subgroups"/>
    <Users media-type="application/vnd.ibexa.api.UserList+xml" href="/api/ibexa/v2/user/groups/1/5/79/users"/>
    <Roles media-type="application/vnd.ibexa.api.RoleAssignmentList+xml" href="/api/ibexa/v2/user/groups/1/5/79/roles"/>
</UserGroup>

Load User Group

Loads User Groups for the given {path}.

path Parameters
path
required
string

UserGroupLoadByPathController identifier

header Parameters
Accept
required
string

If set, the new User Group is returned in XML or JSON format.

If-None-Match
required
string

ETag

Responses

Response samples

Content type
<?xml version="1.0" encoding="UTF-8"?>
<UserGroup media-type="application/vnd.ibexa.api.UserGroup+xml" href="/api/ibexa/v2/user/groups/1/5/79" id="85" remoteId="remoteId-qwert098">
    <ContentType media-type="application/vnd.ibexa.api.ContentType+xml" href="/api/ibexa/v2/content/types/3"/>
    <name>UserGroup2</name>
    <Versions media-type="application/vnd.ibexa.api.VersionList+xml" href="/api/ibexa/v2/content/objects/85/versions"/>
    <Section media-type="application/vnd.ibexa.api.Section+xml" href="/api/ibexa/v2/content/sections/2"/>
    <MainLocation media-type="application/vnd.ibexa.api.Location+xml" href="/api/ibexa/v2/content/locations/1/5/79"/>
    <Locations media-type="application/vnd.ibexa.api.LocationList+xml" href="/api/ibexa/v2/content/objects/85/locations"/>
    <Owner media-type="application/vnd.ibexa.api.User+xml" href="/api/ibexa/v2/user/users/14"/>
    <publishDate>2021-08-09T09:03:35+00:00</publishDate>
    <lastModificationDate>2021-08-09T09:03:35+00:00</lastModificationDate>
    <mainLanguageCode>eng-GB</mainLanguageCode>
    <alwaysAvailable>true</alwaysAvailable>
    <Version media-type="application/vnd.ibexa.api.Version+xml" href="/api/ibexa/v2/content/objects/85/versions/1">
        <VersionInfo>
            <id>576</id>
            <versionNo>1</versionNo>
            <status>PUBLISHED</status>
            <modificationDate>2021-08-09T09:03:35+00:00</modificationDate>
            <Creator media-type="application/vnd.ibexa.api.User+xml" href="/api/ibexa/v2/user/users/14"/>
            <creationDate>2021-08-09T09:03:35+00:00</creationDate>
            <initialLanguageCode>eng-GB</initialLanguageCode>
            <languageCodes>eng-GB</languageCodes>
            <VersionTranslationInfo media-type="application/vnd.ibexa.api.VersionTranslationInfo+xml">
                <Language>
                    <languageCode>eng-GB</languageCode>
                </Language>
            </VersionTranslationInfo>
            <names>
                <value languageCode="eng-GB">UserGroup2</value>
            </names>
            <Content media-type="application/vnd.ibexa.api.ContentInfo+xml" href="/api/ibexa/v2/content/objects/85"/>
        </VersionInfo>
        <Fields>
            <field>
                <id>380</id>
                <fieldDefinitionIdentifier>name</fieldDefinitionIdentifier>
                <languageCode>eng-GB</languageCode>
                <fieldTypeIdentifier>ibexa_string</fieldTypeIdentifier>
                <fieldValue>UserGroup2</fieldValue>
            </field>
            <field>
                <id>381</id>
                <fieldDefinitionIdentifier>description</fieldDefinitionIdentifier>
                <languageCode>eng-GB</languageCode>
                <fieldTypeIdentifier>ibexa_string</fieldTypeIdentifier>
                <fieldValue>This is the description of the user group</fieldValue>
            </field>
        </Fields>
        <Relations media-type="application/vnd.ibexa.api.RelationList+xml" href="/api/ibexa/v2/content/objects/85/versions/1/relations"/>
        <Thumbnail media-type="application/vnd.ibexa.api.Thumbnail+xml">
            <resource>/bundles/ezplatformadminui/img/ez-icons.svg#user_group</resource>
            <width></width>
            <height></height>
            <mimeType>image/svg+xml</mimeType>
        </Thumbnail>
    </Version>
    <ParentUserGroup media-type="application/vnd.ibexa.api.UserGroup+xml" href="/api/ibexa/v2/user/groups/1/5"/>
    <Subgroups media-type="application/vnd.ibexa.api.UserGroupList+xml" href="/api/ibexa/v2/user/groups/1/5/79/subgroups"/>
    <Users media-type="application/vnd.ibexa.api.UserList+xml" href="/api/ibexa/v2/user/groups/1/5/79/users"/>
    <Roles media-type="application/vnd.ibexa.api.RoleAssignmentList+xml" href="/api/ibexa/v2/user/groups/1/5/79/roles"/>
</UserGroup>

Delete User Group

The given User Group is deleted.

path Parameters
path
required
string

UserGroupDeleteController identifier

Responses

Update User Group

Updates a User Group. PATCH or POST with header X-HTTP-Method-Override PATCH.

path Parameters
path
required
string

UserGroupUpdateController identifier

header Parameters
Accept
required
string

If set, the new User Group is returned in XML or JSON format.

Content-Type
required
string

The UserGroupUpdate schema encoded in XML or JSON format.

If-Match
required
string

Performs the PATCH only if the specified ETag is the current one. Otherwise a 412 is returned.

Request Body schema:
optional

The updated UserGroupUpdateController resource

required
object

Responses

Request samples

Content type
<?xml version="1.0" encoding="UTF-8"?>
<UserGroupUpdate>
	<Section href="/api/ibexa/v2/content/sections/2" />
</UserGroupUpdate>

Response samples

Content type
<?xml version="1.0" encoding="UTF-8"?>
<UserGroup media-type="application/vnd.ibexa.api.UserGroup+xml" href="/api/ibexa/v2/user/groups/1/5/79" id="85" remoteId="remoteId-qwert098">
    <ContentType media-type="application/vnd.ibexa.api.ContentType+xml" href="/api/ibexa/v2/content/types/3"/>
    <name>UserGroup2</name>
    <Versions media-type="application/vnd.ibexa.api.VersionList+xml" href="/api/ibexa/v2/content/objects/85/versions"/>
    <Section media-type="application/vnd.ibexa.api.Section+xml" href="/api/ibexa/v2/content/sections/2"/>
    <MainLocation media-type="application/vnd.ibexa.api.Location+xml" href="/api/ibexa/v2/content/locations/1/5/79"/>
    <Locations media-type="application/vnd.ibexa.api.LocationList+xml" href="/api/ibexa/v2/content/objects/85/locations"/>
    <Owner media-type="application/vnd.ibexa.api.User+xml" href="/api/ibexa/v2/user/users/14"/>
    <publishDate>2021-08-09T09:03:35+00:00</publishDate>
    <lastModificationDate>2021-08-09T09:03:35+00:00</lastModificationDate>
    <mainLanguageCode>eng-GB</mainLanguageCode>
    <alwaysAvailable>true</alwaysAvailable>
    <Version media-type="application/vnd.ibexa.api.Version+xml" href="/api/ibexa/v2/content/objects/85/versions/1">
        <VersionInfo>
            <id>576</id>
            <versionNo>1</versionNo>
            <status>PUBLISHED</status>
            <modificationDate>2021-08-09T09:03:35+00:00</modificationDate>
            <Creator media-type="application/vnd.ibexa.api.User+xml" href="/api/ibexa/v2/user/users/14"/>
            <creationDate>2021-08-09T09:03:35+00:00</creationDate>
            <initialLanguageCode>eng-GB</initialLanguageCode>
            <languageCodes>eng-GB</languageCodes>
            <VersionTranslationInfo media-type="application/vnd.ibexa.api.VersionTranslationInfo+xml">
                <Language>
                    <languageCode>eng-GB</languageCode>
                </Language>
            </VersionTranslationInfo>
            <names>
                <value languageCode="eng-GB">UserGroup2</value>
            </names>
            <Content media-type="application/vnd.ibexa.api.ContentInfo+xml" href="/api/ibexa/v2/content/objects/85"/>
        </VersionInfo>
        <Fields>
            <field>
                <id>380</id>
                <fieldDefinitionIdentifier>name</fieldDefinitionIdentifier>
                <languageCode>eng-GB</languageCode>
                <fieldTypeIdentifier>ibexa_string</fieldTypeIdentifier>
                <fieldValue>UserGroup2</fieldValue>
            </field>
            <field>
                <id>381</id>
                <fieldDefinitionIdentifier>description</fieldDefinitionIdentifier>
                <languageCode>eng-GB</languageCode>
                <fieldTypeIdentifier>ibexa_string</fieldTypeIdentifier>
                <fieldValue>This is the description of the user group</fieldValue>
            </field>
        </Fields>
        <Relations media-type="application/vnd.ibexa.api.RelationList+xml" href="/api/ibexa/v2/content/objects/85/versions/1/relations"/>
        <Thumbnail media-type="application/vnd.ibexa.api.Thumbnail+xml">
            <resource>/bundles/ezplatformadminui/img/ez-icons.svg#user_group</resource>
            <width></width>
            <height></height>
            <mimeType>image/svg+xml</mimeType>
        </Thumbnail>
    </Version>
    <ParentUserGroup media-type="application/vnd.ibexa.api.UserGroup+xml" href="/api/ibexa/v2/user/groups/1/5"/>
    <Subgroups media-type="application/vnd.ibexa.api.UserGroupList+xml" href="/api/ibexa/v2/user/groups/1/5/79/subgroups"/>
    <Users media-type="application/vnd.ibexa.api.UserList+xml" href="/api/ibexa/v2/user/groups/1/5/79/users"/>
    <Roles media-type="application/vnd.ibexa.api.RoleAssignmentList+xml" href="/api/ibexa/v2/user/groups/1/5/79/roles"/>
</UserGroup>

Load Roles for User Group

Returns a list of all Roles assigned to the given User Group.

path Parameters
path
required
string

RoleAssignmentForUserGroupListController identifier

Responses

Response samples

Content type
{
  • "RoleAssignment": {
    }
}

Assign Role to User Group

Assigns a Role to a User Group.

path Parameters
path
required
string

RoleAssignToUserGroupController identifier

header Parameters
X-CSRF-Token
required
string

The CSRF Token needed on all unsafe HTTP methods with session.

Request Body schema:
optional

The RoleAssignInput schema encoded in XML or JSON format.

required
object (RoleAssignInput)

This class represents a Role assign input.

Responses

Request samples

Content type
{
  • "RoleAssignInput": {
    }
}

Response samples

Content type
{
  • "RoleAssignmentList": {
    }
}

Load User Group Role Assignment

Returns a Role assignment of the given User Group.

path Parameters
path
required
string

RoleAssignmentForUserGroupLoadByIdController identifier

roleId
required
string

RoleAssignmentForUserGroupLoadByIdController identifier

Responses

Response samples

Content type
{
  • "RoleAssignment": {
    }
}

Unassign Role from User Group

The given Role is removed from the User or User Group.

path Parameters
path
required
string

RoleUnassignFromUserGroupController identifier

roleId
required
string

RoleUnassignFromUserGroupController identifier

header Parameters
X-CSRF-Token
required
string

The CSRF Token needed on all unsafe HTTP methods with session.

Responses

Response samples

Content type
{
  • "RoleAssignmentList": {
    }
}

Load subgroups

Returns a list of the subgroups.

path Parameters
path
required
string

UserSubGroupListController identifier

header Parameters
Accept
required
string

UserGroupList - If set, the User Group list is returned in XML or JSON format. UserGroupRefList - If set, the link list of User Groups is returned in XML or JSON format.

Responses

Response samples

Content type
<?xml version="1.0" encoding="UTF-8"?>
<UserGroupList media-type="application/vnd.ibexa.api.UserGroupList+xml" href="/api/ibexa/v2/user/groups">
    <UserGroup media-type="application/vnd.ibexa.api.UserGroup+xml" href="/api/ibexa/v2/user/groups/1/5/13/15" id="14" remoteId="1bb4fe25487f05527efa8bfd394cecc7">
        <ContentType media-type="application/vnd.ibexa.api.ContentType+xml" href="/api/ibexa/v2/content/types/4"/>
        <name>Administrator User</name>
        <Versions media-type="application/vnd.ibexa.api.VersionList+xml" href="/api/ibexa/v2/content/objects/14/versions"/>
        <Section media-type="application/vnd.ibexa.api.Section+xml" href="/api/ibexa/v2/content/sections/2"/>
        <MainLocation media-type="application/vnd.ibexa.api.Location+xml" href="/api/ibexa/v2/content/locations/1/5/13/15"/>
        <Locations media-type="application/vnd.ibexa.api.LocationList+xml" href="/api/ibexa/v2/content/objects/14/locations"/>
        <Owner media-type="application/vnd.ibexa.api.User+xml" href="/api/ibexa/v2/user/users/14"/>
        <publishDate>2002-10-06T16:13:50+00:00</publishDate>
        <lastModificationDate>2011-03-25T14:07:04+00:00</lastModificationDate>
        <mainLanguageCode>eng-GB</mainLanguageCode>
        <alwaysAvailable>true</alwaysAvailable>
        <Version media-type="application/vnd.ibexa.api.Version+xml" href="/api/ibexa/v2/content/objects/14/versions/3">
            <VersionInfo>
                <id>499</id>
                <versionNo>3</versionNo>
                <status>PUBLISHED</status>
                <modificationDate>2011-03-25T14:07:04+00:00</modificationDate>
                <Creator media-type="application/vnd.ibexa.api.User+xml" href="/api/ibexa/v2/user/users/14"/>
                <creationDate>2011-03-25T14:03:03+00:00</creationDate>
                <initialLanguageCode>eng-GB</initialLanguageCode>
                <languageCodes>eng-GB</languageCodes>
                <VersionTranslationInfo media-type="application/vnd.ibexa.api.VersionTranslationInfo+xml">
                    <Language>
                        <languageCode>eng-GB</languageCode>
                    </Language>
                </VersionTranslationInfo>
                <names>
                    <value languageCode="eng-GB">Administrator User</value>
                </names>
                <Content media-type="application/vnd.ibexa.api.ContentInfo+xml" href="/api/ibexa/v2/content/objects/14"/>
            </VersionInfo>
            <Fields>
                <field>
                    <id>28</id>
                    <fieldDefinitionIdentifier>first_name</fieldDefinitionIdentifier>
                    <languageCode>eng-GB</languageCode>
                    <fieldTypeIdentifier>ibexa_string</fieldTypeIdentifier>
                    <fieldValue>Administrator</fieldValue>
                </field>
                <field>
                    <id>29</id>
                    <fieldDefinitionIdentifier>last_name</fieldDefinitionIdentifier>
                    <languageCode>eng-GB</languageCode>
                    <fieldTypeIdentifier>ibexa_string</fieldTypeIdentifier>
                    <fieldValue>User</fieldValue>
                </field>
                <field>
                    <id>30</id>
                    <fieldDefinitionIdentifier>user_account</fieldDefinitionIdentifier>
                    <languageCode>eng-GB</languageCode>
                    <fieldTypeIdentifier>ibexa_user</fieldTypeIdentifier>
                    <fieldValue>
                        <value key="hasStoredLogin">true</value>
                        <value key="contentId">14</value>
                        <value key="login">admin</value>
                        <value key="email">admin@link.invalid</value>
                        <value key="passwordUpdatedAt"/>
                        <value key="enabled">true</value>
                        <value key="maxLogin">10</value>
                        <value key="plainPassword"/>
                    </fieldValue>
                </field>
                <field>
                    <id>178</id>
                    <fieldDefinitionIdentifier>signature</fieldDefinitionIdentifier>
                    <languageCode>eng-GB</languageCode>
                    <fieldTypeIdentifier>ibexa_text</fieldTypeIdentifier>
                    <fieldValue/>
                </field>
                <field>
                    <id>180</id>
                    <fieldDefinitionIdentifier>image</fieldDefinitionIdentifier>
                    <languageCode>eng-GB</languageCode>
                    <fieldTypeIdentifier>ibexa_image</fieldTypeIdentifier>
                    <fieldValue/>
                </field>
            </Fields>
            <Relations media-type="application/vnd.ibexa.api.RelationList+xml" href="/api/ibexa/v2/content/objects/14/versions/3/relations"/>
            <Thumbnail media-type="application/vnd.ibexa.api.Thumbnail+xml">
                <resource>/bundles/ezplatformadminui/img/ez-icons.svg#user</resource>
                <width></width>
                <height></height>
                <mimeType>image/svg+xml</mimeType>
            </Thumbnail>
        </Version>
        <ParentUserGroup media-type="application/vnd.ibexa.api.UserGroup+xml" href="/api/ibexa/v2/user/groups/1/5/13"/>
        <Subgroups media-type="application/vnd.ibexa.api.UserGroupList+xml" href="/api/ibexa/v2/user/groups/1/5/13/15/subgroups"/>
        <Users media-type="application/vnd.ibexa.api.UserList+xml" href="/api/ibexa/v2/user/groups/1/5/13/15/users"/>
        <Roles media-type="application/vnd.ibexa.api.RoleAssignmentList+xml" href="/api/ibexa/v2/user/groups/1/5/13/15/roles"/>
    </UserGroup>
</UserGroupList>

Create User Group

Creates a new User Group under the given parent. To create a top level group use '/user/groups/subgroups'.

path Parameters
path
required
string

UserGroupCreateController identifier

header Parameters
Accept
required
string

If set, the new User Group is returned in XML or JSON format.

Content-Type
required
string

The UserGroupCreate schema encoded in XML or JSON format.

Request Body schema:
optional

The new UserGroupCreateController resource

mainLanguageCode
required
string
remoteId
required
string
required
object (Fields)

Responses

Request samples

Content type
<?xml version="1.0" encoding="UTF-8"?>
<UserGroupCreate>
  <mainLanguageCode>eng-GB</mainLanguageCode>
  <remoteId>remoteId-qwert098</remoteId>
  <fields>
    <field>
      <fieldDefinitionIdentifier>name</fieldDefinitionIdentifier>
      <languageCode>eng-GB</languageCode>
      <fieldValue>UserGroup</fieldValue>
    </field>
    <field>
      <fieldDefinitionIdentifier>description</fieldDefinitionIdentifier>
      <languageCode>eng-GB</languageCode>
      <fieldValue>This is the description of the user group</fieldValue>
    </field>
  </fields>
</UserGroupCreate>

Response samples

Content type
<?xml version="1.0" encoding="UTF-8"?>
<UserGroup media-type="application/vnd.ibexa.api.UserGroup+xml" href="/api/ibexa/v2/user/groups/1/5/79" id="85" remoteId="remoteId-qwert098">
    <ContentType media-type="application/vnd.ibexa.api.ContentType+xml" href="/api/ibexa/v2/content/types/3"/>
    <name>UserGroup2</name>
    <Versions media-type="application/vnd.ibexa.api.VersionList+xml" href="/api/ibexa/v2/content/objects/85/versions"/>
    <Section media-type="application/vnd.ibexa.api.Section+xml" href="/api/ibexa/v2/content/sections/2"/>
    <MainLocation media-type="application/vnd.ibexa.api.Location+xml" href="/api/ibexa/v2/content/locations/1/5/79"/>
    <Locations media-type="application/vnd.ibexa.api.LocationList+xml" href="/api/ibexa/v2/content/objects/85/locations"/>
    <Owner media-type="application/vnd.ibexa.api.User+xml" href="/api/ibexa/v2/user/users/14"/>
    <publishDate>2021-08-09T09:03:35+00:00</publishDate>
    <lastModificationDate>2021-08-09T09:03:35+00:00</lastModificationDate>
    <mainLanguageCode>eng-GB</mainLanguageCode>
    <alwaysAvailable>true</alwaysAvailable>
    <Version media-type="application/vnd.ibexa.api.Version+xml" href="/api/ibexa/v2/content/objects/85/versions/1">
        <VersionInfo>
            <id>576</id>
            <versionNo>1</versionNo>
            <status>PUBLISHED</status>
            <modificationDate>2021-08-09T09:03:35+00:00</modificationDate>
            <Creator media-type="application/vnd.ibexa.api.User+xml" href="/api/ibexa/v2/user/users/14"/>
            <creationDate>2021-08-09T09:03:35+00:00</creationDate>
            <initialLanguageCode>eng-GB</initialLanguageCode>
            <languageCodes>eng-GB</languageCodes>
            <VersionTranslationInfo media-type="application/vnd.ibexa.api.VersionTranslationInfo+xml">
                <Language>
                    <languageCode>eng-GB</languageCode>
                </Language>
            </VersionTranslationInfo>
            <names>
                <value languageCode="eng-GB">UserGroup2</value>
            </names>
            <Content media-type="application/vnd.ibexa.api.ContentInfo+xml" href="/api/ibexa/v2/content/objects/85"/>
        </VersionInfo>
        <Fields>
            <field>
                <id>380</id>
                <fieldDefinitionIdentifier>name</fieldDefinitionIdentifier>
                <languageCode>eng-GB</languageCode>
                <fieldTypeIdentifier>ibexa_string</fieldTypeIdentifier>
                <fieldValue>UserGroup2</fieldValue>
            </field>
            <field>
                <id>381</id>
                <fieldDefinitionIdentifier>description</fieldDefinitionIdentifier>
                <languageCode>eng-GB</languageCode>
                <fieldTypeIdentifier>ibexa_string</fieldTypeIdentifier>
                <fieldValue>This is the description of the user group</fieldValue>
            </field>
        </Fields>
        <Relations media-type="application/vnd.ibexa.api.RelationList+xml" href="/api/ibexa/v2/content/objects/85/versions/1/relations"/>
        <Thumbnail media-type="application/vnd.ibexa.api.Thumbnail+xml">
            <resource>/bundles/ezplatformadminui/img/ez-icons.svg#user_group</resource>
            <width></width>
            <height></height>
            <mimeType>image/svg+xml</mimeType>
        </Thumbnail>
    </Version>
    <ParentUserGroup media-type="application/vnd.ibexa.api.UserGroup+xml" href="/api/ibexa/v2/user/groups/1/5"/>
    <Subgroups media-type="application/vnd.ibexa.api.UserGroupList+xml" href="/api/ibexa/v2/user/groups/1/5/79/subgroups"/>
    <Users media-type="application/vnd.ibexa.api.UserList+xml" href="/api/ibexa/v2/user/groups/1/5/79/users"/>
    <Roles media-type="application/vnd.ibexa.api.RoleAssignmentList+xml" href="/api/ibexa/v2/user/groups/1/5/79/roles"/>
</UserGroup>

Load Users of Group

Loads the Users of the Group with the given ID.

path Parameters
path
required
string

UserGroupUsersListController identifier

header Parameters
Accept
required
string

UserList - If set, the User list returned in XML or JSON format. UserRefList - If set, the link list of Users returned in XML or JSON format.

Responses

Response samples

Content type
No sample

Create User

Creates a new User in the given Group.

path Parameters
path
required
string

UserCreateController identifier

header Parameters
Accept
required
string

If set, the new User is returned in XML or JSON format.

Content-Type
required
string

The UserCreate schema encoded in XML or JSON format.

Request Body schema:
optional

The new UserCreateController resource

mainLanguageCode
required
string
remoteId
required
string
login
required
string
email
required
string
password
required
string
enabled
boolean

Responses

Request samples

Content type
<?xml version="1.0" encoding="UTF-8"?>
<UserCreate>
  <mainLanguageCode>eng-GB</mainLanguageCode>
  <remoteId>remoteId-23456789</remoteId>
  <login>johnsmith</login>
  <email>example@example.com</email>
  <password>Secrepassword5!</password>
    <fields>
      <field>
        <fieldDefinitionIdentifier>first_name</fieldDefinitionIdentifier>
        <languageCode>eng-GB</languageCode>
        <fieldValue>John</fieldValue>
      </field>
      <field>
        <fieldDefinitionIdentifier>last_name</fieldDefinitionIdentifier>
        <languageCode>eng-GB</languageCode>
        <fieldValue>Smith</fieldValue>
      </field>
      <field>
        <fieldDefinitionIdentifier>user_account</fieldDefinitionIdentifier>
        <languageCode>eng-GB</languageCode>
        <fieldValue>
          <value key="hasStoredLogin">true</value>
          <value key="contentId">14</value>
          <value key="login">johnsmith</value>
          <value key="email">example@example.com</value>
          <value key="enabled">true</value>
          <value key="maxLogin">10</value>
        </fieldValue>
      </field>
    </fields>
</UserCreate>

Response samples

Content type
<?xml version="1.0" encoding="UTF-8"?>
<User media-type="application/vnd.ibexa.api.User+xml" href="/api/ibexa/v2/user/users/79" id="79" remoteId="bcf0764b417f05af21852a1f03fb1f13">
    <ContentType media-type="application/vnd.ibexa.api.ContentType+xml" href="/api/ibexa/v2/content/types/4"/>
    <name>Jose Vargas</name>
    <Versions media-type="application/vnd.ibexa.api.VersionList+xml" href="/api/ibexa/v2/content/objects/79/versions"/>
    <Section media-type="application/vnd.ibexa.api.Section+xml" href="/api/ibexa/v2/content/sections/2"/>
    <MainLocation media-type="application/vnd.ibexa.api.Location+xml" href="/api/ibexa/v2/content/locations/1/5/12/79"/>
    <Locations media-type="application/vnd.ibexa.api.LocationList+xml" href="/api/ibexa/v2/content/objects/79/locations"/>
    <Groups media-type="application/vnd.ibexa.api.UserGroupRefList+xml" href="/api/ibexa/v2/user/users/79/groups"/>
    <Owner media-type="application/vnd.ibexa.api.User+xml" href="/api/ibexa/v2/user/users/10"/>
    <publishDate>2021-06-29T08:23:42+00:00</publishDate>
    <lastModificationDate>2021-07-29T11:45:07+00:00</lastModificationDate>
    <mainLanguageCode>eng-GB</mainLanguageCode>
    <alwaysAvailable>true</alwaysAvailable>
    <Version media-type="application/vnd.ibexa.api.Version+xml" href="/api/ibexa/v2/content/objects/79/versions/6">
        <VersionInfo>
            <id>609</id>
            <versionNo>6</versionNo>
            <status>PUBLISHED</status>
            <modificationDate>2021-07-29T11:45:07+00:00</modificationDate>
            <Creator media-type="application/vnd.ibexa.api.User+xml" href="/api/ibexa/v2/user/users/14"/>
            <creationDate>2021-07-29T11:45:07+00:00</creationDate>
            <initialLanguageCode>eng-GB</initialLanguageCode>
            <languageCodes>eng-GB</languageCodes>
            <VersionTranslationInfo media-type="application/vnd.ibexa.api.VersionTranslationInfo+xml">
                <Language>
                    <languageCode>eng-GB</languageCode>
                </Language>
            </VersionTranslationInfo>
            <names>
                <value languageCode="eng-GB">Jose Vargas</value>
            </names>
            <Content media-type="application/vnd.ibexa.api.ContentInfo+xml" href="/api/ibexa/v2/content/objects/79"/>
        </VersionInfo>
        <Fields>
            <field>
                <id>342</id>
                <fieldDefinitionIdentifier>first_name</fieldDefinitionIdentifier>
                <languageCode>eng-GB</languageCode>
                <fieldTypeIdentifier>ibexa_string</fieldTypeIdentifier>
                <fieldValue>Jose</fieldValue>
            </field>
            <field>
                <id>343</id>
                <fieldDefinitionIdentifier>last_name</fieldDefinitionIdentifier>
                <languageCode>eng-GB</languageCode>
                <fieldTypeIdentifier>ibexa_string</fieldTypeIdentifier>
                <fieldValue>Vargas</fieldValue>
            </field>
            <field>
                <id>344</id>
                <fieldDefinitionIdentifier>user_account</fieldDefinitionIdentifier>
                <languageCode>eng-GB</languageCode>
                <fieldTypeIdentifier>ibexa_user</fieldTypeIdentifier>
                <fieldValue>
                    <value key="hasStoredLogin">true</value>
                    <value key="contentId">79</value>
                    <value key="login">josevargas</value>
                    <value key="email">aa@bb.cc</value>
                    <value key="passwordUpdatedAt"/>
                    <value key="enabled">false</value>
                    <value key="maxLogin">0</value>
                    <value key="plainPassword"/>
                </fieldValue>
            </field>
            <field>
                <id>345</id>
                <fieldDefinitionIdentifier>signature</fieldDefinitionIdentifier>
                <languageCode>eng-GB</languageCode>
                <fieldTypeIdentifier>ibexa_text</fieldTypeIdentifier>
                <fieldValue/>
            </field>
            <field>
                <id>346</id>
                <fieldDefinitionIdentifier>image</fieldDefinitionIdentifier>
                <languageCode>eng-GB</languageCode>
                <fieldTypeIdentifier>ibexa_image</fieldTypeIdentifier>
                <fieldValue/>
            </field>
        </Fields>
        <Relations media-type="application/vnd.ibexa.api.RelationList+xml" href="/api/ibexa/v2/content/objects/79/versions/6/relations"/>
        <Thumbnail media-type="application/vnd.ibexa.api.Thumbnail+xml">
            <resource>/bundles/ezplatformadminui/img/ez-icons.svg#user</resource>
            <width></width>
            <height></height>
            <mimeType>image/svg+xml</mimeType>
        </Thumbnail>
    </Version>
    <login>josevargas</login>
    <email>aa@bb.cc</email>
    <enabled>false</enabled>
    <UserGroups media-type="application/vnd.ibexa.api.UserGroupList+xml" href="/api/ibexa/v2/user/users/79/groups"/>
    <Roles media-type="application/vnd.ibexa.api.RoleAssignmentList+xml" href="/api/ibexa/v2/user/users/79/roles"/>
</User>

User Role

Resource 'User Role' operations.

Load Roles

Returns a list of all Roles.

Responses

Response samples

Content type
{
  • "RoleList": {
    }
}

Create Role or Role draft

Creates a new Role or Role draft.

header Parameters
X-CSRF-Token
required
string

The CSRF Token needed on all unsafe HTTP methods with session.

Request Body schema:
optional

The RoleInput schema encoded in XML or JSON.

required
object (RoleInput)

This class represents a Role input.

Responses

Request samples

Content type
{
  • "RoleInput": {
    }
}

Response samples

Content type
{
  • "Role": {
    }
}

Load Role

Loads a Role for the given ID.

path Parameters
id
required
string

RoleLoadByIdController identifier

header Parameters
If-None-Match
string

ETag

Responses

Response samples

Content type
{
  • "Role": {
    }
}

Create Role Draft

Creates a new Role draft from an existing Role.

path Parameters
id
required
string

RoleDraftCreateController identifier

header Parameters
X-CSRF-Token
required
string

The CSRF Token needed on all unsafe HTTP methods with session.

Responses

Response samples

Content type
{
  • "Role": {
    }
}

Delete Role

The given Role and all assignments to Users or User Groups are deleted.

path Parameters
id
required
string

RoleDeleteController identifier

header Parameters
X-CSRF-Token
required
string

The CSRF Token needed on all unsafe HTTP methods with session.

Responses

Update Role

Updates a Role. PATCH or POST with header X-HTTP-Method-Override PATCH

path Parameters
id
required
string

RoleUpdateController identifier

header Parameters
X-CSRF-Token
required
string

The CSRF Token needed on all unsafe HTTP methods with session.

If-Match
required
string

ETag Causes to patch only if the specified ETag is the current one. Otherwise a 412 is returned.

Request Body schema:
optional

The RoleInput schema encoded in XML or JSON format.

required
object (RoleInput)

This class represents a Role input.

Responses

Request samples

Content type
{
  • "RoleInput": {
    }
}

Response samples

Content type
{
  • "Role": {
    }
}

Load Role draft

Loads a Role draft by original Role ID.

path Parameters
id
required
string

RoleDraftLoadByRoleIdController identifier

header Parameters
If-None-Match
string

ETag

Responses

Response samples

Content type
{
  • "Role": {
    }
}

Delete Role draft

The given Role draft is deleted.

path Parameters
id
required
string

RoleDraftDeleteController identifier

header Parameters
X-CSRF-Token
required
string

The CSRF Token needed on all unsafe HTTP methods with session.

Responses

Update Role draft

Updates a Role draft. PATCH or POST with header X-HTTP-Method-Override PATCH.

path Parameters
id
required
string

RoleDraftUpdateController identifier

header Parameters
X-CSRF-Token
required
string

The CSRF Token needed on all unsafe HTTP methods with session.

If-Match
required
string

Performs a PATCH only if the specified ETag is the current one. Otherwise a 412 is returned.

Request Body schema:
optional

The RoleInput schema encoded in XML or JSON format.

required
object (RoleInput)

This class represents a Role input.

Responses

Request samples

Content type
{
  • "RoleInput": {
    }
}

Response samples

Content type
{
  • "Role": {
    }
}

Load Policies

Loads Policies for the given Role.

path Parameters
id
required
string

RolePolicyListController identifier

Responses

Response samples

Content type
{
  • "PolicyList": {
    }
}

Create Policy

Creates a Policy

path Parameters
id
required
string

RolePolicyCreateController identifier

header Parameters
X-CSRF-Token
required
string

The CSRF Token needed on all unsafe HTTP methods with session.

Request Body schema:
optional

If set, the updated Policy is returned in XML or JSON format.

required
object (PolicyCreate)

This class is used to create a Policy.

Responses

Request samples

Content type
{
  • "PolicyCreate": {
    }
}

Response samples

Content type
{
  • "Policy": {
    }
}

Delete Policies

All Policies of the given Role are deleted.

path Parameters
id
required
string

RolePolicyDeleteAllFromRoleController identifier

header Parameters
X-CSRF-Token
required
string

The CSRF Token needed on all unsafe HTTP methods with session.

Responses

Load Policy

Loads a Policy for the given module and function.

path Parameters
policyId
required
string

RolePolicyLoadByIdController identifier

roleId
required
string

RolePolicyLoadByIdController identifier

header Parameters
If-None-Match
string

ETag

Responses

Response samples

Content type
{
  • "Policy": {
    }
}

Delete Policy

Deletes given Policy.

path Parameters
policyId
required
string

RolePolicyDeleteController identifier

roleId
required
string

RolePolicyDeleteController identifier

header Parameters
X-CSRF-Token
required
string

The CSRF Token needed on all unsafe HTTP methods with session.

Responses

Update Policy

Updates a Policy. PATCH or POST with header X-HTTP-Method-Override PATCH.

path Parameters
policyId
required
string

RolePolicyUpdateController identifier

roleId
required
string

RolePolicyUpdateController identifier

header Parameters
X-CSRF-Token
required
string

The CSRF Token needed on all unsafe HTTP methods with session.

If-Match
required
string

Causes to patch only if the specified ETag is the current one. Otherwise a 412 is returned.

Request Body schema:
optional

If set, the updated Policy is returned in XML or JSON format.

required
object (PolicyUpdate)

This class is used to update a Policy.

Responses

Request samples

Content type
{
  • "PolicyUpdate": {
    }
}

Response samples

Content type
{
  • "Policy": {
    }
}

User Policy

Resource 'User Policy' operations.

List Policies for User

Search all Policies which are applied to a given User.

Responses

Response samples

Content type
{
  • "PolicyList": {
    }
}

Language

Resource 'Language' operations.

Language list

Lists languages

Responses

Response samples

Content type
{
  • "LanguageList": {
    }
}

Get language

Retrieves a LanguageLoadByIdController resource.

path Parameters
code
required
string

LanguageLoadByIdController identifier

Responses

Response samples

Content type
{
  • "Language": {
    }
}

Location

Resource 'Location' operations.

Load Locations by id/remoteId/urlAlias

Loads the Location for a given ID (x), remote ID or URL alias.

Responses

Response samples

Content type
{
  • "Location": {
    }
}

Load Location

Loads the Location for the given path e.g. '/content/locations/1/2/61'.

path Parameters
path
required
string

LocationLoadByPathController identifier

header Parameters
If-None-Match
string

ETag

Responses

Response samples

Content type
{
  • "Location": {
    }
}

Delete subtree

Deletes the complete subtree for the given path. Every content item which does not have any other Location is deleted. Otherwise the deleted Location is removed from the content item. The children are recursively deleted.

path Parameters
path
required
string

LocationSubtreeDeleteController identifier

header Parameters
X-CSRF-Token
required
string

The CSRF Token needed on all unsafe HTTP methods with session.

Responses

Update Location

Updates the Location. This method can also be used to hide/reveal a Location via the hidden field in the LocationUpdate. PATCH or POST with header X-HTTP-Method-Override PATCH.

path Parameters
path
required
string

LocationUpdateController identifier

header Parameters
X-CSRF-Token
required
string

The CSRF Token needed on all unsafe HTTP methods with session.

If-Match
required
string

ETag

Request Body schema:
optional

The LocationUpdate schema encoded in XML or JSON format.

required
object (LocationUpdateStruct)

This class is used for updating Location meta data.

Responses

Request samples

Content type
{
  • "LocationUpdate": {
    }
}

Response samples

Content type
{
  • "Location": {
    }
}

Get child Locations.

Loads all child Locations for the given parent Location.

path Parameters
path
required
string

LocationChildrenListController identifier

Responses

Response samples

Content type
{
  • "LocationList": {
    }
}

List URL aliases for Location

Returns the list of URL aliases for a Location.

path Parameters
path
required
string

URLAliasListLocationController identifier

Responses

Response samples

Content type
{
  • "UrlAliasRefList": {
    }
}

Object State Groups

Resource 'Object State Groups' operations.

List Object state groups

Returns a list of all Object state groups.

header Parameters
If-None-Match
string

ETag

Responses

Response samples

Content type
{
  • "ObjectStateGroupList": {
    }
}

Create Object state group

Creates a new Object state group.

header Parameters
X-CSRF-Token
required
string

The CSRF Token needed on all unsafe HTTP methods with session.

Request Body schema:
optional

The Object state group input schema encoded in XML or JSON format.

required
object (ObjectStateGroupCreate)

This class represents a value for creating Object state groups.

Responses

Request samples

Content type
{
  • "ObjectStateGroupCreate": {
    }
}

Response samples

Content type
{
  • "ObjectStateGroup": {
    }
}

Get Object state group

Returns the Object state group with the provided ID.

path Parameters
objectStateGroupId
required
string

ObjectStateGroupLoadByIdController identifier

header Parameters
If-None-Match
string

ETag

Responses

Response samples

Content type
{
  • "ObjectStateGroup": {
    }
}

Delete Object state group

Deletes the given Object state group including Object states.

path Parameters
objectStateGroupId
required
string

ObjectStateGroupDeleteController identifier

header Parameters
X-CSRF-Token
required
string

The CSRF Token needed on all unsafe HTTP methods with session.

Responses

Update Object state group

Updates an Object state group. PATCH or POST with header X-HTTP-Method-Override PATCH.

path Parameters
objectStateGroupId
required
string

ObjectStateGroupUpdateController identifier

header Parameters
X-CSRF-Token
required
string

The CSRF Token needed on all unsafe HTTP methods with session.

If-Match
required
string

ETag

Request Body schema:
optional

The Object state group input schema encoded in XML or JSON format.

required
object (ObjectStateGroupUpdate)

This class represents a value for updating Object state groups.

Responses

Request samples

Content type
{
  • "ObjectStateGroupUpdate": {
    }
}

Response samples

Content type
{
  • "ObjectStateGroup": {
    }
}

List Object states

Returns a list of all Object states of the given group.

path Parameters
objectStateGroupId
required
string

ObjectStateListController identifier

header Parameters
If-None-Match
string

ETag

Responses

Response samples

Content type
{
  • "ObjectStateList": {
    }
}

Create Object state

Creates a new Object state.

path Parameters
objectStateGroupId
required
string

ObjectStateCreateController identifier

header Parameters
X-CSRF-Token
required
string

The CSRF Token needed on all unsafe HTTP methods with session.

Request Body schema:
optional

The Object state input schema encoded in XML or JSON format.

required
object (ObjectStateCreate)

This class represents a value for creating Object states.

Responses

Request samples

Content type
{
  • "ObjectStateCreate": {
    }
}

Response samples

Content type
{
  • "ObjectState": {
    }
}

Get Object state

Returns the Object state.

path Parameters
objectStateGroupId
required
string

ObjectStateLoadByIdController identifier

objectStateId
required
string

ObjectStateLoadByIdController identifier

header Parameters
If-None-Match
string

ETag

Responses

Response samples

Content type
{
  • "ObjectState": {
    }
}

Delete Object state

Deletes provided Object state.

path Parameters
objectStateGroupId
required
string

ObjectStateDeleteController identifier

objectStateId
required
string

ObjectStateDeleteController identifier

header Parameters
X-CSRF-Token
required
string

The CSRF Token needed on all unsafe HTTP methods with session.

Responses

Update Object state

Updates an Object state. PATCH or POST with header X-HTTP-Method-Override PATCH.

path Parameters
objectStateGroupId
required
string

ObjectStateUpdateController identifier

objectStateId
required
string

ObjectStateUpdateController identifier

header Parameters
X-CSRF-Token
required
string

The CSRF Token needed on all unsafe HTTP methods with session.

If-Match
required
string

ETag

Request Body schema:
optional

The Object state input schema encoded in XML or JSON format.

required
object (ObjectStateUpdate)

This class represents a value for updating Object states.

Responses

Request samples

Content type
{
  • "ObjectStateUpdate": {
    }
}

Response samples

Content type
{
  • "ObjectState": {
    }
}

Trash

Resource 'Trash' operations.

List Trash items

Returns a list of all items in the Trash.

Responses

Response samples

Content type
{
  • "Trash": {
    }
}

Empty Trash

Empties the Trash.

header Parameters
X-CSRF-Token
required
string

The CSRF Token needed on all unsafe HTTP methods with session.

Responses

Get Trash item

Returns the item in Trash with the provided ID.

path Parameters
trashItemid
required
string

TrashItemLoadByIdController identifier

Responses

Response samples

Content type
{
  • "TrashItem": {
    }
}

Delete Trash item

Deletes the provided item from Trash.

path Parameters
trashItemid
required
string

TrashItemDeleteController identifier

header Parameters
X-CSRF-Token
required
string

The CSRF Token needed on all unsafe HTTP methods with session.

Responses

Url Alias

Resource 'Url Alias' operations.

List global URL aliases

Returns the list of global URL aliases.

Responses

Response samples

Content type
{
  • "UrlAliasRefList": {
    }
}

Create URL alias

Creates a URL alias.

header Parameters
X-CSRF-Token
required
string

The CSRF Token needed on all unsafe HTTP methods with session.

Request Body schema:
optional

The URL alias input schema encoded in XML or JSON format.

required
object (UrlAliasCreate)

Responses

Request samples

Content type
{
  • "UrlAliasCreate": {
    }
}

Response samples

Content type
{
  • "UrlAlias": {
    }
}

Get URL alias

Returns the URL alias with the given ID.

path Parameters
urlAliasId
required
string

URLAliasLoadByIdController identifier

Responses

Response samples

Content type
{
  • "UrlAlias": {
    }
}

Delete URL alias

Deletes the provided URL alias.

path Parameters
urlAliasId
required
string

URLAliasDeleteController identifier

header Parameters
X-CSRF-Token
required
string

The CSRF Token needed on all unsafe HTTP methods with session.

Responses

Views

Controller for Repository Views (Search, mostly).

Search content

Executes a query and returns a View including the results. View input reflects the criteria model of the public PHP API. Refer to Search Criteria Reference

header Parameters
X-CSRF-Token
required
string

The CSRF Token needed on all unsafe HTTP methods with session.

Request Body schema:
optional

The view input in XML or JSON format.

required
object (ViewInput)

This class represents a View input.

Responses

Request samples

Content type
{
  • "ViewInput": {
    }
}

Response samples

Content type
application/vnd.ibexa.api.View+xml; version=1.1
<?xml version="1.0" encoding="UTF-8"?>
<View href="/views/TitleView" media-type="application/vnd.ibexa.api.View+xml; version=1.1">
  <identifier>TitleView</identifier>
  <User href="/user/users/14" media-type="vnd.ibexa.api.User+xml"/>
  <public>false</public>
  <LocationQuery>
    <Filter>
      <ParentLocationIdCriterion>2</ParentLocationIdCriterion>
    </Filter>
    <limit>10</limit>
    <offset>0</offset>
    <SortClauses>
      <ContentName>ascending</ContentName>
    </SortClauses>
    <FacetBuilders>
      <contentTypeFacetBuilder/>
    </FacetBuilders>
  </LocationQuery>
  <Result href="/content/views/view1234/results"
    media-type="application/vnd.ibexa.api.ViewResult+xml" count="34" time="31" maxScore="1.0">
    <searchHits>
      <searchHit score="1.0" index="installid1234567890">
        <hightlight/>
        <value>
          <Location media-type="application/vnd.ibexa.api.Location+xml" href="/api/ibexa/v2/content/locations/1/2">
            <id>2</id>
            <priority>0</priority>
            <hidden>false</hidden>
            <invisible>false</invisible>
            <ParentLocation media-type="application/vnd.ibexa.api.Location+xml" href="/api/ibexa/v2/content/locations/1"/>
            <pathString>/1/2/</pathString>
            <depth>1</depth>
            <childCount>8</childCount>
            <remoteId>f3e90596361e31d496d4026eb624c983</remoteId>
            <Children media-type="application/vnd.ibexa.api.LocationList+xml" href="/api/ibexa/v2/content/locations/1/2/children"/>
            <Content media-type="application/vnd.ibexa.api.Content+xml" href="/api/ibexa/v2/content/objects/57"/>
            <sortField>PRIORITY</sortField>
            <sortOrder>ASC</sortOrder>
            <UrlAliases media-type="application/vnd.ibexa.api.UrlAliasRefList+xml" href="/api/ibexa/v2/content/locations/1/2/urlaliases"/>
          </Location>

        </value>
      </searchHit>
      <!-- ... -->
    </searchHits>
    <facets>
      <contentTypeFacet>
        <contentTypeFacetEntry>
          <contentType href="/content/types/1"  media-type="application/vnd.ibexa.api.ContentType+xml"/>
          <count>3</count>
        </contentTypeFacetEntry>
        <contentTypeFacetEntry>
          <contentType href="/content/types/7"  media-type="application/vnd.ibexa.api.ContentType+xml"/>
          <count>9</count>
        </contentTypeFacetEntry>
        <contentTypeFacetEntry>
          <contentType href="/content/types/11"  media-type="application/vnd.ibexa.api.ContentType+xml"/>
          <count>1</count>
        </contentTypeFacetEntry>
        <contentTypeFacetEntry>
          <contentType href="/content/types/15"  media-type="application/vnd.ibexa.api.ContentType+xml"/>
          <count>8</count>
        </contentTypeFacetEntry>
      </contentTypeFacet>
    </facets>
  </Result>
</View>

User Session

Resource 'User Session' operations.

Create session (login a User)

Performs a login for the user or checks if session exists and returns the session and session cookie. The client will need to remember both session name/ID and CSRF token as this is for security reasons not exposed via GET.

header Parameters
Accept
required
string

If set, the session is returned in XML or JSON format.

Content-Type
required
string

The SessionInput schema encoded in XML or JSON format.

Cookie
required
string

Only needed for session's checking {sessionName}={sessionID}.

X-CSRF-Token
required
string

Only needed for session's checking. The {csrfToken} needed on all unsafe HTTP methods with session.

Request Body schema:
optional

The new SessionCreateController resource

_media-type
required
string
_href
string
login
required
string
password
required
string

Responses

Request samples

Content type
<?xml version="1.0" encoding="UTF-8"?>
<SessionInput>
  <login>admin</login>
  <password>secret</password>
</SessionInput>

Response samples

Content type
<?xml version="1.0" encoding="UTF-8"?>
<Session media-type="application/vnd.ibexa.api.Session+xml" href="/api/ibexa/v2/user/sessions/ABCDEFGHIJKLMNOPQRSTUVWXYZ">
  <name>IBX_SESSION_ID0123456789ABCDEFGHIJKLMNOPQRSTUV</name>
  <identifier>ABCDEFGHIJKLMNOPQRSTUVWXYZ</identifier>
  <csrfToken>0123456789ABCDEF.GHIJKLMNOP_QRSTUVWXYZabcdefghijklmnopqrstuv.wxyz0123456-789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopq</csrfToken>
  <User media-type="application/vnd.ibexa.api.User+xml" href="/api/ibexa/v2/user/users/14"/>
</Session>

Get current session

Get current user session, if any.

header Parameters
Cookie
required
string

Only needed for session's checking {sessionName}={sessionID}.

Accept
required
string

If set, the session is returned in XML or JSON format.

Responses

Response samples

Content type
<?xml version="1.0" encoding="UTF-8"?>
<Session media-type="application/vnd.ibexa.api.Session+xml" href="/api/ibexa/v2/user/sessions/ABCDEFGHIJKLMNOPQRSTUVWXYZ">
  <name>IBX_SESSION_ID0123456789ABCDEFGHIJKLMNOPQRSTUV</name>
  <identifier>ABCDEFGHIJKLMNOPQRSTUVWXYZ</identifier>
  <csrfToken>0123456789ABCDEF.GHIJKLMNOP_QRSTUVWXYZabcdefghijklmnopqrstuv.wxyz0123456-789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopq</csrfToken>
  <User media-type="application/vnd.ibexa.api.User+xml" href="/api/ibexa/v2/user/users/14"/>
</Session>

Delete session (logout a User)

The user session is removed i.e. the user is logged out.

path Parameters
sessionId
required
string

SessionDeleteController identifier

header Parameters
Cookie
required
string

{sessionName}={sessionID}

X-CSRF-Token
required
string

The {csrfToken} needed on all unsafe HTTP methods with session.

Responses

Refresh session (deprecated)

Get the session's User information. Deprecated as of Ibexa DXP 4.6, use GET /user/sessions/current instead.

path Parameters
sessionId
required
string

SessionRefreshController identifier

header Parameters
Cookie
required
string

{sessionName}={sessionID}

X-CSRF-Token
required
string

The {csrfToken} needed on all unsafe HTTP methods with session.

Accept
required
string

Responses

Response samples

Content type
<?xml version="1.0" encoding="UTF-8"?>
<Session media-type="application/vnd.ibexa.api.Session+xml" href="/api/ibexa/v2/user/sessions/ABCDEFGHIJKLMNOPQRSTUVWXYZ">
  <name>IBX_SESSION_ID0123456789ABCDEFGHIJKLMNOPQRSTUV</name>
  <identifier>ABCDEFGHIJKLMNOPQRSTUVWXYZ</identifier>
  <csrfToken>0123456789ABCDEF.GHIJKLMNOP_QRSTUVWXYZabcdefghijklmnopqrstuv.wxyz0123456-789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopq</csrfToken>
  <User media-type="application/vnd.ibexa.api.User+xml" href="/api/ibexa/v2/user/users/14"/>
</Session>

Bookmark

Resource 'Bookmark' operations.

List of bookmarks

Lists bookmarked Locations for the current user.

Responses

Response samples

Content type
{
  • "BookmarkList": {
    }
}

Check if Location is bookmarked

Checks if the given Location is bookmarked by the current user.

path Parameters
locationId
required
integer

BookmarkIsBookmarkedController identifier

Responses

Create bookmark

Add given Location to bookmarks of the current user.

path Parameters
locationId
required
string

BookmarkCreateController identifier

header Parameters
X-CSRF-Token
required
string

The CSRF Token needed on all unsafe HTTP methods with session.

Responses

Delete bookmark

Deletes the given Location from bookmarks of the current user.

path Parameters
locationId
required
string

BookmarkDeleteController identifier

header Parameters
X-CSRF-Token
required
string

The CSRF Token needed on all unsafe HTTP methods with session.

Responses

Check if Location is bookmarked

Checks if the given Location is bookmarked by the current user.

path Parameters
locationId
required
integer

BookmarkIsBookmarkedController identifier

Responses

Calendar

Resource 'Calendar' operations.

Calendar list

Calendar event list.

query Parameters
start
required
integer (UnixTimestamp)

timestamp (seconds since the Unix Epoch).

end
required
integer (UnixTimestamp)

timestamp.

count
integer

Maximum number of events returned (10 by default).

types
Array of strings
Example: types=future_publication,future_hide,page_block_reveal,page_block_hide

Comma-separated list of type identifiers.

languages
Array of strings
Example: languages=eng-GB,fre-FR

comma-separated list of language codes.

cursor
string
Example: cursor=MTc3ODI2NDA0MDpmdXR1cmVfaGlkZTpmdXR1cmVfaGlkZToy

Pagination cursor. It's the representation of the event to start the page afterward, as the concatenation of the timestamp, the event type, and the event identifier with a colon separator ("::"), encoded in base64. For example "1778264040:future_hide:future_hide:2" ("future_hide:2" is the ID) encoded as "MTc3ODI2NDA0MDpmdXR1cmVfaGlkZTpmdXR1cmVfaGlkZToy"

Responses

Response samples

Content type
{
  • "EventList": {
    }
}

Calendar list grouped by day

Calendar event list grouped by day.

query Parameters
start
required
integer (UnixTimestamp)

timestamp (seconds since the Unix Epoch).

end
required
integer (UnixTimestamp)

timestamp.

count
integer

Maximum number of events returned (10 by default).

types
Array of strings
Example: types=future_publication,future_hide,page_block_reveal,page_block_hide

Comma-separated list of type identifiers.

languages
Array of strings
Example: languages=eng-GB,fre-FR

comma-separated list of language codes.

cursor
string
Example: cursor=MTc3ODI2NDA0MDpmdXR1cmVfaGlkZTpmdXR1cmVfaGlkZToy

Pagination cursor. It's the representation of the event to start the page afterward, as the concatenation of the timestamp, the event type, and the event identifier with a colon separator ("::"), encoded in base64. For example "1778264040:future_hide:future_hide:2" ("future_hide:2" is the ID) encoded as "MTc3ODI2NDA0MDpmdXR1cmVfaGlkZTpmdXR1cmVfaGlkZToy"

Responses

Response samples

Content type
{
  • "EventGroupList": {
    }
}

Calendar action

A calendar action that e.g. reschedules or unschedules calendar events. The event type should always be copied from an event.

path Parameters
eventType
required
string
Enum: "future_publication" "future_hide"

The type of event to execute an action on.

Request Body schema:
required

Data for the calendar action to execute

required
object (RescheduleAction)

This class represents events to reschedule

Responses

Request samples

Content type
{
  • "RescheduleAction": {
    }
}

Product Attribute

Resource 'Product Attribute' operations.

Load attributes (deprecated)

Loads list of all attributes. Deprecated as of Ibexa DXP 4.3, use POST /product/catalog/attributes/view instead.

Request Body schema:
optional

Attribute filter

required
object (AttributeListGet)

This class represents an attribute list query

Responses

Request samples

Content type
{
  • "AttributeListGet": {
    }
}

Response samples

Content type
{
  • "AttributeList": {
    }
}

Create attribute

Creates a new attribute.

header Parameters
X-CSRF-Token
required
string

The CSRF token is required when passing user session.

Request Body schema: application/vnd.ibexa.api.AttributeCreate+json
optional

The attribute schema encoded in XML or JSON format.

required
object (AttributeCreate)

This class is used to create an attribute.

Responses

Request samples

Content type
application/vnd.ibexa.api.AttributeCreate+json
{
  • "AttributeCreate": {
    }
}

Response samples

Content type
application/vnd.ibexa.api.Attribute+json
{
  • "Attribute": {
    }
}

Delete attribute translation

The given translation is removed from the attribute.

path Parameters
id
required
string

AttributeTranslationDeleteController identifier

languageCode
required
string

AttributeTranslationDeleteController identifier

header Parameters
X-CSRF-Token
required
string

The CSRF token is required when passing user session.

Responses

Filter attributes

Executes a query and returns a View including the results. The View input reflects the criteria model of the public PHP API.

header Parameters
X-CSRF-Token
required
string

The CSRF token is required when passing user session.

Request Body schema:
optional

The view input in XML or JSON format.

required
object (AttributeViewInput)

This class represents an attribute view input.

Responses

Request samples

Content type
{
  • "ViewInput": {
    }
}

Response samples

Content type
{
  • "AttributeView": {
    }
}

Load attribute

Loads given attribute.

path Parameters
id
required
string

AttributeLoadByIdentifierController identifier

Responses

Response samples

Content type
{
  • "Attribute": {
    }
}

Delete attribute

The given attribute is removed from the attribute group.

path Parameters
id
required
string

AttributeDeleteController identifier

header Parameters
X-CSRF-Token
required
string

The CSRF token is required when passing user session.

Responses

Update attribute

Updates an attribute.

path Parameters
id
required
string

AttributeUpdateController identifier

group_id
required
string

AttributeUpdateController identifier

header Parameters
X-CSRF-Token
required
string

The CSRF token is required when passing user session.

Request Body schema: application/vnd.ibexa.api.AttributeUpdate+json
optional

If set, the updated attribute group is returned in XML or JSON format.

required
object (AttributeUpdate)

This class is used to update an attribute.

Responses

Request samples

Content type
application/vnd.ibexa.api.AttributeUpdate+json
{
  • "AttributeUpdate": {
    }
}

Response samples

Content type
application/vnd.ibexa.api.Attribute+json
{
  • "Attribute": {
    }
}

Product Attribute Type

Resource 'Product Attribute Type' operations.

List Attribute Types

Lists all Attribute Types.

Responses

Response samples

Content type
{
  • "AttributeTypeList": {
    }
}

Get Attribute Type

Gets an Attribute Type by its identifier.

path Parameters
identifier
required
string

AttributeTypeLoadByIdentifierController identifier

Responses

Response samples

Content type
{
  • "AttributeType": {
    }
}

Product Attribute Group

Resource 'Product Attribute Group' operations.

Load attribute groups (deprecated)

Returns a list of attribute groups. Deprecated as of Ibexa DXP 4.3, use POST /product/catalog/attribute_groups/view instead.

Request Body schema: application/vnd.ibexa.api.AttributeGroupListGet+json
optional

The AttributeGroupListGet schema encoded in XML or JSON format.

required
object (AttributeGroupListGet)

This class represents an attribute group list request.

Responses

Request samples

Content type
application/vnd.ibexa.api.AttributeGroupListGet+json
{
  • "AttributeGroupListGet": {
    }
}

Response samples

Content type
{
  • "AttributeGroupList": {
    }
}

Create attribute group

Creates a new attribute group.

header Parameters
X-CSRF-Token
required
string

The CSRF token is required when passing user session.

Request Body schema: application/vnd.ibexa.api.AttributeGroupCreate+json
optional

The AttributeGroup schema encoded in XML or JSON format.

required
object (AttributeGroupCreate)

This class is used to create an attribute group.

Responses

Request samples

Content type
application/vnd.ibexa.api.AttributeGroupCreate+json
{
  • "AttributeGroupCreate": {
    }
}

Response samples

Content type
application/vnd.ibexa.api.AttributeGroup+json
{
  • "AttributeGroup": {
    }
}

Delete attribute group translation

Deletes given translation from attribute group.

path Parameters
id
required
string

AttributeGroupTranslationDeleteController identifier

languageCode
required
string

AttributeGroupTranslationDeleteController identifier

header Parameters
X-CSRF-Token
required
string

The CSRF token is required when passing user session.

Responses

Filter attribute groups

Executes a query and returns a View including the results. The View input reflects the criteria model of the public PHP API.

header Parameters
X-CSRF-Token
required
string

The CSRF token is required when passing user session.

Request Body schema:
optional

The view input in XML or JSON format.

required
object (AttributeGroupViewInput)

This class represents an attribute group view input.

Responses

Request samples

Content type
{
  • "ViewInput": {
    }
}

Response samples

Content type
{
  • "AttributeGroupView": {
    }
}

Load attribute group

Returns the given attribute group.

path Parameters
id
required
string

AttributeGroupLoadByIdentifierController identifier

Request Body schema:
optional

An optional AttributeGroupGet schema encoded in XML or JSON format.

required
object (AttributeGroupGet)

This class represents an attribute group query.

Responses

Request samples

Content type
{
  • "AttributeGroupGet": {
    }
}

Response samples

Content type
{
  • "AttributeGroup": {
    }
}

Delete attribute group

Deletes an attribute group.

path Parameters
id
required
string

AttributeGroupDeleteController identifier

header Parameters
X-CSRF-Token
required
string

The CSRF token is required when passing user session.

Responses

Update attribute group

Updates an attribute group.

path Parameters
id
required
string

AttributeGroupUpdateController identifier

header Parameters
X-CSRF-Token
required
string

The CSRF token is required when passing user session.

Request Body schema:
optional

The attribute group update schema is sent in XML or JSON format.

required
object (AttributeGroupUpdate)

This class is used to update an attribute group.

Responses

Request samples

Content type
{
  • "AttributeGroupUpdate": {
    }
}

Response samples

Content type
{
  • "AttributeGroup": {
    }
}

Product Catalog

Resource 'Product Catalog' operations.

Create catalog

Creates a new catalog.

header Parameters
X-CSRF-Token
required
string

The CSRF token is required when passing user session.

Request Body schema: application/vnd.ibexa.api.CatalogCreate+json
optional

The catalog schema encoded in XML or JSON format.

required
object (CatalogCreate)

This class is used to create a catalog.

Responses

Request samples

Content type
application/vnd.ibexa.api.CatalogCreate+json
{
  • "CatalogCreate": {
    }
}

Response samples

Content type
application/vnd.ibexa.api.CatalogCreate+json
{
  • "Catalog": {
    }
}

Copy catalog

Copies a catalog.

path Parameters
identifier
required
string

CatalogCopyController identifier

header Parameters
X-CSRF-Token
required
string

The CSRF token is required when passing user session.

Request Body schema: application/vnd.ibexa.api.CatalogCopy+json
optional

If set, the copied catalog is returned in XML or JSON format.

required
object (CatalogCopy)

This class is used to copy a catalog.

Responses

Request samples

Content type
application/vnd.ibexa.api.CatalogCopy+json
{
  • "CatalogCopy": {
    }
}

Response samples

Content type
application/vnd.ibexa.api.Catalog+json
{
  • "Catalog": {
    }
}

Load catalog filters

Loads product filters available for catalogs.

Responses

Response samples

Content type
{
  • "ProductFilterList": {
    }
}

Load catalog sort clauses

Loads product sort clauses available for catalogs.

Responses

Response samples

Content type
{
  • "ProductSortClauseList": {
    }
}

Filter catalogs

Executes a query and returns a View including the results. The View input reflects the criteria model of the public PHP API.

header Parameters
X-CSRF-Token
required
string

The CSRF token is required when passing user session.

Request Body schema:
optional

The view input in XML or JSON format.

required
object (CatalogViewInput)

This class represents a catalog view input.

Responses

Request samples

Content type
{
  • "ViewInput": {
    }
}

Response samples

Content type
{
  • "CatalogView": {
    }
}

Load catalog

Loads the given catalog.

path Parameters
identifier
required
string

CatalogLoadByIdentifierController identifier

Responses

Response samples

Content type
{
  • "Catalog": {
    }
}

Delete catalog

Deletes the given catalog.

path Parameters
identifier
required
string

CatalogDeleteController identifier

header Parameters
X-CSRF-Token
required
string

The CSRF token is required when passing user session.

Responses

Update catalog

Updates a catalog.

path Parameters
identifier
required
string

CatalogUpdateController identifier

header Parameters
X-CSRF-Token
required
string

The CSRF token is required when passing user session.

Request Body schema: application/vnd.ibexa.api.CatalogUpdate+json
optional

If set, the updated catalog is returned in XML or JSON format.

required
object (CatalogUpdate)

This class is used to update a catalog.

Responses

Request samples

Content type
application/vnd.ibexa.api.CatalogUpdate+json
{
  • "CatalogUpdate": {
    }
}

Response samples

Content type
application/vnd.ibexa.api.Catalog+json
{
  • "Catalog": {
    }
}

Filter catalog products

Executes a query and returns a View including the results. The View input reflects the criteria model of the public PHP API.

path Parameters
identifier
required
string

CatalogProductsViewController identifier

header Parameters
X-CSRF-Token
required
string

The CSRF token is required when passing user session.

Request Body schema:
optional

The view input in XML or JSON format.

required
object (ProductViewInput)

This class represents a product view input.

Responses

Request samples

Content type
{
  • "ViewInput": {
    }
}

Response samples

Content type
{
  • "ProductView": {
    }
}

Product Currency

Resource 'Product Currency' operations.

Load currencies

Loads the list of currencies.

Responses

Response samples

Content type
application/vnd.ibexa.api.CurrencyList+json
{
  • "CurrencyList": {
    }
}

Create currency

Creates a new currency.

header Parameters
X-CSRF-Token
required
string

The CSRF token is required when passing user session.

Request Body schema: application/vnd.ibexa.api.CurrencyCreate+json
optional

The Currency schema encoded in XML or JSON format.

required
object (CurrencyCreate)

This class is used to create currency.

Responses

Request samples

Content type
application/vnd.ibexa.api.CurrencyCreate+json
{
  • "CurrencyCreate": {
    }
}

Response samples

Content type
application/vnd.ibexa.api.Currency+json
{
  • "Currency": {
    }
}

Filter currencies

Executes a query and returns a View including the results. The View input reflects the criteria model of the public PHP API.

header Parameters
X-CSRF-Token
required
string

The CSRF token is required when passing user session.

Request Body schema:
optional

The view input in XML or JSON format.

required
object (CurrencyViewInput)

This class represents a currency view input.

Responses

Request samples

Content type
{
  • "ViewInput": {
    }
}

Response samples

Content type
{
  • "CurrencyView": {
    }
}

Load currency

Loads a currency.

path Parameters
id
required
string

CurrencyLoadByIdController identifier

Responses

Response samples

Content type
application/vnd.ibexa.api.Currency+json
{
  • "Currency": {
    }
}

Delete currency

Deletes the given currency.

path Parameters
id
required
string

CurrencyDeleteController identifier

header Parameters
X-CSRF-Token
required
string

The CSRF token is required when passing user session.

Responses

Update currency

Updates a currency.

path Parameters
id
required
string

CurrencyUpdateController identifier

header Parameters
X-CSRF-Token
required
string

The CSRF token is required when passing user session.

Request Body schema: application/vnd.ibexa.api.CurrencyUpdate+json
optional

The CurrencyUpdate schema encoded in XML or JSON format.

required
object (CurrencyUpdate)

This class is used to update currency.

Responses

Request samples

Content type
application/vnd.ibexa.api.CurrencyUpdate+json
{
  • "CurrencyUpdate": {
    }
}

Response samples

Content type
application/vnd.ibexa.api.Currency+json
{
  • "Currency": {
    }
}

Product Customer Group

Resource 'Product Customer Group' operations.

Load customer groups

Returns a list of customer groups

Responses

Response samples

Content type
application/vnd.ibexa.api.CustomerGroupList+json
{
  • "CustomerGroupList": {
    }
}

Create customer group

Creates a new customer group.

header Parameters
X-CSRF-Token
required
string

The CSRF token is required when passing user session.

Request Body schema: application/vnd.ibexa.api.CustomerGroupCreate+json
optional

The CustomerGroupCreate schema encoded in XML or JSON format.

required
object (CustomerGroupCreate)

This class is used to create a customer group.

Responses

Request samples

Content type
application/vnd.ibexa.api.CustomerGroupCreate+json
{
  • "CustomerGroupCreate": {
    }
}

Response samples

Content type
application/vnd.ibexa.api.CustomerGroup+json
{
  • "CustomerGroup": {
    }
}

Filter customer groups

Executes a query and returns a View including the results. The View input reflects the criteria model of the public PHP API.

header Parameters
X-CSRF-Token
required
string

The CSRF token is required when passing user session.

Request Body schema:
optional

The view input in XML or JSON format.

required
object (CustomerGroupViewInput)

This class represents a customer group view input.

Responses

Request samples

Content type
{
  • "ViewInput": {
    }
}

Response samples

Content type
{
  • "CustomerGroupView": {
    }
}

Load customer group

Returns a customer group

path Parameters
identifier
required
string

CustomerGroupLoadByIdentifierController identifier

Responses

Response samples

Content type
application/vnd.ibexa.api.CustomerGroup+json
{
  • "CustomerGroup": {
    }
}

Delete customer group

Deletes the given customer group.

path Parameters
identifier
required
string

CustomerGroupDeleteController identifier

header Parameters
X-CSRF-Token
required
string

The CSRF token is required when passing user session.

Responses

Update customer group

Updates the given customer group.

path Parameters
identifier
required
string

CustomerGroupUpdateController identifier

header Parameters
X-CSRF-Token
required
string

The CSRF token is required when passing user session.

Request Body schema: application/vnd.ibexa.api.CustomerGroupUpdate+json
optional

The CustomerGroupUpdate schema encoded in XML or JSON format.

required
object (CustomerGroupUpdate)

This class is used to update a customer group.

Responses

Request samples

Content type
application/vnd.ibexa.api.CustomerGroupUpdate+json
{
  • "CustomerGroupUpdate": {
    }
}

Response samples

Content type
application/vnd.ibexa.api.CustomerGroup+json
{
  • "CustomerGroup": {
    }
}

Load customer group

Returns a customer group

path Parameters
id
required
integer

CustomerGroupLoadByIdController identifier

Responses

Response samples

Content type
application/vnd.ibexa.api.CustomerGroup+json
{
  • "CustomerGroup": {
    }
}

Product

Resource 'Product' operations.

Load products list (deprecated)

Returns a list of products. Deprecated as of Ibexa DXP 4.3, use POST /product/catalog/products/view instead.

Request Body schema: application/vnd.ibexa.api.ProductListGet+json
optional

The product list schema encoded in XML or JSON format.

required
object (ProductListGet)

This class represents a product list GET.

Responses

Request samples

Content type
application/vnd.ibexa.api.ProductListGet+json
{
  • "ProductListGet": {
    }
}

Response samples

Content type
application/vnd.ibexa.api.ProductList+json
{
  • "ProductList": {
    }
}

Filter products

Executes a query and returns a View including the results. The View input reflects the criteria model of the public PHP API.

header Parameters
X-CSRF-Token
required
string

The CSRF token is required when passing user session.

Request Body schema:
optional

The view input in XML or JSON format.

required
object (ProductViewInput)

This class represents a product view input.

Responses

Request samples

Content type
{
  • "ViewInput": {
    }
}

Response samples

Content type
{
  • "ProductView": {
    }
}

Load the given product

Loads the given product.

path Parameters
code
required
string

ProductLoadByCodeController identifier

Request Body schema: application/vnd.ibexa.api.ProductGet+json
optional

An optional product schema encoded in XML or JSON format.

required
object (ProductGet)

This class represents a product GET.

Responses

Request samples

Content type
application/vnd.ibexa.api.ProductGet+json
{
  • "ProductGet": {
    }
}

Response samples

Content type
application/vnd.ibexa.api.Product+json
{
  • "Product": {
    }
}

Update product

Updates product.

path Parameters
code
required
string

ProductUpdateController identifier

header Parameters
X-CSRF-Token
required
string

The CSRF token is required when passing user session.

Request Body schema: application/vnd.ibexa.api.ProductUpdate+json
optional

If set, the updated product is returned in XML or JSON format.

required
object (ProductUpdate)

This class is used to update a product.

Responses

Request samples

Content type
application/vnd.ibexa.api.ProductUpdate+json
{
  • "ProductUpdate": {
    }
}

Response samples

Content type
application/vnd.ibexa.api.Product+json
{
  • "Product": {
    }
}

Load the list of product prices

Loads the list of product prices.

path Parameters
code
required
string

PriceLoadAllController identifier

Responses

Response samples

Content type
application/vnd.ibexa.api.PriceList+json
{
  • "PriceList": {
    }
}

Create product price or custom price

Create product price or custom price.

path Parameters
code
required
string

PriceCreateController identifier

header Parameters
X-CSRF-Token
required
string

The CSRF token is required when passing user session.

Request Body schema:
optional

The product price schema encoded in JSON format.

required
object (CustomPriceCreateStruct)

This class represents a custom price creation structure.

Responses

Request samples

Content type
{
  • "CustomPriceCreateStruct": {
    }
}

Response samples

Content type
{
  • "CustomPrice": {
    }
}

Get price in given currency

Get price in given currency.

path Parameters
code
required
string

PriceLoadByProductCodeController identifier

currencyCode
required
string

PriceLoadByProductCodeController identifier

Responses

Response samples

Content type
application/vnd.ibexa.api.Price+json
{
  • "Price": {
    }
}

Get price in given currency and customer group

Get price in given currency and customer group.

path Parameters
code
required
string

PriceLoadByProductCodeController identifier

currencyCode
required
string

PriceLoadByProductCodeController identifier

customerGroupIdentifier
required
string

PriceLoadByProductCodeController identifier

Responses

Response samples

Content type
application/vnd.ibexa.api.CustomPrice+json
{
  • "CustomPrice": {
    }
}

Delete product price

Deletes product price.

path Parameters
code
required
string

PriceDeleteController identifier

id
required
string

PriceDeleteController identifier

header Parameters
X-CSRF-Token
required
string

The CSRF token is required when passing user session.

Responses

Update product price

Updates product price.

path Parameters
code
required
string

PriceUpdateController identifier

id
required
string

PriceUpdateController identifier

header Parameters
X-CSRF-Token
required
string

The CSRF token is required when passing user session.

Request Body schema:
optional

Update price or custom price for given currency.

required
object (CustomPriceUpdateStruct)

This class represents a custom price updating structure.

Responses

Request samples

Content type
{
  • "CustomPriceUpdateStruct": {
    }
}

Response samples

Content type
{
  • "CustomPrice": {
    }
}

Delete product

Deletes the given product.

path Parameters
identifier
required
string

ProductDeleteController identifier

header Parameters
X-CSRF-Token
required
string

The CSRF token is required when passing user session.

Responses

Create product

Creates a new product.

path Parameters
productTypeIdentifier
required
string

ProductCreateController identifier

header Parameters
X-CSRF-Token
required
string

The CSRF token is required when passing user session.

Request Body schema: application/vnd.ibexa.api.ProductCreate+json
optional

The product schema encoded in XML or JSON format.

required
object (ProductCreate)

This class is used to create a product.

Responses

Request samples

Content type
application/vnd.ibexa.api.ProductCreate+json
{
  • "ProductCreate": {
    }
}

Response samples

Content type
application/vnd.ibexa.api.ProductCreate+json
{
  • "Product": {
    }
}

Product Type

Resource 'Product Type' operations.

Load product types (deprecated)

Returns a list of product types. Deprecated as of Ibexa DXP 4.3, use POST /product/catalog/product_types/view instead.

Request Body schema:
optional

The ProductTypeList schema encoded in XML or JSON format.

required
object (ProductTypeListGet)

This class represents a product type list query.

Responses

Request samples

Content type
{
  • "ProductTypeListGet": {
    }
}

Response samples

Content type
{
  • "ProductTypeList": {
    }
}

Create product type

Creates a new product type.

header Parameters
X-CSRF-Token
required
string

The CSRF token is required when passing user session.

Request Body schema: application/vnd.ibexa.api.ProductTypeCreate+json
optional

The ProductType schema encoded in XML or JSON format.

required
object (ProductTypeCreate)

This class is used to create a product type.

Responses

Request samples

Content type
application/vnd.ibexa.api.ProductTypeCreate+json
{
  • "ProductTypeCreate": {
    }
}

Response samples

Content type
application/vnd.ibexa.api.ProductType+json
{
  • "ProductType": {
    }
}

Check product type usage

Checks whether the product type is in use.

path Parameters
identifier
required
string

ProductTypeIsUsedController identifier

Responses

Response samples

Content type
{
  • "ProductTypeUsage": {
    }
}

Filter product types

Executes a query and returns a View including the results. The View input reflects the criteria model of the public PHP API.

header Parameters
X-CSRF-Token
required
string

The CSRF token is required when passing user session.

Request Body schema:
optional

The view input in XML or JSON format.

required
object (ProductTypeViewInput)

This class represents a product type view input.

Responses

Request samples

Content type
{
  • "ViewInput": {
    }
}

Response samples

Content type
{
  • "ProductTypeView": {
    }
}

Load product type

Returns the given product type.

path Parameters
identifier
required
string

ProductTypeLoadByIdentifierController identifier

Responses

Response samples

Content type
{
  • "ProductType": {
    }
}

Delete product type

Deletes the given product type.

path Parameters
id
required
string

ProductTypeDeleteController identifier

header Parameters
X-CSRF-Token
required
string

The CSRF token is required when passing user session.

Responses

Update product type

Updates product type.

path Parameters
id
required
string

ProductTypeUpdateController identifier

header Parameters
X-CSRF-Token
required
string

The CSRF token is required when passing user session.

Request Body schema: application/vnd.ibexa.api.ProductTypeUpdate+json
optional

If set, the updated product type is returned in XML or JSON format.

required
object (ProductTypeUpdate)

This class is used to update a product type.

Responses

Request samples

Content type
application/vnd.ibexa.api.ProductTypeUpdate+json
{
  • "ProductTypeUpdate": {
    }
}

Response samples

Content type
application/vnd.ibexa.api.ProductType+json
{
  • "ProductType": {
    }
}

Product Variant

Resource 'Product Variant' operations.

Load product variant

Loads the given product variant.

path Parameters
code
required
string

ProductVariantLoadByCodeController identifier

Responses

Response samples

Content type
application/vnd.ibexa.api.ProductVariant+json
{
  • "ProductVariant": {
    }
}

Generate product variants

Generates new product variants based on selected (discriminator) attributes.

path Parameters
baseProductCode
required
string

ProductVariantGenereateController identifier

header Parameters
X-CSRF-Token
required
string

The CSRF token is required when passing user session.

Request Body schema: application/vnd.ibexa.api.ProductVariantGenerate+json
optional

The product variant schema encoded in XML or JSON format.

required
object (ProductVariantGenerate)

This class is used to generate a product variant.

Responses

Request samples

Content type
application/vnd.ibexa.api.ProductVariantGenerate+json
{
  • "ProductVariantGenerate": {
    }
}

Filter product variants

Executes a query and returns a View including the results. The View input reflects the criteria model of the public PHP API.

path Parameters
baseProductCode
required
string

ProductVariantViewController identifier

header Parameters
X-CSRF-Token
required
string

The CSRF token is required when passing user session.

Request Body schema:
optional

The view input in XML or JSON format.

required
object (ProductVariantViewInput)

This class represents a product variant view input.

Responses

Request samples

Content type
{
  • "ViewInput": {
    }
}

Response samples

Content type
{
  • "ProductVariantView": {
    }
}

Create product variant

Creates a new product variant.

path Parameters
baseProductCode
required
string

ProductVariantCreateController identifier

header Parameters
X-CSRF-Token
required
string

The CSRF token is required when passing user session.

Request Body schema: application/vnd.ibexa.api.ProductVariantCreate+json
optional

The product variant schema encoded in XML or JSON format.

required
object (ProductVariantCreate)

This class is used to create a product variant.

Responses

Request samples

Content type
application/vnd.ibexa.api.ProductVariantCreate+json
{
  • "ProductVariantCreate": {
    }
}

Delete product variant

Deletes the given product variant.

path Parameters
code
required
string

ProductVariantDeleteController identifier

header Parameters
X-CSRF-Token
required
string

The CSRF token is required when passing user session.

Responses

Update product variant

Updates product variant.

path Parameters
code
required
string

ProductVariantUpdateController identifier

header Parameters
X-CSRF-Token
required
string

The CSRF token is required when passing user session.

Request Body schema: application/vnd.ibexa.api.ProductVariantUpdate+json
optional

The product variant update schema encoded in XML or JSON format.

required
object (ProductVariantUpdate)

This class is used to update a product variant.

Responses

Request samples

Content type
application/vnd.ibexa.api.ProductVariantUpdate+json
{
  • "ProductVariantUpdate": {
    }
}

Response samples

Content type
application/vnd.ibexa.api.ProductVariant+json
{
  • "ProductVariant": {
    }
}

Product Region

Resource 'Product Region' operations.

Load regions

Loads the list of regions.

Responses

Response samples

Content type
{
  • "RegionList": {
    }
}

Filter regions

Executes a query and returns a View including the results. The View input reflects the criteria model of the public PHP API.

header Parameters
X-CSRF-Token
required
string

The CSRF token is required when passing user session.

Request Body schema:
optional

The view input in XML or JSON format.

required
object (RegionViewInput)

This class represents a region view input.

Responses

Request samples

Content type
{
  • "ViewInput": {
    }
}

Response samples

Content type
{
  • "RegionView": {
    }
}

Load region

Loads a region by its identifier

path Parameters
identifier
required
string

RegionLoadByIdentifierController identifier

Responses

Response samples

Content type
{
  • "Region": {
    }
}

Product Vat

Resource 'Product Vat' operations.

Load VAT region

Loads a VAT category for the given region.

path Parameters
region
required
string

VatCategoriesListController identifier

Responses

Response samples

Content type
application/vnd.ibexa.api.VatCategoryList+json
{
  • "VatCategoryList": {
    }
}

Load VAT specific region

Loads a VAT category for the given identifier.

path Parameters
region
required
string

VatCategoryLoadByIdentifierController identifier

identifier
required
string

VatCategoryLoadByIdentifierController identifier

Responses

Response samples

Content type
application/vnd.ibexa.api.VatCategory+json
{
  • "VatCategory": {
    }
}

Taxonomy

Resource 'Taxonomy' operations.

Delete Entries

Bulk removes several taxonomy entries.

path Parameters
taxonomyName
required
string

TaxonomyEntryBulkRemoveController identifier

header Parameters
X-CSRF-Token
required
string

The CSRF token.

Request Body schema:
optional

TaxonomyEntryBulkRemove schema encoded in XML or JSON format.

required
object (TaxonomyEntryBulkRemove)

This class is used to bulk remove taxonomy entries.

Responses

Request samples

Content type
{
  • "TaxonomyEntryBulkRemove": {
    }
}

Move Entries

Bulk move several taxonomy entries relative to sibling.

path Parameters
taxonomyName
required
string

TaxonomyEntryBulkMoveController identifier

header Parameters
X-CSRF-Token
required
string

The CSRF token.

Request Body schema:
optional

The TaxonomyEntryBulkMove schema encoded in XML or JSON format.

required
object (TaxonomyEntryBulkMove)

This class is used to bulk move taxonomy entries.

Responses

Request samples

Content type
{
  • "TaxonomyEntryBulkMove": {
    }
}

Get Assignment by ID

Gets taxonomy entry Assignment by its ID.

path Parameters
taxonomyName
required
string

TaxonomyEntryAssignmentLoadByIdController identifier

id
required
string

TaxonomyEntryAssignmentLoadByIdController identifier

Responses

Response samples

Content type
{
  • "TaxonomyEntryAssignment": {
    }
}

Assign entry

Assigns taxonomy entry to a content item.

path Parameters
taxonomyName
required
string

TaxonomyEntryAssignmentAssignController identifier

header Parameters
X-CSRF-Token
required
string

The CSRF token.

Request Body schema: application/vnd.ibexa.api.TaxonomyEntryAssignToContent+json
optional

TaxonomyEntryAssignToContent schema encoded in JSON format.

required
object (TaxonomyEntryAssignToContent)

This class is used to assign taxonomy entry to content.

Responses

Request samples

Content type
application/vnd.ibexa.api.TaxonomyEntryAssignToContent+json
{
  • "TaxonomyEntryAssignToContent": {
    }
}

Get Assignments to a Content

Gets taxonomy entries assigned to a content item by its ID.

path Parameters
taxonomyName
required
string

TaxonomyEntryAssignmentLoadController identifier

contentId
required
string

TaxonomyEntryAssignmentLoadController identifier

Responses

Response samples

Content type
{
  • "EntryAssignmentCollection": {
    }
}

Unassign entry

Unassigns taxonomy entry from a content item.

path Parameters
taxonomyName
required
string

TaxonomyEntryAssignmentUnassignController identifier

header Parameters
X-CSRF-Token
required
string

The CSRF token.

Request Body schema: application/vnd.ibexa.api.TaxonomyEntryUnassignFromContent+json
optional

TaxonomyEntryUnassignFromContent schema encoded in JSON format.

required
object (TaxonomyEntryUnassignFromContent)

This class is used to unassign taxonomy entry from content.

Responses

Request samples

Content type
application/vnd.ibexa.api.TaxonomyEntryUnassignFromContent+json
{
  • "TaxonomyEntryUnassignFromContent": {
    }
}

Get Entry by Content ID

Loads taxonomy Entry by its Content ID.

path Parameters
taxonomyName
required
string

TaxonomyEntryLoadByContentIdController identifier

contentId
required
string

TaxonomyEntryLoadByContentIdController identifier

Responses

Response samples

Content type
{
  • "TaxonomyEntry": {
    }
}

Get Entry by identifier

Loads taxonomy Entry by its Entry identifier.

path Parameters
taxonomyName
required
string

TaxonomyEntryLoadByIdentifierController identifier

identifier
required
string

TaxonomyEntryLoadByIdentifierController identifier

Responses

Response samples

Content type
{
  • "TaxonomyEntry": {
    }
}

Get Entry by ID

Loads taxonomy Entry by its Entry ID.

path Parameters
taxonomyName
required
string

TaxonomyEntryLoadByIdController identifier

id
required
string

TaxonomyEntryLoadByIdController identifier

Responses

Response samples

Content type
{
  • "TaxonomyEntry": {
    }
}

Page

Resource 'Page' operations.

Page structure

Lists the layouts and blocks available for building Pages, with the zones of every layout and the views and attributes of every block.

query Parameters
contentTypeIdentifier
string
Example: contentTypeIdentifier=landing_page

Identifier of a content type holding a Page. When given, only the layouts and blocks allowed for that content type are returned. When omitted or empty, the whole catalogue is returned.

Responses

Response samples

Content type
{
  • "PageStructure": {
    }
}

Segmentation

Resource 'Segmentation' operations.

List segment groups

Lists segment groups.

Responses

Response samples

Content type
{
  • "SegmentGroupList": {
    }
}

Load segment group

Loads segment group.

path Parameters
identifier
required
string

SegmentGroupViewController identifier

Responses

Response samples

Content type
{
  • "SegmentGroup": {
    }
}

List segment group's segments

Lists segment group's segments.

path Parameters
identifier
required
string

SegmentListController identifier

Responses

Response samples

Content type
{
  • "SegmentList": {
    }
}

Load segment

Loads the identified segment.

path Parameters
identifier
required
string

SegmentViewController identifier

Responses

Response samples

Content type
{
  • "Segment": {
    }
}

Activity Log

Resource 'Activity Log' operations.

List of activity log groups

Lists last activity log groups and their entries.

Responses

Response samples

Content type
{
  • "ActivityLogGroupList": {
    }
}

List of activity log groups

Lists last activity log groups and their entries.

header Parameters
X-CSRF-Token
required
string

The CSRF Token needed on all unsafe HTTP methods with session.

Request Body schema:
optional

The query to filter activity log groups.

required
object (ActivityLogGroupListInput)

This class represents the activity log group search query's criteria and sort clauses.

Responses

Request samples

Content type
{
  • "ActivityLogGroupListInput": {
    }
}

Response samples

Content type
{
  • "ActivityLogGroupList": {
    }
}

Connector AI

Resource 'Connector AI' operations.

Get action types list.

Returns action types list.

Responses

Response samples

Content type
{
  • "ActionTypeList": {
    }
}

Get an action type by its unique identifier.

Returns an action type by its unique string identifier.

path Parameters
identifier
required
string
Example: generate_alt_text

ActionTypeLoadByIdentifierController identifier

Responses

Response samples

Content type
{
  • "ActionType": {
    }
}

Get action configuration list.

Returns action configuration list.

Responses

Response samples

Content type
{
  • "ActionConfigurationList": {
    }
}

Query action configuration list.

Returns action configuration list based on the given query.

header Parameters
X-CSRF-Token
required
string

CSRF token obtained during the authentication.

Request Body schema:
optional

Query action configuration search criteria

query
string
action_type_identifier
string
enabled
boolean
limit
integer
page
integer

Responses

Request samples

Content type
{
  • "ActionConfigurationListInput": {
    }
}

Response samples

Content type
{
  • "ActionConfigurationList": {
    }
}

Execute the given AI action

Executes the given AI Action using configured ActionConfiguration or ActionHandler, if passed. Might consume AI agent resources.

path Parameters
actionConfigurationIdentifier
required
string
Examples:
  • rewrite_with_friendly_tone -
  • rewrite_with_professional_tone -
  • summarize_text -
  • expand_text -
  • shorten_text -
  • proofread -
  • improve_readability -
  • gen_alt_text -

Configured action name (obtain by listing the configured actions via GET /api/ibexa/v2/ai/actions endpoint).

header Parameters
X-CSRF-Token
required
string

CSRF token obtained during the authentication.

Request Body schema:
optional

Input to execute the action. An Input type must match the action type.

_media-type
string
Enum: "application/vnd.ibexa.api.ai.RefineText+json" "application/vnd.ibexa.api.ai.RefineText+xml"
required
object
required
object (RuntimeContext)

Responses

Request samples

Content type
{
  • "RefineText": {
    }
}

Response samples

Content type
{
  • "Text": {
    }
}

Get an action configuration by its unique identifier.

Returns an action configuration by its unique string identifier.

path Parameters
identifier
required
string
Example: rewrite_with_friendly_tone

ActionConfigurationLoadByIdentifierController identifier

Responses

Response samples

Content type
{
  • "ActionConfiguration": {
    }
}

Collaboration Sessions

Resource 'Collaboration Sessions' operations.

Create collaboration session

Creates a new collaboration session with participants and returns the session details.

Request Body schema:
optional

Session creation payload

required
object

Responses

Request samples

Content type
<?xml version="1.0" encoding="UTF-8"?>
<ExampleSessionCreate>
    <Owner media-type="application/vnd.ibexa.api.User+xml"
           href="/api/ibexa/v2/user/users/14"
    >
    </Owner>
    <ParticipantListCreate media-type="application/vnd.ibexa.api.ParticipantListCreate+xml">
        <ParticipantCreate media-type="application/vnd.ibexa.api.InternalParticipantCreate+xml">
            <scope>view</scope>
            <User media-type="application/vnd.ibexa.api.User+xml"
                  href="/api/ibexa/v2/user/users/14"
            >
            </User>
        </ParticipantCreate>
        <ParticipantCreate media-type="application/vnd.ibexa.api.ExternalParticipantCreate+xml">
            <email>user@link.invalid</email>
            <scope>view</scope>
        </ParticipantCreate>
    </ParticipantListCreate>
    <subject>example</subject>
</ExampleSessionCreate>

Response samples

Content type
<?xml version="1.0"?>
<CollaborationSession media-type="application/vnd.ibexa.api.ExampleSession+xml">
    <id>123</id>
    <token>abc123def456ghi789</token>
    <createdAt>2023-11-15T10:30:00+00:00</createdAt>
    <updatedAt>2023-11-15T14:45:00+00:00</updatedAt>
    <ParticipantList media-type="application/vnd.ibexa.api.ParticipantList+xml">
        <Participant media-type="application/vnd.ibexa.api.InternalParticipant+xml">
            <id>1</id>
            <name>John Doe</name>
            <scope>edit</scope>
            <User href="/api/ibexa/v2/user/users/14" media-type="application/vnd.ibexa.api.User+xml"/>
            <createdAt>2023-11-15T10:30:00+00:00</createdAt>
            <updatedAt>2023-11-15T10:30:00+00:00</updatedAt>
        </Participant>
        <Participant media-type="application/vnd.ibexa.api.ExternalParticipant+xml">
            <id>2</id>
            <name>guest@example.com</name>
            <scope>view</scope>
            <email>guest@example.com</email>
            <createdAt>2023-11-15T11:00:00+00:00</createdAt>
            <updatedAt>2023-11-15T11:00:00+00:00</updatedAt>
        </Participant>
    </ParticipantList>
    <Owner href="/api/ibexa/v2/user/users/14" media-type="application/vnd.ibexa.api.User+xml"/>
    <subject>Project Collaboration Session</subject>
    <isActive>true</isActive>
    <hasPublicLink>false</hasPublicLink>
</CollaborationSession>

Get collaboration session

Retrieves a collaboration session by its token.

path Parameters
sessionToken
required
string

The session token to retrieve.

Responses

Response samples

Content type
<?xml version="1.0"?>
<CollaborationSession media-type="application/vnd.ibexa.api.ExampleSession+xml">
    <id>123</id>
    <token>abc123def456ghi789</token>
    <createdAt>2023-11-15T10:30:00+00:00</createdAt>
    <updatedAt>2023-11-15T14:45:00+00:00</updatedAt>
    <ParticipantList media-type="application/vnd.ibexa.api.ParticipantList+xml">
        <Participant media-type="application/vnd.ibexa.api.InternalParticipant+xml">
            <id>1</id>
            <name>John Doe</name>
            <scope>edit</scope>
            <User href="/api/ibexa/v2/user/users/14" media-type="application/vnd.ibexa.api.User+xml"/>
            <createdAt>2023-11-15T10:30:00+00:00</createdAt>
            <updatedAt>2023-11-15T10:30:00+00:00</updatedAt>
        </Participant>
        <Participant media-type="application/vnd.ibexa.api.ExternalParticipant+xml">
            <id>2</id>
            <name>guest@example.com</name>
            <scope>view</scope>
            <email>guest@example.com</email>
            <createdAt>2023-11-15T11:00:00+00:00</createdAt>
            <updatedAt>2023-11-15T11:00:00+00:00</updatedAt>
        </Participant>
    </ParticipantList>
    <Owner href="/api/ibexa/v2/user/users/14" media-type="application/vnd.ibexa.api.User+xml"/>
    <subject>Project Collaboration Session</subject>
    <isActive>true</isActive>
    <hasPublicLink>false</hasPublicLink>
</CollaborationSession>

Delete collaboration session

Deletes a collaboration session and removes all associated data.

path Parameters
sessionToken
required
string

The session token to delete.

Responses

Update collaboration session

Updates collaboration session properties.

path Parameters
sessionToken
required
string

The session token to update.

Request Body schema:
optional

Session update payload

required
object

Responses

Request samples

Content type
<?xml version="1.0" encoding="UTF-8"?>
<ExampleSessionUpdate>
    <hasPublicLink>true</hasPublicLink>
</ExampleSessionUpdate>

Response samples

Content type
<?xml version="1.0"?>
<CollaborationSession media-type="application/vnd.ibexa.api.ExampleSession+xml">
    <id>123</id>
    <token>abc123def456ghi789</token>
    <createdAt>2023-11-15T10:30:00+00:00</createdAt>
    <updatedAt>2023-11-15T14:45:00+00:00</updatedAt>
    <ParticipantList media-type="application/vnd.ibexa.api.ParticipantList+xml">
        <Participant media-type="application/vnd.ibexa.api.InternalParticipant+xml">
            <id>1</id>
            <name>John Doe</name>
            <scope>edit</scope>
            <User href="/api/ibexa/v2/user/users/14" media-type="application/vnd.ibexa.api.User+xml"/>
            <createdAt>2023-11-15T10:30:00+00:00</createdAt>
            <updatedAt>2023-11-15T10:30:00+00:00</updatedAt>
        </Participant>
        <Participant media-type="application/vnd.ibexa.api.ExternalParticipant+xml">
            <id>2</id>
            <name>guest@example.com</name>
            <scope>view</scope>
            <email>guest@example.com</email>
            <createdAt>2023-11-15T11:00:00+00:00</createdAt>
            <updatedAt>2023-11-15T11:00:00+00:00</updatedAt>
        </Participant>
    </ParticipantList>
    <Owner href="/api/ibexa/v2/user/users/14" media-type="application/vnd.ibexa.api.User+xml"/>
    <subject>Project Collaboration Session</subject>
    <isActive>true</isActive>
    <hasPublicLink>false</hasPublicLink>
</CollaborationSession>

Create invitation in collaboration session

Creates an invitation for a participant to join a collaboration session.

path Parameters
sessionToken
required
string

The session token.

Request Body schema:
optional

Invitation creation payload

required
object

Responses

Request samples

Content type
<?xml version="1.0" encoding="UTF-8"?>
<InvitationCreate>
    <Sender media-type="application/vnd.ibexa.api.User+xml"
            href="/api/ibexa/v2/user/users/14"
    >
    </Sender>
    <email>anonymous@link.invalid</email>
    <context>
        <simple_array>
            <element>test</element>
            <element>value1</element>
            <element>value2</element>
            <element>value3</element>
            <element>value4</element>
            <element>value5</element>
        </simple_array>
        <single_value>value</single_value>
        <extended_array>
            <bar>bar_value</bar>
            <baz>baz_value</baz>
            <foo>foo_value</foo>
        </extended_array>
    </context>
</InvitationCreate>

Response samples

Content type
No sample

List collaboration session participants

Retrieves a list of all participants in a collaboration session.

path Parameters
sessionToken
required
string

The session token.

Responses

Response samples

Content type
<?xml version="1.0"?>
<ParticipantList media-type="application/vnd.ibexa.api.ParticipantList+xml">
    <Participant media-type="application/vnd.ibexa.api.InternalParticipant+xml">
        <id>1</id>
        <name>John Doe</name>
        <scope>edit</scope>
        <User href="/api/ibexa/v2/user/users/14" media-type="application/vnd.ibexa.api.User+xml"/>
        <createdAt>2023-11-15T10:30:00+00:00</createdAt>
        <updatedAt>2023-11-15T10:30:00+00:00</updatedAt>
    </Participant>
    <Participant media-type="application/vnd.ibexa.api.ExternalParticipant+xml">
        <id>2</id>
        <name>guest@example.com</name>
        <scope>view</scope>
        <email>guest@example.com</email>
        <createdAt>2023-11-15T11:00:00+00:00</createdAt>
        <updatedAt>2023-11-15T11:00:00+00:00</updatedAt>
    </Participant>
</ParticipantList>

Add participants to collaboration session

Adds new participants to an existing collaboration session.

path Parameters
sessionToken
required
string

The session token.

Request Body schema:
optional

Participant list creation payload

required
object

Responses

Request samples

Content type
<?xml version="1.0" encoding="UTF-8"?>
<ParticipantListCreate>
    <ParticipantCreate media-type="application/vnd.ibexa.api.InternalParticipantCreate+xml">
        <scope>view</scope>
        <User media-type="application/vnd.ibexa.api.User+xml"
              href="/api/ibexa/v2/user/users/14"
        >
        </User>
    </ParticipantCreate>
    <ParticipantCreate media-type="application/vnd.ibexa.api.ExternalParticipantCreate+xml">
        <email>user@link.invalid</email>
        <scope>view</scope>
    </ParticipantCreate>
</ParticipantListCreate>

Response samples

Content type
<?xml version="1.0"?>
<ParticipantList media-type="application/vnd.ibexa.api.ParticipantList+xml">
    <Participant media-type="application/vnd.ibexa.api.InternalParticipant+xml">
        <id>1</id>
        <name>John Doe</name>
        <scope>edit</scope>
        <User href="/api/ibexa/v2/user/users/14" media-type="application/vnd.ibexa.api.User+xml"/>
        <createdAt>2023-11-15T10:30:00+00:00</createdAt>
        <updatedAt>2023-11-15T10:30:00+00:00</updatedAt>
    </Participant>
    <Participant media-type="application/vnd.ibexa.api.ExternalParticipant+xml">
        <id>2</id>
        <name>guest@example.com</name>
        <scope>view</scope>
        <email>guest@example.com</email>
        <createdAt>2023-11-15T11:00:00+00:00</createdAt>
        <updatedAt>2023-11-15T11:00:00+00:00</updatedAt>
    </Participant>
</ParticipantList>

Remove participant from collaboration session

Removes a participant from a collaboration session.

path Parameters
sessionToken
required
string

The session token.

participantId
required
integer

The participant ID to remove.

Responses

Update participant in collaboration session

Updates properties of a participant in a collaboration session.

path Parameters
sessionToken
required
string

The session token.

participantId
required
integer

The participant ID to update.

Request Body schema:
optional

Participant update payload

required
object

Responses

Request samples

Content type
<?xml version="1.0" encoding="UTF-8"?>
<InternalParticipantUpdate>
    <scope>view</scope>
</InternalParticipantUpdate>

Response samples

Content type
No sample