Find target entities related to a source entity

GET {{baseUrl}}/api/relation/:relationName/from/:sourceType/:sourceKey/to/:targetType?sourceStatus=<string>&targetStatus=<string>&sourceVersion=<integer>&targetVersion=<integer>&expand=<string>&expand=<string>&start=0&limit=25

Returns all target entities that have a particular relationship to the source entity. Note, relationships are one way.

For example, the following method finds all content that the current user has an 'ignore' relationship with: GET https://your-domain.atlassian.net/wiki/rest/api/relation/ignore/from/user/current/to/content Note, 'ignore' is an example custom relationship type.

Permissions required: Permission to view both the target entity and source entity.

Request Params

KeyDatatypeRequiredDescription
sourceStatusstringThe status of the source. This parameter is only used when the
sourceType is 'content'.
targetStatusstringThe status of the target. This parameter is only used when the
targetType is 'content'.
sourceVersionstringThe version of the source. This parameter is only used when the
sourceType is 'content' and the sourceStatus is 'historical'.
targetVersionstringThe version of the target. This parameter is only used when the
targetType is 'content' and the targetStatus is 'historical'.
expandstringA multi-value parameter indicating which properties of the response
object to expand.
  • relationData returns information about the relationship, such as who created it and when it was created.

  • source returns the source entity.

  • target returns the target entity. | | expand | string | | A multi-value parameter indicating which properties of the response object to expand.

  • relationData returns information about the relationship, such as who created it and when it was created.

  • source returns the source entity.

  • target returns the target entity. | | start | number | | The starting index of the returned relationships. | | limit | number | | The maximum number of relationships to return per page. Note, this may be restricted by fixed system limits. |

RESPONSES

status: OK

{&quot;results&quot;:[{&quot;name&quot;:&quot;eiusmod dolore&quot;,&quot;_expandable&quot;:{&quot;relationData&quot;:&quot;officia&quot;,&quot;source&quot;:&quot;ut aliqua mollit in laboris&quot;,&quot;target&quot;:&quot;voluptate&quot;},&quot;_links&quot;:{},&quot;relationData&quot;:{&quot;createdBy&quot;:{&quot;type&quot;:&quot;user&quot;,&quot;accountId&quot;:&quot;proident nisi&quot;,&quot;accountType&quot;:&quot;app (if this user is a bot user created on behalf of an Atlassian app)&quot;,&quot;email&quot;:&quot;officia sit&quot;,&quot;publicName&quot;:&quot;culpa&quot;,&quot;profilePicture&quot;:{&quot;path&quot;:&quot;nulla eiusmod&quot;,&quot;width&quot;:57363774,&quot;height&quot;:-21452074,&quot;isDefault&quot;:true},&quot;displayName&quot;:&quot;laborum officia&quot;,&quot;_expandable&quot;:{&quot;operations&quot;:&quot;aliqua elit&quot;,&quot;details&quot;:&quot;sed ex commodo ullamco&quot;,&quot;personalSpace&quot;:&quot;est ut in ad&quot;},&quot;_links&quot;:{},&quot;username&quot;:&quot;Excepteur proident&quot;,&quot;userKey&quot;:&quot;voluptate fugiat nostrud laboris mollit&quot;,&quot;operations&quot;:[{&quot;operation&quot;:&quot;copy&quot;,&quot;targetType&quot;:&quot;blogpost&quot;},{&quot;operation&quot;:&quot;export&quot;,&quot;targetType&quot;:&quot;space&quot;}],&quot;details&quot;:{&quot;business&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;personal&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;}},&quot;personalSpace&quot;:{&quot;id&quot;:30176725,&quot;key&quot;:&quot;qui culpa sit officia irure&quot;,&quot;name&quot;:&quot;mollit&quot;,&quot;type&quot;:&quot;qui dolor consectetur et&quot;,&quot;status&quot;:&quot;exercitation est magna in&quot;,&quot;_expandable&quot;:{&quot;settings&quot;:&quot;id incididunt magna&quot;,&quot;metadata&quot;:&quot;minim qui consectetur&quot;,&quot;operations&quot;:&quot;eu est i&quot;,&quot;lookAndFeel&quot;:&quot;deserunt quis&quot;,&quot;permissions&quot;:&quot;aliquip ut magna&quot;,&quot;icon&quot;:&quot;non&quot;,&quot;description&quot;:&quot;irure aute occaecat&quot;,&quot;theme&quot;:&quot;officia&quot;,&quot;history&quot;:&quot;pariatur Ut dolore adipisicing magna&quot;,&quot;homepage&quot;:&quot;sit sint magna cillum&quot;},&quot;_links&quot;:{},&quot;icon&quot;:{&quot;path&quot;:&quot;est culpa consequ&quot;,&quot;width&quot;:28391664,&quot;height&quot;:6678264,&quot;isDefault&quot;:true},&quot;description&quot;:{&quot;plain&quot;:{&quot;value&quot;:&quot;ad incididunt ex&quot;,&quot;representation&quot;:&quot;view&quot;,&quot;embeddedContent&quot;:[{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;}]},&quot;view&quot;:{&quot;value&quot;:&quot;magna aliqua exe&quot;,&quot;representation&quot;:&quot;plain&quot;,&quot;embeddedContent&quot;:[{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;}]}},&quot;homepage&quot;:{&quot;value&quot;:&quot;\u003cCircular reference to #/components/schemas/Content detected\u003e&quot;},&quot;metadata&quot;:{&quot;labels&quot;:{&quot;results&quot;:[{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;}],&quot;start&quot;:-68962586,&quot;limit&quot;:86790834,&quot;size&quot;:-46961334,&quot;_links&quot;:{}}},&quot;operations&quot;:[{&quot;operation&quot;:&quot;create&quot;,&quot;targetType&quot;:&quot;space&quot;},{&quot;operation&quot;:&quot;move&quot;,&quot;targetType&quot;:&quot;space&quot;}],&quot;permissions&quot;:[{&quot;subjects&quot;:{&quot;_expandable&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;user&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;group&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;}},&quot;operation&quot;:{&quot;operation&quot;:&quot;export&quot;,&quot;targetType&quot;:&quot;blogpost&quot;},&quot;anonymousAccess&quot;:false,&quot;unlicensedAccess&quot;:false},{&quot;subjects&quot;:{&quot;_expandable&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;user&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;group&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;}},&quot;operation&quot;:{&quot;operation&quot;:&quot;purge_version&quot;,&quot;targetType&quot;:&quot;space&quot;},&quot;anonymousAccess&quot;:false,&quot;unlicensedAccess&quot;:false}],&quot;settings&quot;:{&quot;routeOverrideEnabled&quot;:false,&quot;_links&quot;:{}},&quot;theme&quot;:{},&quot;lookAndFeel&quot;:{&quot;headings&quot;:{&quot;color&quot;:&quot;qui magna sint&quot;},&quot;links&quot;:{&quot;color&quot;:&quot;tempor in aliqua&quot;},&quot;menus&quot;:{&quot;hoverOrFocus&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;color&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;}},&quot;header&quot;:{&quot;backgroundColor&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;button&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;primaryNavigation&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;secondaryNavigation&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;search&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;}},&quot;content&quot;:{&quot;screen&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;container&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;header&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;body&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;}},&quot;bordersAndDividers&quot;:{&quot;color&quot;:&quot;ipsum cillum elit&quot;}},&quot;history&quot;:{&quot;createdDate&quot;:&quot;2019-06-08T15:36:45.578Z&quot;}}},&quot;createdDate&quot;:&quot;1942-04-10T17:03:01.544Z&quot;,&quot;friendlyCreatedDate&quot;:&quot;mollit v&quot;},&quot;source&quot;:{},&quot;target&quot;:{}},{&quot;name&quot;:&quot;dolor quis in&quot;,&quot;_expandable&quot;:{&quot;relationData&quot;:&quot;cillum in&quot;,&quot;source&quot;:&quot;irure&quot;,&quot;target&quot;:&quot;do in&quot;},&quot;_links&quot;:{},&quot;relationData&quot;:{&quot;createdBy&quot;:{&quot;type&quot;:&quot;anonymous&quot;,&quot;accountId&quot;:&quot;laboris reprehenderit Ut&quot;,&quot;accountType&quot;:&quot;atlassian&quot;,&quot;email&quot;:&quot;dolor&quot;,&quot;publicName&quot;:&quot;Lorem sit ad&quot;,&quot;profilePicture&quot;:{&quot;path&quot;:&quot;in&quot;,&quot;width&quot;:79807980,&quot;height&quot;:-29772365,&quot;isDefault&quot;:false},&quot;displayName&quot;:&quot;fugiat consectetur et&quot;,&quot;_expandable&quot;:{&quot;operations&quot;:&quot;est eu&quot;,&quot;details&quot;:&quot;in adipisicing&quot;,&quot;personalSpace&quot;:&quot;adipisicing in et id&quot;},&quot;_links&quot;:{},&quot;username&quot;:&quot;tempor consequat deserunt aliqua&quot;,&quot;userKey&quot;:&quot;dolore officia&quot;,&quot;operations&quot;:[{&quot;operation&quot;:&quot;use&quot;,&quot;targetType&quot;:&quot;attachment&quot;},{&quot;operation&quot;:&quot;copy&quot;,&quot;targetType&quot;:&quot;space&quot;}],&quot;details&quot;:{&quot;business&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;personal&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;}},&quot;personalSpace&quot;:{&quot;id&quot;:46964980,&quot;key&quot;:&quot;cillum adipisicing&quot;,&quot;name&quot;:&quot;nulla laboris&quot;,&quot;type&quot;:&quot;proident&quot;,&quot;status&quot;:&quot;dolor&quot;,&quot;_expandable&quot;:{&quot;settings&quot;:&quot;ad Lorem anim dolore&quot;,&quot;metadata&quot;:&quot;non ipsum&quot;,&quot;operations&quot;:&quot;ea aliqua sint&quot;,&quot;lookAndFeel&quot;:&quot;irure minim voluptate sed&quot;,&quot;permissions&quot;:&quot;ullamco &quot;,&quot;icon&quot;:&quot;aliquip in et irure&quot;,&quot;description&quot;:&quot;ad sed&quot;,&quot;theme&quot;:&quot;minim occaecat cillum&quot;,&quot;history&quot;:&quot;cupidatat aute ad&quot;,&quot;homepage&quot;:&quot;ex aliquip&quot;},&quot;_links&quot;:{},&quot;icon&quot;:{&quot;path&quot;:&quot;sed dolor eiusmod sit&quot;,&quot;width&quot;:-41978384,&quot;height&quot;:66964221,&quot;isDefault&quot;:true},&quot;description&quot;:{&quot;plain&quot;:{&quot;value&quot;:&quot;velit sit fugiat in&quot;,&quot;representation&quot;:&quot;plain&quot;,&quot;embeddedContent&quot;:[{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;}]},&quot;view&quot;:{&quot;value&quot;:&quot;non est&quot;,&quot;representation&quot;:&quot;plain&quot;,&quot;embeddedContent&quot;:[{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;}]}},&quot;homepage&quot;:{&quot;value&quot;:&quot;\u003cCircular reference to #/components/schemas/Content detected\u003e&quot;},&quot;metadata&quot;:{&quot;labels&quot;:{&quot;results&quot;:[{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;}],&quot;start&quot;:8721050,&quot;limit&quot;:-31508499,&quot;size&quot;:-70758219,&quot;_links&quot;:{}}},&quot;operations&quot;:[{&quot;operation&quot;:&quot;purge_version&quot;,&quot;targetType&quot;:&quot;page&quot;},{&quot;operation&quot;:&quot;administer&quot;,&quot;targetType&quot;:&quot;comment&quot;}],&quot;permissions&quot;:[{&quot;subjects&quot;:{&quot;_expandable&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;user&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;group&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;}},&quot;operation&quot;:{&quot;operation&quot;:&quot;update&quot;,&quot;targetType&quot;:&quot;application&quot;},&quot;anonymousAccess&quot;:false,&quot;unlicensedAccess&quot;:false},{&quot;subjects&quot;:{&quot;_expandable&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;user&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;group&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;}},&quot;operation&quot;:{&quot;operation&quot;:&quot;move&quot;,&quot;targetType&quot;:&quot;blogpost&quot;},&quot;anonymousAccess&quot;:false,&quot;unlicensedAccess&quot;:false}],&quot;settings&quot;:{&quot;routeOverrideEnabled&quot;:false,&quot;_links&quot;:{}},&quot;theme&quot;:{},&quot;lookAndFeel&quot;:{&quot;headings&quot;:{&quot;color&quot;:&quot;aute proident&quot;},&quot;links&quot;:{&quot;color&quot;:&quot;u&quot;},&quot;menus&quot;:{&quot;hoverOrFocus&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;color&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;}},&quot;header&quot;:{&quot;backgroundColor&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;button&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;primaryNavigation&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;secondaryNavigation&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;search&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;}},&quot;content&quot;:{&quot;screen&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;container&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;header&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;body&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;}},&quot;bordersAndDividers&quot;:{&quot;color&quot;:&quot;amet&quot;}},&quot;history&quot;:{&quot;createdDate&quot;:&quot;1959-02-24T05:04:21.176Z&quot;}}},&quot;createdDate&quot;:&quot;1955-10-26T09:32:56.560Z&quot;,&quot;friendlyCreatedDate&quot;:&quot;amet &quot;},&quot;source&quot;:{},&quot;target&quot;:{}}],&quot;start&quot;:-92854805,&quot;limit&quot;:-69118531,&quot;size&quot;:3210316,&quot;_links&quot;:{}}