Compass

Documentation of our Compass API with gRPC and gRPC-Gateway.

Version: 0.2.1

License: Apache License 2.0

More about Compass

Assets

/v1beta1/assets

GET

Summary

Get list of assets

Description

Returns list of assets, optionally filtered by types, services, sorting, fields in asset.data and querying fields

Parameters

Name	Located in	Description	Required	Schema
q	query	filter by specific query	No	string
q_fields	query	filter by multiple query fields	No	string
types	query	filter by multiple types	No	string
services	query	filter by multiple services	No	string
sort	query	sorting based on fields	No	string
direction	query	sorting direction can either be asc or desc	No	string
size	query	maximum size to fetch	No	long
offset	query	offset to fetch from	No	long
with_total	query	if set include total field in response	No	boolean
is_deleted	query	(default: false) if set include deleted assets in response	No	boolean
data	query	filter by fields inside asset.data (JSON object)	No	string

Responses

Code	Description	Schema
200	A successful response.	GetAllAssetsResponse
400	Returned when the data that user input is wrong.	Status
404	Returned when the resource does not exist.	Status
409	Returned when the resource already exist.	Status
500	Returned when theres is something wrong on the server side.	Status
default	An unexpected error response.	Status

PUT

Summary

Update/Create an asset

Description

Upsert will update an asset or create a new one if it does not exist yet

Parameters

Name	Located in	Description	Required	Schema
body	body		Yes	UpsertAssetRequest

Responses

Code	Description	Schema
200	A successful response.	UpsertAssetResponse
400	Returned when the data that user input is wrong.	Status
404	Returned when the resource does not exist.	Status
409	Returned when the resource already exist.	Status
500	Returned when theres is something wrong on the server side.	Status
default	An unexpected error response.	Status

PATCH

Summary

Patch/Create an asset

Description

Similar to Upsert but with patch strategy and different body format

Parameters

Name	Located in	Description	Required	Schema
body	body		Yes	UpsertPatchAssetRequest

Responses

Code	Description	Schema
200	A successful response.	UpsertPatchAssetResponse
400	Returned when the data that user input is wrong.	Status
404	Returned when the resource does not exist.	Status
409	Returned when the resource already exist.	Status
500	Returned when theres is something wrong on the server side.	Status
default	An unexpected error response.	Status

/v1beta1/assets/{asset_urn}/probes

POST

Summary

Create asset's probe

Description

Add a new probe to an asset

Parameters

Name	Located in	Description	Required	Schema
asset_urn	path		Yes	string
probe	body		Yes	CreateAssetProbeRequest.Probe

Responses

Code	Description	Schema
200	A successful response.	CreateAssetProbeResponse
400	Returned when the data that user input is wrong.	Status
404	Returned when the resource does not exist.	Status
409	Returned when the resource already exist.	Status
500	Returned when theres is something wrong on the server side.	Status
default	An unexpected error response.	Status

/v1beta1/assets/{id}

GET

Summary

Find an asset

Description

Returns a single asset with given ID or URN

Parameters

Name	Located in	Description	Required	Schema
id	path	asset ID (UUID) or URN	Yes	string

Responses

Code	Description	Schema
200	A successful response.	GetAssetByIDResponse
400	Returned when the data that user input is wrong.	Status
404	Returned when the resource does not exist.	Status
409	Returned when the resource already exist.	Status
500	Returned when theres is something wrong on the server side.	Status
default	An unexpected error response.	Status

DELETE

Summary

Soft-delete an asset

Description

Soft-delete a single asset (by ID or URN). The server enqueues a background job to perform downstream cleanup (index and lineage) — the operation is asynchronous.

Parameters

Name	Located in	Description	Required	Schema
id	path		Yes	string

Responses

Code	Description	Schema
200	A successful response.	DeleteAssetResponse
400	Returned when the data that user input is wrong.	Status
404	Returned when the resource does not exist.	Status
409	Returned when the resource already exist.	Status
500	Returned when theres is something wrong on the server side.	Status
default	An unexpected error response.	Status

/v1beta1/assets/delete-by-query

Summary

Soft-delete assets by query expression.

Description

Soft-delete all assets that match the given query expression. The request is processed asynchronously by the server — if dry_run is false the server enqueues a background job to perform soft deletions and downstream cleanup. The query expression must include refreshed_at, type, and service identifiers. type and service identifiers must use equals (==) or IN operator to prevent accidental broad deletions.

Example of a correct query:

refreshed_at <= "2023-12-12 23:59:59" && service in ["service-1", "service-2"] && type == "table"

The query is converted to SQL/Elasticsearch queries. The expr converter supports most common nodes; see the code's query expr converter for exact capabilities. Prefer simpler expressions to avoid unexpected results.

Parameters

Name	Located in	Description	Required	Schema
query_expr	body	query expression based on expr-lang to filter assets to be deleted. refreshed_at, type, and service identifiers must exist in the query. The type and service must use equals (==) or IN operator	Yes	string
dry_run	body	(default: false) if true, deletion is not executed and the API returns the number of matching rows. If false, the server will enqueue a background soft-delete job (default: false)	No	boolean

Responses

Code	Description	Schema
200	A successful response.	DeleteAssetsResponse
400	Returned when the data that user input is wrong.	Status
500	Returned when theres is something wrong on the server side.	Status
default	An unexpected error response.	Status

/v1beta1/assets/{id}/stargazers

GET

Summary

Find users that stars an asset

Description

Returns a list of users that stars an asset

Parameters

Name	Located in	Description	Required	Schema
id	path		Yes	string
size	query		No	long
offset	query		No	long

Responses

Code	Description	Schema
200	A successful response.	GetAssetStargazersResponse
400	Returned when the data that user input is wrong.	Status
404	Returned when the resource does not exist.	Status
409	Returned when the resource already exist.	Status
500	Returned when theres is something wrong on the server side.	Status
default	An unexpected error response.	Status

/v1beta1/assets/{id}/versions

GET

Summary

Get version history of an asset

Description

Returns a list of asset version history

Parameters

Name	Located in	Description	Required	Schema
id	path		Yes	string
size	query		No	long
offset	query		No	long

Responses

Code	Description	Schema
200	A successful response.	GetAssetVersionHistoryResponse
400	Returned when the data that user input is wrong.	Status
404	Returned when the resource does not exist.	Status
409	Returned when the resource already exist.	Status
500	Returned when theres is something wrong on the server side.	Status
default	An unexpected error response.	Status

/v1beta1/assets/{id}/versions/{version}

GET

Summary

Get asset's previous version

Description

Returns a specific version of an asset

Parameters

Name	Located in	Description	Required	Schema
id	path		Yes	string
version	path		Yes	string

Responses

Code	Description	Schema
200	A successful response.	GetAssetByVersionResponse
400	Returned when the data that user input is wrong.	Status
404	Returned when the resource does not exist.	Status
409	Returned when the resource already exist.	Status
500	Returned when theres is something wrong on the server side.	Status
default	An unexpected error response.	Status

/v1beta1/lineage/{urn}

GET

Summary

Get Lineage Graph

Description

Returns the lineage graph. Each entry in the graph describes a (edge) directed relation of assets with source and destination using it's urn, type, and service. Optionally the response can include node attributes (latest probe info) when requested.

Parameters

Name	Located in	Description	Required	Schema
urn	path		Yes	string
level	query		No	long
direction	query		No	string
with_attributes	query	include node attributes (latest probes)	No	boolean

Responses

Code	Description	Schema
200	A successful response.	GetGraphResponse
400	Returned when the data that user input is wrong.	Status
404	Returned when the resource does not exist.	Status
409	Returned when the resource already exist.	Status
500	Returned when theres is something wrong on the server side.	Status
default	An unexpected error response.	Status

/v1beta1/search

GET

Summary

Search for an asset

Description

API for querying documents. 'text' is fuzzy matched against all the available datasets, and matched results are returned. You can specify additional match criteria using 'filter[.*]' query parameters. You can specify each filter multiple times to specify a set of values for those filters. As an alternative, this API also supports fuzzy filter match with 'query' query params. For instance, searching assets that has 'bigqu' term in its description /search/?text=<text>&query[description]=bigqu

Parameters

Name	Located in	Description	Required	Schema
text	query	text to search for (fuzzy)	No	string
rankby	query	descendingly sort based on a numeric field in the asset, or a comma-separated list of field,value pairs to boost exact matches (see note below)	No	string
size	query	number of results to return	No	long
include_fields	query		No	[ string ]
offset	query	offset parameter defines the offset from the first result you want to fetch	No	long
flags.enable_highlight	query	enable highlight in results	No	boolean
flags.disable_fuzzy	query	disable fuzzy matching	No	boolean
flags.is_column_search	query	enable column-level search	No	boolean

RankBy behavior

• Single-field numeric mode: when rankby is a single field name (for example rankby=data.profile.usage_count), the search uses a numeric field_value_factor on that field to boost results with larger values. This behaves like a numeric ranking signal (weight applied).
• Pair-value mode (field,value pairs): when rankby contains commas, it is interpreted as a sequence of field,value pairs (e.g. rankby=data.attributes.category,ssot or multiple pairs rankby=field1,val1,field2,val2). For each pair the search adds a boolean term condition (on the .keyword form of the field) as a scoring function. Documents where field == value receive a score boost — effectively prioritizing exact matches for those pairs.

Examples:

• rankby=data.profile.usage_count — rank higher results with larger data.profile.usage_count.
• rankby=data.attributes.category,ssot — boost documents where data.attributes.category == "ssot".
• rankby=type,table,service,analytics — boost documents that match type == "table" and/or service == "analytics".

Implementation notes (how scores are combined):

• If search text and the query field (e.g. name) are present, an exact term match is added with a large weight (strong priority for exact matches).
• Pair-value matches are added as weighted functions (smaller weight than exact-match) to prefer documents that satisfy the provided pairs.
• When rankby is a numeric field, a field_value_factor is used with a weighting multiplier so higher numeric values push documents up the ranking.

Responses

Code	Description	Schema
200	A successful response.	SearchAssetsResponse
400	Returned when the data that user input is wrong.	Status
404	Returned when the resource does not exist.	Status
409	Returned when the resource already exist.	Status
500	Returned when theres is something wrong on the server side.	Status
default	An unexpected error response.	Status

/v1beta1/search/suggest

GET

Summary

Suggest an asset

Description

Return a list of suggested asset names that match the provided text. The request requires text to be non-empty; the server returns a 400 error when text is empty.

Parameters

Name	Located in	Description	Required	Schema
text	query	text to search for suggestions	Yes	string

Responses

Code	Description	Schema
200	A successful response.	SuggestAssetsResponse
400	Returned when the data that user input is wrong.	Status
500	Returned when theres is something wrong on the server side.	Status
default	An unexpected error response.	Status

Discussions & Comments

/v1beta1/discussions

GET

Summary

Get all discussions

Parameters

Name	Located in	Description	Required	Schema
type	query		No	string
state	query		No	string
owner	query		No	string
assignee	query		No	string
asset	query		No	string
labels	query		No	string
sort	query		No	string
direction	query		No	string
size	query		No	long
offset	query		No	long

Responses

Code	Description	Schema
200	A successful response.	GetAllDiscussionsResponse
400	Returned when the data that user input is wrong.	Status
404	Returned when the resource does not exist.	Status
409	Returned when the resource already exist.	Status
500	Returned when theres is something wrong on the server side.	Status
default	An unexpected error response.	Status

POST

Summary

Create a discussion

Parameters

Name	Located in	Description	Required	Schema
body	body	Request to be sent to create a discussion	Yes	CreateDiscussionRequest

Responses

Code	Description	Schema
200	A successful response.	CreateDiscussionResponse
400	Returned when the data that user input is wrong.	Status
404	Returned when the resource does not exist.	Status
409	Returned when the resource already exist.	Status
500	Returned when theres is something wrong on the server side.	Status
default	An unexpected error response.	Status

/v1beta1/discussions/{id}

GET

Summary

Get a discussion

Parameters

Name	Located in	Description	Required	Schema
id	path		Yes	string

Responses

Code	Description	Schema
200	A successful response.	GetDiscussionResponse
400	Returned when the data that user input is wrong.	Status
404	Returned when the resource does not exist.	Status
409	Returned when the resource already exist.	Status
500	Returned when theres is something wrong on the server side.	Status
default	An unexpected error response.	Status

PATCH

Summary

Patch a discussion

Parameters

Name	Located in	Description	Required	Schema
id	path		Yes	string
body	body		Yes	{ "assets": [ string ], "assignees": [ string ], "body": string, "labels": [ string ], "state": string, "title": string, "type": string }

Responses

Code	Description	Schema
200	A successful response.	PatchDiscussionResponse
400	Returned when the data that user input is wrong.	Status
404	Returned when the resource does not exist.	Status
409	Returned when the resource already exist.	Status
500	Returned when theres is something wrong on the server side.	Status
default	An unexpected error response.	Status

/v1beta1/discussions/{discussion_id}/comments

GET

Summary

Get all comments of a discussion

Parameters

Name	Located in	Description	Required	Schema
discussion_id	path		Yes	string
sort	query		No	string
direction	query		No	string
size	query		No	long
offset	query		No	long

Responses

Code	Description	Schema
200	A successful response.	GetAllCommentsResponse
400	Returned when the data that user input is wrong.	Status
404	Returned when the resource does not exist.	Status
409	Returned when the resource already exist.	Status
500	Returned when theres is something wrong on the server side.	Status
default	An unexpected error response.	Status

POST

Summary

Create a comment of a discussion

Parameters

Name	Located in	Description	Required	Schema
discussion_id	path		Yes	string
body	body		Yes	{ "body": string }

Responses

Code	Description	Schema
200	A successful response.	CreateCommentResponse
400	Returned when the data that user input is wrong.	Status
404	Returned when the resource does not exist.	Status
409	Returned when the resource already exist.	Status
500	Returned when theres is something wrong on the server side.	Status
default	An unexpected error response.	Status

/v1beta1/discussions/{discussion_id}/comments/{id}

GET

Summary

Get a comment of a discussion

Parameters

Name	Located in	Description	Required	Schema
discussion_id	path		Yes	string
id	path		Yes	string

Responses

Code	Description	Schema
200	A successful response.	GetCommentResponse
400	Returned when the data that user input is wrong.	Status
404	Returned when the resource does not exist.	Status
409	Returned when the resource already exist.	Status
500	Returned when theres is something wrong on the server side.	Status
default	An unexpected error response.	Status

DELETE

Summary

Delete a comment of a discussion

Parameters

Name	Located in	Description	Required	Schema
discussion_id	path		Yes	string
id	path		Yes	string

Responses

Code	Description	Schema
200	A successful response.	DeleteCommentResponse
400	Returned when the data that user input is wrong.	Status
404	Returned when the resource does not exist.	Status
409	Returned when the resource already exist.	Status
500	Returned when theres is something wrong on the server side.	Status
default	An unexpected error response.	Status

PUT

Summary

Update a comment of a discussion

Parameters

Name	Located in	Description	Required	Schema
discussion_id	path		Yes	string
id	path		Yes	string
body	body		Yes	{ "body": string }

Responses

Code	Description	Schema
200	A successful response.	UpdateCommentResponse
400	Returned when the data that user input is wrong.	Status
404	Returned when the resource does not exist.	Status
409	Returned when the resource already exist.	Status
500	Returned when theres is something wrong on the server side.	Status
default	An unexpected error response.	Status

Me & Stars

/v1beta1/me/discussions

GET

Summary

Get all discussions of a user

Description

Returns all discussions given possible filters of a user

Parameters

Name	Located in	Description	Required	Schema
filter	query		No	string
type	query		No	string
state	query		No	string
asset	query		No	string
labels	query		No	string
sort	query		No	string
direction	query		No	string
size	query		No	long
offset	query		No	long

Responses

Code	Description	Schema
200	A successful response.	GetMyDiscussionsResponse
400	Returned when the data that user input is wrong.	Status
404	Returned when the resource does not exist.	Status
409	Returned when the resource already exist.	Status
500	Returned when theres is something wrong on the server side.	Status
default	An unexpected error response.	Status

/v1beta1/me/starred

GET

Summary

Get my starred assets

Description

Get all assets starred by the authenticated user

Parameters

Name	Located in	Description	Required	Schema
size	query		No	long
offset	query		No	long

Responses

Code	Description	Schema
200	A successful response.	GetMyStarredAssetsResponse
400	Returned when the data that user input is wrong.	Status
404	Returned when the resource does not exist.	Status
409	Returned when the resource already exist.	Status
500	Returned when theres is something wrong on the server side.	Status
default	An unexpected error response.	Status

/v1beta1/me/starred/{asset_id}

GET

Summary

Get my starred asset

Description

Get an asset starred by the authenticated user

Parameters

Name	Located in	Description	Required	Schema
asset_id	path		Yes	string

Responses

Code	Description	Schema
200	A successful response.	GetMyStarredAssetResponse
400	Returned when the data that user input is wrong.	Status
404	Returned when the resource does not exist.	Status
409	Returned when the resource already exist.	Status
500	Returned when theres is something wrong on the server side.	Status
default	An unexpected error response.	Status

DELETE

Summary

Unstar an asset

Description

Unmark a starred asset for the authenticated user

Parameters

Name	Located in	Description	Required	Schema
asset_id	path		Yes	string

Responses

Code	Description	Schema
200	A successful response.	UnstarAssetResponse
400	Returned when the data that user input is wrong.	Status
404	Returned when the resource does not exist.	Status
409	Returned when the resource already exist.	Status
500	Returned when theres is something wrong on the server side.	Status
default	An unexpected error response.	Status

PUT

Summary

Star an asset

Description

Mark an asset with a star for the authenticated user

Parameters

Name	Located in	Description	Required	Schema
asset_id	path		Yes	string

Responses

Code	Description	Schema
200	A successful response.	StarAssetResponse
400	Returned when the data that user input is wrong.	Status
404	Returned when the resource does not exist.	Status
409	Returned when the resource already exist.	Status
500	Returned when theres is something wrong on the server side.	Status
default	An unexpected error response.	Status

/v1beta1/users/{user_id}/starred

GET

Summary

Get assets starred by a user

Description

Get all assets starred by a (specified) user

Parameters

Name	Located in	Description	Required	Schema
user_id	path		Yes	string
size	query		No	long
offset	query		No	long

Responses

Code	Description	Schema
200	A successful response.	GetUserStarredAssetsResponse
400	Returned when the data that user input is wrong.	Status
404	Returned when the resource does not exist.	Status
409	Returned when the resource already exist.	Status
500	Returned when theres is something wrong on the server side.	Status
default	An unexpected error response.	Status

Tags

/v1beta1/tags/assets

POST

Summary

Tag an asset

Description

Tag an asset with a tag template

Parameters

Name	Located in	Description	Required	Schema
body	body	Request to be sent to create a tag	Yes	CreateTagAssetRequest

Responses

Code	Description	Schema
200	A successful response.	CreateTagAssetResponse
400	Returned when the data that user input is wrong.	Status
404	Returned when the resource does not exist.	Status
409	Returned when the resource already exist.	Status
500	Returned when theres is something wrong on the server side.	Status
default	An unexpected error response.	Status

/v1beta1/tags/assets/{asset_id}

GET

Summary

Get an asset's tags

Description

Get all tags for an asset

Parameters

Name	Located in	Description	Required	Schema
asset_id	path		Yes	string

Responses

Code	Description	Schema
200	A successful response.	GetAllTagsByAssetResponse
400	Returned when the data that user input is wrong.	Status
404	Returned when the resource does not exist.	Status
409	Returned when the resource already exist.	Status
500	Returned when theres is something wrong on the server side.	Status
default	An unexpected error response.	Status

/v1beta1/tags/assets/{asset_id}/templates/{template_urn}

GET

Summary

Find a tag by asset and template

Description

Find a single tag using asset id and template urn

Parameters

Name	Located in	Description	Required	Schema
asset_id	path		Yes	string
template_urn	path		Yes	string

Responses

Code	Description	Schema
200	A successful response.	GetTagByAssetAndTemplateResponse
400	Returned when the data that user input is wrong.	Status
404	Returned when the resource does not exist.	Status
409	Returned when the resource already exist.	Status
500	Returned when theres is something wrong on the server side.	Status
default	An unexpected error response.	Status

DELETE

Summary

Remove a tag on an asset

Description

Remove a tag on an asset in a type

Parameters

Name	Located in	Description	Required	Schema
asset_id	path		Yes	string
template_urn	path		Yes	string

Responses

Code	Description	Schema
200	A successful response.	DeleteTagAssetResponse
400	Returned when the data that user input is wrong.	Status
404	Returned when the resource does not exist.	Status
409	Returned when the resource already exist.	Status
500	Returned when theres is something wrong on the server side.	Status
default	An unexpected error response.	Status

PUT

Summary

Update a tag on an asset

Description

Update a tag on an asset

Parameters

Name	Located in	Description	Required	Schema
asset_id	path		Yes	string
template_urn	path		Yes	string
body	body		Yes	{ "tag_values": [ TagValue ], "template_description": string, "template_display_name": string }

Responses

Code	Description	Schema
200	A successful response.	UpdateTagAssetResponse
400	Returned when the data that user input is wrong.	Status
404	Returned when the resource does not exist.	Status
409	Returned when the resource already exist.	Status
500	Returned when theres is something wrong on the server side.	Status
default	An unexpected error response.	Status

/v1beta1/tags/templates

GET

Summary

Get all tag templates

Description

Get all available tag templates

Parameters

Name	Located in	Description	Required	Schema
urn	query		No	string

Responses

Code	Description	Schema
200	A successful response.	GetAllTagTemplatesResponse
400	Returned when the data that user input is wrong.	Status
404	Returned when the resource does not exist.	Status
409	Returned when the resource already exist.	Status
500	Returned when theres is something wrong on the server side.	Status
default	An unexpected error response.	Status

POST

Summary

Create a template

Description

Create a new tag template

Parameters

Name	Located in	Description	Required	Schema
body	body	Request to be sent to create a tag's template	Yes	CreateTagTemplateRequest

Responses

Code	Description	Schema
200	A successful response.	CreateTagTemplateResponse
400	Returned when the data that user input is wrong.	Status
404	Returned when the resource does not exist.	Status
409	Returned when the resource already exist.	Status
500	Returned when theres is something wrong on the server side.	Status
default	An unexpected error response.	Status

/v1beta1/tags/templates/{template_urn}

GET

Summary

Get a tag template

Description

Get a single tag template

Parameters

Name	Located in	Description	Required	Schema
template_urn	path		Yes	string

Responses

Code	Description	Schema
200	A successful response.	GetTagTemplateResponse
400	Returned when the data that user input is wrong.	Status
404	Returned when the resource does not exist.	Status
409	Returned when the resource already exist.	Status
500	Returned when theres is something wrong on the server side.	Status
default	An unexpected error response.	Status

DELETE

Summary

Delete a tag template

Description

Delete a single tag template

Parameters

Name	Located in	Description	Required	Schema
template_urn	path		Yes	string

Responses

Code	Description	Schema
200	A successful response.	DeleteTagTemplateResponse
400	Returned when the data that user input is wrong.	Status
404	Returned when the resource does not exist.	Status
409	Returned when the resource already exist.	Status
500	Returned when theres is something wrong on the server side.	Status
default	An unexpected error response.	Status

PUT

Summary

Update a template

Description

Update an existing tag template

Parameters

Name	Located in	Description	Required	Schema
template_urn	path		Yes	string
body	body		Yes	{ "description": string, "display_name": string, "fields": [ TagTemplateField ] }

Responses

Code	Description	Schema
200	A successful response.	UpdateTagTemplateResponse
400	Returned when the data that user input is wrong.	Status
404	Returned when the resource does not exist.	Status
409	Returned when the resource already exist.	Status
500	Returned when theres is something wrong on the server side.	Status
default	An unexpected error response.	Status

Types

/v1beta1/types

GET

Summary

fetch all types

Description

Fetch all types supported in Compass

Parameters

Name	Located in	Description	Required	Schema
q	query	filter by specific query	No	string
q_fields	query	filter by multiple query fields	No	string
types	query	filter by multiple types	No	string
services	query	filter by multiple services	No	string

Responses

Code	Description	Schema
200	A successful response.	GetAllTypesResponse
400	Returned when the data that user input is wrong.	Status
404	Returned when the resource does not exist.	Status
409	Returned when the resource already exist.	Status
500	Returned when theres is something wrong on the server side.	Status
default	An unexpected error response.	Status

Models

Any

Name	Type	Description	Required
@type	string		No

Change

Name	Type	Description	Required
from			No
path	[ string ]		No
to			No
type	string		No

Comment

Name	Type	Description	Required
body	string		No
created_at	dateTime		No
discussion_id	string		No
id	string		No
owner	User		No
updated_at	dateTime		No
updated_by	User		No

CreateAssetProbeRequest.Probe

Name	Type	Description	Required
metadata	object		No
status	string		Yes
status_reason	string		No
timestamp	dateTime		No

CreateAssetProbeResponse

Name	Type	Description	Required
id	string		No

CreateCommentResponse

Name	Type	Description	Required
id	string		No

CreateDiscussionRequest

Request to be sent to create a discussion

Name	Type	Description	Required
assets	[ string ]		No
assignees	[ string ]		No
body	string		Yes
labels	[ string ]		No
state	string		No
title	string		Yes
type	string		No

CreateDiscussionResponse

Name	Type	Description	Required
id	string		No

CreateTagAssetRequest

Request to be sent to create a tag

Name	Type	Description	Required
asset_id	string		Yes
tag_values	[ TagValue ]		Yes
template_description	string		No
template_display_name	string		No
template_urn	string		Yes

CreateTagAssetResponse

Name	Type	Description	Required
data	v1beta1.Tag		No

CreateTagTemplateRequest

Request to be sent to create a tag's template

Name	Type	Description	Required
description	string		Yes
display_name	string		Yes
fields	[ TagTemplateField ]		No
urn	string		Yes

CreateTagTemplateResponse

Name	Type	Description	Required
data	TagTemplate		No

DeleteAssetResponse

Name	Type	Description	Required
DeleteAssetResponse	object

DeleteAssetsResponse

Name	Type	Description
affected_rows	integer	the numbers of assets that match the given query

DeleteCommentResponse

Name	Type	Description	Required
DeleteCommentResponse	object

DeleteTagAssetResponse

Name	Type	Description	Required
DeleteTagAssetResponse	object

DeleteTagTemplateResponse

Name	Type	Description	Required
DeleteTagTemplateResponse	object

Discussion

Name	Type	Description	Required
assets	[ string ]		No
assignees	[ string ]		No
body	string		No
created_at	dateTime		No
id	string		No
labels	[ string ]		No
owner	User		No
state	string		No
title	string		No
type	string		No
updated_at	dateTime		No

GetAllAssetsResponse

Name	Type	Description	Required
data	[ v1beta1.Asset ]		No
total	long		No

GetAllCommentsResponse

Name	Type	Description	Required
data	[ Comment ]		No

GetAllDiscussionsResponse

Name	Type	Description	Required
data	[ Discussion ]		No

GetAllTagTemplatesResponse

Name	Type	Description	Required
data	[ TagTemplate ]		No

GetAllTagsByAssetResponse

Name	Type	Description	Required
data	[ v1beta1.Tag ]		No

GetAllTypesResponse

Name	Type	Description	Required
data	[ v1beta1.Type ]		No

GetAssetByIDResponse

Name	Type	Description	Required
data	v1beta1.Asset		No

GetAssetByVersionResponse

Name	Type	Description	Required
data	v1beta1.Asset		No

GetAssetStargazersResponse

Name	Type	Description	Required
data	[ User ]		No

GetAssetVersionHistoryResponse

Name	Type	Description	Required
data	[ v1beta1.Asset ]		No

GetCommentResponse

Name	Type	Description	Required
data	Comment		No

GetDiscussionResponse

Name	Type	Description	Required
data	Discussion		No

GetGraphResponse

Name	Type	Description	Required
data	[ LineageEdge ]	Edges in the graph.	No
node_attrs	object	Key is the asset URN. Node attributes, if present, will be returned for source and target nodes in the LineageEdge.	No

GetMyDiscussionsResponse

Name	Type	Description	Required
data	[ Discussion ]		No

GetMyStarredAssetResponse

Name	Type	Description	Required
data	v1beta1.Asset		No

GetMyStarredAssetsResponse

Name	Type	Description	Required
data	[ v1beta1.Asset ]		No

GetTagByAssetAndTemplateResponse

Name	Type	Description	Required
data	v1beta1.Tag		No

GetTagTemplateResponse

Name	Type	Description	Required
data	TagTemplate		No

GetUserStarredAssetsResponse

Name	Type	Description	Required
data	[ v1beta1.Asset ]		No

LineageEdge

Name	Type	Description	Required
prop	object		No
source	string		No
target	string		No

LineageNode

Name	Type	Description	Required
service	string		No
type	string		No
urn	string		No

NodeAttributes

Name	Type	Description	Required
probes	ProbesInfo		No

NullValue

NullValue is a singleton enumeration to represent the null value for the Value type union.

The JSON representation for NullValue is JSON null.

• NULL_VALUE: Null value.

Name	Type	Description	Required
NullValue	string	NullValue is a singleton enumeration to represent the null value for the Value type union. The JSON representation for NullValue is JSON null. - NULL_VALUE: Null value.

PatchDiscussionResponse

Name	Type	Description	Required
PatchDiscussionResponse	object

ProbesInfo

Name	Type	Description	Required
latest	v1beta1.Probe		No

SearchAssetsResponse

Name	Type	Description	Required
data	[ v1beta1.Asset ]		No

StarAssetResponse

Name	Type	Description	Required
id	string		No

Status

Name	Type	Description	Required
code	integer		No
details	[ Any ]		No
message	string		No

SuggestAssetsResponse

Name	Type	Description	Required
data	[ string ]		No

TagTemplate

Name	Type	Description	Required
created_at	dateTime		No
description	string		No
display_name	string		No
fields	[ TagTemplateField ]		No
updated_at	dateTime		No
urn	string		No

TagTemplateField

Name	Type	Description	Required
created_at	dateTime		No
data_type	string		No
description	string		No
display_name	string		No
id	long		No
options	[ string ]		No
required	boolean		No
updated_at	dateTime		No
urn	string		No

TagValue

Name	Type	Description	Required
created_at	dateTime		No
field_data_type	string		No
field_description	string		No
field_display_name	string		No
field_id	long		No
field_options	[ string ]		No
field_required	boolean		No
field_urn	string		No
field_value			No
updated_at	dateTime		No

UnstarAssetResponse

Name	Type	Description	Required
UnstarAssetResponse	object

UpdateCommentResponse

Name	Type	Description	Required
UpdateCommentResponse	object

UpdateTagAssetResponse

Name	Type	Description	Required
data	v1beta1.Tag		No

UpdateTagTemplateResponse

Name	Type	Description	Required
data	TagTemplate		No

UpsertAssetRequest

Name	Type	Description	Required
asset	UpsertAssetRequest.Asset		No
downstreams	[ LineageNode ]		No
upstreams	[ LineageNode ]		No

UpsertAssetRequest.Asset

Name	Type	Description	Required
data	object	dynamic data of an asset	No
description	string		No
labels	object	labels of an asset	No
name	string		No
owners	[ User ]	list of owners of the asset	No
service	string		No
type	string		No
url	string		No
urn	string		No

UpsertAssetResponse

Name	Type	Description	Required
id	string		No

UpsertPatchAssetRequest

Name	Type	Description	Required
asset	UpsertPatchAssetRequest.Asset		No
downstreams	[ LineageNode ]		No
overwrite_lineage	boolean	overwrite_lineage determines whether the asset's lineage should be overwritten with the upstreams and downstreams specified in the request. Currently, it is only applicable when both upstreams and downstreams are empty/not specified.	No
upstreams	[ LineageNode ]		No

UpsertPatchAssetRequest.Asset

Name	Type	Description	Required
data	object	dynamic data of an asset	No
description	string	description of an asset	No
labels	object	labels of an asset	No
name	string	name of an asset	No
owners	[ User ]	list of owners of the asset	No
service	string		No
type	string		No
url	string		No
urn	string		No

UpsertPatchAssetResponse

Name	Type	Description	Required
id	string		No

User

Name	Type	Description	Required
created_at	dateTime		No
email	string		No
id	string		No
provider	string		No
updated_at	dateTime		No
uuid	string		No

v1beta1.Asset

Name	Type	Description	Required
changelog	[ Change ]		No
created_at	dateTime		No
data	object		No
description	string		No
id	string		No
labels	object		No
name	string		No
owners	[ User ]		No
probes	[ v1beta1.Probe ]		No
service	string		No
type	string		No
updated_at	dateTime		No
updated_by	User		No
url	string		No
urn	string		No
version	string		No

v1beta1.Probe

Name	Type	Description	Required
asset_urn	string		No
created_at	dateTime		No
id	string		No
metadata	object		No
status	string		No
status_reason	string		No
timestamp	dateTime		No

v1beta1.Tag

Name	Type	Description	Required
asset_id	string		No
tag_values	[ TagValue ]		No
template_description	string		No
template_display_name	string		No
template_urn	string		No

v1beta1.Type

Name	Type	Description	Required
count	long		No
name	string		No