post /v1/blocks/{parentBlockId}/goals

Create a subgoal

Creates a goal directly under an existing goal. Requires edit access to the parent. Send a UUID requestId and a plain-text title. Retrying with the same caller, parent and requestId returns the same goal without overwriting later edits. Reuse the original requestId and title after an uncertain response.

path params

parentBlockIdstring required

Request body

requestId String required

title String required

Responses

response body

object

block Object

BLOCK PROPERTIES

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

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

Create a subgoal

path params

Request body

Responses