post /v1/organizations/{organizationId}/spaces

Create space

Creates a blank space or organization template synchronously. To create a space from a template, set templateSpaceId; that request returns the new space immediately and finishes copying its contents asynchronously. When operationId is present, poll GET /v1/organizations/{organizationId}/spaces/{space.id}/operations/{operationId} until status is succeeded or failed. To duplicate an ordinary space instead, use POST /v1/organizations/{organizationId}/spaces/{spaceId}/copy.

path params

organizationIdstring required

Request body

name String Required when template_space_id is omitted. When creating from a template, this optionally overrides the template's name.

type String ENUM

TYPE ENUM VALUES

otherTypeName String

organizationSharing String ENUM

ORGANIZATIONSHARING ENUM VALUES

linkSharing String ENUM

LINKSHARING ENUM VALUES

publicSharing String ENUM

PUBLICSHARING ENUM VALUES

tags Array of String

templateType String ENUM

TEMPLATETYPE ENUM VALUES

iconName String

enableProgressTracking Boolean

onlyAllowExistingOrganizationMembers Boolean

allowBlockSharingOrganizationMembers Boolean

allowBlockSharingPublic Boolean

allowBlockSharingUsers Boolean

templateSpaceId String Creates an independent space from this template. When set, every other creation setting except name must be omitted.

Responses

response body

object

space Object

SPACE PROPERTIES

id String

organizationId String

name String

type String ENUM

TYPE ENUM VALUES

personalSpaceUserId String

otherTypeName String

organizationSharing String ENUM

ORGANIZATIONSHARING ENUM VALUES

linkSharing String ENUM

LINKSHARING ENUM VALUES

publicSharing String ENUM

PUBLICSHARING ENUM VALUES

linkSharingSecret String

tags Array of String

status String ENUM

STATUS ENUM VALUES

templateType String ENUM

TEMPLATETYPE ENUM VALUES

coverPhotoFileId String

coverPhotoXOffset Integer

coverPhotoYOffset Integer

iconName String

defaultSpaceRoleId String

descriptionBlockId String

enableProgressTracking Boolean

onlyAllowExistingOrganizationMembers Boolean

allowBlockSharingOrganizationMembers Boolean

allowBlockSharingPublic Boolean

allowBlockSharingUsers Boolean

coverPhotoFileUrl String

roles Array

Array of SpaceRole

id String

spaceId String

name String

type String ENUM

TYPE ENUM VALUES

classification String

permissions Array

Array of String

createdAt String

updatedAt String

memberCount Integer

membersView Array

Array of MemberView

startDate String

endDate String

createdAt String

updatedAt String

deletedAt String

lastActivityAt String

createdById String

pilotToken String

labels Array

Array of Label

operationId String Present when template contents are being applied asynchronously. Poll the space operation status endpoint using space.id and this operation ID.

Pivot Mobile and Desktop App

The Infinite Canvas Block

Audio and Video Messages

Making the Most of Your Personal Space

Integrating with Pivot using Zapier

Create space

path params

Request body

Responses