get /v1/organizations/{organizationId}/spaces/{spaceId}/blocks

List space home blocks

Returns the blocks displayed on the space home. Reading a space's content requires membership in that space, separate from membership in its organization -- an organization API key must be added to a space before it can read the space's blocks, even though it can already list the space and its members. A 403 means the caller can see the space but is not a space member; a 404 means the space does not exist or is outside the caller's organization.

path params

organizationIdstring required

spaceIdstring required

Responses

response body

object

blocks Array

Array of Block

id String

descriptionSpaceId String

homeSpaceId String

attachedToMessageId String

parentBlockId String

type String ENUM

TYPE ENUM VALUES

BLOCK_TYPE_UNSPECIFIED BLOCK_TYPE_PAGE BLOCK_TYPE_SECTION BLOCK_TYPE_HEADING BLOCK_TYPE_TEXT BLOCK_TYPE_BULLETED_LIST_ITEM BLOCK_TYPE_NUMBERED_LIST_ITEM BLOCK_TYPE_FILE BLOCK_TYPE_IMAGE BLOCK_TYPE_CHECKBOX_LIST_ITEM BLOCK_TYPE_CALLOUT BLOCK_TYPE_QUOTE BLOCK_TYPE_DIVIDER BLOCK_TYPE_EMBED BLOCK_TYPE_LINK_PREVIEW BLOCK_TYPE_TABLE BLOCK_TYPE_BUTTON BLOCK_TYPE_CODE BLOCK_TYPE_VIDEO BLOCK_TYPE_AUDIO BLOCK_TYPE_SYNCED_BLOCK BLOCK_TYPE_TABLE_OF_CONTENTS BLOCK_TYPE_CALENDAR BLOCK_TYPE_TEMPLATE BLOCK_TYPE_WORKFLOW BLOCK_TYPE_ROOM BLOCK_TYPE_EVENT BLOCK_TYPE_POLL BLOCK_TYPE_AUDIO_MESSAGE BLOCK_TYPE_VIDEO_MESSAGE BLOCK_TYPE_CANVAS BLOCK_TYPE_FIND_A_TIME BLOCK_TYPE_FORM BLOCK_TYPE_GOAL BLOCK_TYPE_DATABASE BLOCK_TYPE_DATABASE_ITEM BLOCK_TYPE_CHART BLOCK_TYPE_ASSIGNMENT BLOCK_TYPE_QUIZ BLOCK_TYPE_RUBRIC BLOCK_TYPE_GRADES BLOCK_TYPE_PARAGRAPH BLOCK_TYPE_SLIDES BLOCK_TYPE_SLIDE BLOCK_TYPE_COLUMN_LIST BLOCK_TYPE_COLUMN BLOCK_TYPE_TABS BLOCK_TYPE_TAB

richContent String

icon String

createdBy String

updatedBy String

vOrder Number

hOrder Number

vOrderV2 String

hOrderV2 String

hideAfter String

unhideAfter String

startAt String

endAt String

isLocked Boolean

allowResponsesStart String

allowResponsesEnd String

responsesAreEditable Boolean

url String

defaultLayout String ENUM

DEFAULTLAYOUT ENUM VALUES

templateType String ENUM

TEMPLATETYPE ENUM VALUES

mediaThumbnailTime Number

programmingLanguage String

overrideDisplayNumber Boolean

publicAllowDuplicateAsTemplate Boolean

publicLinkExpiresAt String

publicSharingLevel String ENUM

PUBLICSHARINGLEVEL ENUM VALUES

organizationSharingLevel String ENUM

ORGANIZATIONSHARINGLEVEL ENUM VALUES

spaceMemberSharingLevel String ENUM

SPACEMEMBERSHARINGLEVEL ENUM VALUES

updatedAt String

createdAt String

deletedAt String

deletedBy String

jwtToken String

pilotToken String

correspondingRoomId String

userIsComplete Boolean Block user data

lastUserViewId String

lastSeenInfo Array

Array of LastSeenInfo

content String

ancestors Array

Array of BlockAncestor

attachments Array

Array of BlockAttachment

id String

fileId String

fileUrl String

displayName String

createdAt String

videoThumbnailUrl String

videoCaptionsUrl String

videoStoryboardUrl String

videoDuration String

assets Array

Array of Asset

id String

referencePrefix String

referenceId String

type String ENUM

TYPE ENUM VALUES

transcript Object

TRANSCRIPT PROPERTIES

chapterList Object

CHAPTERLIST PROPERTIES

summary Object

SUMMARY PROPERTIES

captions Object

CAPTIONS PROPERTIES

createdAt String

playbackFailed Boolean A terminal playback workflow failure; an absent URL alone can still be pending.

blockData Array

Array of BlockData

id String

blockId String

type String ENUM

TYPE ENUM VALUES

plainTextContent String

propertyValueDetail Object Kept as property_value_detail for wire-compatibility.

eventAttendanceDetail Object

goalCycleDefinitionDetail Object

createdAt String

updatedAt String

deletedAt String

relatedViewId String

parentBlockDataId String

createdById String

updatedById String

vOrder Number

vOrderV2 String Fractional-index ordering key (base-62) for position_in_view rows.

views Array

Array of BlockView

currentUserAccessLevel String ENUM

CURRENTUSERACCESSLEVEL ENUM VALUES

richTextCrdtVersion Integer

Pivot Desktop App

The Infinite Canvas Block

Audio and Video Messages

Making the Most of Your Personal Space

Integrating with Pivot using Zapier

List space home blocks

path params

Responses