Skip to content
VIDMOATDocs

Create a workspace

POSThttps://api.vidmoat.com/v1/workspaces
Bearer tokenScope projects.writeFreeTry it in the playground

Create a workspace. Pass teamId to make it a shared one.

Body#

  • namestringrequired
    Up to 48 characters.
  • colorstring
    One of #FF4D2E, #5AA9FF, #7ED9A6, #FFD447, #A855F7, #FF7A5A, #9EDCC4, #94A3B8. Any other value is stored as null.
  • iconstring
    One emoji (at most two code points). Longer is stored as null.
  • teamIdstring
    A team you belong to, for a shared workspace.

Response#

Returns 201.

Response fields#

  • idstring
    The workspace id.
  • namestring
    Its name.
  • colorstring or null
    A hex colour, or null when none is set.
  • iconstring or null
    An emoji, or null.
  • teamIdstring or null
    The team it belongs to, or null for a personal workspace.
  • projectCountinteger
    Projects filed in it (0 for a new one).

Errors#

Besides the errors any request can get (authentication, rate limits):

StatusCodeWhen
400invalid_requestNo name, a team you are not in, or you already have 60 workspaces.