Send a Data Action

Version 4.0.24.20 (latest)

Perform a data action. The data action object can be obtained from query results, and used to perform an arbitrary action.

Request

POST /data_actions
Datatype
Description
Request
HTTP Request
body
HTTP Body
Expand HTTP Body definition...
body
Data Action Request
Expand DataActionRequest definition...
action
object
The JSON describing the data action. This JSON should be considered opaque and should be passed through unmodified from the query result it came from.
form_values
object
User input for any form values the data action might use.

Response

200: Data Action Response

Datatype
Description
webhook_id
string
ID of the webhook event that sent this data action. In some error conditions, this may be null.
success
boolean
Whether the data action was successful.
refresh_query
boolean
When true, indicates that the client should refresh (rerun) the source query because the data may have been changed by the action.
validation_errors
Validation errors returned by the data action server.
Expand ValidationError definition...
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
message
string
Optional message returned by the data action server describing the state of the action that took place. This can be used to implement custom failure messages. If a failure is related to a particular form field, the server should send back a validation error instead. The Looker web UI does not currently display any message if the action indicates 'success', but may do so in the future.

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

429: Too Many Requests

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