Postman API
  1. API
Postman API
  • API
    • Get all APIs
      GET
    • Create API
      POST
    • Delete an API
      DELETE
    • Single API
      GET
    • Update an API
      PUT
    • Get All API Versions
      GET
    • Create API Version
      POST
    • Delete an API Version
      DELETE
    • Get an API Version
      GET
    • Update an API Version
      PUT
    • Get contract test relations
      GET
    • Get documentation relations
      GET
    • Get environment relations
      GET
    • Get integration test relations
      GET
    • Get monitor relations
      GET
    • Get linked relations
      GET
    • Create relations
      POST
    • Create Schema
      POST
    • Get Schema
      GET
    • Update Schema
      PUT
    • Create collection from schema
      POST
    • Get test suite relations
      GET
    • Sync relations with schema
      PUT
  • Collections
    • All Collections
      GET
    • Create Collection
      POST
    • Create a Fork
      POST
    • Merge a Fork
      POST
    • Delete Collection
      DELETE
    • Single Collection
      GET
    • Update Collection
      PUT
  • Environments
    • All Environments
    • Create Environment
    • Delete Environment
    • Single Environment
    • Update Environment
  • Import
    • Import exported data
    • Import external API specification
  • User
    • API Key Owner
  • Mocks
    • All Mocks
    • Create Mock
    • Delete Mock
    • Single Mock
    • Update Mock
    • Publish Mock
    • Unpublish Mock
  • Monitors
    • All Monitors
    • Create Monitor
    • Delete Monitor
    • Single Monitor
    • Update Monitor
    • Run a Monitor
  • Webhooks
    • Create Webhook
  • Workspaces
    • All workspaces
    • Create Workspace
    • Delete Workspace
    • Single workspace
    • Update Workspace
  1. API

Update an API

PUT
/apis/{apiId}
API
This call updates an existing API .
Request body should contain an api object which should have the fields to be updated. Only name, summary and description fields can be edited for an API.
Response contains an api object with all the details related to the created API, namely, id, name, summary, description etc.
Requires API Key as X-Api-Key request header or apikey URL query parameter.
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request PUT 'https://api.getpostman.com/apis/' \
--header 'Content-Type: application/json' \
--data-raw '{
    "api": {
        "description": "This is an updated Description",
        "name": "New name"
    }
}'
Response Response Example
{
  "api": {
    "createdAt": "2019-02-12T19:34:49.000Z",
    "createdBy": "5665",
    "description": "This is a description.",
    "id": "387c2863-6ee3-4a56-8210-225f774edade",
    "name": "Sync API",
    "summary": "This is a summary",
    "updatedAt": "2019-02-12T19:34:49.000Z"
  }
}

Request

Path Params
apiId
string 
required
Body Params application/json
api
object 
optional
description
string 
optional
Example:
This is an updated Description
name
string 
optional
Example:
New name
Examples

Responses

🟢200Update an API
application/json
Body
api
object 
optional
createdAt
string 
optional
Example:
2019-02-12T19:34:49.000Z
createdBy
string 
optional
Example:
5665
description
string 
optional
Example:
This is a description.
id
string 
optional
Example:
387c2863-6ee3-4a56-8210-225f774edade
name
string 
optional
Example:
Sync API
summary
string 
optional
Example:
This is a summary
updatedAt
string 
optional
Example:
2019-02-12T19:34:49.000Z
Previous
Single API
Next
Get All API Versions
Built with