Create Board Item

Version 4.0.24.20 (latest)

Create a new board item.

Request

POST /board_items
Datatype
Description
Request
HTTP Request
body
HTTP Body
Expand HTTP Body definition...
body
Board Item
Expand BoardItem definition...
can
object
Operations the current user is able to perform on this object
content_created_by
string
Name of user who created the content this item is based on
content_favorite_id
string
Content favorite id associated with the item this content is based on
content_metadata_id
string
Content metadata id associated with the item this content is based on
content_updated_at
string
Last time the content that this item is based on was updated
custom_description
string
Custom description entered by the user, if present
custom_title
string
Custom title entered by the user, if present
custom_url
string
Custom url entered by the user, if present
dashboard_id
string
Dashboard to base this item on
description
string
The actual description for display
favorite_count
integer
Number of times content has been favorited, if present
board_section_id
string
Associated Board Section
id
string
Unique Id
image_url
string
The actual image_url for display
location
string
The container folder name of the content
look_id
string
Look to base this item on
lookml_dashboard_id
string
LookML Dashboard to base this item on
order
integer
An arbitrary integer representing the sort order within the section
title
string
The actual title for display
url
string
Relative url for the associated content
use_custom_description
boolean
Whether the custom description should be used instead of the content description, if the item is associated with content
use_custom_title
boolean
Whether the custom title should be used instead of the content title, if the item is associated with content
use_custom_url
boolean
Whether the custom url should be used instead of the content url, if the item is associated with content
view_count
integer
Number of times content has been viewed, if present
custom_image_data_base64
string
(Write-Only) base64 encoded image data
custom_image_url
string
Custom image_url entered by the user, if present
use_custom_image
boolean
Whether the custom image should be used instead of the content image, if the item is associated with content
query
HTTP Query
Expand HTTP Query definition...
fields
string
Requested fields.

Response

200: Board Item

Datatype
Description
(object)
can
object
Operations the current user is able to perform on this object
content_created_by
string
Name of user who created the content this item is based on
content_favorite_id
string
Content favorite id associated with the item this content is based on
content_metadata_id
string
Content metadata id associated with the item this content is based on
content_updated_at
string
Last time the content that this item is based on was updated
custom_description
string
Custom description entered by the user, if present
custom_title
string
Custom title entered by the user, if present
custom_url
string
Custom url entered by the user, if present
dashboard_id
string
Dashboard to base this item on
description
string
The actual description for display
favorite_count
integer
Number of times content has been favorited, if present
board_section_id
string
Associated Board Section
id
string
Unique Id
image_url
string
The actual image_url for display
location
string
The container folder name of the content
look_id
string
Look to base this item on
lookml_dashboard_id
string
LookML Dashboard to base this item on
order
integer
An arbitrary integer representing the sort order within the section
title
string
The actual title for display
url
string
Relative url for the associated content
use_custom_description
boolean
Whether the custom description should be used instead of the content description, if the item is associated with content
use_custom_title
boolean
Whether the custom title should be used instead of the content title, if the item is associated with content
use_custom_url
boolean
Whether the custom url should be used instead of the content url, if the item is associated with content
view_count
integer
Number of times content has been viewed, if present
custom_image_data_base64
string
(Write-Only) base64 encoded image data
custom_image_url
string
Custom image_url entered by the user, if present
use_custom_image
boolean
Whether the custom image should be used instead of the content image, if the item is associated with content

400: Bad Request

Datatype
Description
(object)
message
string
Error details
documentation_url
string
Documentation link

404: Not Found

Datatype
Description
(object)
message
string
Error details
documentation_url
string
Documentation link

409: Resource Already Exists

Datatype
Description
(object)
message
string
Error details
documentation_url
string
Documentation link

422: Validation Error

Datatype
Description
(object)
message
string
Error details
Expand ValidationErrorDetail definition...
field
string
Field with error
code
string
Error code
message
string
Error info message
documentation_url
string
Documentation link
documentation_url
string
Documentation link

429: Too Many Requests

Datatype
Description
(object)
message
string
Error details
documentation_url
string
Documentation link

Examples