API ReferenceActions

Create several actions

Headers

AuthorizationstringRequired

Bearer authentication of the form Bearer <token>, where token is your auth token.

X-Disable-Hooks"true"RequiredDefaults to true

Query parameters

spaceIdstringRequired
The Space ID for which to create the Actions.

Request

This endpoint expects a list of objects.
labelstringRequired
The text on the Button itself
targetIdstringRequired
confirmbooleanOptional
Whether to show a modal to confirm the action
constraintslist of objectsOptional
A limitation or restriction on the action.
createdFromstringOptional
The action that this action was cloned from
deletedAtdatetimeOptional
The time this action was deleted
descriptionstringOptional
The text that appears in the dialog after the action is clicked.
guardrailobjectOptional
guideobjectOptional
iconstringOptional
Icon will work on primary actions. It will only accept an already existing Flatfile design system icon.
inputFormobjectOptional
Adds an input form for this action after it is clicked.
invalidConditionalMessagingbooleanOptional
When enabled, shows dynamic confirmation messages based on record validation status instead of the static description
invalidRecordsMessagestringOptional

Custom message to show when there are invalid records (only used when invalidConditionalMessaging is true)

lastPropagatedAtdatetimeOptional
The last time this action was propagated to a workbook
messageslist of objectsOptional
modeenumOptional
Foreground and toolbarBlocking action mode will prevent interacting with the resource until complete
Allowed values:
mountobjectOptional
operationstringOptional
This will become the job operation that is triggered
primarybooleanOptional
A primary action will be more visibly present, whether in Sheet or Workbook.
scheduleenumOptional
Determines if the action should happen on a regular cadence.
Allowed values:
tooltipstringOptional
A tooltip that appears when hovering the action button
typestringOptional

This is deprecated.

validRecordsMessagestringOptional

Custom message to show when all records are valid (only used when invalidConditionalMessaging is true)

requireAllValidbooleanOptionalDeprecated

This is deprecated. Use constraints instead.

requireSelectionbooleanOptionalDeprecated

This is deprecated. Use constraints instead.

slugstringOptionalDeprecated

This is deprecated. Use operation instead.

Response

This endpoint returns a list of objects.
createdAtdatetime
idstring
Action ID
labelstring
The text on the Button itself
targetIdstring
updatedAtdatetime
confirmboolean or null
Whether to show a modal to confirm the action
constraintslist of objects or null
A limitation or restriction on the action.
createdFromstring or null
The action that this action was cloned from
deletedAtdatetime or null
The time this action was deleted
descriptionstring or null
The text that appears in the dialog after the action is clicked.
guardrailobject or null
guideobject or null
iconstring or null
Icon will work on primary actions. It will only accept an already existing Flatfile design system icon.
inputFormobject or null
Adds an input form for this action after it is clicked.
invalidConditionalMessagingboolean or null
When enabled, shows dynamic confirmation messages based on record validation status instead of the static description
invalidRecordsMessagestring or null

Custom message to show when there are invalid records (only used when invalidConditionalMessaging is true)

lastPropagatedAtdatetime or null
The last time this action was propagated to a workbook
messageslist of objects or null
modeenum or null
Foreground and toolbarBlocking action mode will prevent interacting with the resource until complete
Allowed values:
mountobject or null
operationstring or null
This will become the job operation that is triggered
primaryboolean or null
A primary action will be more visibly present, whether in Sheet or Workbook.
scheduleenum or null
Determines if the action should happen on a regular cadence.
Allowed values:
tooltipstring or null
A tooltip that appears when hovering the action button
typestring or null

This is deprecated.

validRecordsMessagestring or null

Custom message to show when all records are valid (only used when invalidConditionalMessaging is true)

requireAllValidboolean or nullDeprecated

This is deprecated. Use constraints instead.

requireSelectionboolean or nullDeprecated

This is deprecated. Use constraints instead.

slugstring or nullDeprecated

This is deprecated. Use operation instead.