For the complete documentation index, see llms.txt. This page is also available as Markdown.

Domains

Search domains

get

Finds the domains that match the given search criteria. Only parameters that are specified in this request and have not null values are used for filtering. All other parameters are ignored. By default a result containing 1000 domains is returned.

Authorizations
AuthorizationstringRequired
Query parameters
offsetinteger · int32OptionalDeprecated

The first result to retrieve. If not set (offset = 0), results will be retrieved starting from row 0. Cursor should be preferred over offset for better performance and stable results. It is forbidden to use both in the same request.

Default: 0
limitinteger · int32Optional

The maximum number of results to retrieve. If not set (limit = 0), the default limit will be used. The maximum allowed limit is 1000.

Default: 0
countLimitinteger · int32OptionalDeprecated

Allows to limit the number of elements that will be counted. -1 will count everything and 0 will cause the count to be skipped. For cursor pagination this parameter is ignored and count is skipped.

Default: -1
cursorstringOptional

Cursor for the current page of results. To retrieve the first page with cursor pagination you need to pass this parameter with an empty value (must be non-null). For the next pages, the value must be taken from the response (nextCursor property).

namestringOptional

The name of the domain to search for

nameMatchModestring · enumOptional

The match mode used to compare name. If the match mode is EXACT the search is case-sensitive, otherwise the search is case-insensitive.

Default: ANYWHEREPossible values:
excludeMetabooleanOptional

The exclude meta flag. If this is set to true then the meta domains will not be returned (meta domains are i.e. domains not created manually by the user).

Default: true
communityIdstring · uuidOptional

The ID of the community to find the domains in

typeIdstring · uuidOptional

The ID of the domain type to search for. Returned domains are of this type. Ignored if typeIds is also provided.

typeIdsstring · uuid[]Optional

The IDs of the domain types to search for. Returned domains are of these types. When provided, typeId is ignored.

typePublicIdstringOptional

The public ID of the domain type to search for. Returned domains are of this type

includeSubCommunitiesbooleanOptional

Whether to include sub-communities. When true, direct sub-communities of the community referenced by the communityId parameter are also included in the search. Sub-communities of those sub-communities are not included.

Default: false
Responses
200

OK - The request has succeeded.

application/json
totalinteger · int64Optional

The total number of results.

Example: 1000
offsetinteger · int64Optional

The offset for the results.

Example: 10
limitinteger · int64Optional

The maximum number of results to be returned.

Example: 100
get/domains

Add domain

post

Adds a new domain with given data into a community.

Authorizations
AuthorizationstringRequired
Body
namestring · min: 1 · max: 255Required

The name of the new domain. Should be unique within the community.

communityIdstring · uuidRequired

The ID of the community that the new domain should be added to.

typeIdstring · uuidOptional

The ID of the domain type of the new domain.

descriptionstringOptional

The description of the new domain.

idstring · uuidOptional

The ID of the new domain. Should be unique within all domains.
It should have a format of universally unique identifier (UUID) and should not start with 00000000-0000-0000- which is a reserved prefix.

excludedFromAutoHyperlinkingbooleanOptional
typePublicIdstringOptional

The public ID of the domain type of the new domain.

Responses
201

Created - The request has been fulfilled and resulted in a new resource being created.

application/json
idstring · uuidRequired

The id of the represented object (entity).

createdBystring · uuidOptional

The id of the user that created this resource.

Example: 4d250cc5-e583-4640-9874-b93d82c7a6cb
createdOninteger · int64Optional

The timestamp (in UTC time standard) of the creation of this resource.

Example: 1475503010320
lastModifiedBystring · uuidOptional

The id of the user who modified this resource the last time.

Example: a073ff90-e7bc-4b35-ba90-c4d475f642fe
lastModifiedOninteger · int64Optional

The timestamp (in UTC time standard) of the last modification of this resource.

Example: 1476703764163
systembooleanOptional

Whether this is a system resource or not.

resourceTypestring · enumRequiredDeprecated

The type of the resource, e.g. [Community, Asset, Domain, Attribute, Relation, WorkflowInstance, ...]. This property is deprecated and will be removed in the future. In order to stay backwards compatible and to enable introduction of new types of resources, where necessary, a resource discriminator property (of type String) has been added to specific subtypes of Resource, e.g. assignedResourceDiscriminator on AssignedResource, or attributeDiscriminator on Attribute. For new types of resource that didn't exist before this change, the resourceType will be BaseDataType.

Possible values:
namestringOptional

The name of the resource.

Example: Test name
descriptionstringOptional

The description of the resource.

Example: Sample descripion of the resource.
excludedFromAutoHyperlinkingbooleanOptional

Whether this domain is excluded from hyperlinking or not.

post/domains

Add multiple domains

post

Adds multiple domains using the given parameters

Authorizations
AuthorizationstringRequired
Bodyobject · AddDomainRequest[]
namestring · min: 1 · max: 255Required

The name of the new domain. Should be unique within the community.

communityIdstring · uuidRequired

The ID of the community that the new domain should be added to.

typeIdstring · uuidOptional

The ID of the domain type of the new domain.

descriptionstringOptional

The description of the new domain.

idstring · uuidOptional

The ID of the new domain. Should be unique within all domains.
It should have a format of universally unique identifier (UUID) and should not start with 00000000-0000-0000- which is a reserved prefix.

excludedFromAutoHyperlinkingbooleanOptional
typePublicIdstringOptional

The public ID of the domain type of the new domain.

Responses
201

Created - The request has been fulfilled and resulted in a new resource being created.

application/json
idstring · uuidRequired

The id of the represented object (entity).

createdBystring · uuidOptional

The id of the user that created this resource.

Example: 4d250cc5-e583-4640-9874-b93d82c7a6cb
createdOninteger · int64Optional

The timestamp (in UTC time standard) of the creation of this resource.

Example: 1475503010320
lastModifiedBystring · uuidOptional

The id of the user who modified this resource the last time.

Example: a073ff90-e7bc-4b35-ba90-c4d475f642fe
lastModifiedOninteger · int64Optional

The timestamp (in UTC time standard) of the last modification of this resource.

Example: 1476703764163
systembooleanOptional

Whether this is a system resource or not.

resourceTypestring · enumRequiredDeprecated

The type of the resource, e.g. [Community, Asset, Domain, Attribute, Relation, WorkflowInstance, ...]. This property is deprecated and will be removed in the future. In order to stay backwards compatible and to enable introduction of new types of resources, where necessary, a resource discriminator property (of type String) has been added to specific subtypes of Resource, e.g. assignedResourceDiscriminator on AssignedResource, or attributeDiscriminator on Attribute. For new types of resource that didn't exist before this change, the resourceType will be BaseDataType.

Possible values:
namestringOptional

The name of the resource.

Example: Test name
descriptionstringOptional

The description of the resource.

Example: Sample descripion of the resource.
excludedFromAutoHyperlinkingbooleanOptional

Whether this domain is excluded from hyperlinking or not.

post/domains/bulk
Deprecated

Remove multiple domains

delete

This endpoint will be removed in the future. Please use POST /domains/removalJobs.

Authorizations
AuthorizationstringRequired
Bodystring · uuid[]
string · uuid[]Optional
Responses
204

No Content - The server has fulfilled the request but does not need to return an entity-body.

No content

delete/domains/bulk

No content

Change multiple domains

patch

Changes multiple domains using the given parameters

Authorizations
AuthorizationstringRequired
Bodyobject · ChangeDomainRequest[]
idstring · uuidRequired

The ID of the domain to be changed. Silently ignored if the ID is provided as path parameter of the request.

namestring · min: 1 · max: 255Optional

The new name for the domain

communityIdstring · uuidOptional

The ID of the new community for the domain

typeIdstring · uuidOptional

The ID of the new domain type for the domain

descriptionstringOptional

The new description for the domain

excludedFromAutoHyperlinkingbooleanOptional

Whether the domain should be excluded from hyperlinking or not

removeScopeOverlapOnMovebooleanOptional

Whether scopes assigned to domain should be removed on move if there are any inherited scopes in new community

typePublicIdstringOptional

The public ID of the new domain type for the domain

Responses
200

OK - The request has succeeded.

application/json
idstring · uuidRequired

The id of the represented object (entity).

createdBystring · uuidOptional

The id of the user that created this resource.

Example: 4d250cc5-e583-4640-9874-b93d82c7a6cb
createdOninteger · int64Optional

The timestamp (in UTC time standard) of the creation of this resource.

Example: 1475503010320
lastModifiedBystring · uuidOptional

The id of the user who modified this resource the last time.

Example: a073ff90-e7bc-4b35-ba90-c4d475f642fe
lastModifiedOninteger · int64Optional

The timestamp (in UTC time standard) of the last modification of this resource.

Example: 1476703764163
systembooleanOptional

Whether this is a system resource or not.

resourceTypestring · enumRequiredDeprecated

The type of the resource, e.g. [Community, Asset, Domain, Attribute, Relation, WorkflowInstance, ...]. This property is deprecated and will be removed in the future. In order to stay backwards compatible and to enable introduction of new types of resources, where necessary, a resource discriminator property (of type String) has been added to specific subtypes of Resource, e.g. assignedResourceDiscriminator on AssignedResource, or attributeDiscriminator on Attribute. For new types of resource that didn't exist before this change, the resourceType will be BaseDataType.

Possible values:
namestringOptional

The name of the resource.

Example: Test name
descriptionstringOptional

The description of the resource.

Example: Sample descripion of the resource.
excludedFromAutoHyperlinkingbooleanOptional

Whether this domain is excluded from hyperlinking or not.

patch/domains/bulk

Get domain

get

Returns the domain with the given ID

Authorizations
AuthorizationstringRequired
Path parameters
domainIdstring · uuidRequired

the ID of the domain

Responses
200

OK - The request has succeeded.

application/json
idstring · uuidRequired

The id of the represented object (entity).

createdBystring · uuidOptional

The id of the user that created this resource.

Example: 4d250cc5-e583-4640-9874-b93d82c7a6cb
createdOninteger · int64Optional

The timestamp (in UTC time standard) of the creation of this resource.

Example: 1475503010320
lastModifiedBystring · uuidOptional

The id of the user who modified this resource the last time.

Example: a073ff90-e7bc-4b35-ba90-c4d475f642fe
lastModifiedOninteger · int64Optional

The timestamp (in UTC time standard) of the last modification of this resource.

Example: 1476703764163
systembooleanOptional

Whether this is a system resource or not.

resourceTypestring · enumRequiredDeprecated

The type of the resource, e.g. [Community, Asset, Domain, Attribute, Relation, WorkflowInstance, ...]. This property is deprecated and will be removed in the future. In order to stay backwards compatible and to enable introduction of new types of resources, where necessary, a resource discriminator property (of type String) has been added to specific subtypes of Resource, e.g. assignedResourceDiscriminator on AssignedResource, or attributeDiscriminator on Attribute. For new types of resource that didn't exist before this change, the resourceType will be BaseDataType.

Possible values:
namestringOptional

The name of the resource.

Example: Test name
descriptionstringOptional

The description of the resource.

Example: Sample descripion of the resource.
excludedFromAutoHyperlinkingbooleanOptional

Whether this domain is excluded from hyperlinking or not.

get/domains/{domainId}
Deprecated

Remove domain

delete

This endpoint will be removed in the future. Please use POST /domains/removalJobs.

Authorizations
AuthorizationstringRequired
Path parameters
domainIdstring · uuidRequired

the ID of the domain to remove

Responses
204

No Content - The server has fulfilled the request but does not need to return an entity-body.

No content

delete/domains/{domainId}

No content

Change domain

patch

Changes the domain with the information that is present in the request. Only properties that are specified in this request and have not null values are updated. All other properties are ignored.

Authorizations
AuthorizationstringRequired
Path parameters
domainIdstring · uuidRequired

the ID of the domain to be changed.

Body
idstring · uuidRequired

The ID of the domain to be changed. Silently ignored if the ID is provided as path parameter of the request.

namestring · min: 1 · max: 255Optional

The new name for the domain

communityIdstring · uuidOptional

The ID of the new community for the domain

typeIdstring · uuidOptional

The ID of the new domain type for the domain

descriptionstringOptional

The new description for the domain

excludedFromAutoHyperlinkingbooleanOptional

Whether the domain should be excluded from hyperlinking or not

removeScopeOverlapOnMovebooleanOptional

Whether scopes assigned to domain should be removed on move if there are any inherited scopes in new community

typePublicIdstringOptional

The public ID of the new domain type for the domain

Responses
200

OK - The request has succeeded.

application/json
idstring · uuidRequired

The id of the represented object (entity).

createdBystring · uuidOptional

The id of the user that created this resource.

Example: 4d250cc5-e583-4640-9874-b93d82c7a6cb
createdOninteger · int64Optional

The timestamp (in UTC time standard) of the creation of this resource.

Example: 1475503010320
lastModifiedBystring · uuidOptional

The id of the user who modified this resource the last time.

Example: a073ff90-e7bc-4b35-ba90-c4d475f642fe
lastModifiedOninteger · int64Optional

The timestamp (in UTC time standard) of the last modification of this resource.

Example: 1476703764163
systembooleanOptional

Whether this is a system resource or not.

resourceTypestring · enumRequiredDeprecated

The type of the resource, e.g. [Community, Asset, Domain, Attribute, Relation, WorkflowInstance, ...]. This property is deprecated and will be removed in the future. In order to stay backwards compatible and to enable introduction of new types of resources, where necessary, a resource discriminator property (of type String) has been added to specific subtypes of Resource, e.g. assignedResourceDiscriminator on AssignedResource, or attributeDiscriminator on Attribute. For new types of resource that didn't exist before this change, the resourceType will be BaseDataType.

Possible values:
namestringOptional

The name of the resource.

Example: Test name
descriptionstringOptional

The description of the resource.

Example: Sample descripion of the resource.
excludedFromAutoHyperlinkingbooleanOptional

Whether this domain is excluded from hyperlinking or not.

patch/domains/{domainId}

Get domain breadcrumb

get

Returns the list of resources that lead to the domain identified by the given ID.

Authorizations
AuthorizationstringRequired
Path parameters
domainIdstringRequired

The ID of the domain

Responses
200

OK - The request has succeeded.

application/json

Represents reference to the resource, including its name.

idstring · uuidRequired

The id of the referenced resource.

Example: 2b7f3a1a-4e50-4077-96f0-a58a395c860d
resourceTypestring · enumRequiredDeprecated

The type of the resource, e.g. [Community, Asset, Domain, Attribute, Relation, WorkflowInstance, ...]. This property is deprecated and will be removed in the future. In order to stay backwards compatible and to enable us to introduce new types of resources, we are replacing the ResourceType enum with a String. For new types of resources that didn't exist before this change, resourceType will be BaseDataType. Please use the resourceDiscriminator property instead. Refer to the object containing the ResourceReference for possible values.

Example: CommunityPossible values:
resourceDiscriminatorstringOptional

The resource discriminator, which indicates the type of the referenced resource, e.g. "Community", "Asset", ... Check the documentation of the class using the resource reference for detailed documentation regarding the possible resource discriminator values.

Example: Community
namestringOptional

The name of the referenced resource.

get/domains/{domainId}/breadcrumb

Remove multiple domains asynchronously

post

Removes multiple domains with the given IDs in a job.

Authorizations
AuthorizationstringRequired
Bodystring · uuid[]
string · uuid[]Optional
Responses
200

OK - The request has succeeded.

application/json

Represents a job. Job is a single atomic task that is to be performed asynchronously

idstring · uuidRequired

The id of the represented object (entity).

createdBystring · uuidOptional

The id of the user that created this resource.

Example: 4d250cc5-e583-4640-9874-b93d82c7a6cb
createdOninteger · int64Optional

The timestamp (in UTC time standard) of the creation of this resource.

Example: 1475503010320
lastModifiedBystring · uuidOptional

The id of the user who modified this resource the last time.

Example: a073ff90-e7bc-4b35-ba90-c4d475f642fe
lastModifiedOninteger · int64Optional

The timestamp (in UTC time standard) of the last modification of this resource.

Example: 1476703764163
systembooleanOptional

Whether this is a system resource or not.

resourceTypestring · enumRequiredDeprecated

The type of the resource, e.g. [Community, Asset, Domain, Attribute, Relation, WorkflowInstance, ...]. This property is deprecated and will be removed in the future. In order to stay backwards compatible and to enable introduction of new types of resources, where necessary, a resource discriminator property (of type String) has been added to specific subtypes of Resource, e.g. assignedResourceDiscriminator on AssignedResource, or attributeDiscriminator on Attribute. For new types of resource that didn't exist before this change, the resourceType will be BaseDataType.

Possible values:
namestringOptional

The name of the resource.

Example: Test name
typestringOptional

The type of the job.

Example: IMPORT
userIdstring · uuidOptional

The ID of the user that initiated this job.

visibilityinteger · int32Optional

The visibility of the job.

progressPercentagenumber · doubleOptional

The progress percentage of the job.

Example: 50
cancelablebooleanOptional

Whether this job is cancelable or not. If set to false it will not be possible to cancel the job once submitted.

startDateinteger · int64Optional

The start date of the job.

Example: 1488016800
endDateinteger · int64Optional

The end date of the job.

Example: 1488021800
statestring · enumOptional

The state of the job.

Example: COMPLETEDPossible values:
resultstring · enumOptional

The result of the job.

Example: SUCCESSPossible values:
messagestringOptional

The message of the job.

Example: Import finished in 12s.
post/domains/removalJobs

Last updated

Was this helpful?