Update a request

PUT

/collections/:collectionId/requests/:requestId

PUT

/collections/:collectionId/requests/:requestId

$ curl -X PUT https://api.getpostman.com/collections/12ece9e1-2abf-4edc-8e34-de66e74114d2/requests/c82dd02c-4870-4907-8fcb-593a876cf05b \
>      -H "x-api-key: <apiKey>" \
>      -H "Content-Type: application/json" \
>      -d '{
>   "name": "Example POST Request",
>   "description": "This is an example POST request.",
>   "method": "POST",
>   "url": "https://postman-echo.com/post",
>   "headerData": [],
>   "queryParams": [],
>   "dataMode": "raw",
>   "rawModeData": "{\n    \"field\": \"Value\"\n}",
>   "dataOptions": {
>     "raw": {
>       "language": "json"
>     }
>   },
>   "collection": "c05fb60e-bb28-4e7b-9cf7-55ada6ab320c",
>   "createdAt": "2023-09-01T07:59:25.000Z",
>   "currentHelper": null,
>   "dataDisabled": false,
>   "descriptionFormat": null,
>   "folder": null,
>   "headers": null,
>   "helperAttributes": null,
>   "lastRevision": 32368133476,
>   "lastUpdatedBy": "12345678",
>   "oauth": "noauth",
>   "owner": "12345678",
>   "pathVariableData": [],
>   "pathVariables": null,
>   "preRequestScript": null,
>   "protocolProfileBehavior": null,
>   "responses_order": [],
>   "tests": null,
>   "updatedAt": "2023-09-01T09:29:54.000Z",
>   "variables": null
> }'

1 {
2   "data": {
3     "id": "c82dd02c-4870-4907-8fcb-593a876cf05b",
4     "name": "Example POST Request",
5     "description": "This is an example POST request.",
6     "createdAt": "2023-09-01T07:59:25.000Z",
7     "updatedAt": "2023-09-08T12:30:29.000Z",
8     "owner": "12345678",
9     "lastUpdatedBy": "12345678",
10     "lastRevision": 32473087936,
11     "auth": "noauth",
12     "collection": "12ece9e1-2abf-4edc-8e34-de66e74114d2",
13     "currentHelper": null,
14     "data": null,
15     "dataDisabled": false,
16     "dataMode": "raw",
17     "dataOptions": {
18       "raw": {
19         "language": "json"
20       }
21     },
22     "descriptionFormat": null,
23     "events": null,
24     "folder": null,
25     "headerData": [],
26     "headers": null,
27     "helperAttributes": null,
28     "method": "POST",
29     "pathVariableData": [],
30     "pathVariables": null,
31     "preRequestScript": null,
32     "protocolProfileBehavior": null,
33     "queryParams": [],
34     "rawModeData": "{\n    \"field\": \"Value\"\n}",
35     "responses_order": [],
36     "tests": null,
37     "url": "https://postman-echo.com/post",
38     "variables": null
39   },
40   "meta": {
41     "action": "update",
42     "model": "request"
43   },
44   "model_id": "c82dd02c-4870-4907-8fcb-593a876cf05b",
45   "revision": 32473098909
46 }

Updates a request in a collection. For a complete list of properties, refer to the Request entry in the Postman Collection Format documentation.

Note:

You must pass a collection ID (12ece9e1-2abf-4edc-8e34-de66e74114d2), not a collection(12345678-12ece9e1-2abf-4edc-8e34-de66e74114d2), in this endpoint.
This endpoint does not support changing the folder of a request.

Updates a request in a collection. For a complete list of properties, refer to the **Request** entry in the [Postman Collection Format documentation](https://schema.postman.com/collection/json/v2.1.0/draft-07/docs/index.html). **Note:** - You must pass a collection ID (`12ece9e1-2abf-4edc-8e34-de66e74114d2`), not a collection(`12345678-12ece9e1-2abf-4edc-8e34-de66e74114d2`), in this endpoint. - This endpoint does not support changing the folder of a request.

Authentication

x-api-keystring

API Key authentication via header

Authorizationstring

A valid SCIM API key for calls to SCIM endpoints.

A valid [SCIM API key](https://learning.postman.com/docs/administration/scim-provisioning/scim-provisioning-overview/#generating-scim-api-key) for calls to SCIM endpoints.

AuthorizationBasic

Basic authentication of the form Basic <base64(username:password)>.

Path parameters

requestIdstringRequired

The request's ID.

collectionIdstringRequired

The collection's ID.

Request

This endpoint expects an object.

namestringOptional

The request's name.

descriptionstring or nullOptional

The request's description.

methodenumOptional

The request's HTTP method.

urlstring or nullOptional

The request's URL.

headerDatalist of objectsOptional

The request's headers.

queryParamslist of objectsOptional

The request's query parameters.

dataModeenumOptional

The request body's data mode.

datalist of objectsOptional

The request body's form data.

rawModeDatastring or nullOptional

The request body's raw mode data.

graphqlModeDataobjectOptional

The request body's GraphQL mode data.

dataOptionsobjectOptional

Additional configurations and options set for the request body's various data modes.

authobjectOptional

The request's authentication information.

eventslist of objectsOptional

A list of scripts configured to run when specific events occur.

Response

Successful Response

dataobject

Information about the updated request. For a complete list of properties, refer to the Request entry in the Postman Collection Format documentation.

metamap from strings to any

A Postman-specific response that contains information about the internal performed operation.

model_idstring

The request's ID.

revisiondouble

An internal revision ID. Its value increments each time the resource changes. You can use this ID to track whether there were changes since the last time you fetched the resource.

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error

500

Internal Server Error