Create an API
POST https://api.getpostman.com/apis
Creates an API. Include the following properties in the api
object:
-
name
— A string value that contains the API's name.
You can include the following optional properties:
-
summary
— A string value that contains a summary of the API. -
description
— A string value that contains the description of the API.
Request Params
Key | Datatype | Required | Description |
---|---|---|---|
workspace | string | Optional. The workspace ID in which to create the API. |
If you do not use this parameter, the system creates the API in the "My Workspace" workspace. |
Request Body
{"api"=>{"name"=>"{{apiName}}", "summary"=>"{{apiSummary}}", "description"=>"{{apiDescription}}"}}
HEADERS
Key | Datatype | Required | Description |
---|---|---|---|
Content-Type | string |
RESPONSES
status: OK
{"api":{"createdAt":"2022-06-29T20:46:58.000Z","updatedAt":"2022-06-29T20:46:58.000Z","id":"5360b75f-447e-467c-9299-12fd6c92450d","name":"Test API","summary":"Test API Schema","description":"This is a test API.","createdBy":"12345678","updatedBy":"12345678"}}