{ "info": { "_postman_id": "2480976c-cc88-4a37-a43f-3ca8a81a9dc6", "name": "Sideko API Projects SDK Generation 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:20.000Z", "updatedAt": "2026-07-28T02:53:20.000Z", "lastUpdatedBy": "35240", "uid": "35240-2480976c-cc88-4a37-a43f-3ca8a81a9dc6" }, "item": [ { "name": "api-projects", "item": [ { "name": "{projectId}", "item": [ { "name": "sdks", "item": [ { "name": "{sdkId}", "item": [ { "name": "Get SDK Generation", "id": "804de59b-1dd8-4cb5-ba5b-1b23ca0f0386", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api-projects/:projectId/sdks/:sdkId", "host": [ "{{baseUrl}}" ], "path": [ "api-projects", ":projectId", "sdks", ":sdkId" ], "variable": [ { "id": "a303ef6f-c1f0-4411-a310-008fd5be4019", "key": "projectId", "value": "", "description": "(Required) Unique identifier of the API project" }, { "id": "a1b46438-981f-4017-a9f9-21bc840f4e5e", "key": "sdkId", "value": "", "description": "(Required) Unique identifier of the SDK generation job" } ] }, "description": "Returns the status and details of a specific SDK generation job. When the status is complete, a download URL is provided to retrieve the generated SDK archive." }, "response": [ { "id": "50c41310-cded-4701-8528-02ed98e72499", "name": "SDK generation job details 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/sdks/:sdkId", "host": [ "{{baseUrl}}" ], "path": [ "api-projects", ":projectId", "sdks", ":sdkId" ], "variable": [ { "key": "projectId" }, { "key": "sdkId" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"id\": \"\",\n \"projectId\": \"\",\n \"versionId\": \"\",\n \"language\": \"java\",\n \"status\": \"running\",\n \"ghActions\": \"\",\n \"llmCodingAssistants\": [\n \"claude_code\",\n \"claude_code\"\n ],\n \"downloadUrl\": \"\",\n \"createdAt\": \"\",\n \"completedAt\": \"\"\n}", "createdAt": "2026-07-28T02:53:21.000Z", "updatedAt": "2026-07-28T02:53:21.000Z", "uid": "35240-50c41310-cded-4701-8528-02ed98e72499" }, { "id": "ea2c1a49-cebb-42a1-9819-55cc19d5be31", "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/sdks/:sdkId", "host": [ "{{baseUrl}}" ], "path": [ "api-projects", ":projectId", "sdks", ":sdkId" ], "variable": [ { "key": "projectId" }, { "key": "sdkId" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T02:53:21.000Z", "updatedAt": "2026-07-28T02:53:21.000Z", "uid": "35240-ea2c1a49-cebb-42a1-9819-55cc19d5be31" }, { "id": "4f2c5674-5da8-4425-941c-1dc55eff7351", "name": "SDK generation job 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/sdks/:sdkId", "host": [ "{{baseUrl}}" ], "path": [ "api-projects", ":projectId", "sdks", ":sdkId" ], "variable": [ { "key": "projectId" }, { "key": "sdkId" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T02:53:21.000Z", "updatedAt": "2026-07-28T02:53:21.000Z", "uid": "35240-4f2c5674-5da8-4425-941c-1dc55eff7351" } ], "createdAt": "2026-07-28T02:53:21.000Z", "updatedAt": "2026-07-28T02:53:21.000Z", "uid": "35240-804de59b-1dd8-4cb5-ba5b-1b23ca0f0386" } ], "id": "f998a793-b28b-4c9b-9c1b-22dd85622e22", "createdAt": "2026-07-28T02:53:21.000Z", "updatedAt": "2026-07-28T02:53:21.000Z", "uid": "35240-f998a793-b28b-4c9b-9c1b-22dd85622e22" }, { "name": "List SDK Generations", "id": "66e28548-7d2f-46b5-ace4-4bc6fd71f5c8", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api-projects/:projectId/sdks", "host": [ "{{baseUrl}}" ], "path": [ "api-projects", ":projectId", "sdks" ], "variable": [ { "id": "ede84008-377d-4555-aa91-4c2f5a4896ef", "key": "projectId", "value": "", "description": "(Required) Unique identifier of the API project" } ] }, "description": "Returns all SDK generation jobs for an API project across all target languages, including their status and download URLs when complete." }, "response": [ { "id": "df7d60b9-8581-4a03-8b42-8344b8788293", "name": "List of SDK generation jobs 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/sdks", "host": [ "{{baseUrl}}" ], "path": [ "api-projects", ":projectId", "sdks" ], "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 \"versionId\": \"\",\n \"language\": \"rust\",\n \"status\": \"pending\",\n \"ghActions\": \"\",\n \"llmCodingAssistants\": [\n \"github_copilot\",\n \"gemini\"\n ],\n \"downloadUrl\": \"\",\n \"createdAt\": \"\",\n \"completedAt\": \"\"\n },\n {\n \"id\": \"\",\n \"projectId\": \"\",\n \"versionId\": \"\",\n \"language\": \"java\",\n \"status\": \"complete\",\n \"ghActions\": \"\",\n \"llmCodingAssistants\": [\n \"cursor\",\n \"gemini\"\n ],\n \"downloadUrl\": \"\",\n \"createdAt\": \"\",\n \"completedAt\": \"\"\n }\n ],\n \"total\": \"\"\n}", "createdAt": "2026-07-28T02:53:21.000Z", "updatedAt": "2026-07-28T02:53:21.000Z", "uid": "35240-df7d60b9-8581-4a03-8b42-8344b8788293" }, { "id": "6f7868ad-6fb3-453d-b37e-5b60b6635321", "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/sdks", "host": [ "{{baseUrl}}" ], "path": [ "api-projects", ":projectId", "sdks" ], "variable": [ { "key": "projectId" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T02:53:21.000Z", "updatedAt": "2026-07-28T02:53:21.000Z", "uid": "35240-6f7868ad-6fb3-453d-b37e-5b60b6635321" }, { "id": "79d7f686-87fb-4bd6-abca-bb8267eaac72", "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/sdks", "host": [ "{{baseUrl}}" ], "path": [ "api-projects", ":projectId", "sdks" ], "variable": [ { "key": "projectId" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T02:53:21.000Z", "updatedAt": "2026-07-28T02:53:21.000Z", "uid": "35240-79d7f686-87fb-4bd6-abca-bb8267eaac72" } ], "createdAt": "2026-07-28T02:53:21.000Z", "updatedAt": "2026-07-28T02:53:21.000Z", "uid": "35240-66e28548-7d2f-46b5-ace4-4bc6fd71f5c8" }, { "name": "Trigger SDK Generation", "id": "896c40a1-02b5-4649-b77e-0a32c065c7cc", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"language\": \"java\",\n \"versionId\": \"\",\n \"ghActions\": false,\n \"llmCodingAssistants\": [\n \"claude_code\",\n \"github_copilot\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api-projects/:projectId/sdks", "host": [ "{{baseUrl}}" ], "path": [ "api-projects", ":projectId", "sdks" ], "variable": [ { "id": "62c7ff35-61e9-4a50-9caa-b0fc28e8d3bb", "key": "projectId", "value": "", "description": "(Required) Unique identifier of the API project" } ] }, "description": "Initiates an SDK generation job for the specified API project version and target programming language. The job runs asynchronously and the resulting SDK can be downloaded when the status is complete." }, "response": [ { "id": "18580f0a-fc6c-4f24-bb09-d8d53e417ed2", "name": "SDK generation job accepted and queued", "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 \"language\": \"java\",\n \"versionId\": \"\",\n \"ghActions\": false,\n \"llmCodingAssistants\": [\n \"claude_code\",\n \"github_copilot\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api-projects/:projectId/sdks", "host": [ "{{baseUrl}}" ], "path": [ "api-projects", ":projectId", "sdks" ], "variable": [ { "key": "projectId" } ] } }, "status": "Accepted", "code": 202, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"id\": \"\",\n \"projectId\": \"\",\n \"versionId\": \"\",\n \"language\": \"java\",\n \"status\": \"running\",\n \"ghActions\": \"\",\n \"llmCodingAssistants\": [\n \"claude_code\",\n \"claude_code\"\n ],\n \"downloadUrl\": \"\",\n \"createdAt\": \"\",\n \"completedAt\": \"\"\n}", "createdAt": "2026-07-28T02:53:21.000Z", "updatedAt": "2026-07-28T02:53:21.000Z", "uid": "35240-18580f0a-fc6c-4f24-bb09-d8d53e417ed2" }, { "id": "f7a47ee3-468d-42c4-879c-d818c9153f07", "name": "Invalid request parameters", "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 \"language\": \"java\",\n \"versionId\": \"\",\n \"ghActions\": false,\n \"llmCodingAssistants\": [\n \"claude_code\",\n \"github_copilot\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api-projects/:projectId/sdks", "host": [ "{{baseUrl}}" ], "path": [ "api-projects", ":projectId", "sdks" ], "variable": [ { "key": "projectId" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T02:53:21.000Z", "updatedAt": "2026-07-28T02:53:21.000Z", "uid": "35240-f7a47ee3-468d-42c4-879c-d818c9153f07" }, { "id": "dd6030e8-5fde-4ac8-85f3-793c85ee5103", "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 \"language\": \"java\",\n \"versionId\": \"\",\n \"ghActions\": false,\n \"llmCodingAssistants\": [\n \"claude_code\",\n \"github_copilot\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api-projects/:projectId/sdks", "host": [ "{{baseUrl}}" ], "path": [ "api-projects", ":projectId", "sdks" ], "variable": [ { "key": "projectId" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T02:53:21.000Z", "updatedAt": "2026-07-28T02:53:21.000Z", "uid": "35240-dd6030e8-5fde-4ac8-85f3-793c85ee5103" }, { "id": "76694f81-ee92-4963-b9be-6d87eac1d0cb", "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 \"language\": \"java\",\n \"versionId\": \"\",\n \"ghActions\": false,\n \"llmCodingAssistants\": [\n \"claude_code\",\n \"github_copilot\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api-projects/:projectId/sdks", "host": [ "{{baseUrl}}" ], "path": [ "api-projects", ":projectId", "sdks" ], "variable": [ { "key": "projectId" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T02:53:21.000Z", "updatedAt": "2026-07-28T02:53:21.000Z", "uid": "35240-76694f81-ee92-4963-b9be-6d87eac1d0cb" } ], "createdAt": "2026-07-28T02:53:21.000Z", "updatedAt": "2026-07-28T02:53:21.000Z", "uid": "35240-896c40a1-02b5-4649-b77e-0a32c065c7cc" } ], "id": "b501fc43-6c4e-4adc-8099-f0183b278d7a", "createdAt": "2026-07-28T02:53:21.000Z", "updatedAt": "2026-07-28T02:53:21.000Z", "uid": "35240-b501fc43-6c4e-4adc-8099-f0183b278d7a" } ], "id": "3f399f87-e0c3-4019-915b-2009709ea4e1", "createdAt": "2026-07-28T02:53:21.000Z", "updatedAt": "2026-07-28T02:53:21.000Z", "uid": "35240-3f399f87-e0c3-4019-915b-2009709ea4e1" } ], "id": "9fcf611e-cf11-4c9d-ab42-e4375ff9567c", "createdAt": "2026-07-28T02:53:21.000Z", "updatedAt": "2026-07-28T02:53:21.000Z", "uid": "35240-9fcf611e-cf11-4c9d-ab42-e4375ff9567c" } ], "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" } ] }