RenderTask : Manage Render Tasks
Create Lookml Dashboard Render Task deprecated
POST/api/3.0/render_tasks/lookml_dashboards/{dashboard_id}/{result_format}
create_lookml_dashboard_render_task(dashboard_id, result_format, body, width, height, fields, pdf_paper_size, pdf_landscape)
Implementation Notes
Create a new task to render a lookml dashboard to a document or image.
DEPRECATED: Use create_dashboard_render_task()) in API 4.0+
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).
Response Class
RenderTask {
can (object, read-only): Operations the current user is able to perform on this object,
created_at (string, read-only): Date/Time render task was created,
dashboard_filters (string, read-only): Filter values to apply to the dashboard queries, in URL query format,
dashboard_id (long, read-only): Id of dashboard to render,
dashboard_style (string, read-only): Dashboard layout style: single_column or tiled,
finalized_at (string, read-only): Date/Time render task was completed,
height (long, read-only): Output height in pixels. Flowed layouts may ignore this value.,
id (string, read-only): Id of this render task,
look_id (long, read-only): Id of look to render,
lookml_dashboard_id (string, read-only): Id of lookml dashboard to render,
query_id (long, read-only): Id of query to render,
query_runtime (double, read-only): Number of seconds elapsed running queries,
render_runtime (double, read-only): Number of seconds elapsed rendering data,
result_format (string, read-only): Output format: pdf, png, or jpg,
runtime (double, read-only): Total seconds elapsed for render task,
status (string, read-only): Render task status: enqueued_for_query, querying, enqueued_for_render, rendering, success, failure,
status_detail (string, read-only): Additional information about the current status,
user_id (long, read-only): The user account permissions in which the render task will execute,
width (long, read-only): Output width in pixels
}
Parameters
| Parameter | Required? | Description | Parameter Type | Data Type |
|---|---|---|---|---|
| dashboard_id | true | Id of lookml dashboard to render | string | string |
| result_format | true | Output type: pdf, png, or jpg | string | string |
| body | true | Dashboard render task parameters | body |
CreateDashboardRenderTask {
dashboard_filters (string): Filter values to apply to the dashboard queries, in URL query format, dashboard_style (string): Dashboard layout style: single_column or tiled }
|
| width | true | Output width in pixels | integer | int64 |
| height | true | Output height in pixels | integer | int64 |
| fields | false | Requested fields. | string | string |
| pdf_paper_size | false | Paper size for pdf. Value can be one of: [“letter”,”legal”,”tabloid”,”a0”,”a1”,”a2”,”a3”,”a4”,”a5”] | string | string |
| pdf_landscape | false | Whether to render pdf in landscape | boolean | boolean |
Response Messages
| HTTP Status Code | Reason | Response Model |
|---|---|---|
| 400 | Bad Request |
Error {
message (string, read-only, required): Error details, documentation_url (string, read-only, required): Documentation link }
|
| 404 | Not Found |
Error {
message (string, read-only, required): Error details, documentation_url (string, read-only, required): Documentation link }
|
| 409 | Resource Already Exists |
Error {
message (string, read-only, required): Error details, documentation_url (string, read-only, required): Documentation link }
|
| 422 | Validation Error |
ValidationError {
message (string, read-only, required): Error details, errors (Array[ValidationErrorDetail], read-only): Error detail array, documentation_url (string, read-only, required): Documentation link }ValidationErrorDetail { field (string, read-only): Field with error, code (string, read-only): Error code, message (string, read-only): Error info message, documentation_url (string, read-only, required): Documentation link }
|
| 429 | Too Many Requests |
Error {
message (string, read-only, required): Error details, documentation_url (string, read-only, required): Documentation link }
|
Create Look Render Task
POST/api/3.0/render_tasks/looks/{look_id}/{result_format}
create_look_render_task(look_id, result_format, width, height, fields)
Implementation Notes
Create a new task to render a look 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).
Response Class
RenderTask {
can (object, read-only): Operations the current user is able to perform on this object,
created_at (string, read-only): Date/Time render task was created,
dashboard_filters (string, read-only): Filter values to apply to the dashboard queries, in URL query format,
dashboard_id (long, read-only): Id of dashboard to render,
dashboard_style (string, read-only): Dashboard layout style: single_column or tiled,
finalized_at (string, read-only): Date/Time render task was completed,
height (long, read-only): Output height in pixels. Flowed layouts may ignore this value.,
id (string, read-only): Id of this render task,
look_id (long, read-only): Id of look to render,
lookml_dashboard_id (string, read-only): Id of lookml dashboard to render,
query_id (long, read-only): Id of query to render,
query_runtime (double, read-only): Number of seconds elapsed running queries,
render_runtime (double, read-only): Number of seconds elapsed rendering data,
result_format (string, read-only): Output format: pdf, png, or jpg,
runtime (double, read-only): Total seconds elapsed for render task,
status (string, read-only): Render task status: enqueued_for_query, querying, enqueued_for_render, rendering, success, failure,
status_detail (string, read-only): Additional information about the current status,
user_id (long, read-only): The user account permissions in which the render task will execute,
width (long, read-only): Output width in pixels
}
Parameters
| Parameter | Required? | Description | Parameter Type | Data Type |
|---|---|---|---|---|
| look_id | true | Id of look to render | integer | int64 |
| result_format | true | Output type: png, or jpg | string | string |
| width | true | Output width in pixels | integer | int64 |
| height | true | Output height in pixels | integer | int64 |
| fields | false | Requested fields. | string | string |
Response Messages
| HTTP Status Code | Reason | Response Model |
|---|---|---|
| 400 | Bad Request |
Error {
message (string, read-only, required): Error details, documentation_url (string, read-only, required): Documentation link }
|
| 404 | Not Found |
Error {
message (string, read-only, required): Error details, documentation_url (string, read-only, required): Documentation link }
|
| 409 | Resource Already Exists |
Error {
message (string, read-only, required): Error details, documentation_url (string, read-only, required): Documentation link }
|
| 422 | Validation Error |
ValidationError {
message (string, read-only, required): Error details, errors (Array[ValidationErrorDetail], read-only): Error detail array, documentation_url (string, read-only, required): Documentation link }ValidationErrorDetail { field (string, read-only): Field with error, code (string, read-only): Error code, message (string, read-only): Error info message, documentation_url (string, read-only, required): Documentation link }
|
| 429 | Too Many Requests |
Error {
message (string, read-only, required): Error details, documentation_url (string, read-only, required): Documentation link }
|
Create Query Render Task
POST/api/3.0/render_tasks/queries/{query_id}/{result_format}
create_query_render_task(query_id, result_format, width, height, fields)
Implementation Notes
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).
Response Class
RenderTask {
can (object, read-only): Operations the current user is able to perform on this object,
created_at (string, read-only): Date/Time render task was created,
dashboard_filters (string, read-only): Filter values to apply to the dashboard queries, in URL query format,
dashboard_id (long, read-only): Id of dashboard to render,
dashboard_style (string, read-only): Dashboard layout style: single_column or tiled,
finalized_at (string, read-only): Date/Time render task was completed,
height (long, read-only): Output height in pixels. Flowed layouts may ignore this value.,
id (string, read-only): Id of this render task,
look_id (long, read-only): Id of look to render,
lookml_dashboard_id (string, read-only): Id of lookml dashboard to render,
query_id (long, read-only): Id of query to render,
query_runtime (double, read-only): Number of seconds elapsed running queries,
render_runtime (double, read-only): Number of seconds elapsed rendering data,
result_format (string, read-only): Output format: pdf, png, or jpg,
runtime (double, read-only): Total seconds elapsed for render task,
status (string, read-only): Render task status: enqueued_for_query, querying, enqueued_for_render, rendering, success, failure,
status_detail (string, read-only): Additional information about the current status,
user_id (long, read-only): The user account permissions in which the render task will execute,
width (long, read-only): Output width in pixels
}
Parameters
| Parameter | Required? | Description | Parameter Type | Data Type |
|---|---|---|---|---|
| query_id | true | Id of the query to render | integer | int64 |
| result_format | true | Output type: png or jpg | string | string |
| width | true | Output width in pixels | integer | int64 |
| height | true | Output height in pixels | integer | int64 |
| fields | false | Requested fields. | string | string |
Response Messages
| HTTP Status Code | Reason | Response Model |
|---|---|---|
| 400 | Bad Request |
Error {
message (string, read-only, required): Error details, documentation_url (string, read-only, required): Documentation link }
|
| 404 | Not Found |
Error {
message (string, read-only, required): Error details, documentation_url (string, read-only, required): Documentation link }
|
| 409 | Resource Already Exists |
Error {
message (string, read-only, required): Error details, documentation_url (string, read-only, required): Documentation link }
|
| 422 | Validation Error |
ValidationError {
message (string, read-only, required): Error details, errors (Array[ValidationErrorDetail], read-only): Error detail array, documentation_url (string, read-only, required): Documentation link }ValidationErrorDetail { field (string, read-only): Field with error, code (string, read-only): Error code, message (string, read-only): Error info message, documentation_url (string, read-only, required): Documentation link }
|
| 429 | Too Many Requests |
Error {
message (string, read-only, required): Error details, documentation_url (string, read-only, required): Documentation link }
|
Create Dashboard Render Task
POST/api/3.0/render_tasks/dashboards/{dashboard_id}/{result_format}
create_dashboard_render_task(dashboard_id, result_format, body, width, height, fields, pdf_paper_size, pdf_landscape)
Implementation Notes
Create a new task to render a dashboard to a document or 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).
Response Class
RenderTask {
can (object, read-only): Operations the current user is able to perform on this object,
created_at (string, read-only): Date/Time render task was created,
dashboard_filters (string, read-only): Filter values to apply to the dashboard queries, in URL query format,
dashboard_id (long, read-only): Id of dashboard to render,
dashboard_style (string, read-only): Dashboard layout style: single_column or tiled,
finalized_at (string, read-only): Date/Time render task was completed,
height (long, read-only): Output height in pixels. Flowed layouts may ignore this value.,
id (string, read-only): Id of this render task,
look_id (long, read-only): Id of look to render,
lookml_dashboard_id (string, read-only): Id of lookml dashboard to render,
query_id (long, read-only): Id of query to render,
query_runtime (double, read-only): Number of seconds elapsed running queries,
render_runtime (double, read-only): Number of seconds elapsed rendering data,
result_format (string, read-only): Output format: pdf, png, or jpg,
runtime (double, read-only): Total seconds elapsed for render task,
status (string, read-only): Render task status: enqueued_for_query, querying, enqueued_for_render, rendering, success, failure,
status_detail (string, read-only): Additional information about the current status,
user_id (long, read-only): The user account permissions in which the render task will execute,
width (long, read-only): Output width in pixels
}
Parameters
| Parameter | Required? | Description | Parameter Type | Data Type |
|---|---|---|---|---|
| dashboard_id | true | Id of dashboard to render | integer | int64 |
| result_format | true | Output type: pdf, png, or jpg | string | string |
| body | true | Dashboard render task parameters | body |
CreateDashboardRenderTask {
dashboard_filters (string): Filter values to apply to the dashboard queries, in URL query format, dashboard_style (string): Dashboard layout style: single_column or tiled }
|
| width | true | Output width in pixels | integer | int64 |
| height | true | Output height in pixels | integer | int64 |
| fields | false | Requested fields. | string | string |
| pdf_paper_size | false | Paper size for pdf. Value can be one of: [“letter”,”legal”,”tabloid”,”a0”,”a1”,”a2”,”a3”,”a4”,”a5”] | string | string |
| pdf_landscape | false | Whether to render pdf in landscape paper orientation | boolean | boolean |
Response Messages
| HTTP Status Code | Reason | Response Model |
|---|---|---|
| 400 | Bad Request |
Error {
message (string, read-only, required): Error details, documentation_url (string, read-only, required): Documentation link }
|
| 404 | Not Found |
Error {
message (string, read-only, required): Error details, documentation_url (string, read-only, required): Documentation link }
|
| 409 | Resource Already Exists |
Error {
message (string, read-only, required): Error details, documentation_url (string, read-only, required): Documentation link }
|
| 422 | Validation Error |
ValidationError {
message (string, read-only, required): Error details, errors (Array[ValidationErrorDetail], read-only): Error detail array, documentation_url (string, read-only, required): Documentation link }ValidationErrorDetail { field (string, read-only): Field with error, code (string, read-only): Error code, message (string, read-only): Error info message, documentation_url (string, read-only, required): Documentation link }
|
| 429 | Too Many Requests |
Error {
message (string, read-only, required): Error details, documentation_url (string, read-only, required): Documentation link }
|
Get Render Task
GET/api/3.0/render_tasks/{render_task_id}
render_task(render_task_id, fields)
Implementation Notes
Get information about a render task.
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).
Response Class
RenderTask {
can (object, read-only): Operations the current user is able to perform on this object,
created_at (string, read-only): Date/Time render task was created,
dashboard_filters (string, read-only): Filter values to apply to the dashboard queries, in URL query format,
dashboard_id (long, read-only): Id of dashboard to render,
dashboard_style (string, read-only): Dashboard layout style: single_column or tiled,
finalized_at (string, read-only): Date/Time render task was completed,
height (long, read-only): Output height in pixels. Flowed layouts may ignore this value.,
id (string, read-only): Id of this render task,
look_id (long, read-only): Id of look to render,
lookml_dashboard_id (string, read-only): Id of lookml dashboard to render,
query_id (long, read-only): Id of query to render,
query_runtime (double, read-only): Number of seconds elapsed running queries,
render_runtime (double, read-only): Number of seconds elapsed rendering data,
result_format (string, read-only): Output format: pdf, png, or jpg,
runtime (double, read-only): Total seconds elapsed for render task,
status (string, read-only): Render task status: enqueued_for_query, querying, enqueued_for_render, rendering, success, failure,
status_detail (string, read-only): Additional information about the current status,
user_id (long, read-only): The user account permissions in which the render task will execute,
width (long, read-only): Output width in pixels
}
Parameters
| Parameter | Required? | Description | Parameter Type | Data Type |
|---|---|---|---|---|
| render_task_id | true | Id of render task | string | string |
| fields | false | Requested fields. | string | string |
Response Messages
| HTTP Status Code | Reason | Response Model |
|---|---|---|
| 400 | Bad Request |
Error {
message (string, read-only, required): Error details, documentation_url (string, read-only, required): Documentation link }
|
| 404 | Not Found |
Error {
message (string, read-only, required): Error details, documentation_url (string, read-only, required): Documentation link }
|
Render Task Results
GET/api/3.0/render_tasks/{render_task_id}/results
render_task_results(render_task_id)
Implementation Notes
Get the document or image produced by a completed render task.
Returns 102 Processing if the render task has not completed.
Response Class
string
Parameters
| Parameter | Required? | Description | Parameter Type | Data Type |
|---|---|---|---|---|
| render_task_id | true | Id of render task | string | string |
Response Messages
| HTTP Status Code | Reason | Response Model |
|---|---|---|
| 400 | Bad Request |
Error {
message (string, read-only, required): Error details, documentation_url (string, read-only, required): Documentation link }
|
| 404 | Not Found |
Error {
message (string, read-only, required): Error details, documentation_url (string, read-only, required): Documentation link }
|
| 102 | Processing |