Smartsheet Models
AccessToken
Account
AlternateEmail
Attachment
- class smartsheet.models.attachment.Attachment(props=None, base_obj=None)
Bases:
objectSmartsheet Attachment data model.
- property attachment_sub_type
- property attachment_type
- property created_at
- property created_by
- property description
- property id_
- property mime_type
- property name
- property parent_id
- property parent_type
- property size_in_kb
- to_dict()
- to_json()
- property url
- property url_expires_in_millis
AutoNumberFormat
AutomationAction
- class smartsheet.models.automation_action.AutomationAction(props=None, base_obj=None)
Bases:
objectSmartsheet AutomationAction data model.
- property frequency
- property include_all_columns
- property include_attachments
- property include_discussions
- property included_column_ids
- property message
- property recipient_column_ids
- property recipients
- property subject
- to_dict()
- to_json()
- property type_
AutomationRule
- class smartsheet.models.automation_rule.AutomationRule(props=None, base_obj=None)
Bases:
objectSmartsheet AutomationRule data model.
- property action
- property created_at
- property created_by
- property disabled_reason
- property disabled_reason_text
- property enabled
- property id_
- property modified_at
- property modified_by
- property name
- to_dict()
- to_json()
- property user_can_modify
BooleanObjectValue
- class smartsheet.models.boolean_object_value.BooleanObjectValue(value=None, base_obj=None)
Bases:
PrimitiveObjectValueSmartsheet BooleanObjectValue data model.
- property object_type
BulkItemFailure
BulkItemResult
- class smartsheet.models.bulk_item_result.BulkItemResult(props=None, dynamic_result_type: Type[T] = None, base_obj=None)
Bases:
Generic[T]Smartsheet BulkItemResult data model.
- property data: List[T]
Simplify difference between Result and IndexResult
- property failed_items
- property message
- property result: List[T]
- property result_code
- to_dict()
- to_json()
- property version
Cell
- class smartsheet.models.cell.Cell(props=None, base_obj=None)
Bases:
objectSmartsheet Cell data model.
- property column_id
- property column_type
- property conditional_format
- property display_value
- property format_
- property formula
- property hyperlink
- property image
- property link_in_from_cell
- property links_out_to_cells
- property object_value
- property override_validation
- property strict
- to_dict()
- to_json()
- property value
CellDataItem
- class smartsheet.models.cell_data_item.CellDataItem(props=None, base_obj=None)
Bases:
objectSmartsheet CellDataItem data model.
- property cell
- property column_id
- property data_source
- property label
- property label_format
- property object_value
- property order
- property profile_field
- property row_id
- property sheet_id
- to_dict()
- to_json()
- property value_format
CellHistory
CellLink
CellLinkWidgetContent
ChartWidgetContent
- class smartsheet.models.chart_widget_content.ChartWidgetContent(props=None, base_obj=None)
Bases:
WidgetContentSmartsheet ChartWidgetContent data model.
- property axes
- property hyperlink
- property included_column_ids
- property legend
- property report_id
- property selection_ranges
- property series
- property sheet_id
- to_dict()
- to_json()
Column
- class smartsheet.models.column.Column(props=None, base_obj=None)
Bases:
objectSmartsheet Column data model.
- property auto_number_format
- property contact_options
- property description
- property format_
- property formula
- property id_
- property index
- property locked
- property locked_for_user
- property options
- property primary
- property symbol
- property system_column_type
- property tags
- property title
- to_dict()
- to_json()
- property type_
- property validation
- property version
- property width
Comment
Contact
ContactObjectValue
- class smartsheet.models.contact_object_value.ContactObjectValue(props=None, base_obj=None)
Bases:
ObjectValue,ContactSmartsheet ContactObjectValue data model.
- property image_id
- property ref_index
ContainerDestination
CopyOrMoveRowDestination
CopyOrMoveRowDirective
CopyOrMoveRowResult
Criteria
CrossSheetReference
- class smartsheet.models.cross_sheet_reference.CrossSheetReference(props=None, base_obj=None)
Bases:
objectSmartsheet CrossSheetReference data model.
- property end_column_id
- property end_row_id
- property id_
- property name
- property source_sheet_id
- property start_column_id
- property start_row_id
- property status
- to_dict()
- to_json()
Currency
DateObjectValue
- class smartsheet.models.date_object_value.DateObjectValue(props=None, base_obj=None)
Bases:
ObjectValueSmartsheet DateObjectValue data model.
- property value
DatetimeObjectValue
- class smartsheet.models.datetime_object_value.DatetimeObjectValue(props=None, object_type=None, base_obj=None)
Bases:
ObjectValueSmartsheet DatetimeObjectValue data model.
- property value
Discussion
- class smartsheet.models.discussion.Discussion(props=None, base_obj=None)
Bases:
objectSmartsheet Discussion data model.
- property access_level
- property comment
- property comment_attachments
- property comment_count
- property comments
- property created_by
- property id_
- property last_commented_at
- property last_commented_user
- property parent_id
- property parent_type
- property read_only
- property title
- to_dict()
- to_json()
DownloadedFile
Duration
Email
Error
ErrorResult
- class smartsheet.models.error_result.ErrorResult(props=None, base_obj=None)
Bases:
objectSmartsheet ErrorResult data model.
- property code
- property error_code
- property message
- property name
- property recommendation
- property ref_id
- property should_retry
- property status_code
- to_dict()
- to_json()
Event
- class smartsheet.models.event.Event(props=None, base_obj=None)
Bases:
objectSmartsheet Event data model.
- property access_token_name
- property action
- property additional_details
- property event_id
- property event_timestamp
- property object_id
- property object_type
- property request_user_id
- property source
- to_dict()
- to_json()
- property user_id
EventResult
ExplicitNull
Favorite
Folder
- class smartsheet.models.folder.Folder(props=None, base_obj=None)
Bases:
objectSmartsheet Folder data model.
- create_folder(folder_obj)
- property created_at
- property favorite
- property folders
- property id_
- property modified_at
- property name
- property permalink
- property reports
- property sheets
- property sights
- property source
- property templates
- to_dict()
- to_json()
FontFamily
FormatDetails
FormatTables
- class smartsheet.models.format_tables.FormatTables(props=None, base_obj=None)
Bases:
objectSmartsheet FormatTables data model.
- property bold
- property color
- property currency
- property date_format
- property decimal_count
- property defaults
- property font_family
- property font_size
- property horizontal_align
- property italic
- property number_format
- property strikethrough
- property text_wrap
- property thousands_separator
- to_dict()
- to_json()
- property underline
- property vertical_align
Group
GroupMember
Home
Hyperlink
Image
ImageUrl
ImageUrlMap
ImageWidgetContent
IndexResult
- class smartsheet.models.index_result.IndexResult(props=None, dynamic_data_type: Type[T] = None, base_obj=None)
Bases:
Generic[T]Smartsheet IndexResult data model.
- property data: List[T]
- property last_key
- property page_number
- property page_size
- property result
Simplify difference between Result and IndexResult
- to_dict()
- to_json()
- property total_count
- property total_pages
JsonObject
MultiContactObjectValue
- class smartsheet.models.multi_contact_object_value.MultiContactObjectValue(props=None, base_obj=None)
Bases:
ObjectValueSmartsheet MultiContactObjectValue data model.
- property values
MultiPicklistObjectValue
- class smartsheet.models.multi_picklist_object_value.MultiPicklistObjectValue(props=None, base_obj=None)
Bases:
ObjectValueSmartsheet MultiPicklistObjectValue data model.
- property values
MultiRowEmail
NumberObjectValue
- class smartsheet.models.number_object_value.NumberObjectValue(value=None, base_obj=None)
Bases:
PrimitiveObjectValueSmartsheet NumberObjectValue data model.
- property object_type
OAuthError
ObjectValue
- class smartsheet.models.object_value.ObjectValue(object_type=None, base_obj=None)
Bases:
objectSmartsheet ObjectValue data model.
- property object_type
- serialize()
- to_dict()
- to_json()
- smartsheet.models.object_value.enum_object_value_type(object_type=None)
PaginatedChildrenResult
- class smartsheet.models.paginated_children_result.PaginatedChildrenResult(props=None, base_obj=None)
Bases:
TokenPaginatedResult[Folder|Sheet|Sight|Report]Smartsheet PaginatedChildrenResult that deserializes mixed children based on resourceType.
- append_data(item)
Append data item, converting to appropriate model based on resourceType.
- property data
Predecessor
PredecessorList
- class smartsheet.models.predecessor_list.PredecessorList(props=None, base_obj=None)
Bases:
ObjectValueSmartsheet PredecessorList data model.
- property predecessors
PrimitiveObjectValue
ProfileImage
ProjectSettings
Recipient
Report
ReportSummarizingCriterion
- class smartsheet.models.report_summarizing_criterion.ReportSummarizingCriterion(props=None, base_obj=None)
Bases:
objectSmartsheet ReportSummarizingCriterion data model.
Report summarizing criterion. Requires ‘column’ and ‘aggregationType’.
- property aggregation_type: EnumeratedValue
Type of aggregation (SUM, AVG, MIN, MAX, COUNT, FIRST, LAST).
- property column: ReportColumnIdentifier | None
Column to summarize.
- to_dict()
- to_json()
ReportCell
ReportColumn
ReportColumnIdentifier
- class smartsheet.models.report_column_identifier.ReportColumnIdentifier(props=None, base_obj=None)
Bases:
objectSmartsheet ReportColumnIdentifier data model.
Object used to match a sheet column for a report. Either ‘type’ or ‘primary’ must be specified.
Column Matching Options: - Regular columns: Specify ‘type’ to match columns by type (optionally with ‘title’
for additional matching).
System columns: Specify both ‘type’ and ‘systemColumnType’ to match system columns (e.g., Created By, Modified Date).
Sheet name column: Specify ‘type=TEXT_NUMBER’ and ‘sheetNameColumn=True’ to match the special “Sheet Name” column.
Primary column: Specify ‘primary=True’ to match the primary column. When matching primary columns, ‘title’ can be used to customize the primary column name in the rendered report.
Note: Columns in the report are matched by the combination of ‘title’ and ‘type’ (and ‘systemColumnType’ or ‘sheetNameColumn’ if specified).
Note: ‘symbol’ is not used for matching and as a result ‘CHECKBOX’ or ‘PICKLIST’ columns with different symbols (from different sheets) can be combined into the same column in the report. You cannot combine ‘CHECKBOX’ with ‘PICKLIST’ into the same column in the report because they are different types.
- property primary: bool | None
- property sheet_name_column: bool | None
- property system_column_type: EnumeratedValue
- property title: str | None
- to_dict()
- to_json()
- property type: EnumeratedValue
ReportDefinition
- class smartsheet.models.report_definition.ReportDefinition(props=None, base_obj=None)
Bases:
objectSmartsheet ReportDefinition data model.
The report definition contains filters, grouping and sorting properties of the report.
Note: When groupingCriteria is defined the primary column of the report will move to index 0 when it is first rendered by the app.
Supports partial updates on root level properties such as: - filters - groupingCriteria - summarizingCriteria - sortingCriteria
- property filters
- property grouping_criteria
- property sorting_criteria
- property summarizing_criteria
- to_dict()
- to_json()
ReportFilterCriterion
- class smartsheet.models.report_filter_criterion.ReportFilterCriterion(props=None, base_obj=None)
Bases:
objectSmartsheet ReportFilterCriterion data model.
Criteria object specifying custom criteria against which to match cell values.
The values property can contain: - Simple values: strings, numbers, or None - Object values: dicts with ‘objectType’ (DATE or CURRENT_USER) and ‘value’ properties
- Example with object value:
- {
“column”: {“title”: “Date”, “type”: “DATE”}, “operator”: “EQUAL”, “values”: [{“objectType”: “DATE”, “value”: “2024-01-01”}]
}
- property column: ReportColumnIdentifier | None
- property operator: EnumeratedValue
- to_dict()
- to_json()
- property values: List[str | int | float | dict | None] | None
List of filter values.
Can contain: - strings - numbers (int or float) - None (null) - dicts with ‘objectType’ and ‘value’ keys for special values like dates
ReportFilterExpression
- class smartsheet.models.report_filter_expression.ReportFilterExpression(props=None, base_obj=None)
Bases:
objectSmartsheet ReportFilterExpression data model.
An expression to filter on report columns. It is a recursive object that allows at most three levels.
It must include ‘operator’ and at least one of the following: ‘criteria’ or ‘nestedCriteria’
Here is a two-level example:
- {
“operator”: “OR”, “nestedCriteria”: [
- {
“operator”: “AND”, “criteria”: [
- {
“column”: { “title”: “Price”, “type”: “TEXT_NUMBER” }, “operator”: “GREATER_THAN”, “values”: [“11”]
}, {
“column”: { “primary”: true }, “operator”: “CONTAINS”, “values”: [“PROJ-1”]
}
]
}, {
“operator”: “AND”, “criteria”: [
- {
“column”: { “title”: “Quantity”, “type”: “TEXT_NUMBER” }, “operator”: “LESS_THAN”, “values”: [“12”]
}, {
“column”: { “title”: “Sold Out”, “type”: “CHECKBOX” }, “operator”: “IS_CHECKED”
}
]
}
]
}
It’s equivalent to the following pseudo logic:
(“Price” > 11 AND “Primary” CONTAINS “PROJ-1”) OR (“Quantity” < 12 AND “Sold Out” IS_CHECKED)
- property operator: EnumeratedValue
- to_dict()
- to_json()
ReportGroupingCriterion
- class smartsheet.models.report_grouping_criterion.ReportGroupingCriterion(props=None, base_obj=None)
Bases:
objectSmartsheet ReportGroupingCriterion data model.
Report grouping criterion. Requires ‘column’ and ‘sortingDirection’.
- property column: ReportColumnIdentifier | None
Column to group by.
- property is_expanded: bool | None
true).
- Type:
Indicates whether the group is expanded in the UI (default
- property sorting_direction: EnumeratedValue
Sorting direction within the group (ASCENDING or DESCENDING).
- to_dict()
- to_json()
ReportScopeInclusion
ReportPublish
- class smartsheet.models.report_publish.ReportPublish(props=None, base_obj=None)
Bases:
objectSmartsheet ReportPublish data model.
- property read_only_full_accessible_by
- property read_only_full_default_view
- property read_only_full_enabled
- property read_only_full_show_toolbar
- property read_only_full_url
- to_dict()
- to_json()
ReportRow
ReportSortingCriterion
- class smartsheet.models.report_sorting_criterion.ReportSortingCriterion(props=None, base_obj=None)
Bases:
objectSmartsheet ReportSortingCriterion data model.
Report sorting criterion. Requires ‘column’ and ‘sortingDirection’.
- property column: ReportColumnIdentifier | None
Column to sort by.
- property sorting_direction: EnumeratedValue
Sorting direction (ASCENDING or DESCENDING).
- to_dict()
- to_json()
ReportWidgetContent
Result
- class smartsheet.models.result.Result(props=None, dynamic_result_type: Type[T] = None, base_obj=None)
Bases:
Generic[T]Smartsheet Result data model.
- property data: T
Simplify difference between Result and IndexResult
- property message
- property result
- property result_code
- to_dict()
- to_json()
- property version
Row
- class smartsheet.models.row.Row(props=None, base_obj=None)
Bases:
objectSmartsheet Row data model.
- property above
- property access_level
- property attachments
- property cells
- property columns
- property conditional_format
- property created_at
- property created_by
- property discussions
- property expanded
- property filtered_out
- property format_
- get_column(column_id)
- property id_
- property in_critical_path
- property indent
- property locked
- property locked_for_user
- property modified_at
- property modified_by
- property outdent
- property parent_id
- property permalink
- property row_number
- set_column(column_id, replacement_cell)
- property sheet_id
- property sibling_id
- property to_bottom
- to_dict()
- to_json()
- property to_top
- property version
RowEmail
RowMapping
Schedule
- class smartsheet.models.schedule.Schedule(props=None, base_obj=None)
Bases:
objectSmartsheet Schedule data model.
- property day_descriptors
- property day_of_month
- property day_ordinal
- property end_at
- property last_sent_at
- property next_send_at
- property repeat_every
- property start_at
- to_dict()
- to_json()
- property type_
Scope
SearchResult
SearchResultItem
- class smartsheet.models.search_result_item.SearchResultItem(props=None, base_obj=None)
Bases:
objectSmartsheet SearchResultItem data model.
- property context_data
- property favorite
- property object_id
- property object_type
- property parent_object_favorite
- property parent_object_id
- property parent_object_name
- property parent_object_type
- property text
- to_dict()
- to_json()
SelectionRange
SentUpdateRequest
- class smartsheet.models.sent_update_request.SentUpdateRequest(props=None, base_obj=None)
Bases:
objectSmartsheet SentUpdateRequest data model.
- property column_ids
- property id_
- property include_attachments
- property include_discussions
- property message
- property row_ids
- property sent_at
- property sent_by
- property sent_to
- property status
- property subject
- to_dict()
- to_json()
- property update_request_id
ServerInfo
Sheet
- class smartsheet.models.sheet.Sheet(props=None, base_obj=None)
Bases:
objectSmartsheet Sheet data model.
- property access_level
- add_columns(list_of_columns)
- add_rows(list_of_rows)
- attach_url(attachment_obj)
- property attachments
- property columns
- property contact_references
- create_discussion(title, comment, _file=None)
- property created_at
- property cross_sheet_references
- delete_column(column_id)
- delete_rows(object_ids, ignore_rows_not_found=False)
- property dependencies_enabled
- property discussions
- property effective_attachment_options
- property favorite
- property filters
- property from_id
- property gantt_enabled
- get_all_discussions(include=None, page_size=100, page=1, include_all=False)
- get_column(column_id, include=None)
- get_column_by_title(title)
- get_columns(include=None, page_size=100, page=1, include_all=False)
- get_publish_status()
- get_row(row_id, include=None, exclude=None)
- get_version()
- property has_summary_fields
- property id_
- property modified_at
- property name
- property owner
- property owner_id
- property permalink
- property project_settings
- property read_only
- property resource_management_enabled
- property rows
- set_publish_status(sheet_publish_obj)
- property show_parent_rows_for_filters
- property source
- property summary
- to_dict()
- to_json()
- property total_row_count
- update_name(new_name)
- property user_permissions
- property user_settings
- property version
- property workspace
SheetEmail
SheetFilter
SheetFilterDetails
SheetPublish
- class smartsheet.models.sheet_publish.SheetPublish(props=None, base_obj=None)
Bases:
objectSmartsheet SheetPublish data model.
- property ical_enabled
- property ical_url
- property read_only_full_accessible_by
- property read_only_full_default_view
- property read_only_full_enabled
- property read_only_full_show_toolbar
- property read_only_full_url
- property read_only_lite_enabled
- property read_only_lite_ssl_url
- property read_only_lite_url
- property read_write_accessible_by
- property read_write_default_view
- property read_write_enabled
- property read_write_show_toolbar
- property read_write_url
- to_dict()
- to_json()
SheetSummary
SheetUserPermissions
SheetUserSettings
ShortcutDataItem
ShortcutWidgetContent
- class smartsheet.models.shortcut_widget_content.ShortcutWidgetContent(props=None, base_obj=None)
Bases:
WidgetContentSmartsheet ShortcutWidgetContent data model.
- property shortcut_data
- to_dict()
- to_json()
Sight
- class smartsheet.models.sight.Sight(props=None, base_obj=None)
Bases:
objectSmartsheet Sight data model.
- property access_level
- property background_color
- property column_count
- property created_at
- property favorite
- property id_
- property modified_at
- property name
- property permalink
- property source
- to_dict()
- to_json()
- property widgets
- property workspace
SightPublish
SortCriterion
SortSpecifier
Source
StringObjectValue
- class smartsheet.models.string_object_value.StringObjectValue(value=None, base_obj=None)
Bases:
PrimitiveObjectValueSmartsheet StringObjectValue data model.
- property object_type
SummaryField
- class smartsheet.models.summary_field.SummaryField(props=None, base_obj=None)
Bases:
objectSmartsheet SummaryField data model.
- property contact_options
- property created_at
- property created_by
- property display_value
- property format_
- property formula
- property hyperlink
- property id_
- property image
- property index
- property locked
- property locked_for_user
- property modified_at
- property modified_by
- property object_value
- property options
- property symbol
- property title
- to_dict()
- to_json()
- property type_
- property validation
Template
- class smartsheet.models.template.Template(props=None, base_obj=None)
Bases:
objectSmartsheet Template data model.
- property access_level
- property blank
- property categories
- property description
- property global_template
- property id_
- property image
- property large_image
- property locale
- property name
- property tags
- to_dict()
- to_json()
- property type
TitleRichTextWidgetContent
TokenPaginatedResult
UpdateRequest
User
UserModel
- class smartsheet.models.user_model.UserModel(props=None, base_obj=None)
Bases:
objectSmartsheet UserModel data model.
- property admin
- property alternate_emails
- property company
- property custom_welcome_screen_viewed
- property department
- property email
- property first_name
- property group_admin
- property id_
- property is_internal
- property last_login
- property last_name
- property licensed_sheet_creator
- property mobile_phone
- property profile_image
- property provisional_expiration_date
- property resource_viewer
- property role
- property seat_type
- property seat_type_last_changed_at
- property sheet_count
- property status
- property title
- to_dict()
- to_json()
- property work_phone
UserPlan
UserProfile
Version
WebContentWidgetContent
- class smartsheet.models.web_content_widget_content.WebContentWidgetContent(props=None, base_obj=None)
Bases:
WidgetContentSmartsheet WebContentWidgetContent data model.
- to_dict()
- to_json()
- property url
Webhook
- class smartsheet.models.webhook.Webhook(props=None, base_obj=None)
Bases:
objectSmartsheet Webhook data model.
- property api_client_id
- property api_client_name
- property callback_url
- property created_at
- property disabled_details
- property enabled
- property events
- property id_
- property modified_at
- property name
- property scope
- property scope_object_id
- property stats
- property status
- property subscope
- to_dict()
- to_json()
- property version
WebhookSecret
WebhookStats
WebhookSubscope
Widget
- class smartsheet.models.widget.Widget(props=None, base_obj=None)
Bases:
objectSmartsheet Widget data model.
- property contents
- property error
- property height
- property id_
- property show_title
- property show_title_icon
- property title
- property title_format
- to_dict()
- to_json()
- property type
- property version
- property width
- property x_position
- property y_position
WidgetContent
WidgetHyperlink
Workspace
- class smartsheet.models.workspace.Workspace(props=None, base_obj=None)
Bases:
objectSmartsheet Workspace data model.
- property access_level
- property created_at
- property favorite
- property folders
- property id_
- property modified_at
- property name
- property permalink
- property reports
- property sheets
- property sights
- property source
- property templates
- to_dict()
- to_json()