{ "item": [ { "id": "9c88fbc3-cfb5-4bcd-9f06-180fc2d568e3", "name": "Projects", "description": { "content": "Manage projects within an organisation. Projects contain environments and feature flags.", "type": "text/plain" }, "item": [ { "id": "efa9e41e-fe02-4be5-b88b-ac47a931a15b", "name": "List projects", "request": { "name": "List projects", "description": { "content": "Retrieves a list of all projects the authenticated user has access to across all organisations.", "type": "text/plain" }, "url": { "path": [ "projects", "" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": null }, "response": [ { "id": "1b4b8767-5e16-4c9e-bc19-9fd2c67f1d65", "name": "Successful response containing a list of projects", "originalRequest": { "url": { "path": [ "projects", "" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "[\n {\n \"id\": 1804,\n \"name\": \"string\",\n \"created_date\": \"1968-07-03T20:59:46.682Z\",\n \"organisation\": 9552,\n \"hide_disabled_flags\": false,\n \"enable_realtime_updates\": false\n },\n {\n \"id\": 2428,\n \"name\": \"string\",\n \"created_date\": \"2022-06-14T19:12:12.502Z\",\n \"organisation\": 7136,\n \"hide_disabled_flags\": false,\n \"enable_realtime_updates\": false\n }\n]", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f956da05-5cdc-4d19-bd52-0255ffa71ff4", "name": "Unauthorized - invalid or missing API token", "originalRequest": { "url": { "path": [ "projects", "" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "text/plain" } ], "body": "", "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "b87981ee-8ae4-4df5-baca-a6d50a9116a8", "name": "Create a project", "request": { "name": "Create a project", "description": { "content": "Creates a new project within an organisation. Projects are containers for environments and feature flags.", "type": "text/plain" }, "url": { "path": [ "projects", "" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": null, "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"organisation\": \"\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "e2f15459-e6ba-4224-a847-10af8c4fc1e0", "name": "Project created successfully", "originalRequest": { "url": { "path": [ "projects", "" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"organisation\": \"\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"id\": 6665,\n \"name\": \"string\",\n \"created_date\": \"2015-06-25T11:41:06.006Z\",\n \"organisation\": 3070,\n \"hide_disabled_flags\": false,\n \"enable_realtime_updates\": false\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "410743bf-b47c-40a4-9b7d-8d3d64c323df", "name": "Bad request - validation error", "originalRequest": { "url": { "path": [ "projects", "" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"organisation\": \"\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "text/plain" } ], "body": "", "cookie": [], "_postman_previewlanguage": "text" }, { "id": "076cb11f-0da2-451b-9e60-a3b880d05a3b", "name": "Unauthorized - invalid or missing API token", "originalRequest": { "url": { "path": [ "projects", "" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"organisation\": \"\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "text/plain" } ], "body": "", "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "71700cd4-0496-4376-a0c8-17ca812a5593", "name": "Get a project", "request": { "name": "Get a project", "description": { "content": "Retrieves the details of a specific project by its ID, including its name, organisation, and associated environments.", "type": "text/plain" }, "url": { "path": [ "projects", ":project_id", "" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "project_id", "description": "(Required) The unique identifier for the project" } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": null }, "response": [ { "id": "5cf2fbde-96dd-4e3c-8e31-7fedc6b87e52", "name": "Successful response containing the project details", "originalRequest": { "url": { "path": [ "projects", ":project_id", "" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "project_id", "description": "(Required) The unique identifier for the project" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"id\": 6665,\n \"name\": \"string\",\n \"created_date\": \"2015-06-25T11:41:06.006Z\",\n \"organisation\": 3070,\n \"hide_disabled_flags\": false,\n \"enable_realtime_updates\": false\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2b1b9326-185d-46c2-b918-e7d51ed9814e", "name": "Unauthorized - invalid or missing API token", "originalRequest": { "url": { "path": [ "projects", ":project_id", "" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "project_id", "description": "(Required) The unique identifier for the project" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "text/plain" } ], "body": "", "cookie": [], "_postman_previewlanguage": "text" }, { "id": "85cca303-1877-4f46-a9a0-13a9f61d4ec7", "name": "Project not found", "originalRequest": { "url": { "path": [ "projects", ":project_id", "" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "project_id", "description": "(Required) The unique identifier for the project" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "text/plain" } ], "body": "", "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "db1b8e90-75aa-4782-a32c-e0fe75c4e16d", "name": "Update a project", "request": { "name": "Update a project", "description": { "content": "Updates the details of an existing project. Allows modification of the project name and other configurable properties.", "type": "text/plain" }, "url": { "path": [ "projects", ":project_id", "" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "project_id", "description": "(Required) The unique identifier for the project" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "auth": null, "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"organisation\": \"\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "9c20cddd-9f7d-4f00-ac91-ce1b204f22ab", "name": "Project updated successfully", "originalRequest": { "url": { "path": [ "projects", ":project_id", "" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "project_id", "description": "(Required) The unique identifier for the project" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"organisation\": \"\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"id\": 6665,\n \"name\": \"string\",\n \"created_date\": \"2015-06-25T11:41:06.006Z\",\n \"organisation\": 3070,\n \"hide_disabled_flags\": false,\n \"enable_realtime_updates\": false\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c0779989-d6b6-43d4-b2d0-1bd58ee39150", "name": "Bad request - validation error", "originalRequest": { "url": { "path": [ "projects", ":project_id", "" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "project_id", "description": "(Required) The unique identifier for the project" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"organisation\": \"\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "text/plain" } ], "body": "", "cookie": [], "_postman_previewlanguage": "text" }, { "id": "a9c7ed1b-d9a1-4ed7-82ec-ca8feb272ffd", "name": "Unauthorized - invalid or missing API token", "originalRequest": { "url": { "path": [ "projects", ":project_id", "" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "project_id", "description": "(Required) The unique identifier for the project" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"organisation\": \"\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "text/plain" } ], "body": "", "cookie": [], "_postman_previewlanguage": "text" }, { "id": "d11098d0-7df5-42f5-9d59-c3463d3d5b37", "name": "Project not found", "originalRequest": { "url": { "path": [ "projects", ":project_id", "" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "project_id", "description": "(Required) The unique identifier for the project" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"organisation\": \"\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "text/plain" } ], "body": "", "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "5d4b2046-9d69-4c39-9495-09963ae4c95f", "name": "Delete a project", "request": { "name": "Delete a project", "description": { "content": "Permanently deletes a project and all associated environments, feature flags, and data. This action cannot be undone.", "type": "text/plain" }, "url": { "path": [ "projects", ":project_id", "" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "project_id", "description": "(Required) The unique identifier for the project" } ] }, "method": "DELETE", "auth": null }, "response": [ { "id": "deea9866-8d54-4664-aa0c-354bff532cc2", "name": "Project deleted successfully", "originalRequest": { "url": { "path": [ "projects", ":project_id", "" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "project_id", "description": "(Required) The unique identifier for the project" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "DELETE", "body": {} }, "status": "No Content", "code": 204, "header": [ { "key": "Content-Type", "value": "text/plain" } ], "body": "", "cookie": [], "_postman_previewlanguage": "text" }, { "id": "b636f768-2227-444e-97f5-84bc07d09b7e", "name": "Unauthorized - invalid or missing API token", "originalRequest": { "url": { "path": [ "projects", ":project_id", "" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "project_id", "description": "(Required) The unique identifier for the project" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "text/plain" } ], "body": "", "cookie": [], "_postman_previewlanguage": "text" }, { "id": "680aaff1-80c4-42e1-b394-0772e9e2851f", "name": "Project not found", "originalRequest": { "url": { "path": [ "projects", ":project_id", "" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "project_id", "description": "(Required) The unique identifier for the project" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "text/plain" } ], "body": "", "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "event": [] } ], "event": [], "variable": [ { "type": "string", "value": "https://api.flagsmith.com/api/v1", "key": "baseUrl" } ], "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] }, "info": { "_postman_id": "76472bfe-88b4-4cd1-851b-97599c3fa95b", "name": "Flagsmith Admin Environments Projects API", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "description": { "content": "The Flagsmith Admin API allows developers to programmatically manage all aspects of their Flagsmith projects. Anything that can be done through the Flagsmith dashboard can also be accomplished via this API, including creating, updating, and deleting projects, environments, feature flags, segments, and users. It uses a secret Organisation API Token for authentication and provides a Swagger interface at api.flagsmith.com/api/v1/docs for interactive exploration.\n\nContact Support:\n Name: Flagsmith Support", "type": "text/plain" } } }