---
title: "Create a space document"
method: POST
path: "/1.0/space-documents"
tags: ["Space Documents"]
---

# Create a space document

`POST /1.0/space-documents`

## Request body

- SpaceTabPublicRequestAPIEntity
  - `spaceDocumentId` integer — The space document's unique, system-generated identifier, which can be used to identify the space document globally.
  - `spaceDocumentName` string — The name of the space document.By default, the name is 'Untitled'.
  - `space` SpacePublicAPISpaceTabRequestEntity, required — Information about the space to which the space document belongs to.
    - `spaceId` integer — The space's unique, system-generated identifier, which can be used to identify the space globally.
    - `spaceName` string — The name of the space.
  - `spaceDocumentType` 'ROCKETLANE_DOCUMENT' | 'EMBEDDED_DOCUMENT', required — Defines the type of the space document. This could be a Rocketlane document or an embedded document.
  - `url` string — The url that is embedded in the space document.
  - `source` SpaceTabImportPublicAPIRequestEntity — Sources denote the document templates based on which the document is created
    - `templateId` integer — The unique identifier for the template.
    - `templateName` string — The name of the template.

## Response `201`

The resource was successfully created in the database.

- SpaceTabPublicResponseAPIEntity
  - `spaceDocumentId` integer — The space document's unique, system-generated identifier, which can be used to identify the space document globally.
  - `spaceDocumentName` string — The name of the space document.
  - `space` SpacePublicAPISpaceTabResponseEntity — Information about the space to which the space document belongs to.
    - `spaceId` integer — The space's unique, system-generated identifier, which can be used to identify the space globally.
    - `spaceName` string — The name of the space.
  - `spaceDocumentType` 'ROCKETLANE_DOCUMENT' | 'EMBEDDED_DOCUMENT' — Defines the type of the space document. This could be a Rocketlane document or an embedded document.
  - `url` string — The url that is embedded in the space document.
  - `source` SpaceTabSourcePublicResponse — Sources denote the document templates based on which the document is created
    - `templateId` integer — The unique identifier for the template.
    - `templateName` string — The name of the template.
  - `createdAt` integer — The timestamp when the space document was created.
  - `createdBy` SpaceTabCreatedByUserPublicAPI — The team member who created the space document.
    - `emailId` string — The team members email identifier.
    - `userId` integer — The unique identifier for the user.
    - `firstName` string — The first name of the user.
    - `lastName` string — The last name of the user.
  - `updatedAt` integer — The timestamp when the space document was last updated.
  - `updatedBy` SpaceTabUpdatedByUserPublicAPI — The team member who updated the space document.
    - `emailId` string — The team members email identifier.
    - `userId` integer — The unique identifier for the user.
    - `firstName` string — The first name of the user.
    - `lastName` string — The last name of the user.
  - `private` boolean — Describes the privacy of the space i.e. if it is private or shared.

## Other responses

- `400` — This error typically happens when the request payload contains an error. If you want to make sure that the request's parameters are named correctly and are the right data types, you can examine the request's syntax.
- `401` — You see this error when trying to access this resource without being authenticated. Check the API request header to make sure it is not empty and has a valid api-key that you acquired from the Rocketlane API Settings tab.

---

[API](https://skmtc.net/rocketlane/apis/rocketlane-api.md) · [All operations](https://skmtc.net/rocketlane/apis/rocketlane-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/rocketlane/rocketlane-api/versions/1e8ba619e741/schema)