Sign in

v1

latestOpenAPI 3.0.12026-07-13130168404.3 KB
Relation

Create relationship

Creates a relationship between two entities (user, space, content). The 'favourite' relationship is supported by default, but you can use this method to create any type of relationship between two entities.

For example, the following method creates a 'sibling' relationship between two pieces of content: PUT /wiki/rest/api/relation/sibling/from/content/123/to/content/456

Permissions required: Permission to access the Confluence site ('Can use' global permission).

put/wiki/rest/api/relation/{relationName}/from/{sourceType}/{sourceKey}/to/{targetType}/{targetKey}

Path parameters

relationNamestring required

The name of the relationship. This method supports the 'favourite' (i.e. 'save for later') relationship. You can also specify any other value for this parameter to create a custom relationship type.

sourceType'user' | 'content' | 'space' required

The source entity type of the relationship. This must be 'user', if the relationName is 'favourite'.

sourceKeystring required

  • The identifier for the source entity:

  • If sourceType is user, then specify either current (logged-in user), the user key of the user, or the account ID of the user. Note that the user key has been deprecated in favor of the account ID for this parameter. See the migration guide for details.

  • If sourceType is 'content', then specify the content ID.

  • If sourceType is 'space', then specify the space key.

targetType'user' | 'content' | 'space' required

The target entity type of the relationship. This must be 'space' or 'content', if the relationName is 'favourite'.

targetKeystring required

  • The identifier for the target entity:

  • If targetType is user, then specify either current (logged-in user), the user key of the user, or the account ID of the user. Note that the user key has been deprecated in favor of the account ID for this parameter. See the migration guide for details.

  • If targetType is 'content', then specify the content ID.

  • If targetType is 'space', then specify the space key.

Query parameters

sourceStatusstring

The status of the source. This parameter is only used when the sourceType is 'content'.

targetStatusstring

The status of the target. This parameter is only used when the targetType is 'content'.

sourceVersioninteger

The version of the source. This parameter is only used when the sourceType is 'content' and the sourceStatus is 'historical'.

targetVersioninteger

The version of the target. This parameter is only used when the targetType is 'content' and the targetStatus is 'historical'.

Response

Returned if the relationship is created.

namestring required
_linksGenericLinks required