createSpecFile
Creates API specification files in JSON or YAML format for Postman, enabling structured API documentation and multi-file specifications with automatic folder creation.
Instructions
Creates an API specification file.
Note:
If the file path contains a `/` (forward slash) character, then a folder is created. For example, if the path is the `components/schemas.json` value, then a `components` folder is created with the `schemas.json` file inside.
Creating a spec file assigns it the `DEFAULT` file type.
Multi-file specifications can only have one root file.
Files cannot exceed a maximum of 10 MB in size.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| specId | Yes | The spec's ID. | |
| path | Yes | The file's path. Accepts JSON or YAML files. | |
| content | Yes | The file's stringified contents. |