Version 4.0.25.20 (latest)
Get one or more artifacts
Returns an array of artifacts matching the specified key value(s).
Note: The artifact storage API can only be used by Looker-built extensions.
Request
GET
/artifact/{namespace}
Datatype
Description
Request
HTTP Request
path
HTTP Path
Expand HTTP Path definition...
namespace
string
Artifact storage namespace
query
HTTP Query
Expand HTTP Query definition...
key
string
Comma-delimited list of keys. Wildcards not allowed.
fields
string
Comma-delimited names of fields to return in responses. Omit for all fields
limit
integer
Number of results to return. (used with offset)
offset
integer
Number of results to skip before returning any. (used with limit)
tally
boolean
Return the full count of results in the X-Total-Count response header. (Slight performance hit.)
Response
200: Created or updated artifacts
Datatype
Description
(array)
Artifact
[]
key
string
Key of value to store. Namespace + Key must be unique.
value
string
Value to store.
content_type
string
MIME type of content. This can only be used to override content that is detected as text/plain. Needed to set application/json content types, which are analyzed as plain text.
version
lock
integer
Version number of the stored value. The version must be provided for any updates to an existing artifact.
namespace
lock
string
Artifact storage namespace.
created_at
lock
string
Timestamp when this artifact was created.
updated_at
lock
string
Timestamp when this artifact was updated.
value_size
lock
integer
Size (in bytes) of the stored value.
created_by_userid
lock
string
User id of the artifact creator.
updated_by_userid
lock
string
User id of the artifact updater.
400: Bad Request
Datatype
Description
(object)
message
lock
string
Error details
documentation_url
lock
string
Documentation link
404: Not Found
Datatype
Description
(object)
message
lock
string
Error details
documentation_url
lock
string
Documentation link
422: Validation Error
Datatype
Description
(object)
message
lock
string
Error details
errors
Expand ValidationErrorDetail definition...
field
lock
string
Field with error
code
lock
string
Error code
message
lock
string
Error info message
documentation_url
lock
string
Documentation link
documentation_url
lock
string
Documentation link
429: Too Many Requests
Datatype
Description
(object)
message
lock
string
Error details
documentation_url
lock
string
Documentation link
