Update Mock - Postman API

This endpoint allows you to update a mock you have created using its uid. The endpoint allows you to edit fields,

name

environment

description

private

versionTag

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

curl --location --request PUT 'https://api.getpostman.com/mocks/' \ --header 'Content-Type: application/json' \ --data-raw '{ "mock": { "description": "example describing update mock description", "environment": "11582779-ac1b6608-deb7-4c05-9d48-ee775aabfc19", "name": "My Mock Server", "private": false, "versionTag": "abf07d3d-f8ec-47d4-8015-9fe83078b4ec" } }'

{ "mock": { "collection": "11582779-fd6797e2-de6b-4699-975c-85290e4c2499", "config": { "headers": [], "matchBody": false, "matchQueryParams": true, "matchWildcards": true }, "environment": "11582779-ac1b6608-deb7-4c05-9d48-ee775aabfc19", "id": "06040138-dd6b-4cce-9a02-7e1c1ab59723", "mockUrl": "https://06040138-dd6b-4cce-9a02-7e1c1ab59723.mock.pstmn.io", "name": "My Mock Server", "owner": "11582779", "uid": "11582779-06040138-dd6b-4cce-9a02-7e1c1ab59723" } }

Request

Path Params

mock_uid

string

required

Body Params application/json

mock

object

optional

description

string

optional

Example:

example describing update mock description

environment

string

optional

Example:

11582779-ac1b6608-deb7-4c05-9d48-ee775aabfc19

name

string

optional

Example:

My Mock Server

private

boolean

optional

Example:

false

versionTag

string

optional

Example:

abf07d3d-f8ec-47d4-8015-9fe83078b4ec

Examples

Responses

🟢200success Response

application/json

Body

mock

object

optional

collection

string

optional

Example:

11582779-fd6797e2-de6b-4699-975c-85290e4c2499

config

object

optional

environment

string

optional

Example:

11582779-ac1b6608-deb7-4c05-9d48-ee775aabfc19

string

optional

Example:

06040138-dd6b-4cce-9a02-7e1c1ab59723

mockUrl

string

optional

Example:

https://06040138-dd6b-4cce-9a02-7e1c1ab59723.mock.pstmn.io

name

string

optional

Example:

My Mock Server

owner

string

optional

Example:

11582779

uid

string

optional

Example:

11582779-06040138-dd6b-4cce-9a02-7e1c1ab59723