{ "info": { "_postman_id": "cc811a53-9135-44e1-9947-d4ec75189a17", "name": "Sideko API Projects 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:12.000Z", "updatedAt": "2026-07-28T02:53:12.000Z", "lastUpdatedBy": "35240", "uid": "35240-cc811a53-9135-44e1-9947-d4ec75189a17" }, "item": [ { "name": "api-projects", "item": [ { "name": "{projectId}", "item": [ { "name": "Get API Project", "id": "3563f81b-40e5-4be4-9d1d-5df395509e23", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api-projects/:projectId", "host": [ "{{baseUrl}}" ], "path": [ "api-projects", ":projectId" ], "variable": [ { "id": "0a758c68-abee-497a-823a-c713e10026c3", "key": "projectId", "value": "", "description": "(Required) Unique identifier of the API project" } ] }, "description": "Returns the details of a specific API project by its unique identifier, including project metadata, versions, and associated tooling." }, "response": [ { "id": "7d157773-7131-4b7d-ab12-28e988719e45", "name": "API project 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", "host": [ "{{baseUrl}}" ], "path": [ "api-projects", ":projectId" ], "variable": [ { "key": "projectId" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"id\": \"\",\n \"name\": \"\",\n \"description\": \"\",\n \"slug\": \"\",\n \"versionCount\": \"\",\n \"createdAt\": \"\",\n \"updatedAt\": \"\"\n}", "createdAt": "2026-07-28T02:53:13.000Z", "updatedAt": "2026-07-28T02:53:13.000Z", "uid": "35240-7d157773-7131-4b7d-ab12-28e988719e45" }, { "id": "625643da-cf63-41eb-a2f9-ba508c42d865", "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", "host": [ "{{baseUrl}}" ], "path": [ "api-projects", ":projectId" ], "variable": [ { "key": "projectId" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T02:53:13.000Z", "updatedAt": "2026-07-28T02:53:13.000Z", "uid": "35240-625643da-cf63-41eb-a2f9-ba508c42d865" }, { "id": "6128fa68-168c-4443-bc5f-c375c17a3910", "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", "host": [ "{{baseUrl}}" ], "path": [ "api-projects", ":projectId" ], "variable": [ { "key": "projectId" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T02:53:13.000Z", "updatedAt": "2026-07-28T02:53:13.000Z", "uid": "35240-6128fa68-168c-4443-bc5f-c375c17a3910" } ], "createdAt": "2026-07-28T02:53:13.000Z", "updatedAt": "2026-07-28T02:53:13.000Z", "uid": "35240-3563f81b-40e5-4be4-9d1d-5df395509e23" }, { "name": "Update API Project", "id": "c1359ba1-c248-46a6-9acf-b7231d87ac53", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"description\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api-projects/:projectId", "host": [ "{{baseUrl}}" ], "path": [ "api-projects", ":projectId" ], "variable": [ { "id": "fec9ebfe-6c56-4605-982a-1de645d09965", "key": "projectId", "value": "", "description": "(Required) Unique identifier of the API project" } ] }, "description": "Updates the metadata of an existing API project, including the project name, description, and configuration settings." }, "response": [ { "id": "1c5a1b45-bd8f-4d75-a465-5143e7477d23", "name": "API project updated successfully", "originalRequest": { "method": "PUT", "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 \"name\": \"\",\n \"description\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api-projects/:projectId", "host": [ "{{baseUrl}}" ], "path": [ "api-projects", ":projectId" ], "variable": [ { "key": "projectId" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"id\": \"\",\n \"name\": \"\",\n \"description\": \"\",\n \"slug\": \"\",\n \"versionCount\": \"\",\n \"createdAt\": \"\",\n \"updatedAt\": \"\"\n}", "createdAt": "2026-07-28T02:53:13.000Z", "updatedAt": "2026-07-28T02:53:13.000Z", "uid": "35240-1c5a1b45-bd8f-4d75-a465-5143e7477d23" }, { "id": "541e9a93-5303-48f8-9533-0da27848e518", "name": "Invalid request parameters", "originalRequest": { "method": "PUT", "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 \"name\": \"\",\n \"description\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api-projects/:projectId", "host": [ "{{baseUrl}}" ], "path": [ "api-projects", ":projectId" ], "variable": [ { "key": "projectId" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T02:53:13.000Z", "updatedAt": "2026-07-28T02:53:13.000Z", "uid": "35240-541e9a93-5303-48f8-9533-0da27848e518" }, { "id": "d635927b-faf2-435d-8d50-0214276d770e", "name": "Invalid or missing API key", "originalRequest": { "method": "PUT", "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 \"name\": \"\",\n \"description\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api-projects/:projectId", "host": [ "{{baseUrl}}" ], "path": [ "api-projects", ":projectId" ], "variable": [ { "key": "projectId" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T02:53:13.000Z", "updatedAt": "2026-07-28T02:53:13.000Z", "uid": "35240-d635927b-faf2-435d-8d50-0214276d770e" }, { "id": "92df52d8-5997-4a04-ac66-076c9be80ce3", "name": "API project not found", "originalRequest": { "method": "PUT", "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 \"name\": \"\",\n \"description\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api-projects/:projectId", "host": [ "{{baseUrl}}" ], "path": [ "api-projects", ":projectId" ], "variable": [ { "key": "projectId" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T02:53:13.000Z", "updatedAt": "2026-07-28T02:53:13.000Z", "uid": "35240-92df52d8-5997-4a04-ac66-076c9be80ce3" } ], "createdAt": "2026-07-28T02:53:13.000Z", "updatedAt": "2026-07-28T02:53:13.000Z", "uid": "35240-c1359ba1-c248-46a6-9acf-b7231d87ac53" }, { "name": "Delete API Project", "id": "c5bef10e-fe90-471b-8349-9770655dfb73", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "DELETE", "header": [], "url": { "raw": "{{baseUrl}}/api-projects/:projectId", "host": [ "{{baseUrl}}" ], "path": [ "api-projects", ":projectId" ], "variable": [ { "id": "cfb27941-792a-4577-bafb-193623e1d7e1", "key": "projectId", "value": "", "description": "(Required) Unique identifier of the API project" } ] }, "description": "Permanently deletes an API project and all associated versions, generated SDKs, documentation, and mock server configurations." }, "response": [ { "id": "033de152-0911-48c0-bd21-1aa93a8df5c9", "name": "API project deleted successfully", "originalRequest": { "method": "DELETE", "header": [ { "description": "Added as a part of security scheme: apikey", "key": "x-sideko-key", "value": "" } ], "url": { "raw": "{{baseUrl}}/api-projects/:projectId", "host": [ "{{baseUrl}}" ], "path": [ "api-projects", ":projectId" ], "variable": [ { "key": "projectId" } ] } }, "status": "No Content", "code": 204, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T02:53:13.000Z", "updatedAt": "2026-07-28T02:53:13.000Z", "uid": "35240-033de152-0911-48c0-bd21-1aa93a8df5c9" }, { "id": "5d72601b-458f-4e9f-a262-d820ac7fe16f", "name": "Invalid or missing API key", "originalRequest": { "method": "DELETE", "header": [ { "description": "Added as a part of security scheme: apikey", "key": "x-sideko-key", "value": "" } ], "url": { "raw": "{{baseUrl}}/api-projects/:projectId", "host": [ "{{baseUrl}}" ], "path": [ "api-projects", ":projectId" ], "variable": [ { "key": "projectId" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T02:53:13.000Z", "updatedAt": "2026-07-28T02:53:13.000Z", "uid": "35240-5d72601b-458f-4e9f-a262-d820ac7fe16f" }, { "id": "664af9d1-eadd-4385-a3e6-bc7fde151d1c", "name": "API project not found", "originalRequest": { "method": "DELETE", "header": [ { "description": "Added as a part of security scheme: apikey", "key": "x-sideko-key", "value": "" } ], "url": { "raw": "{{baseUrl}}/api-projects/:projectId", "host": [ "{{baseUrl}}" ], "path": [ "api-projects", ":projectId" ], "variable": [ { "key": "projectId" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T02:53:13.000Z", "updatedAt": "2026-07-28T02:53:13.000Z", "uid": "35240-664af9d1-eadd-4385-a3e6-bc7fde151d1c" } ], "createdAt": "2026-07-28T02:53:13.000Z", "updatedAt": "2026-07-28T02:53:13.000Z", "uid": "35240-c5bef10e-fe90-471b-8349-9770655dfb73" } ], "id": "cf3ac19e-133f-4d57-beb4-16b728ff6301", "createdAt": "2026-07-28T02:53:12.000Z", "updatedAt": "2026-07-28T02:53:12.000Z", "uid": "35240-cf3ac19e-133f-4d57-beb4-16b728ff6301" }, { "name": "List API Projects", "id": "74751a66-657d-48a0-b0ab-4bbeecca6fdf", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api-projects?page=1&limit=20", "host": [ "{{baseUrl}}" ], "path": [ "api-projects" ], "query": [ { "description": "Page number for pagination", "key": "page", "value": "1" }, { "description": "Number of results per page", "key": "limit", "value": "20" } ] }, "description": "Returns a paginated list of all API projects in the authenticated organization. Each project contains one or more API versions defined by OpenAPI specifications." }, "response": [ { "id": "15b57a41-b7e2-4769-be29-1fc85af1b577", "name": "List of API projects 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?page=1&limit=20", "host": [ "{{baseUrl}}" ], "path": [ "api-projects" ], "query": [ { "description": "Page number for pagination", "key": "page", "value": "1" }, { "description": "Number of results per page", "key": "limit", "value": "20" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"items\": [\n {\n \"id\": \"\",\n \"name\": \"\",\n \"description\": \"\",\n \"slug\": \"\",\n \"versionCount\": \"\",\n \"createdAt\": \"\",\n \"updatedAt\": \"\"\n },\n {\n \"id\": \"\",\n \"name\": \"\",\n \"description\": \"\",\n \"slug\": \"\",\n \"versionCount\": \"\",\n \"createdAt\": \"\",\n \"updatedAt\": \"\"\n }\n ],\n \"total\": \"\",\n \"page\": \"\",\n \"limit\": \"\"\n}", "createdAt": "2026-07-28T02:53:13.000Z", "updatedAt": "2026-07-28T02:53:13.000Z", "uid": "35240-15b57a41-b7e2-4769-be29-1fc85af1b577" }, { "id": "a2798afe-1abd-412a-b072-32ff3ad77bcc", "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?page=1&limit=20", "host": [ "{{baseUrl}}" ], "path": [ "api-projects" ], "query": [ { "description": "Page number for pagination", "key": "page", "value": "1" }, { "description": "Number of results per page", "key": "limit", "value": "20" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T02:53:13.000Z", "updatedAt": "2026-07-28T02:53:13.000Z", "uid": "35240-a2798afe-1abd-412a-b072-32ff3ad77bcc" } ], "createdAt": "2026-07-28T02:53:13.000Z", "updatedAt": "2026-07-28T02:53:13.000Z", "uid": "35240-74751a66-657d-48a0-b0ab-4bbeecca6fdf" }, { "name": "Create API Project", "id": "8540fd7a-fd11-4ced-88b7-bb67cab4cbb1", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"description\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api-projects", "host": [ "{{baseUrl}}" ], "path": [ "api-projects" ] }, "description": "Creates a new API project in the authenticated organization. The project will hold OpenAPI specifications and serve as the container for generated SDKs, documentation, and mock servers." }, "response": [ { "id": "ddea8475-2dc7-4f40-bb8e-4d8ff99ee85f", "name": "API project created 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 \"name\": \"\",\n \"description\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api-projects", "host": [ "{{baseUrl}}" ], "path": [ "api-projects" ] } }, "status": "Created", "code": 201, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"id\": \"\",\n \"name\": \"\",\n \"description\": \"\",\n \"slug\": \"\",\n \"versionCount\": \"\",\n \"createdAt\": \"\",\n \"updatedAt\": \"\"\n}", "createdAt": "2026-07-28T02:53:13.000Z", "updatedAt": "2026-07-28T02:53:13.000Z", "uid": "35240-ddea8475-2dc7-4f40-bb8e-4d8ff99ee85f" }, { "id": "859c994a-126b-4595-b458-30adb2c929c9", "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 \"name\": \"\",\n \"description\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api-projects", "host": [ "{{baseUrl}}" ], "path": [ "api-projects" ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T02:53:13.000Z", "updatedAt": "2026-07-28T02:53:13.000Z", "uid": "35240-859c994a-126b-4595-b458-30adb2c929c9" }, { "id": "3c159390-2177-43a4-8c28-707a9dab4656", "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 \"name\": \"\",\n \"description\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api-projects", "host": [ "{{baseUrl}}" ], "path": [ "api-projects" ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T02:53:13.000Z", "updatedAt": "2026-07-28T02:53:13.000Z", "uid": "35240-3c159390-2177-43a4-8c28-707a9dab4656" }, { "id": "3e65530d-5a61-4243-ab48-4773e1d6017f", "name": "Project with this name already exists", "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 \"name\": \"\",\n \"description\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api-projects", "host": [ "{{baseUrl}}" ], "path": [ "api-projects" ] } }, "status": "Conflict", "code": 409, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T02:53:13.000Z", "updatedAt": "2026-07-28T02:53:13.000Z", "uid": "35240-3e65530d-5a61-4243-ab48-4773e1d6017f" } ], "createdAt": "2026-07-28T02:53:13.000Z", "updatedAt": "2026-07-28T02:53:13.000Z", "uid": "35240-8540fd7a-fd11-4ced-88b7-bb67cab4cbb1" } ], "id": "6cf8d09e-39e5-44ce-bc08-1c6c09af3731", "createdAt": "2026-07-28T02:53:12.000Z", "updatedAt": "2026-07-28T02:53:12.000Z", "uid": "35240-6cf8d09e-39e5-44ce-bc08-1c6c09af3731" } ], "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" } ] }