Logo
30 days of Postman - for developers API Documentation

API

Number of APIs: 5


1. Create API

POST https://api.getpostman.com/apis?workspace={{workspaceId}}

This call creates a new API with a default API Version.

Request body should contain an api object which should atleast have a property name.

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.



2. Update an API

PUT https://api.getpostman.com/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.



3. Delete an API

DELETE https://api.getpostman.com/apis/{{apiId}}

This call deletes an existing API having the specified id.

Response contains an api object with id of the API which was deleted.

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



4. Get all APIs

GET https://api.getpostman.com/apis

This call fetches all the APIs present in the specified workspace

Response contains an array named apis which would contain all the details of APIs present in the workspace.

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



5. Single API

GET https://api.getpostman.com/apis/{{apiId}}

This call fetches a single API having the specified id.

Response contains an api object with all the details related to the queried API, namely, id, name, summary, description etc.

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



ENDPOINTS