{ "info": { "_postman_id": "7737e836-e240-4d76-a65e-477043c94f48", "name": "Sideko API Projects Linting 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:16.000Z", "updatedAt": "2026-07-28T02:53:16.000Z", "lastUpdatedBy": "35240", "uid": "35240-7737e836-e240-4d76-a65e-477043c94f48" }, "item": [ { "name": "api-projects", "item": [ { "name": "{projectId}", "item": [ { "name": "lint", "item": [ { "name": "Lint API Project", "id": "b5d0f76e-6825-489c-a850-2bc3f5d8ad09", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"versionId\": \"\",\n \"errorsOnly\": false\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api-projects/:projectId/lint", "host": [ "{{baseUrl}}" ], "path": [ "api-projects", ":projectId", "lint" ], "variable": [ { "id": "80bdeaf3-83fa-4799-97c4-05ed3f882f4e", "key": "projectId", "value": "", "description": "(Required) Unique identifier of the API project" } ] }, "description": "Runs Sideko's OpenAPI linting rules against a project version and returns any blocking or advisory linting errors that would prevent SDK, MCP, or mock generation." }, "response": [ { "id": "7f3ef3ff-4674-4e25-8e99-b3859dd1a9e9", "name": "Lint result returned successfully", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "x-sideko-key", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"versionId\": \"\",\n \"errorsOnly\": false\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api-projects/:projectId/lint", "host": [ "{{baseUrl}}" ], "path": [ "api-projects", ":projectId", "lint" ], "variable": [ { "key": "projectId" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"clean\": \"\",\n \"issues\": [\n {\n \"code\": \"\",\n \"severity\": \"hint\",\n \"message\": \"\",\n \"path\": \"\"\n },\n {\n \"code\": \"\",\n \"severity\": \"warn\",\n \"message\": \"\",\n \"path\": \"\"\n }\n ],\n \"errorCount\": \"\",\n \"warningCount\": \"\"\n}", "createdAt": "2026-07-28T02:53:16.000Z", "updatedAt": "2026-07-28T02:53:16.000Z", "uid": "35240-7f3ef3ff-4674-4e25-8e99-b3859dd1a9e9" }, { "id": "e45921ed-8695-4520-80cb-2cb5b248d040", "name": "Invalid or missing API key", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "x-sideko-key", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"versionId\": \"\",\n \"errorsOnly\": false\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api-projects/:projectId/lint", "host": [ "{{baseUrl}}" ], "path": [ "api-projects", ":projectId", "lint" ], "variable": [ { "key": "projectId" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T02:53:16.000Z", "updatedAt": "2026-07-28T02:53:16.000Z", "uid": "35240-e45921ed-8695-4520-80cb-2cb5b248d040" }, { "id": "da4ed95a-afa2-4b7f-bf16-37254594bfd5", "name": "API project not found", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "x-sideko-key", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"versionId\": \"\",\n \"errorsOnly\": false\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api-projects/:projectId/lint", "host": [ "{{baseUrl}}" ], "path": [ "api-projects", ":projectId", "lint" ], "variable": [ { "key": "projectId" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T02:53:16.000Z", "updatedAt": "2026-07-28T02:53:16.000Z", "uid": "35240-da4ed95a-afa2-4b7f-bf16-37254594bfd5" } ], "createdAt": "2026-07-28T02:53:16.000Z", "updatedAt": "2026-07-28T02:53:16.000Z", "uid": "35240-b5d0f76e-6825-489c-a850-2bc3f5d8ad09" } ], "id": "00b6b6da-e234-4196-a3e7-a9228a12aa86", "createdAt": "2026-07-28T02:53:16.000Z", "updatedAt": "2026-07-28T02:53:16.000Z", "uid": "35240-00b6b6da-e234-4196-a3e7-a9228a12aa86" } ], "id": "a1c1db75-a1dd-4403-89fc-3d5ef88f0e82", "createdAt": "2026-07-28T02:53:16.000Z", "updatedAt": "2026-07-28T02:53:16.000Z", "uid": "35240-a1c1db75-a1dd-4403-89fc-3d5ef88f0e82" } ], "id": "393aa5fb-1615-4414-8c2e-5f718e980b5b", "createdAt": "2026-07-28T02:53:16.000Z", "updatedAt": "2026-07-28T02:53:16.000Z", "uid": "35240-393aa5fb-1615-4414-8c2e-5f718e980b5b" } ], "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" } ] }