Create a space

Creates a new space based on an existing Space Config

This endpoint expects an object.

accesslist of enumsOptional

Allowed values:

actionslist of objectsOptional

appIdstringOptional

The ID of the App that space is associated with

archivedAtdatetimeOptional

Date when space was archived

autoConfigurebooleanOptional

Only used during creation - will be ignored on update

displayOrderintegerOptional

The display order

environmentIdstringOptional

Environment ID

guestAuthenticationlist of enumsOptional

Allowed values:

isAppTemplatebooleanOptional

Whether the space is an app template. Only one space per app can be an app template.

labelslist of stringsOptional

languageOverridestringOptional

metadataanyOptional

Metadata for the space

namestringOptional

The name of the space

namespacestringOptional

primaryWorkbookIdstringOptional

The ID of the primary workbook for the space. This should not be included in create space requests.

settingsobjectOptional

The Space settings.

spaceConfigIdstringOptional

Space Config ID

translationsPathstringOptional

This endpoint returns an object.

dataobject

A place to store your workbooks

1	curl -X POST https://api.x.flatfile.com/v1/spaces \
2	-H "X-Disable-Hooks: true" \
3	-H "Authorization: Bearer <token>" \
4	-H "Content-Type: application/json" \
5	-d '{
6	"displayOrder": 1,
7	"environmentId": "us_env_YOUR_ID",
8	"name": "My First Workbook",
9	"primaryWorkbookId": "us_wb_YOUR_ID"
10	}'

1	{
2	"data": {
3	"createdAt": "2021-01-01T00:00:00.000Z",
4	"guestAuthentication": [
5	"magic_link",
6	"shared_link"
7	],
8	"id": "us_sp_YOUR_ID",
9	"name": "My First Worbook",
10	"updatedAt": "2021-01-01T00:00:00.000Z",
11	"createdByUserId": "us_usr_YOUR_ID",
12	"displayOrder": 1,
13	"environmentId": "us_env_YOUR_ID",
14	"filesCount": 1,
15	"isCollaborative": true,
16	"labels": [],
17	"lastActivityAt": "2021-01-01T00:00:00.000Z",
18	"metadata": null,
19	"primaryWorkbookId": "us_wb_YOUR_ID",
20	"upgradedAt": "2021-01-01T00:00:00.000Z",
21	"workbooksCount": 1
22	}
23	}