PATCH /user/codespaces/{codespace_name}

Updates a codespace owned by the authenticated user. Currently only the codespace's machine type and recent folders can be modified using this endpoint.

If you specify a new machine type it will be applied the next time your codespace is started.

OAuth app tokens and personal access tokens (classic) need the codespace scope to use this endpoint.

Servers

Path parameters

Name Type Required Description
codespace_name String Yes

The name of the codespace.

Request headers

Name Type Required Description
Content-Type String Yes The media type of the request body.

Default value: "application/json"

Request body fields

Name Type Required Description
display_name String No

Display name for this codespace

machine String No

A valid machine to transition this codespace to.

recent_folders[] Array No

Recently opened folders inside the codespace. It is currently used by the clients to determine the folder path to load the codespace in.

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. Search for the API you want to integrate with and click on the name.
    • This loads the API reference documentation and prepares the Http request settings.
  3. Click Test request to test run your request to the API and see the API's response.