Create Query Render Task

Version 4.0.25.2 (latest)

Create a new task to render an existing query to an image.

Returns a render task object. To check the status of a render task, pass the render_task.id to Get Render Task. Once the render task is complete, you can download the resulting document or image using Get Render Task Results.

Request

POST /render_tasks/queries/{query_id}/{result_format}
Datatype
Description
Request
HTTP Request
path
HTTP Path
query_id
string
Id of the query to render
result_format
string
Output type: png or jpg
query
HTTP Query
width
integer
Output width in pixels
height
integer
Output height in pixels
fields
string
Requested fields.

Response

Datatype
Description
(object)
can
object
Operations the current user is able to perform on this object
created_at
string
Date/Time render task was created
dashboard_filters
string
Filter values to apply to the dashboard queries, in URL query format
dashboard_id
string
Id of dashboard to render
dashboard_style
string
Dashboard layout style: single_column or tiled
finalized_at
string
Date/Time render task was completed
height
integer
Output height in pixels. Flowed layouts may ignore this value.
id
string
Id of this render task
look_id
string
Id of look to render
lookml_dashboard_id
string
Id of lookml dashboard to render
query_id
string
Id of query to render
dashboard_element_id
string
Id of dashboard element to render: UDD dashboard element would be numeric and LookML dashboard element would be model_name::dashboard_title::lookml_link_id
query_runtime
number
Number of seconds elapsed running queries
render_runtime
number
Number of seconds elapsed rendering data
result_format
string
Output format: pdf, png, or jpg
runtime
number
Total seconds elapsed for render task
status
string
Render task status: enqueued_for_query, querying, enqueued_for_render, rendering, success, failure
status_detail
string
Additional information about the current status
user_id
string
The user account permissions in which the render task will execute
width
integer
Output width in pixels
Datatype
Description
(object)
message
string
Error details
documentation_url
string
Documentation link
Datatype
Description
(object)
message
string
Error details
documentation_url
string
Documentation link
Datatype
Description
(object)
message
string
Error details
documentation_url
string
Documentation link
Datatype
Description
(object)
message
string
Error details
field
string
Field with error
code
string
Error code
message
string
Error info message
documentation_url
string
Documentation link
documentation_url
string
Documentation link
Datatype
Description
(object)
message
string
Error details
documentation_url
string
Documentation link

Examples