Create a response

POST

/collections/:collectionId/responses

POST

/collections/:collectionId/responses

$ curl -X POST "https://api.getpostman.com/collections/12ece9e1-2abf-4edc-8e34-de66e74114d2/responses?request=c82dd02c-4870-4907-8fcb-593a876cf05b" \
>      -H "x-api-key: <apiKey>" \
>      -H "Content-Type: application/json" \
>      -d '{
>   "name": "Example POST Response",
>   "description": "This is an example POST response.",
>   "url": "https://postman-echo.com/post",
>   "method": "POST",
>   "headers": [
>     {
>       "key": "Host",
>       "value": "postman-echo.com"
>     },
>     {
>       "key": "user-agent",
>       "value": "curl/7.88.1"
>     },
>     {
>       "key": "accept",
>       "value": "*/*"
>     },
>     {
>       "key": "content-type",
>       "value": "application/json"
>     },
>     {
>       "key": "content-length",
>       "value": "22"
>     }
>   ],
>   "dataMode": "raw",
>   "rawModeData": "{\n    \"field\": \"Value\"\n}",
>   "dataOptions": {
>     "raw": {
>       "language": "json"
>     }
>   }
> }'

1 {
2   "data": {
3     "id": "43e1277f-6079-4feb-9316-c8ec24605092",
4     "owner": "12345678",
5     "request": "c82dd02c-4870-4907-8fcb-593a876cf05b",
6     "createdAt": "2022-08-29T16:58:15.523Z",
7     "updatedAt": "2022-08-29T16:58:15.523Z",
8     "lastUpdatedBy": "12345678"
9   },
10   "meta": {
11     "action": "create",
12     "model": "response"
13   },
14   "model_id": "43e1277f-6079-4feb-9316-c8ec24605092",
15   "revision": 26532286083
16 }

Creates a request response in a collection. For a complete list of request body properties, refer to the Response entry in the Postman Collection Format documentation.

Note:

It is recommended that you pass the name property in the request body. If you do not, the system uses a null value. As a result, this creates a response with a blank name.

Creates a request response in a collection. For a complete list of request body properties, refer to the **Response** entry in the [Postman Collection Format documentation](https://schema.postman.com/collection/json/v2.1.0/draft-07/docs/index.html). **Note:** It is recommended that you pass the `name` property in the request body. If you do not, the system uses a null value. As a result, this creates a response with a blank name.

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

collectionIdstringRequired

The collection's ID.

Query parameters

requeststringRequired

The parent request's ID.

Request

This endpoint expects an object.

namestringOptional

The response’s name. It is recommended that you pass the name property in the request body. If you do not, the system uses a null value. As a result, this creates a response with a blank name.

descriptionstring or nullOptional

The response's description.

urlstring or nullOptional

The associated request's URL.

methodenumOptional

The request's HTTP method.

headerslist of objectsOptional

A list of headers.

dataModeenumOptional

The associated request body's data mode.

rawModeDatastring or nullOptional

The associated request body's raw mode data.

dataOptionsobjectOptional

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

responseCodeobjectOptional

The response's HTTP response code information.

statusstring or nullOptional

The response's HTTP status text.

timestringOptional

The time taken by the request to complete, in milliseconds.

cookiesstring or nullOptional

The response's cookie data.

mimestring or nullOptional

The response's MIME type.

textstringOptional

The raw text of the response body.

languagestringOptional

The response body's language type.

rawDataTypestring or nullOptional

The response's raw data type.

requestObjectstringOptional

A JSON-stringified representation of the associated request.

Response

Successful Response

dataobject

Information about the response. For a complete list of properties, refer to the Response 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 response'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

500

Internal Server Error