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

Relations

Returns relations matching the given search criteria.

get

Returns relations matching 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. The returned relations satisfy all constraints that are specified in this search criteria. By default a result containing 1000 relations 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).

relationTypeIdstring · uuidOptional

The ID of the type of relations to search for.

sourceIdstring · uuidOptional

The ID of the source of relations to search for.

targetIdstring · uuidOptional

The ID of the target of relations to search for.

sourceTargetLogicalOperatorstring · enumOptional

The logical operator determining how to combine the source and target criteria: AND or OR.

Default: ANDPossible values:
typePublicIdstringOptional

The public ID of the type of relations to search for.

Responses
200

OK - The request has succeeded.

application/json
totalinteger · int64Optional

The total number of results. -1 when cursor pagination is used.

Example: 1000
offsetinteger · int64Optional

The offset for the results. -1 when cursor pagination is used.

Example: 10
limitinteger · int64Optional

The maximum number of results to be returned.

Example: 100
nextCursorstringOptional

Cursor value to be passed in next request to retrieve next page of results. Not returned on last page or when offset pagination is used.

get/relations

Adds a new relation.

post

Adds a new relation.

Authorizations
AuthorizationstringRequired
Body
sourceIdstring · uuidRequired

The ID of the source of the relation.

targetIdstring · uuidRequired

The ID of the target of the relation.

typeIdstring · uuidOptional

The ID of the type of the relation.

startingDateinteger · int64OptionalDeprecated

The starting date of the relation.

Example: 1488016800
endingDateinteger · int64OptionalDeprecated

The ending date of the relation.

Example: 1658021800
typePublicIdstringOptional

The public ID of the type of the relation.

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:
startingDateinteger · int64OptionalDeprecated

The timestamp representing the starting date of the relation.

endingDateinteger · int64OptionalDeprecated

The timestamp representing the ending date of the relation.

post/relations

Adds multiple relations in one go.

post

Adds multiple relations in one gos.

Authorizations
AuthorizationstringRequired
Bodyobject · AddRelationRequest[]
sourceIdstring · uuidRequired

The ID of the source of the relation.

targetIdstring · uuidRequired

The ID of the target of the relation.

typeIdstring · uuidOptional

The ID of the type of the relation.

startingDateinteger · int64OptionalDeprecated

The starting date of the relation.

Example: 1488016800
endingDateinteger · int64OptionalDeprecated

The ending date of the relation.

Example: 1658021800
typePublicIdstringOptional

The public ID of the type of the relation.

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:
startingDateinteger · int64OptionalDeprecated

The timestamp representing the starting date of the relation.

endingDateinteger · int64OptionalDeprecated

The timestamp representing the ending date of the relation.

post/relations/bulk

Removes multiple relations.

delete

Removes multiple relations.

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/relations/bulk

No content

Deprecated

Changes multiple relations.

patch

Changes multiple relations. This API is deprecated, use removeRelations with addRelations instead.

Authorizations
AuthorizationstringRequired
Bodyobject · ChangeRelationRequest[]
idstring · uuidRequired

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

sourceIdstring · uuidOptional

The ID of the new source for the relation.

targetIdstring · uuidOptional

The ID of the new target for the relation.

startingDateinteger · int64OptionalDeprecated

The new starting date for the relation.

Example: 1488016800
endingDateinteger · int64OptionalDeprecated

The new ending date for the relation.

Example: 1658021800
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:
startingDateinteger · int64OptionalDeprecated

The timestamp representing the starting date of the relation.

endingDateinteger · int64OptionalDeprecated

The timestamp representing the ending date of the relation.

patch/relations/bulk

Returns a relation identified by given id.

get

Returns a relation identified by given id.

Authorizations
AuthorizationstringRequired
Path parameters
relationIdstring · uuidRequired

the ID of the relation

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:
startingDateinteger · int64OptionalDeprecated

The timestamp representing the starting date of the relation.

endingDateinteger · int64OptionalDeprecated

The timestamp representing the ending date of the relation.

get/relations/{relationId}

Removes a relation identified by given id.

delete

Removes a relation identified by given id.

Authorizations
AuthorizationstringRequired
Path parameters
relationIdstring · uuidRequired

the ID of the relation to remove

Responses
204

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

No content

delete/relations/{relationId}

No content

Deprecated

Changes the relation with the information that is present in the request.

patch

Changes the relation 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. This API is deprecated, use removeRelation with addRelation instead.

Authorizations
AuthorizationstringRequired
Path parameters
relationIdstring · uuidRequired

The ID of the relation to be changed.

Body
idstring · uuidRequired

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

sourceIdstring · uuidOptional

The ID of the new source for the relation.

targetIdstring · uuidOptional

The ID of the new target for the relation.

startingDateinteger · int64OptionalDeprecated

The new starting date for the relation.

Example: 1488016800
endingDateinteger · int64OptionalDeprecated

The new ending date for the relation.

Example: 1658021800
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:
startingDateinteger · int64OptionalDeprecated

The timestamp representing the starting date of the relation.

endingDateinteger · int64OptionalDeprecated

The timestamp representing the ending date of the relation.

patch/relations/{relationId}

Last updated

Was this helpful?