Create a schema

Deprecated

POST

/apis/:apiId/schemas

POST

/apis/:apiId/schemas

$ curl -X POST https://api.postman.com/apis/90ca9f5a-c4c4-11ed-afa1-0242ac120002/schemas \
>      -H "Accept: application/vnd.api.v10+json" \
>      -H "x-api-key: <apiKey>" \
>      -H "Content-Type: application/json" \
>      -d '{
>   "type": "openapi:3",
>   "files": [
>     {
>       "path": "index.json",
>       "content": "{\n  \"openapi\": \"3.0.0\",\n  \"info\": {\n    \"version\": \"1.0.0\",\n    \"title\": \"Sample API\",\n    \"description\": \"Buy or rent spacecrafts\"\n  },\n  \"paths\": {\n    \"/spacecrafts/{spacecraftId}\": {\n      \"parameters\": [\n        {\n          \"name\": \"spacecraftId\",\n          \"description\": \"The unique identifier of the spacecraft\",\n          \"in\": \"path\",\n          \"required\": true,\n          \"schema\": {\n            \"$ref\": \"#/components/schemas/SpacecraftId\"\n          }\n        }\n      ],\n      \"get\": {\n        \"summary\": \"Read a spacecraft\",\n        \"responses\": {\n          \"200\": {\n            \"description\": \"The spacecraft corresponding to the provided `spacecraftId`\",\n            \"content\": {\n              \"application/json\": {\n                \"schema\": {\n                  \"$ref\": \"#/components/schemas/Spacecraft\"\n                }\n              }\n            }\n          },\n          \"404\": {\n            \"description\": \"No spacecraft found for the provided `spacecraftId`\",\n            \"content\": {\n              \"application/json\": {\n                \"schema\": {\n                  \"$ref\": \"#/components/schemas/Error\"\n                }\n              }\n            }\n          },\n          \"500\": {\n            \"description\": \"Unexpected error\",\n            \"content\": {\n              \"application/json\": {\n                \"schema\": {\n                  \"$ref\": \"#/components/schemas/Error\"\n                }\n              }\n            }\n          }\n        }\n      }\n    }\n  },\n  \"components\": {\n    \"schemas\": {\n      \"SpacecraftId\": {\n        \"description\": \"The unique identifier of a spacecraft\",\n        \"type\": \"string\"\n      },\n      \"Spacecraft\": {\n        \"type\": \"object\",\n        \"required\": [\n          \"id\",\n          \"name\",\n          \"type\"\n        ],\n        \"properties\": {\n          \"id\": {\n            \"$ref\": \"#/components/schemas/SpacecraftId\"\n          },\n          \"name\": {\n            \"type\": \"string\"\n          },\n          \"type\": {\n            \"type\": \"string\",\n            \"enum\": [\n              \"capsule\",\n              \"probe\",\n              \"satellite\",\n              \"spaceplane\",\n              \"station\"\n            ]\n          },\n          \"description\": {\n            \"type\": \"string\"\n          }\n        }\n      },\n      \"Error\": {\n        \"type\": \"object\",\n        \"required\": [\n          \"message\"\n        ],\n        \"properties\": {\n          \"message\": {\n            \"description\": \"A human readable error message\",\n            \"type\": \"string\"\n          }\n        }\n      }\n    },\n    \"securitySchemes\": {\n      \"ApiKey\": {\n        \"type\": \"apiKey\",\n        \"in\": \"header\",\n        \"name\": \"X-Api-Key\"\n      }\n    }\n  },\n  \"security\": [\n    {\n      \"ApiKey\": [\n\n      ]\n    }\n  ]\n}"
>     }
>   ]
> }'

1 {
2   "id": "b4fc1bdc-6587-4f9b-95c9-f768146089b4",
3   "type": "openapi:3",
4   "files": [
5     {
6       "id": "b4fc1bdc-6587-4f9b-95c9-f768146089b4",
7       "name": "index.json",
8       "path": "index.json",
9       "createdAt": "2024-07-18T13:17:30.000Z",
10       "root": {
11         "enabled": true
12       },
13       "createdBy": "12345678",
14       "updatedAt": "2024-07-18T13:17:30.000Z",
15       "updatedBy": "12345678"
16     }
17   ],
18   "createdAt": "2024-07-18T13:17:30.000Z",
19   "createdBy": "12345678",
20   "updatedAt": "2024-07-18T13:17:30.000Z",
21   "updatedBy": "12345678"
22 }

Creates a schema for an API.

Authentication

x-api-keystring

API Key authentication via header

Path parameters

apiIdstringRequired

The API's ID.

Request

The request body to create an API schema.

typeenumRequired

The schema's type.

fileslist of objectsRequired

The list of files that are part of the schema.

Response

Created

idstringOptional

The schema's ID.

typeenumOptional

The schema's type.

fileslist of objectsOptional

A list of the schema's files.

createdAtdatetimeOptional

The date and time at which the schema was created.

createdBystringOptional

The user ID of the user that created the schema.

updatedAtdatetimeOptional

The date and time at which the schema was last updated.

updatedBystringOptional

The user ID of the user that updated the schema.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

422

Unprocessable Entity Error

500

Internal Server Error

Authentication

Path parameters

Headers

Request

Response

Errors