Merge externalURI
/members/{member}/externaluris/{uri}/merge [POST]
| API Support | Available since | Last updated | Output |
|---|---|---|---|
| 6.0005 | 6.3004 | xml, json |
Description
Merge an external URI into this one.
Moves the specified URL's current incoming links (reverse xrefs) and unarchived discussions to this external URI and archives the URL. This can be useful to merge a http URL into its corresponding https URL.
Parameters
| Name | Description | Required | Type | Default value |
|---|---|---|---|---|
| url | the URL to move links/discussions from | yes | url |
Permission
This service requires contributor or higher in a group with edit all URLs permission.
Response
The output has the following format where @links and @discussions are the number of links and discussions that were moved:
<uri-merge links="12" discussions="23">
<uri id="[id]" path="[path]" ...>
<displaytitle>[title]</displaytitle>
...
</uri>
</uri-merge>Error handling
| Code | Cause / Description |
|---|---|
| 0x1213 | URI not found |
| 0x1240 | The URI is not external |
| 0x1241 | A URL cannot be merged with itself |