Merge a Fork

POST

/collections/merge

Collections

This endpoint allows you to merge a forked collection back to its destination collection.

On successful creation of the collection, the response returns the collection name, id and uid.

You need to specify the fork UID (as source) and destination collection UID (as destination) in the request body.

Optionally, you can also specify the merge strategy as either deleteSource or updateSourceWithDestination. Following is an explanation of the merge strategies

Merge Strategy	Behaviour
deleteSource	Forked collection is deleted after merging
updateSourceWithDestination	Forked collection is up to date with changes in destination collection

If the collections cannot be merged (due to conflicts), appropriate error messages will be returned.

Requires API Key as X-Api-Key request header or apikey URL query parameter.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.getpostman.com/collections/merge' \
--header 'Content-Type: application/json' \
--data-raw '{
    "destination": "{{destination_collection_uid}}",
    "source": "{{source_collection_uid}}",
    "strategy": "deleteSource"
}'

Response Example

{}

Request

Body Params application/json

destination

string

optional

Example:

source

string

optional

Example:

strategy

string

optional

Example:

deleteSource

Examples

Responses

🟢200Success

application/json

Body

object {0}

Modified at 2023-08-15 05:41:03

Create a Fork

Delete Collection