> For the complete documentation index, see [llms.txt](https://developer.harness.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.harness.io/feature-management-experimentation/split-api-reference/projects-was-workspaces.md).

# Projects (was Workspaces)

## Get Projects (Workspaces)

> Retrieves the projects (formerly known as workspaces) for an account.

```json
{"openapi":"3.1.0","info":{"title":"Harness FME Admin API","version":"2"},"tags":[{"name":"Projects (was Workspaces)"}],"servers":[{"url":"https://api.split.io/internal/api/v2"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Admin API Key, sent as `Authorization: Bearer <ADMIN_API_KEY>`"}}},"paths":{"/workspaces":{"get":{"summary":"Get Projects (Workspaces)","description":"Retrieves the projects (formerly known as workspaces) for an account.","operationId":"get-workspaces","parameters":[{"name":"offset","in":"query","description":"The offset to retrieve. Useful for pagination.","schema":{"type":"integer","format":"int32"}},{"name":"limit","in":"query","description":"The maximum return limit per call is 1000.","schema":{"type":"integer","format":"int32","default":20}},{"name":"name","in":"query","description":"Filter projects by name. This must be the project name and cannot be the project ID.","schema":{"type":"string"}},{"name":"nameOp","in":"query","description":"Match operator for the name query parameter. `IS` is the default value but `STARTS_WITH` and `CONTAINS` is also supported.","schema":{"type":"string","default":"IS"}},{"in":"query","name":"organizationIdentifier","schema":{"type":"string"},"description":"Filter projects by the Harness organization ID."},{"in":"query","name":"projectIdentifier","schema":{"type":"string"},"description":"Filter projects by the Harness project ID."}],"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"objects":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"The Harness project (workspace) ID."},"name":{"type":"string","description":"The Harness project (workspace) name."},"type":{"type":"string","description":"The project (workspace) type.","default":"workspace"},"organizationIdentifier":{"type":"string","description":"The Harness organization ID."},"projectIdentifier":{"type":"string","description":"The Harness project (workspace) ID."}}}},"offset":{"type":"integer","default":0},"limit":{"type":"integer","default":0},"totalCount":{"type":"integer","default":0}}}}}},"401":{"description":"401","content":{"text/plain":{"schema":{"type":"object","properties":{"code":{"type":"integer","default":0},"message":{"type":"string"},"transactionId":{"type":"string"}}}}}},"403":{"description":"403","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","default":0},"message":{"type":"string"},"transactionId":{"type":"string"}}}}}}},"deprecated":false,"tags":["Projects (was Workspaces)"]}}}}
```

## Create Projects (Workspaces)

> Allows you to create projects (formerly known as workspaces). Note: When you create a project from this API, this won't create the default environment. You must use the \<a href="[https://docs.split.io/reference/create-environment">create](https://docs.split.io/reference/create-environment">create) environments API\</a> to create an environment.

```json
{"openapi":"3.1.0","info":{"title":"Harness FME Admin API","version":"2"},"tags":[{"name":"Projects (was Workspaces)"}],"servers":[{"url":"https://api.split.io/internal/api/v2"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Admin API Key, sent as `Authorization: Bearer <ADMIN_API_KEY>`"}}},"paths":{"/workspaces":{"post":{"summary":"Create Projects (Workspaces)","description":"Allows you to create projects (formerly known as workspaces). Note: When you create a project from this API, this won't create the default environment. You must use the <a href=\"https://docs.split.io/reference/create-environment\">create environments API</a> to create an environment.","operationId":"create-workspace","requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"type":"object","properties":{"workspace":{"type":"string","description":"request payload","format":"json"}}}}}},"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string"},"name":{"type":"string"},"requiresTitleAndComments":{"type":"boolean","default":true}}}}}},"400":{"description":"400","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","default":0},"message":{"type":"string"},"details":{"type":"string"},"transactionId":{"type":"string"}}}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","default":0},"message":{"type":"string"},"details":{"type":"string"},"transactionId":{"type":"string"}}}}}},"409":{"description":"409","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","default":0},"message":{"type":"string"},"details":{"type":"string"},"transactionId":{"type":"string"}}}}}},"500":{"description":"500","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","default":0},"message":{"type":"string"},"details":{"type":"string"},"transactionId":{"type":"string"}}}}}}},"deprecated":false,"tags":["Projects (was Workspaces)"]}}}}
```

## Delete Projects (Workspaces)

> Deletes a project, formerly known as workspace.

```json
{"openapi":"3.1.0","info":{"title":"Harness FME Admin API","version":"2"},"tags":[{"name":"Projects (was Workspaces)"}],"servers":[{"url":"https://api.split.io/internal/api/v2"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Admin API Key, sent as `Authorization: Bearer <ADMIN_API_KEY>`"}}},"paths":{"/workspaces/{workspace_id}":{"delete":{"summary":"Delete Projects (Workspaces)","description":"Deletes a project, formerly known as workspace.","operationId":"delete-workspace","parameters":[{"name":"workspace_id","in":"path","description":"The ID of the project (workspace) to delete.","schema":{"type":"string"},"required":true}],"responses":{"204":{"description":"204","content":{"text/plain":{}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","default":0},"message":{"type":"string"},"details":{"type":"string"},"transactionId":{"type":"string"}}}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","default":0},"message":{"type":"string"},"details":{"type":"string"},"transactionId":{"type":"string"}}}}}}},"deprecated":false,"tags":["Projects (was Workspaces)"]}}}}
```

## Update Projects (Workspaces)

> This endpoint provides a partial update for a project (formerly known as workspace).

```json
{"openapi":"3.1.0","info":{"title":"Harness FME Admin API","version":"2"},"tags":[{"name":"Projects (was Workspaces)"}],"servers":[{"url":"https://api.split.io/internal/api/v2"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Admin API Key, sent as `Authorization: Bearer <ADMIN_API_KEY>`"}}},"paths":{"/workspaces/{workspace_id}":{"patch":{"summary":"Update Projects (Workspaces)","description":"This endpoint provides a partial update for a project (formerly known as workspace).","operationId":"update-workspace","parameters":[{"name":"workspace_id","in":"path","description":"The ID of the project (workspace) to update","schema":{"type":"string"},"required":true}],"requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"type":"object","properties":{"patch":{"type":"string","description":"patch operation payload","format":"json"}}}}}},"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string"},"name":{"type":"string"},"requiresTitleAndComments":{"type":"boolean","default":true}}}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","default":0},"message":{"type":"string"},"details":{"type":"string"},"transactionId":{"type":"string"}}}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","default":0},"message":{"type":"string"},"details":{"type":"string"},"transactionId":{"type":"string"}}}}}}},"deprecated":false,"tags":["Projects (was Workspaces)"]}}}}
```
