> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://nemo-platform.docs.buildwithfern.com/nemo/platform/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://nemo-platform.docs.buildwithfern.com/nemo/platform/_mcp/server. # Create a new workspace POST https://host.com/apis/entities/v2/workspaces Content-Type: application/json Create a new workspace. The creator is automatically granted Admin role on the workspace. By default, this endpoint waits for the Admin role to propagate before returning. Use `wait_role_propagation=false` to skip waiting (useful for bulk operations). Example: ``` POST /apis/entities/v2/workspaces { "name": "ml-team", "description": "Machine Learning Team workspace" } ``` Reference: https://nemo-platform.docs.buildwithfern.com/nemo/platform/nemo/platform/documentation/reference/api-reference/entity-store/create-workspace-apis-entities-v-2-workspaces-post ## OpenAPI Specification ```yaml openapi: 3.1.0 info: title: Nemo Platform API version: 1.0.0 paths: /apis/entities/v2/workspaces: post: operationId: create-workspace-apis-entities-v-2-workspaces-post summary: Create a new workspace description: >- Create a new workspace. The creator is automatically granted Admin role on the workspace. By default, this endpoint waits for the Admin role to propagate before returning. Use `wait_role_propagation=false` to skip waiting (useful for bulk operations). Example: ``` POST /apis/entities/v2/workspaces { "name": "ml-team", "description": "Machine Learning Team workspace" } ``` tags: - subpackage_entityStore parameters: - name: wait_role_propagation in: query description: >- If true, wait for Admin role to propagate before returning (default: true). Set to false for bulk operations. required: false schema: type: boolean default: true responses: '201': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/Workspace' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' requestBody: content: application/json: schema: $ref: '#/components/schemas/WorkspaceInput' servers: - url: https://host.com description: Default components: schemas: WorkspaceInput: type: object properties: name: type: string description: >- Workspace name (unique identifier). Name must start with a lowercase letter, be 2-63 characters, and contain only lowercase letters, digits, and hyphens (no consecutive hyphens, cannot end with a hyphen). description: type: string description: Optional description of the workspace required: - name description: Schema for creating a new workspace. title: WorkspaceInput Workspace: type: object properties: id: type: string description: System-generated UUID name: type: string description: Workspace name (user-provided) description: type: string description: Optional description created_at: type: string format: date-time description: Timestamp of workspace creation created_by: type: string description: Principal id for workspace creator updated_at: type: string format: date-time description: Timestamp of last workspace update updated_by: type: string description: Principal id for last workspace update required: - id - name - created_at - updated_at description: Workspace schema for API responses. title: Workspace ValidationErrorLocItems: oneOf: - type: string - type: integer title: ValidationErrorLocItems ValidationError: type: object properties: loc: type: array items: $ref: '#/components/schemas/ValidationErrorLocItems' msg: type: string type: type: string input: description: Any type ctx: type: object additionalProperties: description: Any type required: - loc - msg - type title: ValidationError HTTPValidationError: type: object properties: detail: type: array items: $ref: '#/components/schemas/ValidationError' title: HTTPValidationError ``` ## Examples **Request** ```json { "name": "data-science-team" } ``` **Response** ```json { "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "name": "data-science-team", "created_at": "2024-01-15T09:30:00Z", "updated_at": "2024-01-15T09:30:00Z", "description": "Workspace for the Data Science Team projects and collaboration", "created_by": "user-12345", "updated_by": "user-12345" } ``` **SDK Code** ```python import requests url = "https://host.com/apis/entities/v2/workspaces" payload = { "name": "data-science-team" } headers = {"Content-Type": "application/json"} response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript const url = 'https://host.com/apis/entities/v2/workspaces'; const options = { method: 'POST', headers: {'Content-Type': 'application/json'}, body: '{"name":"data-science-team"}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://host.com/apis/entities/v2/workspaces" payload := strings.NewReader("{\n \"name\": \"data-science-team\"\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby require 'uri' require 'net/http' url = URI("https://host.com/apis/entities/v2/workspaces") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Content-Type"] = 'application/json' request.body = "{\n \"name\": \"data-science-team\"\n}" response = http.request(request) puts response.read_body ``` ```java import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://host.com/apis/entities/v2/workspaces") .header("Content-Type", "application/json") .body("{\n \"name\": \"data-science-team\"\n}") .asString(); ``` ```php request('POST', 'https://host.com/apis/entities/v2/workspaces', [ 'body' => '{ "name": "data-science-team" }', 'headers' => [ 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp using RestSharp; var client = new RestClient("https://host.com/apis/entities/v2/workspaces"); var request = new RestRequest(Method.POST); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"name\": \"data-science-team\"\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift import Foundation let headers = ["Content-Type": "application/json"] let parameters = ["name": "data-science-team"] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://host.com/apis/entities/v2/workspaces")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```