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}
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

Body Params application/json

Examples

Responses

🟢200Update an API
application/json
Body

Modified at 2023-08-15 05:41:03
Previous
Single API
Next
Get All API Versions
Built with