createSpec
Upload API spec files to Postman's Spec Hub with support for OpenAPI, AsyncAPI, protobuf, and GraphQL. Specify workspace, name, and type to organize your specs.
Instructions
Creates an API spec in Postman's Spec Hub. Supports OpenAPI 2.0/3.0/3.1, AsyncAPI 2.0, protobuf 2/3, GraphQL. Max file size 10MB.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"files": "<files>",
"name": "<name>",
"type": "<type>",
"workspaceId": "<workspaceId>"
},
"name": "createSpec"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| files | Yes | List of spec files with path and content. Use '/' in path to create folders. | |
| name | Yes | Specification name | |
| type | Yes | Spec type (openapi, asyncapi, proto, graphql) | |
| workspaceId | Yes | Workspace ID |