Cached Project Validation Results

Version 4.0.24.16

Get Cached Project Validation Results

Returns the cached results of a previous project validation calculation, if any. Returns http status 204 No Content if no validation results exist.

Validating the content of all the files in a project can be computationally intensive for large projects. Use this API to simply fetch the results of the most recent project validation rather than revalidating the entire project from scratch.

A value of "stale": true in the response indicates that the project has changed since the cached validation results were computed. The cached validation results may no longer reflect the current state of the project.

Request

GET /projects/{project_id}/validate
Datatype
Description
Request
HTTP Request
path
HTTP Path
Expand HTTP Path definition...
project_id
string
Project Id
query
HTTP Query
Expand HTTP Query definition...
fields
string
Requested fields

Response

200: Project validation results

Datatype
Description
errors
Expand ProjectError definition...
code
string
A stable token that uniquely identifies this class of error, ignoring parameter values. Error message text may vary due to parameters or localization, but error codes do not. For example, a "File not found" error will have the same error code regardless of the filename in question or the user's display language
severity
string
Severity: fatal, error, warning, info, success
kind
string
Error classification: syntax, deprecation, model_configuration, etc
message
string
Error message which may contain information such as dashboard or model names that may be considered sensitive in some use cases. Avoid storing or sending this message outside of Looker
field_name
string
The field associated with this error
file_path
string
Name of the file containing this error
line_number
integer
Line number in the file of this error
model_id
string
The model associated with this error
explore
string
The explore associated with this error
help_url
string
A link to Looker documentation about this error
params
object
Error parameters
sanitized_message
string
A version of the error message that does not contain potentially sensitive information. Suitable for situations in which messages are stored or sent to consumers outside of Looker, such as external logs. Sanitized messages will display "(?)" where sensitive information would appear in the corresponding non-sanitized message
project_digest
string
A hash value computed from the project's current state
models_not_validated
Expand ModelsNotValidated definition...
name
string
Model name
project_file_id
string
Project file
computation_time
number
Duration of project validation in seconds
stale
boolean
If true, the cached project validation results are no longer accurate because the project has changed since the cached results were calculated

204: Deleted

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