Bearer token authentication used by the Versori Platform. External consumers must provide an API key, however
internal consumers must provide a JWT id_token issued by our IdP.
{"docsConfig":{"theme":"almond","$schema":"https://mintlify.com/docs.json","name":"Versori User Documentation","colors":{"primary":"#6EB0D8","light":"#6EB0D8","dark":"#6EB0D8"},"logo":{"light":"https://mintcdn.com/versori/PWNCaMS5nGiiWoff/logo/versori-logo-wordmark.svg?fit=max\u0026auto=format\u0026n=PWNCaMS5nGiiWoff\u0026q=85\u0026s=be10819ca139d000a6edaef35334c0af","dark":"https://mintcdn.com/versori/PWNCaMS5nGiiWoff/logo/versori-logo-wordmark-white.svg?fit=max\u0026auto=format\u0026n=PWNCaMS5nGiiWoff\u0026q=85\u0026s=1568a99dadb6fa8dfc83009eba877497"},"favicon":"https://mintcdn.com/versori/PWNCaMS5nGiiWoff/logo/versori-logo.svg?fit=max\u0026auto=format\u0026n=PWNCaMS5nGiiWoff\u0026q=85\u0026s=1765cb3e4363526dd85cf7c576a8f68f","api":{"openapi":["openapi/connect-api-v1.yaml","openapi/embedded-api-v1.yaml","openapi/organisations-api-v1.yaml","openapi/switchboard-api-v1alpha1.yaml","openapi/platform-api.yaml"],"playground":{"display":"interactive","proxy":false},"mdx":{"auth":{"method":"bearer","name":"Authorization"},"server":["https://platform.versori.com/api"]}},"background":{"decoration":"gradient","color":{"light":"#ffffff","dark":"#151919"}},"search":{"prompt":"Search the docs..."},"interaction":{"drilldown":false},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"versori","hasAudioNarration":false,"actualSubdomain":"versori","customDomains":["docs.versori.com"],"gitSource":{"type":"github","owner":"versori","repo":"user-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ad09d9413e5d952c6a7407c","collectionId":"314b2d25-0631-41c2-aeae-fdf8104d942c","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ad09d9413e5d952c6a7407c"},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ad09d9413e5d952c6a7407c","clientVersion":"0.0.3965","searchFilterCounts":[{"language":"default","tag":"API Reference","count":525},{"language":"default","tag":"Platform API","count":115},{"language":"default","tag":"Switchboard API","count":82},{"language":"default","tag":"Endpoints","count":62},{"language":"default","tag":"Connect API","count":41},{"language":"default","tag":"Organisations API","count":38},{"language":"default","tag":"Documentation","count":32},{"language":"default","tag":"projects","count":32},{"language":"default","tag":"User Guide","count":31},{"language":"default","tag":"CLI","count":27}]},"assistantConfig":{},"hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-v7-file-tree","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-nav-generations","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"isAtlas":false,"googleFontsInlined":true},"customCss":[{"filePath":"style.css","content":"#content-area.max-w-xl{max-width:64rem}.whitespace-pre-line{white-space:unset}"}],"page":{"pagePath":"v2/api-reference/projects/list-projects-for-organisation","slug":"/v2/api-reference/projects/list-projects-for-organisation","pageMetadata":{"openapi":"get /o/{organisation_id}/projects","title":"List projects for organisation","description":null,"href":"/v2/api-reference/projects/list-projects-for-organisation"},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"openapi":"get /o/{organisation_id}/projects","title":"List projects for organisation","description":null,"href":"/v2/api-reference/projects/list-projects-for-organisation"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"ListProjects","summary":"List projects for organisation","tags":["projects"],"responses":{"200":"5441b3f6-0d70-4aba-bf20-b7a37e62a66e","default":"068127c3-cd0c-497c-8e9b-d1199a3fa338"},"method":"get","type":"path","servers":["d0eac863-e307-4ad7-a239-2c447e8ba4c0","0bedeed1-5e05-4d49-a0f1-0acdda0da1fe","731967af-8899-446e-b2cf-c9e6c5801b84"],"security":["ad977c79-c846-4804-9548-4d09cb6f8f14","b1012d3e-47bf-44f7-b929-7fdf4592103d"],"path":"/o/{organisation_id}/projects","baseUrlOptions":["https://platform.versori.com/api/v2","https://platform-staging.versori.com/api/v2","http://localhost:8901"],"title":"List projects for organisation","description":"","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated","disableProxy":true},"dependencies":{"parameters":{"d0c41ee3-aa37-40e3-b2a0-f8b57fcf8911":{"name":"organisation_id","in":"path","required":true,"schema":{"type":"string","format":"ulid","x-go-type":"ulid.ULID","x-go-name":"OrganisationID","x-go-type-import":{"path":"versori.dev/vergo/ulid"},"isRequired":true,"uniqueKey":"","typeLabel":"string\u003culid>"}}},"responses":{"5441b3f6-0d70-4aba-bf20-b7a37e62a66e":{"description":"OK","content":{"application/json":{"schema":{"description":"ProjectsList is the response body for listing all projects.","type":"object","properties":{"projects":{"type":"array","items":{"description":"The Project represents a deployable unit within our platform that includes both the functional components (files) and configuration. It serves as the backbone of custom or predefined functionalities, allowing organizations to create, update, and manage APIs and projects.\n","type":"object","properties":{"id":{"type":"string","description":"The unique identifier for the project.","format":"ulid","x-go-name":"ID","x-go-type":"ulid.ULID","x-go-type-import":{"path":"versori.dev/vergo/ulid"},"isRequired":true,"uniqueKey":"projects.items.[INDEX].id","typeLabel":"string\u003culid>"},"name":{"type":"string","isRequired":true,"uniqueKey":"projects.items.[INDEX].name","typeLabel":"string"},"createdAt":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"projects.items.[INDEX].createdAt","typeLabel":"string\u003cdate-time>"},"updatedAt":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"projects.items.[INDEX].updatedAt","typeLabel":"string\u003cdate-time>"},"environments":{"type":"array","description":"List of environments for the project.\n","items":{"type":"object","properties":{"id":{"type":"string","description":"The unique identifier for the environment.","format":"ulid","x-go-name":"ID","x-go-type":"ulid.ULID","x-go-type-import":{"path":"versori.dev/vergo/ulid"},"isRequired":true,"uniqueKey":"projects.items.[INDEX].environments.items.[INDEX].id","typeLabel":"string\u003culid>"},"name":{"type":"string","isRequired":true,"uniqueKey":"projects.items.[INDEX].environments.items.[INDEX].name","typeLabel":"string"},"status":{"type":"string","description":"One of running|suspended|error|draft.","isRequired":true,"uniqueKey":"projects.items.[INDEX].environments.items.[INDEX].status","typeLabel":"string"},"createdAt":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"projects.items.[INDEX].environments.items.[INDEX].createdAt","typeLabel":"string\u003cdate-time>"},"updatedAt":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"projects.items.[INDEX].environments.items.[INDEX].updatedAt","typeLabel":"string\u003cdate-time>"},"publicUrl":{"type":"string","isRequired":true,"uniqueKey":"projects.items.[INDEX].environments.items.[INDEX].publicUrl","typeLabel":"string"},"config":{"type":"object","properties":{"deploymentSpec":{"type":"object","properties":{"replicas":{"type":"integer","uniqueKey":"projects.items.[INDEX].environments.items.[INDEX].config.deploymentSpec.replicas","typeLabel":"integer"},"autoscaling":{"type":"object","properties":{"maxReplicas":{"type":"integer","description":"The maximum number of replicas that can be created for this environment. When this is configured autoscaling will be enabled for the environment.","uniqueKey":"projects.items.[INDEX].environments.items.[INDEX].config.deploymentSpec.autoscaling.maxReplicas","typeLabel":"integer"}},"x-go-type-skip-optional-pointer":true,"uniqueKey":"projects.items.[INDEX].environments.items.[INDEX].config.deploymentSpec.autoscaling","typeLabel":"object"},"staticIP":{"type":"boolean","description":"If set to true it will configure the environment to use the static IP for the execution pool selected by the environment.\n","uniqueKey":"projects.items.[INDEX].environments.items.[INDEX].config.deploymentSpec.staticIP","typeLabel":"boolean"},"resources":{"type":"object","properties":{"limits":{"type":"object","properties":{"cpu":{"type":"string","uniqueKey":"projects.items.[INDEX].environments.items.[INDEX].config.deploymentSpec.resources.limits.cpu","typeLabel":"string"},"memory":{"type":"string","uniqueKey":"projects.items.[INDEX].environments.items.[INDEX].config.deploymentSpec.resources.limits.memory","typeLabel":"string"}},"uniqueKey":"projects.items.[INDEX].environments.items.[INDEX].config.deploymentSpec.resources.limits","typeLabel":"object"},"requests":{"type":"object","properties":{"cpu":{"type":"string","uniqueKey":"projects.items.[INDEX].environments.items.[INDEX].config.deploymentSpec.resources.requests.cpu","typeLabel":"string"},"memory":{"type":"string","uniqueKey":"projects.items.[INDEX].environments.items.[INDEX].config.deploymentSpec.resources.requests.memory","typeLabel":"string"}},"uniqueKey":"projects.items.[INDEX].environments.items.[INDEX].config.deploymentSpec.resources.requests","typeLabel":"object"}},"uniqueKey":"projects.items.[INDEX].environments.items.[INDEX].config.deploymentSpec.resources","typeLabel":"object"},"serviceAccountName":{"type":"string","uniqueKey":"projects.items.[INDEX].environments.items.[INDEX].config.deploymentSpec.serviceAccountName","typeLabel":"string"}},"uniqueKey":"projects.items.[INDEX].environments.items.[INDEX].config.deploymentSpec","typeLabel":"object"}},"isRequired":true,"uniqueKey":"projects.items.[INDEX].environments.items.[INDEX].config","typeLabel":"object"},"executionPool":{"type":"string","description":"The name of the execution pool used to deploy this environment.","x-go-type-skip-optional-pointer":true,"uniqueKey":"projects.items.[INDEX].environments.items.[INDEX].executionPool","typeLabel":"string"},"files":{"type":"array","description":"The currently deployed files for the environment.","items":{"type":"object","properties":{"filename":{"type":"string","description":"The name of the file.","isRequired":true,"uniqueKey":"projects.items.[INDEX].environments.items.[INDEX].files.items.[INDEX].filename","typeLabel":"string"},"content":{"type":"string","description":"The content of the file.","isRequired":true,"uniqueKey":"projects.items.[INDEX].environments.items.[INDEX].files.items.[INDEX].content","typeLabel":"string"}},"required":["filename","content"],"uniqueKey":"projects.items.[INDEX].environments.items.[INDEX].files.items.[INDEX]","typeLabel":"object"},"x-go-type-skip-optional-pointer":true,"uniqueKey":"projects.items.[INDEX].environments.items.[INDEX].files","typeLabel":"object[]"},"labels":{"type":"object","description":"Labels is a map of key-value pairs that can be used to store arbitrary metadata about a resource.\nKeys must start with a letter and can only contain letters, numbers, and underscores.\nValues can be any string.\n","x-go-type":"map[string]string","x-go-type-skip-optional-pointer":true,"uniqueKey":"projects.items.[INDEX].environments.items.[INDEX].labels","typeLabel":"object"},"deployedVersion":{"type":"object","properties":{"id":{"type":"string","description":"The unique identifier for the version.","format":"ulid","x-go-name":"ID","x-go-type":"ulid.ULID","x-go-type-skip-optional-pointer":true,"x-go-type-import":{"path":"versori.dev/vergo/ulid"},"isRequired":true,"uniqueKey":"projects.items.[INDEX].environments.items.[INDEX].deployedVersion.id","typeLabel":"string\u003culid>"},"name":{"type":"string","x-go-type-skip-optional-pointer":true,"description":"The short name for this version. This name must be unique within this project.\n","isRequired":true,"uniqueKey":"projects.items.[INDEX].environments.items.[INDEX].deployedVersion.name","typeLabel":"string"},"state":{"type":"string","description":"The state of the version.","enum":["draft","failed","ready","superseded"],"isRequired":true,"uniqueKey":"projects.items.[INDEX].environments.items.[INDEX].deployedVersion.state","typeLabel":"enum\u003cstring>"},"createdAt":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"projects.items.[INDEX].environments.items.[INDEX].deployedVersion.createdAt","typeLabel":"string\u003cdate-time>"},"description":{"type":"string","x-go-type-skip-optional-pointer":true,"description":"The description of this version.\n","uniqueKey":"projects.items.[INDEX].environments.items.[INDEX].deployedVersion.description","typeLabel":"string"},"labels":{"type":"object","x-go-type-skip-optional-pointer":true,"x-go-type":"map[string]string","description":"Key-value pairs of strings.\n","uniqueKey":"projects.items.[INDEX].environments.items.[INDEX].deployedVersion.labels","typeLabel":"object"}},"required":["id","name","state","createdAt"],"uniqueKey":"projects.items.[INDEX].environments.items.[INDEX].deployedVersion","typeLabel":"object"}},"required":["id","name","status","createdAt","updatedAt","publicUrl","lastDeployedAt","config"],"uniqueKey":"projects.items.[INDEX].environments.items.[INDEX]","typeLabel":"object"},"x-go-type-skip-optional-pointer":true,"isRequired":true,"uniqueKey":"projects.items.[INDEX].environments","typeLabel":"object[]"}},"required":["id","name","createdAt","updatedAt","environments"],"uniqueKey":"projects.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"projects","typeLabel":"object[]"}},"required":["projects"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"projects":[{"id":"\u003cstring>","name":"\u003cstring>","createdAt":"2023-11-07T05:31:56Z","updatedAt":"2023-11-07T05:31:56Z","environments":[{"id":"\u003cstring>","name":"\u003cstring>","status":"\u003cstring>","createdAt":"2023-11-07T05:31:56Z","updatedAt":"2023-11-07T05:31:56Z","publicUrl":"\u003cstring>","config":{"deploymentSpec":{"replicas":123,"autoscaling":{"maxReplicas":123},"staticIP":true,"resources":{"limits":{"cpu":"\u003cstring>","memory":"\u003cstring>"},"requests":{"cpu":"\u003cstring>","memory":"\u003cstring>"}},"serviceAccountName":"\u003cstring>"}},"executionPool":"\u003cstring>","files":[{"filename":"\u003cstring>","content":"\u003cstring>"}],"labels":{},"deployedVersion":{"id":"\u003cstring>","name":"\u003cstring>","state":"draft","createdAt":"2023-11-07T05:31:56Z","description":"\u003cstring>","labels":{}}}]}]}}},"exampleType":"generated"}},"exampleType":"generated"},"068127c3-cd0c-497c-8e9b-d1199a3fa338":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"Code is a machine-readable error code.","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"message":{"type":"string","description":"Message is a human-readable error message.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"fields":{"type":"array","items":{"description":"ErrorField denotes a field which has an error.","type":"object","properties":{"field":{"type":"string","description":"Field is the name of the field which has an error, this may be a path to a nested field, including array\nelements. The format of this field is of the form: \"field1.field2[0].field3\"\n","isRequired":true,"uniqueKey":"fields.items.[INDEX].field","typeLabel":"string"},"message":{"type":"string","description":"Message is the error message for this specific field.","isRequired":true,"uniqueKey":"fields.items.[INDEX].message","typeLabel":"string"}},"required":["field","message"],"uniqueKey":"fields.items.[INDEX]","typeLabel":"object"},"x-go-type-skip-optional-pointer":true,"uniqueKey":"fields","typeLabel":"object[]"},"details":{"type":"string","x-go-type-skip-optional-pointer":true,"uniqueKey":"details","typeLabel":"string"}},"required":["code","message"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"\u003cstring>","message":"\u003cstring>","fields":[{"field":"\u003cstring>","message":"\u003cstring>"}],"details":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"ad977c79-c846-4804-9548-4d09cb6f8f14":{"bearerToken":{"description":"Bearer token authentication used by the Versori Platform. External consumers must provide an API key, however\ninternal consumers must provide a JWT id_token issued by our IdP.\n","type":"http","scheme":"bearer","scopes":[]}},"b1012d3e-47bf-44f7-b929-7fdf4592103d":{"cookie":{"description":"Cookie authentication used by the Versori Platform.","type":"apiKey","in":"cookie","name":"cookie","scopes":[]}}},"servers":{"d0eac863-e307-4ad7-a239-2c447e8ba4c0":{"description":"Production","url":"https://platform.versori.com/api/v2"},"0bedeed1-5e05-4d49-a0f1-0acdda0da1fe":{"description":"Staging","url":"https://platform-staging.versori.com/api/v2"},"731967af-8899-446e-b2cf-c9e6c5801b84":{"description":"Development","url":"http://localhost:8901"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"description":"Bearer token authentication used by the Versori Platform. External consumers must provide an API key, however\ninternal consumers must provide a JWT id_token issued by our IdP.\n","type":"http","scheme":"bearer","scopes":[]},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer token authentication used by the Versori Platform. External consumers must provide an API key, however\ninternal consumers must provide a JWT id_token issued by our IdP.\n","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerToken","name":"Authorization"}],"title":"bearerToken"},{"schemes":[{"scheme":{"description":"Cookie authentication used by the Versori Platform.","type":"apiKey","in":"cookie","name":"cookie","scopes":[]},"schema":{"title":"cookie","type":"string","description":"Cookie authentication used by the Versori Platform.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"cookie","name":"cookie"}],"title":"cookie"}]},"originalFileLocation":"openapi/platform-api.yaml"},"subdomain":"versori","siteName":"Versori User Documentation","title":"List projects for organisation - Versori User Documentation","navMaps":{"firstHrefInVersion":{"Latest":{"href":"/latest/home","matchLevel":4},"Legacy":{"href":"/legacy/welcome","matchLevel":4},"v2":{"href":"/v2/api-reference/projects/list-projects-for-organisation","matchLevel":0}},"firstHrefInLanguage":{}},"lastModified":"2026-10-14T11:02:54.627Z","originalFileLocation":"v2/api-reference/projects/list-projects-for-organisation.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"application-name\" content=\"Versori User Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/versori/JHvcKEOb4limbJz2/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/versori/JHvcKEOb4limbJz2/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/versori/JHvcKEOb4limbJz2/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/versori/JHvcKEOb4limbJz2/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/versori/JHvcKEOb4limbJz2/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/versori/JHvcKEOb4limbJz2/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/versori/JHvcKEOb4limbJz2/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/versori/JHvcKEOb4limbJz2/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/versori/JHvcKEOb4limbJz2/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"List projects for organisation - Versori User Documentation\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Versori User Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.versori.com/v2/api-reference/projects/list-projects-for-organisation\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://versori.mintlify.app/_mintlify/api/og/v2?division=Projects\u0026amp;title=List+projects+for+organisation\u0026amp;theme=1ac70f2532992ffb34bd6aef\u0026amp;signature=8eac919491c71bc1213bcef7fe065c5034af19bd4b50e64189af52ce924ae33a\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"List projects for organisation - Versori User Documentation\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://versori.mintlify.app/_mintlify/api/og/v2?division=Projects\u0026amp;title=List+projects+for+organisation\u0026amp;theme=1ac70f2532992ffb34bd6aef\u0026amp;signature=8eac919491c71bc1213bcef7fe065c5034af19bd4b50e64189af52ce924ae33a\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/versori/JHvcKEOb4limbJz2/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Versori User Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#6EB0D8\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.versori.com/v2/api-reference/projects/list-projects-for-organisation\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/v2/api-reference/projects/list-projects-for-organisation.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.versori.com/#organization\",\"name\":\"Versori User Documentation\",\"url\":\"https://docs.versori.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/versori/PWNCaMS5nGiiWoff/logo/versori-logo-wordmark.svg?fit=max\u0026auto=format\u0026n=PWNCaMS5nGiiWoff\u0026q=85\u0026s=be10819ca139d000a6edaef35334c0af\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.versori.com#website\",\"name\":\"Versori User Documentation\",\"url\":\"https://docs.versori.com\",\"publisher\":{\"@id\":\"https://docs.versori.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.versori.com/v2/api-reference/projects/list-projects-for-organisation#webpage\",\"url\":\"https://docs.versori.com/v2/api-reference/projects/list-projects-for-organisation\",\"name\":\"List projects for organisation\",\"dateModified\":\"2026-10-14T11:02:54.627Z\",\"isPartOf\":{\"@id\":\"https://docs.versori.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.versori.com/v2/api-reference/projects/list-projects-for-organisation#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.versori.com/v2/api-reference/projects/list-projects-for-organisation#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Projects\",\"item\":\"https://docs.versori.com/v2/api-reference/projects/activates-a-user-on-an-environment\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"List projects for organisation\",\"item\":\"https://docs.versori.com/v2/api-reference/projects/list-projects-for-organisation\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.versori.com/v2/api-reference/projects/list-projects-for-organisation#apireference\",\"headline\":\"List projects for organisation\",\"name\":\"List projects for organisation\",\"url\":\"https://docs.versori.com/v2/api-reference/projects/list-projects-for-organisation\",\"mainEntityOfPage\":{\"@id\":\"https://docs.versori.com/v2/api-reference/projects/list-projects-for-organisation#webpage\"},\"dateModified\":\"2026-10-14T11:02:54.627Z\",\"publisher\":{\"@id\":\"https://docs.versori.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.versori.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Versori User Documentation\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Versori User Documentation","nav":{"global":null,"versions":[{"version":"Latest","pages":[{"title":"Latest","href":"/latest/home"}]},{"version":"Legacy","pages":[{"title":"Legacy","href":"/legacy/welcome"}]},{"version":"v2","anchors":[{"anchor":"Documentation","icon":"book-open","pages":[{"title":"Documentation","href":"/v2/introduction"}]},{"anchor":"API Reference","icon":"terminal","groups":[{"group":"Activations","pages":[{"openapi":"delete /o/{organisation_id}/environments/{environment_id}/activations/{activation_id}","title":"Delete an Activation","href":"/v2/api-reference/activations/delete-an-activation"},{"openapi":"get /o/{organisation_id}/environment/{environment_id}/users/{external_user_id}/activations","title":"List Activations for User","href":"/v2/api-reference/activations/list-activations-for-user"},{"openapi":"get /o/{organisation_id}/environments/{environment_id}/activations","title":"List Activations","href":"/v2/api-reference/activations/list-activations"},{"openapi":"get /o/{organisation_id}/environments/{environment_id}/activations/{activation_id}","title":"Retrieve an Activation by ID","href":"/v2/api-reference/activations/retrieve-an-activation-by-id"},{"openapi":"put /o/{organisation_id}/environments/{environment_id}/activations/{activation_id}/variables/{variable_name}","title":"Set a dynamic variable by name","href":"/v2/api-reference/activations/set-a-dynamic-variable-by-name"},{"openapi":"patch /o/{organisation_id}/environments/{environment_id}/activations/{activation_id}/variables","title":"Set dynamic variables for an activation","href":"/v2/api-reference/activations/set-dynamic-variables-for-an-activation"},{"openapi":"patch /o/{organisation_id}/environments/{environment_id}/variables","title":"Set static variables for the static activation","href":"/v2/api-reference/activations/set-static-variables-for-the-static-activation"}]},{"group":"Connections","pages":[{"openapi":"post /o/{organisation_id}/connections","title":"Create a new connection.","href":"/v2/api-reference/connections/create-a-new-connection"},{"openapi":"get /o/{organisation_id}/connections/{connection_id}","title":"Get a Connection by ID","href":"/v2/api-reference/connections/get-a-connection-by-id"},{"openapi":"post /o/{organisation_id}/systems/{system_id}/oauth2/initialise","title":"Initialise OAuth 2.0 Connection","href":"/v2/api-reference/connections/initialise-oauth-20-connection"},{"openapi":"post /o/{organisation_id}/connections/{connection_id}/link","title":"Link an existing connection to an environment","href":"/v2/api-reference/connections/link-an-existing-connection-to-an-environment"},{"openapi":"get /o/{organisation_id}/connections","title":"List Connections","href":"/v2/api-reference/connections/list-connections"},{"openapi":"get /o/{organisation_id}/projects/{project_id}/connections","title":"List static connections for project environment","href":"/v2/api-reference/connections/list-static-connections-for-project-environment"},{"openapi":"get /o/{organisation_id}/environment-systems/{env_system_id}/activations/{activation_id}","title":"Retrieve the connection for the activations.","href":"/v2/api-reference/connections/retrieve-the-connection-for-the-activations"},{"openapi":"put /o/{organisation_id}/connections/{connection_id}","title":"Update a Connection by ID","href":"/v2/api-reference/connections/update-a-connection-by-id"}]},{"group":"End Users","pages":[{"openapi":"post /o/{organisation_id}/users","title":"Create an End User","href":"/v2/api-reference/end_users/create-an-end-user"},{"openapi":"delete /o/{organisation_id}/users/{user_id}","title":"Delete an End User","href":"/v2/api-reference/end_users/delete-an-end-user"},{"openapi":"get /o/{organisation_id}/users","title":"List End Users","href":"/v2/api-reference/end_users/list-end-users"},{"openapi":"get /o/{organisation_id}/users/{user_id}","title":"Retrieve an End User","href":"/v2/api-reference/end_users/retrieve-an-end-user"}]},{"group":"Projects","pages":[{"openapi":"post /o/{organisation_id}/activations","title":"Activates a User on an Environment.","href":"/v2/api-reference/projects/activates-a-user-on-an-environment"},{"openapi":"post /o/{organisation_id}/projects","title":"Create new project","href":"/v2/api-reference/projects/create-new-project"},{"openapi":"delete /o/{organisation_id}/projects/{project_id}","title":"Delete Project","href":"/v2/api-reference/projects/delete-project"},{"openapi":"put /o/{organisation_id}/projects/{project_id}/deploy","title":"Deploy Project","href":"/v2/api-reference/projects/deploy-project"},{"openapi":"get /o/{organisation_id}/projects/{project_id}/files","title":"Get Files","href":"/v2/api-reference/projects/get-files"},{"openapi":"get /o/{organisation_id}/projects/{project_id}/logs","title":"Get Project Logs","href":"/v2/api-reference/projects/get-project-logs"},{"openapi":"get /o/{organisation_id}/projects/{project_id}","title":"Get Project","href":"/v2/api-reference/projects/get-project"},{"openapi":"get /o/{organisation_id}/projects/{project_id}/traces/{trace_id}","title":"Get Trace","href":"/v2/api-reference/projects/get-trace"},{"openapi":"get /o/{organisation_id}/projects/{project_id}/traces","title":"List project traces","description":"ListTraces returns a list of traces for the given organisation.\n","href":"/v2/api-reference/projects/list-project-traces"},{"openapi":"get /o/{organisation_id}/projects","title":"List projects for organisation","href":"/v2/api-reference/projects/list-projects-for-organisation"},{"openapi":"patch /o/{organisation_id}/projects/{project_id}/variables","title":"Patch the schema for the project's dynamic variables","description":"PatchProjectVariablesSchema patches the JSON schema for the project's dynamic variables. This allows you to add,\nremove or edit the schema for the project's dynamic variables.\n","href":"/v2/api-reference/projects/patch-the-schema-for-the-projects-dynamic-variables"},{"openapi":"put /o/{organisation_id}/projects/{project_id}/variables","title":"Set the schema for the project variables","href":"/v2/api-reference/projects/set-the-schema-for-the-project-variables"},{"openapi":"post /o/{organisation_id}/projects/{project_id}/suspend","title":"Suspend Project","href":"/v2/api-reference/projects/suspend-project"},{"openapi":"put /o/{organisation_id}/projects/{project_id}/files","title":"Update Files","href":"/v2/api-reference/projects/update-files"},{"openapi":"put /o/{organisation_id}/projects/{project_id}","title":"Update Project","href":"/v2/api-reference/projects/update-project"}]},{"group":"Systems","pages":[{"openapi":"post /o/{organisation_id}/projects/{project_id}/systems","title":null,"href":"/v2/api-reference/systems/add-a-system-to-a-project-environment"},{"openapi":"put /o/{organisation_id}/systems/{system_id}/auth-scheme-configs/{auth_scheme_config_id}","title":"Adds or updates an auth scheme for the system.","href":"/v2/api-reference/systems/adds-or-updates-an-auth-scheme-for-the-system"},{"openapi":"post /o/{organisation_id}/projects/{project_id}/connection-templates","title":"Create a new connection template","href":"/v2/api-reference/systems/create-a-new-connection-template"},{"openapi":"post /o/{organisation_id}/systems","title":"Create a new system.","href":"/v2/api-reference/systems/create-a-new-system"},{"openapi":"delete /o/{organisation_id}/systems/{system_id}/auth-scheme-configs/{auth_scheme_config_id}","title":"Deletes an auth scheme for the system.","href":"/v2/api-reference/systems/deletes-an-auth-scheme-for-the-system"},{"openapi":"get /o/{organisation_id}/projects/{project_id}/connection-templates","title":"List project environment connection templates","href":"/v2/api-reference/systems/list-project-environment-connection-templates"},{"openapi":"get /o/{organisation_id}/projects/{project_id}/systems","title":null,"href":"/v2/api-reference/systems/list-the-systems-linked-to-the-project-environment"},{"openapi":"get /o/{organisation_id}/systems","title":"Lists the systems for the organisation.","href":"/v2/api-reference/systems/lists-the-systems-for-the-organisation"},{"openapi":"delete /o/{organisation_id}/projects/{project_id}/connection-templates/{template_id}","title":"Remove a connection template","href":"/v2/api-reference/systems/remove-a-connection-template"},{"openapi":"put /o/{organisation_id}/projects/{project_id}/connection-templates/{template_id}","title":"Remove a system from a project environment","href":"/v2/api-reference/systems/remove-a-system-from-a-project-environment-1"},{"openapi":"delete /o/{organisation_id}/projects/{project_id}/systems","title":null,"href":"/v2/api-reference/systems/remove-a-system-from-a-project-environment"},{"openapi":"put /o/{organisation_id}/systems/{system_id}","title":"Update system.","href":"/v2/api-reference/systems/update-system"}]}]}]}]},"title":"List projects for organisation - Versori User Documentation","buildId":"dpl_849ArpqvBiCczQiT1Y1stNGpbqHT","deploymentId":"dpl_849ArpqvBiCczQiT1Y1stNGpbqHT","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-Bbp7I60D.js","utils-C3RIvJha.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DqD-vLt8.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-B31Loprg.js","snippetPresets-DKpk-b8t.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-Cj65AhOR.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BXtn5gcC.js","shallow-RY2b03Cp.js","getApiPlaygroundDisplay-B0jeiPk3.js","CodeSnippet-CYgBjjwn.js","CodeSnippets-DOngDrYB.js","Page-n7I5XbKb.js","getPastedJson-DRQbJx-T.js","icon-CQiQCicY.js","MethodPill-BKTLdNtu.js","DuplicateIcon-B9jpAdat.js","createIcon-DCddRrXv.js","DynamicMarkdown-a8hUKrw6.js","SectionHeading-eECVV2eH.js","axios-vUo_bRtp.js","Markdown--GF7ZIpf.js","clsx-DZLdJUrt.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-2LoAhjKH.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-Zwc0ZncM.js"]}