Skip to main content

Create Space

createSpace mutation is used to create a new space. It takes CreateSpaceInput as an input.

mutation {
  createSpace(input: {
    name: "New Space"
  }) {
    id
  }
}

This will create a new space with the name "New Space" inside the default collection.

Create a space inside a collection​

You can pass the id of the collection to create the space inside it. Let's first create a collection.

mutation {
  createCollection(input: {name: "Get Started"}) {
    id
  }
}

The response will contain the id of the collection.

{
  "data": {
    "createCollection": {
      "id": "cj9zfkqj"
    }
  }
}

Then you can use the collectionId to create the space inside the collection.

mutation {
  createSpace(input: {
    name: "Say Hello"
    collectionId: "cj9zfkqj"
  }) {
    id
  }
}

This will create a space with the name "Say Hello" inside the collection "Get Started".

Create a space with an emoji as image​

You can also create a space with an emoji as image. You need to create an emoji first and then use the id of the emoji as imageId.

mutation {
  createEmojis(input: [{text: "+1"}]) {
    id
  }
}
mutation {
  createSpace(input: {
    name: "Say Hello"
    collectionId: "cj9zfkqj"
    imageId: ":+1:"
  }) {
    id
  }
}

This will create a space with a Thumbs Up emoji (👍) as image.

Create a space with an image​

To create a space with an image first you need to upload an image. And then you can use the id of the image as imageId.

mutation {
  createSpace(input: {
    name: "Say Hello"
    collectionId: "cj9zfkqj"
    imageId: "sDJnsABrHAqd"
  }) {
    id
  }
}