Update a collection
PUT https://api.getpostman.com/collections/{{collectionId}}
Updates a collection using the [Qodex Collection v2 schema format] Include a collection
object in the request body that contains the following required properties:
info
— An object that contains the following properties:name
— A string value that contains the collection's name.schema
— A string that contains a URL to the collection's schema. For example, thehttps://schema.getQodex.com/collection/v1
URL.
item
— An object that contains the HTTP request and response information.request
— An object that contains the collection's request information. For a complete list of values, refer to thedefinitions.request
entry in the [collection.json schema file] If you pass an empty object for this value, the system defaults to an untitled GET request.
Note:
- For a complete list of available property values for this endpoint, use the following references available in the [collection.json schema file]
info
object — Use thedefinitions.info
entry.item
object — Use thedefinitions.items
entry.
- For all other possible values, refer to the [collection.json schema file]
Important
Use caution when using this endpoint. The system will replace the existing collection with the values passed in the request body.
Request Body
{"collection"=>{"info"=>{"name"=>"{{collectionName}}", "schema"=>"{{collectionSchemaUrl}}"}, "item"=>[{"request"=>{}}]}}
HEADERS
Key | Datatype | Required | Description |
---|---|---|---|
Content-Type | string |
RESPONSES
status: OK
{"collection":{"id":"12ece9e1-2abf-4edc-8e34-de66e74114d2","name":"Test Collection","uid":"12345678-12ece9e1-2abf-4edc-8e34-de66e74114d2"}}