post /v1/organizations/{organizationId}/spaces

Create space

Creates a new space in the organization. Set templateSpaceId to create an independent space from a template; when it is set, only name may also be provided.

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 Deprecated and ignored. Template management is exposed through the dedicated space-template operations.

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

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