Sign in

v1

latestOpenAPI 3.0.12026-07-13130168404.3 KB
Relation

Delete relationship

Deletes a relationship between two entities (user, space, content).

Permissions required: Permission to access the Confluence site ('Can use' global permission). For favourite relationships, the current user can only delete their own favourite relationships. A space administrator can delete favourite relationships for any user.

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

Path parameters

relationNamestring required

The name of the relationship.

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 deleted or the relationship didn't exist.