{ "info": { "_postman_id": "dda675f9-d136-42a7-bd09-4418f147664e", "name": "Sideko API Projects API Versions API", "description": "The Sideko REST API enables developers to programmatically manage API projects, generate SDKs in six languages, generate Model Context Protocol (MCP) servers, deploy CLI tools, create mock servers, lint OpenAPI specifications, and publish API documentation. The API powers the Sideko platform which transforms OpenAPI specifications into complete developer tooling suites (SDKs, MCP, Docs, Mocks, CLIs) automatically.\n\nContact Support:\n Name: Sideko Support\n Email: support@sideko.dev", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "createdAt": "2026-07-28T02:53:13.000Z", "updatedAt": "2026-07-28T02:53:13.000Z", "lastUpdatedBy": "35240", "uid": "35240-dda675f9-d136-42a7-bd09-4418f147664e" }, "item": [ { "name": "api-projects", "item": [ { "name": "{projectId}", "item": [ { "name": "versions", "item": [ { "name": "{versionId}", "item": [ { "name": "download", "item": [ { "name": "Download API Version Spec", "id": "134ff960-4626-4455-8d50-f802ba11b233", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/yaml" } ], "url": { "raw": "{{baseUrl}}/api-projects/:projectId/versions/:versionId/download?format=yaml", "host": [ "{{baseUrl}}" ], "path": [ "api-projects", ":projectId", "versions", ":versionId", "download" ], "query": [ { "description": "Preferred output format for the downloaded specification", "key": "format", "value": "yaml" } ], "variable": [ { "id": "1960518c-4d84-4741-bb89-11b95b15375e", "key": "projectId", "value": "", "description": "(Required) Unique identifier of the API project" }, { "id": "64094819-d0bf-4ae3-856d-c0c0e586ccc3", "key": "versionId", "value": "", "description": "(Required) Unique identifier of the API version" } ] }, "description": "Returns the raw OpenAPI specification (JSON or YAML) for a specific API project version. Matches the CLI command `sideko api version download`." }, "response": [ { "id": "0a62a54d-0a37-4a71-9565-a827c1bab83b", "name": "OpenAPI specification returned successfully", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/yaml" }, { "description": "Added as a part of security scheme: apikey", "key": "x-sideko-key", "value": "" } ], "url": { "raw": "{{baseUrl}}/api-projects/:projectId/versions/:versionId/download?format=yaml", "host": [ "{{baseUrl}}" ], "path": [ "api-projects", ":projectId", "versions", ":versionId", "download" ], "query": [ { "description": "Preferred output format for the downloaded specification", "key": "format", "value": "yaml" } ], "variable": [ { "key": "projectId" }, { "key": "versionId" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{}", "createdAt": "2026-07-28T02:53:14.000Z", "updatedAt": "2026-07-28T02:53:14.000Z", "uid": "35240-0a62a54d-0a37-4a71-9565-a827c1bab83b" }, { "id": "55cb214f-efbc-4157-93db-fdf7a02ef72c", "name": "Invalid or missing API key", "originalRequest": { "method": "GET", "header": [ { "description": "Added as a part of security scheme: apikey", "key": "x-sideko-key", "value": "" } ], "url": { "raw": "{{baseUrl}}/api-projects/:projectId/versions/:versionId/download?format=yaml", "host": [ "{{baseUrl}}" ], "path": [ "api-projects", ":projectId", "versions", ":versionId", "download" ], "query": [ { "description": "Preferred output format for the downloaded specification", "key": "format", "value": "yaml" } ], "variable": [ { "key": "projectId" }, { "key": "versionId" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T02:53:14.000Z", "updatedAt": "2026-07-28T02:53:14.000Z", "uid": "35240-55cb214f-efbc-4157-93db-fdf7a02ef72c" }, { "id": "55d6d592-65bb-4314-b5e1-8c7d269a2dd5", "name": "API version not found", "originalRequest": { "method": "GET", "header": [ { "description": "Added as a part of security scheme: apikey", "key": "x-sideko-key", "value": "" } ], "url": { "raw": "{{baseUrl}}/api-projects/:projectId/versions/:versionId/download?format=yaml", "host": [ "{{baseUrl}}" ], "path": [ "api-projects", ":projectId", "versions", ":versionId", "download" ], "query": [ { "description": "Preferred output format for the downloaded specification", "key": "format", "value": "yaml" } ], "variable": [ { "key": "projectId" }, { "key": "versionId" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T02:53:14.000Z", "updatedAt": "2026-07-28T02:53:14.000Z", "uid": "35240-55d6d592-65bb-4314-b5e1-8c7d269a2dd5" } ], "createdAt": "2026-07-28T02:53:13.000Z", "updatedAt": "2026-07-28T02:53:13.000Z", "uid": "35240-134ff960-4626-4455-8d50-f802ba11b233" } ], "id": "5d36fcaa-fd88-4db8-8b22-8a8520f4602e", "createdAt": "2026-07-28T02:53:13.000Z", "updatedAt": "2026-07-28T02:53:13.000Z", "uid": "35240-5d36fcaa-fd88-4db8-8b22-8a8520f4602e" } ], "id": "826b694b-b0c9-4113-a140-9e7e990c6aaf", "createdAt": "2026-07-28T02:53:13.000Z", "updatedAt": "2026-07-28T02:53:13.000Z", "uid": "35240-826b694b-b0c9-4113-a140-9e7e990c6aaf" }, { "name": "List API Versions", "id": "2a8253a5-cb6c-4a6a-a6d4-39fe14a85241", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api-projects/:projectId/versions", "host": [ "{{baseUrl}}" ], "path": [ "api-projects", ":projectId", "versions" ], "variable": [ { "id": "e7dcb09c-866f-4c6c-a6cf-23ea2afbd85e", "key": "projectId", "value": "", "description": "(Required) Unique identifier of the API project" } ] }, "description": "Returns all versions of an API project. Each version corresponds to a distinct OpenAPI specification uploaded to the project." }, "response": [ { "id": "0e07da1f-f464-4601-bcea-7f6919ad7402", "name": "List of API versions returned successfully", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "x-sideko-key", "value": "" } ], "url": { "raw": "{{baseUrl}}/api-projects/:projectId/versions", "host": [ "{{baseUrl}}" ], "path": [ "api-projects", ":projectId", "versions" ], "variable": [ { "key": "projectId" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"items\": [\n {\n \"id\": \"\",\n \"projectId\": \"\",\n \"version\": \"\",\n \"specFormat\": \"openapi3_1\",\n \"createdAt\": \"\"\n },\n {\n \"id\": \"\",\n \"projectId\": \"\",\n \"version\": \"\",\n \"specFormat\": \"openapi3_0\",\n \"createdAt\": \"\"\n }\n ],\n \"total\": \"\"\n}", "createdAt": "2026-07-28T02:53:14.000Z", "updatedAt": "2026-07-28T02:53:14.000Z", "uid": "35240-0e07da1f-f464-4601-bcea-7f6919ad7402" }, { "id": "7185c75b-6ff9-40e8-9e85-5524753a4961", "name": "Invalid or missing API key", "originalRequest": { "method": "GET", "header": [ { "description": "Added as a part of security scheme: apikey", "key": "x-sideko-key", "value": "" } ], "url": { "raw": "{{baseUrl}}/api-projects/:projectId/versions", "host": [ "{{baseUrl}}" ], "path": [ "api-projects", ":projectId", "versions" ], "variable": [ { "key": "projectId" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T02:53:14.000Z", "updatedAt": "2026-07-28T02:53:14.000Z", "uid": "35240-7185c75b-6ff9-40e8-9e85-5524753a4961" }, { "id": "f89b8269-ae5e-4ea6-b3d5-37cb738c1a66", "name": "API project not found", "originalRequest": { "method": "GET", "header": [ { "description": "Added as a part of security scheme: apikey", "key": "x-sideko-key", "value": "" } ], "url": { "raw": "{{baseUrl}}/api-projects/:projectId/versions", "host": [ "{{baseUrl}}" ], "path": [ "api-projects", ":projectId", "versions" ], "variable": [ { "key": "projectId" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T02:53:14.000Z", "updatedAt": "2026-07-28T02:53:14.000Z", "uid": "35240-f89b8269-ae5e-4ea6-b3d5-37cb738c1a66" } ], "createdAt": "2026-07-28T02:53:13.000Z", "updatedAt": "2026-07-28T02:53:13.000Z", "uid": "35240-2a8253a5-cb6c-4a6a-a6d4-39fe14a85241" }, { "name": "Create API Version", "id": "a393d9f7-a5fd-43aa-b15c-59f3379cd3fa", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "multipart/form-data" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "formdata", "formdata": [ { "description": "(Required) OpenAPI specification file (JSON or YAML)", "key": "spec", "type": "file", "value": null }, { "description": "Override the version from the spec info.version field", "key": "version", "value": "", "type": "text" } ] }, "url": { "raw": "{{baseUrl}}/api-projects/:projectId/versions", "host": [ "{{baseUrl}}" ], "path": [ "api-projects", ":projectId", "versions" ], "variable": [ { "id": "b2b28f40-7f01-410f-bc67-83004f1a5015", "key": "projectId", "value": "", "description": "(Required) Unique identifier of the API project" } ] }, "description": "Uploads a new OpenAPI specification to create a new version of the API project. Accepts OpenAPI 3.0 and 3.1 specifications in JSON or YAML format and runs Sideko linting before accepting the version." }, "response": [ { "id": "ef857251-d77d-4cb5-9e19-931c81acf082", "name": "API version created successfully", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "multipart/form-data" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "x-sideko-key", "value": "" } ], "body": { "mode": "formdata", "formdata": [ { "description": "(Required) OpenAPI specification file (JSON or YAML)", "key": "spec", "type": "file" }, { "description": "Override the version from the spec info.version field", "key": "version", "value": "", "type": "text" } ] }, "url": { "raw": "{{baseUrl}}/api-projects/:projectId/versions", "host": [ "{{baseUrl}}" ], "path": [ "api-projects", ":projectId", "versions" ], "variable": [ { "key": "projectId" } ] } }, "status": "Created", "code": 201, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"id\": \"\",\n \"projectId\": \"\",\n \"version\": \"\",\n \"specFormat\": \"openapi3_1\",\n \"createdAt\": \"\"\n}", "createdAt": "2026-07-28T02:53:14.000Z", "updatedAt": "2026-07-28T02:53:14.000Z", "uid": "35240-ef857251-d77d-4cb5-9e19-931c81acf082" }, { "id": "d63050e5-287b-4150-a462-a22d9761fce2", "name": "Invalid OpenAPI specification", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "multipart/form-data" }, { "description": "Added as a part of security scheme: apikey", "key": "x-sideko-key", "value": "" } ], "body": { "mode": "formdata", "formdata": [ { "description": "(Required) OpenAPI specification file (JSON or YAML)", "key": "spec", "type": "file" }, { "description": "Override the version from the spec info.version field", "key": "version", "value": "", "type": "text" } ] }, "url": { "raw": "{{baseUrl}}/api-projects/:projectId/versions", "host": [ "{{baseUrl}}" ], "path": [ "api-projects", ":projectId", "versions" ], "variable": [ { "key": "projectId" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T02:53:14.000Z", "updatedAt": "2026-07-28T02:53:14.000Z", "uid": "35240-d63050e5-287b-4150-a462-a22d9761fce2" }, { "id": "2568c230-ffb7-458c-997e-6e9181029842", "name": "Invalid or missing API key", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "multipart/form-data" }, { "description": "Added as a part of security scheme: apikey", "key": "x-sideko-key", "value": "" } ], "body": { "mode": "formdata", "formdata": [ { "description": "(Required) OpenAPI specification file (JSON or YAML)", "key": "spec", "type": "file" }, { "description": "Override the version from the spec info.version field", "key": "version", "value": "", "type": "text" } ] }, "url": { "raw": "{{baseUrl}}/api-projects/:projectId/versions", "host": [ "{{baseUrl}}" ], "path": [ "api-projects", ":projectId", "versions" ], "variable": [ { "key": "projectId" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T02:53:14.000Z", "updatedAt": "2026-07-28T02:53:14.000Z", "uid": "35240-2568c230-ffb7-458c-997e-6e9181029842" }, { "id": "1488c2d9-9e86-4844-85b2-b50084893916", "name": "API project not found", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "multipart/form-data" }, { "description": "Added as a part of security scheme: apikey", "key": "x-sideko-key", "value": "" } ], "body": { "mode": "formdata", "formdata": [ { "description": "(Required) OpenAPI specification file (JSON or YAML)", "key": "spec", "type": "file" }, { "description": "Override the version from the spec info.version field", "key": "version", "value": "", "type": "text" } ] }, "url": { "raw": "{{baseUrl}}/api-projects/:projectId/versions", "host": [ "{{baseUrl}}" ], "path": [ "api-projects", ":projectId", "versions" ], "variable": [ { "key": "projectId" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T02:53:14.000Z", "updatedAt": "2026-07-28T02:53:14.000Z", "uid": "35240-1488c2d9-9e86-4844-85b2-b50084893916" } ], "createdAt": "2026-07-28T02:53:13.000Z", "updatedAt": "2026-07-28T02:53:13.000Z", "uid": "35240-a393d9f7-a5fd-43aa-b15c-59f3379cd3fa" } ], "id": "47d395b4-443f-434b-a4b8-b3c103ba566e", "createdAt": "2026-07-28T02:53:13.000Z", "updatedAt": "2026-07-28T02:53:13.000Z", "uid": "35240-47d395b4-443f-434b-a4b8-b3c103ba566e" } ], "id": "1e67e117-6aae-48a1-8aa0-281962093c1d", "createdAt": "2026-07-28T02:53:13.000Z", "updatedAt": "2026-07-28T02:53:13.000Z", "uid": "35240-1e67e117-6aae-48a1-8aa0-281962093c1d" } ], "id": "70054bfe-e795-49b3-b9c2-55e2205fb911", "createdAt": "2026-07-28T02:53:13.000Z", "updatedAt": "2026-07-28T02:53:13.000Z", "uid": "35240-70054bfe-e795-49b3-b9c2-55e2205fb911" } ], "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "x-sideko-key", "type": "string" }, { "key": "value", "value": "{{apiKey}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "variable": [ { "key": "baseUrl", "value": "https://api.sideko.dev/v1" } ] }