Input objects

AcceptRoleInput

Input provided when accepting a DataHub role using an invite token

Arguments

Name	Description
inviteToken String!	The token needed to accept the role

ActorFilterInput

Input required when creating or updating an Access Policies Determines which actors the Policy applies to

Arguments

Name	Description
users [String!]	A disjunctive set of users to apply the policy to
groups [String!]	A disjunctive set of groups to apply the policy to
resourceOwners Boolean!	Whether the filter should return TRUE for owners of a particular resource Only applies to policies of type METADATA, which have a resource associated with them
resourceOwnersTypes [String!]	Set of OwnershipTypes to apply the policy to (if resourceOwners field is set to True)
allUsers Boolean!	Whether the filter should apply to all users
allGroups Boolean!	Whether the filter should apply to all groups

AddGroupMembersInput

Input required to add members to an external DataHub group

Arguments

Name	Description
groupUrn String!	The group to add members to
userUrns [String!]!	The members to add to the group

AddLinkInput

Input provided when adding the association between a Metadata Entity and a Link

Arguments

Name	Description
linkUrl String!	The url of the link to add or remove
label String!	A label to attach to the link
resourceUrn String!	The urn of the resource or entity to attach the link to, for example a dataset urn

AddNativeGroupMembersInput

Input required to add members to a native DataHub group

Arguments

Name	Description
groupUrn String!	The group to add members to
userUrns [String!]!	The members to add to the group

AddOwnerInput

Input provided when adding the association between a Metadata Entity and an user or group owner

Arguments

Name	Description
ownerUrn String!	The primary key of the Owner to add or remove
ownerEntityType OwnerEntityType!	The owner type, either a user or group
type OwnershipType	Deprecated: No longer supported The ownership type for the new owner. If none is provided, then a new NONE will be added. Deprecated - Use ownershipTypeUrn field instead.
ownershipTypeUrn String	The urn of the ownership type entity.
resourceUrn String!	The urn of the resource or entity to attach or remove the owner from, for example a dataset urn

AddOwnersInput

Input provided when adding multiple associations between a Metadata Entity and an user or group owner

Arguments

Name	Description
owners [OwnerInput!]!	The primary key of the Owner to add or remove
resourceUrn String!	The urn of the resource or entity to attach or remove the owner from, for example a dataset urn

AddTagsInput

Input provided when adding tags to an asset

Arguments

Name	Description
tagUrns [String!]!	The primary key of the Tags
resourceUrn String!	The target Metadata Entity to add or remove the Tag to
subResourceType SubResourceType	An optional type of a sub resource to attach the Tag to
subResource String	An optional sub resource identifier to attach the Tag to

AddTermsInput

Input provided when adding Terms to an asset

Arguments

Name	Description
termUrns [String!]!	The primary key of the Glossary Term to add or remove
resourceUrn String!	The target Metadata Entity to add or remove the Glossary Term from
subResourceType SubResourceType	An optional type of a sub resource to attach the Glossary Term to
subResource String	An optional sub resource identifier to attach the Glossary Term to

AggregateAcrossEntitiesInput

Input arguments for a full text search query across entities to get aggregations

Arguments

Name	Description
types [EntityType!]	Entity types to be searched. If this is not provided, all entities will be searched.
query String!	The query string
facets [String]	The list of facets to get aggregations for. If list is empty or null, get aggregations for all facets Sub-aggregations can be specified with the unicode character ␞ (U+241E) as a delimiter between the subtypes. e.g. _entityType␞owners
orFilters [AndFilterInput!]	A list of disjunctive criterion for the filter. (or operation to combine filters)
viewUrn String	Optional - A View to apply when generating results
searchFlags SearchFlags	Flags controlling search options

AndFilterInput

A list of disjunctive criterion for the filter. (or operation to combine filters)

Arguments

Name	Description
and [FacetFilterInput!]	A list of and criteria the filter applies to the query

AspectParams

Params to configure what list of aspects should be fetched by the aspects property

Arguments

Name	Description
autoRenderOnly Boolean	Only fetch auto render aspects

AutoCompleteInput

Input for performing an auto completion query against a single Metadata Entity

Arguments

Name	Description
type EntityType	Entity type to be autocompleted against
query String!	The raw query string
field String	An optional entity field name to autocomplete on
limit Int	The maximum number of autocomplete results to be returned
filters [FacetFilterInput!]	Faceted filters applied to autocomplete results
orFilters [AndFilterInput!]	A list of disjunctive criterion for the filter. (or operation to combine filters)

AutoCompleteMultipleInput

Input for performing an auto completion query against a a set of Metadata Entities

Arguments

Name	Description
types [EntityType!]	Entity types to be autocompleted against Optional, if none supplied, all searchable types will be autocompleted against
query String!	The raw query string
field String	An optional field to autocomplete against
limit Int	The maximum number of autocomplete results
filters [FacetFilterInput!]	Faceted filters applied to autocomplete results
orFilters [AndFilterInput!]	A list of disjunctive criterion for the filter. (or operation to combine filters)
viewUrn String	Optional - A View to apply when generating results

BatchAddOwnersInput

Input provided when adding owners to a batch of assets

Arguments

Name	Description
owners [OwnerInput!]!	The primary key of the owners
ownershipTypeUrn String	The ownership type to remove, optional. By default will remove regardless of ownership type.
resources [ResourceRefInput]!	The target assets to attach the owners to

BatchAddTagsInput

Input provided when adding tags to a batch of assets

Arguments

Name	Description
tagUrns [String!]!	The primary key of the Tags
resources [ResourceRefInput!]!	The target assets to attach the tags to

BatchAddTermsInput

Input provided when adding glossary terms to a batch of assets

Arguments

Name	Description
termUrns [String!]!	The primary key of the Glossary Terms
resources [ResourceRefInput]!	The target assets to attach the glossary terms to

BatchAssignRoleInput

Input provided when batch assigning a role to a list of users

Arguments

Name	Description
roleUrn String	The urn of the role to assign to the actors. If undefined, will remove the role.
actors [String!]!	The urns of the actors to assign the role to

BatchDatasetUpdateInput

Arguments provided to batch update Dataset entities

Arguments

Name	Description
urn String!	Primary key of the Dataset to which the update will be applied
update DatasetUpdateInput!	Arguments provided to update the Dataset

BatchGetStepStatesInput

Input arguments required for fetching step states

Arguments

Name	Description
ids [String!]!	The unique ids for the steps to retrieve

BatchRemoveOwnersInput

Input provided when removing owners from a batch of assets

Arguments

Name	Description
ownerUrns [String!]!	The primary key of the owners
ownershipTypeUrn String	The ownership type to remove, optional. By default will remove regardless of ownership type.
resources [ResourceRefInput]!	The target assets to remove the owners from

BatchRemoveTagsInput

Input provided when removing tags from a batch of assets

Arguments

Name	Description
tagUrns [String!]!	The primary key of the Tags
resources [ResourceRefInput]!	The target assets to remove the tags from

BatchRemoveTermsInput

Input provided when removing glossary terms from a batch of assets

Arguments

Name	Description
termUrns [String!]!	The primary key of the Glossary Terms
resources [ResourceRefInput]!	The target assets to remove the glossary terms from

BatchSetDataProductInput

Input properties required for batch setting a DataProduct on other entities

Arguments

Name	Description
dataProductUrn String	The urn of the data product you are setting on a group of resources. If this is null, the Data Product will be unset for the given resources.
resourceUrns [String!]!	The urns of the entities the given data product should be set on

BatchSetDomainInput

Input provided when adding tags to a batch of assets

Arguments

Name	Description
domainUrn String	The primary key of the Domain, or null if the domain will be unset
resources [ResourceRefInput!]!	The target assets to attach the Domain

BatchUpdateDeprecationInput

Input provided when updating the deprecation status for a batch of assets.

Arguments

Name	Description
deprecated Boolean!	Whether the Entity is marked as deprecated.
decommissionTime Long	Optional - The time user plan to decommission this entity
note String	Optional - Additional information about the entity deprecation plan
resources [ResourceRefInput]!	The target assets to attach the tags to

BatchUpdateSoftDeletedInput

Input provided when updating the soft-deleted status for a batch of assets

Arguments

Name	Description
urns [String!]!	The urns of the assets to soft delete
deleted Boolean!	Whether to mark the asset as soft-deleted (hidden)

BatchUpdateStepStatesInput

Input arguments required for updating step states

Arguments

Name	Description
states [StepStateInput!]!	Set of step states. If the id does not exist, it will be created.

BrowseInput

Input required for browse queries

Arguments

Name	Description
type EntityType!	The browse entity type
path [String!]	The browse path
start Int	The starting point of paginated results
count Int	The number of elements included in the results
filters [FacetFilterInput!]	Deprecated: Use `orFilters`- they are more expressive Deprecated in favor of the more expressive orFilters field Facet filters to apply to search results. These will be 'AND'-ed together.
orFilters [AndFilterInput!]	A list of disjunctive criterion for the filter. (or operation to combine filters)

BrowsePathsInput

Inputs for fetching the browse paths for a Metadata Entity

Arguments

Name	Description
type EntityType!	The browse entity type
urn String!	The entity urn

BrowseV2Input

Input required for browse queries

Arguments

Name	Description
type EntityType!	The browse entity type
path [String!]	The browse path V2 - a list with each entry being part of the browse path V2
start Int	The starting point of paginated results
count Int	The number of elements included in the results
orFilters [AndFilterInput!]	A list of disjunctive criterion for the filter. (or operation to combine filters)
viewUrn String	Optional - A View to apply when generating results
query String	The search query string

CancelIngestionExecutionRequestInput

Input for cancelling an execution request input

Arguments

Name	Description
ingestionSourceUrn String!	Urn of the ingestion source
executionRequestUrn String!	Urn of the specific execution request to cancel

ChartEditablePropertiesUpdate

Update to writable Chart fields

Arguments

Name	Description
description String!	Writable description aka documentation for a Chart

ChartUpdateInput

Arguments provided to update a Chart Entity

Arguments

Name	Description
ownership OwnershipUpdate	Update to ownership
globalTags GlobalTagsUpdate	Deprecated, use tags field instead Update to global tags
tags GlobalTagsUpdate	Update to tags
editableProperties ChartEditablePropertiesUpdate	Update to editable properties

ContainerEntitiesInput

Input required to fetch the entities inside of a container.

Arguments

Name	Description
query String	Optional query filter for particular entities inside the container
start Int	The offset of the result set
count Int	The number of entities to include in result set
filters [FacetFilterInput!]	Optional Facet filters to apply to the result set

CorpGroupUpdateInput

Arguments provided to update a CorpGroup Entity

Arguments

Name	Description
description String	DataHub description of the group
slack String	Slack handle for the group
email String	Email address for the group

CorpUserUpdateInput

Arguments provided to update a CorpUser Entity

Arguments

Name	Description
displayName String	Display name to show on DataHub
title String	Title to show on DataHub
aboutMe String	About me section of the user
teams [String!]	Teams that the user belongs to
skills [String!]	Skills that the user possesses
pictureLink String	A URL which points to a picture which user wants to set as a profile photo
slack String	The slack handle of the user
phone String	Phone number for the user
email String	Email address for the user

CreateAccessTokenInput

Arguments

Name	Description
type AccessTokenType!	The type of the Access Token.
actorUrn String!	The actor associated with the Access Token.
duration AccessTokenDuration!	The duration for which the Access Token is valid.
name String!	The name of the token to be generated.
description String	Description of the token if defined.

CreateDataProductInput

Input required for creating a DataProduct.

Arguments

Name	Description
properties CreateDataProductPropertiesInput!	Properties about the Query
domainUrn String!	The primary key of the Domain

CreateDataProductPropertiesInput

Input properties required for creating a DataProduct

Arguments

Name	Description
name String!	A display name for the DataProduct
description String	An optional description for the DataProduct

CreateDomainInput

Input required to create a new Domain.

Arguments

Name	Description
id String	Optional! A custom id to use as the primary key identifier for the domain. If not provided, a random UUID will be generated as the id.
name String!	Display name for the Domain
description String	Optional description for the Domain

CreateGlossaryEntityInput

Input required to create a new Glossary Entity - a Node or a Term.

Arguments

Name	Description
id String	Optional! A custom id to use as the primary key identifier for the domain. If not provided, a random UUID will be generated as the id.
name String!	Display name for the Node or Term
description String	Description for the Node or Term
parentNode String	Optional parent node urn for the Glossary Node or Term

CreateGroupInput

Input for creating a new group

Arguments

Name	Description
id String	Optional! A custom id to use as the primary key identifier for the group. If not provided, a random UUID will be generated as the id.
name String!	The display name of the group
description String	The description of the group

CreateIngestionExecutionRequestInput

Input for creating an execution request input

Arguments

Name	Description
ingestionSourceUrn String!	Urn of the ingestion source to execute

CreateInviteTokenInput

Input provided when creating an invite token

Arguments

Name	Description
roleUrn String	The urn of the role to create the invite token for

CreateNativeUserResetTokenInput

Input required to generate a password reset token for a native user.

Arguments

Name	Description
userUrn String!	The urn of the user to reset the password of

CreateOwnershipTypeInput

Arguments

Name	Description
name String!	The name of the Custom Ownership Type
description String!	The description of the Custom Ownership Type

CreatePostInput

Input provided when creating a Post

Arguments

Name	Description
postType PostType!	The type of post
content UpdatePostContentInput!	The content of the post

CreateQueryInput

Input required for creating a Query. Requires the 'Edit Queries' privilege for all query subjects.

Arguments

Name	Description
properties CreateQueryPropertiesInput!	Properties about the Query
subjects [CreateQuerySubjectInput!]!	Subjects for the query

CreateQueryPropertiesInput

Input properties required for creating a Query

Arguments

Name	Description
name String	An optional display name for the Query
description String	An optional description for the Query
statement QueryStatementInput!	The Query contents

CreateQuerySubjectInput

Input required for creating a Query. For now, only datasets are supported.

Arguments

Name	Description
datasetUrn String!	The urn of the dataset that is the subject of the query

CreateSecretInput

Input arguments for creating a new Secret

Arguments

Name	Description
name String!	The name of the secret for reference in ingestion recipes
value String!	The value of the secret, to be encrypted and stored
description String	An optional description for the secret

CreateTagInput

Input required to create a new Tag

Arguments

Name	Description
id String	Optional! A custom id to use as the primary key identifier for the Tag. If not provided, a random UUID will be generated as the id.
name String!	Display name for the Tag
description String	Optional description for the Tag

CreateTestConnectionRequestInput

Input for creating a test connection request

Arguments

Name	Description
recipe String!	A JSON-encoded recipe
version String	Advanced: The version of the ingestion framework to use

CreateTestInput

Arguments

Name	Description
id String	Advanced: a custom id for the test.
name String!	The name of the Test
category String!	The category of the Test (user defined)
description String	Description of the test
definition TestDefinitionInput!	The test definition

CreateViewInput

Input provided when creating a DataHub View

Arguments

Name	Description
viewType DataHubViewType!	The type of View
name String!	The name of the View
description String	An optional description of the View
definition DataHubViewDefinitionInput!	The view definition itself

DashboardEditablePropertiesUpdate

Update to writable Dashboard fields

Arguments

Name	Description
description String!	Writable description aka documentation for a Dashboard

DashboardUpdateInput

Arguments provided to update a Dashboard Entity

Arguments

Name	Description
ownership OwnershipUpdate	Update to ownership
globalTags GlobalTagsUpdate	Deprecated, use tags field instead Update to global tags
tags GlobalTagsUpdate	Update to tags
editableProperties DashboardEditablePropertiesUpdate	Update to editable properties

DataFlowEditablePropertiesUpdate

Update to writable Data Flow fields

Arguments

Name	Description
description String!	Writable description aka documentation for a Data Flow

DataFlowUpdateInput

Arguments provided to update a Data Flow aka Pipeline Entity

Arguments

Name	Description
ownership OwnershipUpdate	Update to ownership
globalTags GlobalTagsUpdate	Deprecated, use tags field instead Update to global tags
tags GlobalTagsUpdate	Update to tags
editableProperties DataFlowEditablePropertiesUpdate	Update to editable properties

DataHubViewDefinitionInput

Input required for creating a DataHub View Definition

Arguments

Name	Description
entityTypes [EntityType!]!	A set of entity types that the view applies for. If left empty, then ALL entities will be in scope.
filter DataHubViewFilterInput!	A set of filters to apply.

DataHubViewFilterInput

Input required for creating a DataHub View Definition

Arguments

Name	Description
operator LogicalOperator!	The operator used to combine the filters.
filters [FacetFilterInput!]!	A set of filters combined via an operator. If left empty, then no filters will be applied.

DataJobEditablePropertiesUpdate

Update to writable Data Job fields

Arguments

Name	Description
description String!	Writable description aka documentation for a Data Job

DataJobUpdateInput

Arguments provided to update a Data Job aka Task Entity

Arguments

Name	Description
ownership OwnershipUpdate	Update to ownership
globalTags GlobalTagsUpdate	Deprecated, use tags field instead Update to global tags
tags GlobalTagsUpdate	Update to tags
editableProperties DataJobEditablePropertiesUpdate	Update to editable properties

DataProductEntitiesInput

Input required to fetch the entities inside of a Data Product.

Arguments

Name	Description
query String	Optional query filter for particular entities inside the Data Product
start Int	The offset of the result set
count Int	The number of entities to include in result set
filters [FacetFilterInput!]	Optional Facet filters to apply to the result set

DatasetDeprecationUpdate

An update for the deprecation information for a Metadata Entity

Arguments

Name	Description
deprecated Boolean!	Whether the dataset is deprecated
decommissionTime Long	The time user plan to decommission this dataset
note String!	Additional information about the dataset deprecation plan

DatasetEditablePropertiesUpdate

Update to writable Dataset fields

Arguments

Name	Description
description String!	Writable description aka documentation for a Dataset

DatasetUpdateInput

Arguments provided to update a Dataset Entity

Arguments

Name	Description
ownership OwnershipUpdate	Update to ownership
deprecation DatasetDeprecationUpdate	Update to deprecation status
institutionalMemory InstitutionalMemoryUpdate	Update to institutional memory, ie documentation
globalTags GlobalTagsUpdate	Deprecated, use tags field instead Update to global tags
tags GlobalTagsUpdate	Update to tags
editableSchemaMetadata EditableSchemaMetadataUpdate	Update to editable schema metadata of the dataset
editableProperties DatasetEditablePropertiesUpdate	Update to editable properties

DescriptionUpdateInput

Incubating. Updates the description of a resource. Currently supports DatasetField descriptions only

Arguments

Name	Description
description String!	The new description
resourceUrn String!	The primary key of the resource to attach the description to, eg dataset urn
subResourceType SubResourceType	An optional sub resource type
subResource String	A sub resource identifier, eg dataset field path

DomainEntitiesInput

Input required to fetch the entities inside of a Domain.

Arguments

Name	Description
query String	Optional query filter for particular entities inside the domain
start Int	The offset of the result set
count Int	The number of entities to include in result set
filters [FacetFilterInput!]	Optional Facet filters to apply to the result set

EditableSchemaFieldInfoUpdate

Update to writable schema field metadata

Arguments

Name	Description
fieldPath String!	Flattened name of a field identifying the field the editable info is applied to
description String	Edited description of the field
globalTags GlobalTagsUpdate	Tags associated with the field

EditableSchemaMetadataUpdate

Update to editable schema metadata of the dataset

Arguments

Name	Description
editableSchemaFieldInfo [EditableSchemaFieldInfoUpdate!]!	Update to writable schema field metadata

EntityCountInput

Input for the get entity counts endpoint

Arguments

Name	Description
types [EntityType!]

EntityRequestContext

Context that defines an entity page requesting recommendations

Arguments

Name	Description
type EntityType!	Type of the enity being displayed
urn String!	Urn of the entity being displayed

FacetFilterInput

Facet filters to apply to search results

Arguments

Name	Description
field String!	Name of field to filter by
value String	Deprecated: Prefer `values` for single elements Value of the field to filter by. Deprecated in favor of values, which should accept a single element array for a value
values [String!]	Values, one of which the intended field should match.
negated Boolean	If the filter should or should not be matched
condition FilterOperator	Condition for the values. How to If unset, assumed to be equality

FilterInput

A set of filter criteria

Arguments

Name	Description
and [FacetFilterInput!]!	A list of conjunctive filters

GetAccessTokenInput

Input required to fetch a new Access Token.

Arguments

Name	Description
type AccessTokenType!	The type of the Access Token.
actorUrn String!	The actor associated with the Access Token.
duration AccessTokenDuration!	The duration for which the Access Token is valid.

GetGrantedPrivilegesInput

Input for getting granted privileges

Arguments

Name	Description
actorUrn String!	Urn of the actor
resourceSpec ResourceSpec	Spec to identify resource. If empty, gets privileges granted to the actor

GetInviteTokenInput

Input provided when getting an invite token

Arguments

Name	Description
roleUrn String	The urn of the role to get the invite token for

GetQuickFiltersInput

Input for getting Quick Filters

Arguments

Name	Description
viewUrn String	Optional - A View to apply when generating results

GetRootGlossaryEntitiesInput

Input required when getting Business Glossary entities

Arguments

Name	Description
start Int!	The starting offset of the result set returned
count Int!	The number of Glossary Entities in the returned result set

GetSchemaBlameInput

Input for getting schema changes computed at a specific version.

Arguments

Name	Description
datasetUrn String!	The dataset urn
version String	Changes after this version are not shown. If not provided, this is the latestVersion.

GetSchemaVersionListInput

Input for getting list of schema versions.

Arguments

Name	Description
datasetUrn String!	The dataset urn

GetSecretValuesInput

Input arguments for retrieving the plaintext values of a set of secrets

Arguments

Name	Description
secrets [String!]!	A list of secret names

GlobalTagsUpdate

Deprecated, use addTag or removeTag mutation instead Update to the Tags associated with a Metadata Entity

Arguments

Name	Description
tags [TagAssociationUpdate!]	The new set of tags

InstitutionalMemoryMetadataUpdate

An institutional memory to add to a Metadata Entity TODO Add a USER or GROUP actor enum

Arguments

Name	Description
url String!	Link to a document or wiki page or another internal resource
description String	Description of the resource
author String!	The corp user urn of the author of the metadata
createdAt Long	The time at which this metadata was created

InstitutionalMemoryUpdate

An update for the institutional memory information for a Metadata Entity

Arguments

Name	Description
elements [InstitutionalMemoryMetadataUpdate!]!	The individual references in the institutional memory

LineageEdge

Arguments

Name	Description
downstreamUrn String!	Urn of the source entity. This urn is downstream of the destinationUrn.
upstreamUrn String!	Urn of the destination entity. This urn is upstream of the destinationUrn

LineageInput

Input for the list lineage property of an Entity

Arguments

Name	Description
direction LineageDirection!	The direction of the relationship, either incoming or outgoing from the source entity
start Int	The starting offset of the result set
count Int	The number of results to be returned
separateSiblings Boolean	Optional flag to not merge siblings in the response. They are merged by default.
startTimeMillis Long	An optional starting time to filter on
endTimeMillis Long	An optional ending time to filter on

ListAccessTokenInput

Input arguments for listing access tokens

Arguments

Name	Description
start Int	The starting offset of the result set
count Int	The number of results to be returned
filters [FacetFilterInput!]	Facet filters to apply to search results

ListDomainsInput

Input required when listing DataHub Domains

Arguments

Name	Description
start Int	The starting offset of the result set returned
count Int	The maximum number of Domains to be returned in the result set
query String	Optional search query

ListGlobalViewsInput

Input provided when listing DataHub Global Views

Arguments

Name	Description
start Int	The starting offset of the result set returned
count Int	The maximum number of Views to be returned in the result set
query String	Optional search query

ListGroupsInput

Input required when listing DataHub Groups

Arguments

Name	Description
start Int	The starting offset of the result set returned
count Int	The maximum number of Policies to be returned in the result set
query String	Optional search query

ListIngestionSourcesInput

Input arguments for listing Ingestion Sources

Arguments

Name	Description
start Int	The starting offset of the result set
count Int	The number of results to be returned
query String	An optional search query
filters [FacetFilterInput!]	Optional Facet filters to apply to the result set

ListMyViewsInput

Input provided when listing DataHub Views

Arguments

Name	Description
start Int	The starting offset of the result set returned
count Int	The maximum number of Views to be returned in the result set
query String	Optional search query
viewType DataHubViewType	Optional - List the type of View to filter for.

ListOwnershipTypesInput

Input required for listing custom ownership types entities

Arguments

Name	Description
start Int	The starting offset of the result set returned, default is 0
count Int	The maximum number of Custom Ownership Types to be returned in the result set, default is 20
query String	Optional search query
filters [FacetFilterInput!]	Optional Facet filters to apply to the result set

ListPoliciesInput

Input required when listing DataHub Access Policies

Arguments

Name	Description
start Int	The starting offset of the result set returned
count Int	The maximum number of Policies to be returned in the result set
query String	Optional search query

ListPostsInput

Input provided when listing existing posts

Arguments

Name	Description
start Int	The starting offset of the result set returned
count Int	The maximum number of Roles to be returned in the result set
query String	Optional search query

ListQueriesInput

Input required for listing query entities

Arguments

Name	Description
start Int	The starting offset of the result set returned
count Int	The maximum number of Queries to be returned in the result set
query String	A raw search query
source QuerySource	An optional source for the query
datasetUrn String	An optional Urn for the parent dataset that the query is associated with.

ListRecommendationsInput

Input arguments for fetching UI recommendations

Arguments

Name	Description
userUrn String!	Urn of the actor requesting recommendations
requestContext RecommendationRequestContext	Context provider by the caller requesting recommendations
limit Int	Max number of modules to return

ListRolesInput

Input provided when listing existing roles

Arguments

Name	Description
start Int	The starting offset of the result set returned
count Int	The maximum number of Roles to be returned in the result set
query String	Optional search query

ListSecretsInput

Input for listing DataHub Secrets

Arguments

Name	Description
start Int	The starting offset of the result set
count Int	The number of results to be returned
query String	An optional search query

ListTestsInput

Input required when listing DataHub Tests

Arguments

Name	Description
start Int	The starting offset of the result set returned
count Int	The maximum number of Domains to be returned in the result set
query String	Optional query string to match on

ListUsersInput

Input required when listing DataHub Users

Arguments

Name	Description
start Int	The starting offset of the result set returned
count Int	The maximum number of Policies to be returned in the result set
query String	Optional search query

MetadataAnalyticsInput

Input to fetch metadata analytics charts

Arguments

Name	Description
entityType EntityType	Entity type to fetch analytics for (If empty, queries across all entities)
domain String	Urn of the domain to fetch analytics for (If empty or GLOBAL, queries across all domains)
query String	Search query to filter down result (If empty, does not apply any search query)

NotebookEditablePropertiesUpdate

Update to writable Notebook fields

Arguments

Name	Description
description String!	Writable description aka documentation for a Notebook

NotebookUpdateInput

Arguments provided to update a Notebook Entity

Arguments

Name	Description
ownership OwnershipUpdate	Update to ownership
tags GlobalTagsUpdate	Update to tags
editableProperties NotebookEditablePropertiesUpdate	Update to editable properties

OwnerInput

Input provided when adding an owner to an asset

Arguments

Name	Description
ownerUrn String!	The primary key of the Owner to add or remove
ownerEntityType OwnerEntityType!	The owner type, either a user or group
type OwnershipType	Deprecated: No longer supported The ownership type for the new owner. If none is provided, then a new NONE will be added. Deprecated - Use ownershipTypeUrn field instead.
ownershipTypeUrn String	The urn of the ownership type entity.

OwnershipUpdate

An update for the ownership information for a Metadata Entity

Arguments

Name	Description
owners [OwnerUpdate!]!	The updated list of owners

OwnerUpdate

An owner to add to a Metadata Entity TODO Add a USER or GROUP actor enum

Arguments

Name	Description
owner String!	The owner URN, either a corpGroup or corpuser
type OwnershipType	Deprecated: No longer supported The owner type. Deprecated - Use ownershipTypeUrn field instead.
ownershipTypeUrn String	The urn of the ownership type entity.

PolicyMatchCriterionInput

Criterion to define relationship between field and values

Arguments

Name	Description
field String!	The name of the field that the criterion refers to e.g. entity_type, entity_urn, domain
values [String!]!	Values. Matches criterion if any one of the values matches condition (OR-relationship)
condition PolicyMatchCondition!	The name of the field that the criterion refers to

PolicyMatchFilterInput

Filter object that encodes a complex filter logic with OR + AND

Arguments

Name	Description
criteria [PolicyMatchCriterionInput!]	List of criteria to apply

PolicyUpdateInput

Input provided when creating or updating an Access Policy

Arguments

Name	Description
type PolicyType!	The Policy Type
name String!	The Policy name
state PolicyState!	The Policy state
description String	A Policy description
resources ResourceFilterInput	The set of resources that the Policy privileges apply to
privileges [String!]!	The set of privileges that the Policy grants
actors ActorFilterInput!	The set of actors that the Policy privileges are granted to

QueryStatementInput

Input required for creating a Query Statement

Arguments

Name	Description
value String!	The query text
language QueryLanguage!	The query language

RecommendationRequestContext

Context that defines the page requesting recommendations i.e. for search pages, the query/filters. for entity pages, the entity urn and tab

Arguments

Name	Description
scenario ScenarioType!	Scenario in which the recommendations will be displayed
searchRequestContext SearchRequestContext	Additional context for defining the search page requesting recommendations
entityRequestContext EntityRequestContext	Additional context for defining the entity page requesting recommendations

RelatedTermsInput

Input provided when adding Terms to an asset

Arguments

Name	Description
urn String!	The Glossary Term urn to add or remove this relationship to/from
termUrns [String!]!	The primary key of the Glossary Term to add or remove
relationshipType TermRelationshipType!	The type of relationship we're adding or removing to/from for a Glossary Term

RelationshipsInput

Input for the list relationships field of an Entity

Arguments

Name	Description
types [String!]!	The types of relationships to query, representing an OR
direction RelationshipDirection!	The direction of the relationship, either incoming or outgoing from the source entity
start Int	The starting offset of the result set
count Int	The number of results to be returned

RemoveGroupMembersInput

Input required to remove members from an external DataHub group

Arguments

Name	Description
groupUrn String!	The group to remove members from
userUrns [String!]!	The members to remove from the group

RemoveLinkInput

Input provided when removing the association between a Metadata Entity and a Link

Arguments

Name	Description
linkUrl String!	The url of the link to add or remove, which uniquely identifies the Link
resourceUrn String!	The urn of the resource or entity to attach the link to, for example a dataset urn

RemoveNativeGroupMembersInput

Input required to remove members from a native DataHub group

Arguments

Name	Description
groupUrn String!	The group to remove members from
userUrns [String!]!	The members to remove from the group

RemoveOwnerInput

Input provided when removing the association between a Metadata Entity and an user or group owner

Arguments

Name	Description
ownerUrn String!	The primary key of the Owner to add or remove
ownershipTypeUrn String	The ownership type to remove, optional. By default will remove regardless of ownership type.
resourceUrn String!	The urn of the resource or entity to attach or remove the owner from, for example a dataset urn

ReportOperationInput

Input provided to report an asset operation

Arguments

Name	Description
urn String!	The urn of the asset (e.g. dataset) to report the operation for
operationType OperationType!	The type of operation that was performed. Required
customOperationType String	A custom type of operation. Required if operation type is CUSTOM.
sourceType OperationSourceType!	The source or reporter of the operation
customProperties [StringMapEntryInput!]	A list of key-value parameters to include
partition String	An optional partition identifier
numAffectedRows Long	Optional: The number of affected rows
timestampMillis Long	Optional: Provide a timestamp associated with the operation. If not provided, one will be generated for you based on the current time.

ResourceFilterInput

Input required when creating or updating an Access Policies Determines which resources the Policy applies to

Arguments

Name	Description
type String	The type of the resource the policy should apply to Not required because in the future we want to support filtering by type OR by domain
resources [String!]	A list of specific resource urns to apply the filter to
allResources Boolean	Whether of not to apply the filter to all resources of the type
filter PolicyMatchFilterInput	Whether of not to apply the filter to all resources of the type

ResourceRefInput

Reference to a resource to apply an action to

Arguments

Name	Description
resourceUrn String!	The urn of the resource being referenced
subResourceType SubResourceType	An optional type of a sub resource to attach the Tag to
subResource String	An optional sub resource identifier to attach the Tag to

ResourceSpec

Spec to identify resource

Arguments

Name	Description
resourceType EntityType!	Resource type
resourceUrn String!	Resource urn

RollbackIngestionInput

Input for rolling back an ingestion execution

Arguments

Name	Description
runId String!	An ingestion run ID

ScrollAcrossEntitiesInput

Input arguments for a full text search query across entities, specifying a starting pointer. Allows paging beyond 10k results

Arguments

Name	Description
types [EntityType!]	Entity types to be searched. If this is not provided, all entities will be searched.
query String!	The query string
scrollId String	The starting point of paginated results, an opaque ID the backend understands as a pointer
keepAlive String	The amount of time to keep the point in time snapshot alive, takes a time unit based string ex: 5m or 30s
count Int	The number of elements included in the results
orFilters [AndFilterInput!]	A list of disjunctive criterion for the filter. (or operation to combine filters)
viewUrn String	Optional - A View to apply when generating results
searchFlags SearchFlags	Flags controlling search options

ScrollAcrossLineageInput

Input arguments for a search query over the results of a multi-hop graph query, uses scroll API

Arguments

Name	Description
urn String	Urn of the source node
direction LineageDirection!	The direction of the relationship, either incoming or outgoing from the source entity
types [EntityType!]	Entity types to be searched. If this is not provided, all entities will be searched.
query String	The query string
scrollId String	The starting point of paginated results, an opaque ID the backend understands as a pointer
keepAlive String	The amount of time to keep the point in time snapshot alive, takes a time unit based string ex: 5m or 30s
count Int	The number of elements included in the results
orFilters [AndFilterInput!]	A list of disjunctive criterion for the filter. (or operation to combine filters)
startTimeMillis Long	An optional starting time to filter on
endTimeMillis Long	An optional ending time to filter on
searchFlags SearchFlags	Flags controlling search options

SearchAcrossEntitiesInput

Input arguments for a full text search query across entities

Arguments

Name	Description
types [EntityType!]	Entity types to be searched. If this is not provided, all entities will be searched.
query String!	The query string
start Int	The starting point of paginated results
count Int	The number of elements included in the results
filters [FacetFilterInput!]	Deprecated: Use `orFilters`- they are more expressive Deprecated in favor of the more expressive orFilters field Facet filters to apply to search results. These will be 'AND'-ed together.
orFilters [AndFilterInput!]	A list of disjunctive criterion for the filter. (or operation to combine filters)
viewUrn String	Optional - A View to apply when generating results
searchFlags SearchFlags	Flags controlling search options
sortInput SearchSortInput	Optional - Information on how to sort this search result

SearchAcrossLineageInput

Input arguments for a search query over the results of a multi-hop graph query

Arguments

Name	Description
urn String	Urn of the source node
direction LineageDirection!	The direction of the relationship, either incoming or outgoing from the source entity
types [EntityType!]	Entity types to be searched. If this is not provided, all entities will be searched.
query String	The query string
start Int	The starting point of paginated results
count Int	The number of elements included in the results
filters [FacetFilterInput!]	Deprecated: Use `orFilters`- they are more expressive Deprecated in favor of the more expressive orFilters field Facet filters to apply to search results. These will be 'AND'-ed together.
orFilters [AndFilterInput!]	A list of disjunctive criterion for the filter. (or operation to combine filters)
startTimeMillis Long	An optional starting time to filter on
endTimeMillis Long	An optional ending time to filter on
searchFlags SearchFlags	Flags controlling search options

SearchFlags

Set of flags to control search behavior

Arguments

Name	Description
skipCache Boolean	Whether to skip cache
maxAggValues Int	The maximum number of values in an facet aggregation
fulltext Boolean	Structured or unstructured fulltext query
skipHighlighting Boolean	Whether to skip highlighting
skipAggregates Boolean	Whether to skip aggregates/facets

SearchInput

Input arguments for a full text search query

Arguments

Name	Description
type EntityType!	The Metadata Entity type to be searched against
query String!	The raw query string
start Int	The offset of the result set
count Int	The number of entities to include in result set
filters [FacetFilterInput!]	Deprecated: Use `orFilters`- they are more expressive Deprecated in favor of the more expressive orFilters field Facet filters to apply to search results. These will be 'AND'-ed together.
orFilters [AndFilterInput!]	A list of disjunctive criterion for the filter. (or operation to combine filters)
searchFlags SearchFlags	Flags controlling search options

SearchRequestContext

Context that defines a search page requesting recommendatinos

Arguments

Name	Description
query String!	Search query
filters [FacetFilterInput!]	Faceted filters applied to search results

SearchSortInput

Input required in order to sort search results

Arguments

Name	Description
sortCriterion SortCriterion!	A criterion to sort search results on

SortCriterion

A single sorting criterion for sorting search.

Arguments

Name	Description
field String!	A field upon which we'll do sorting on.
sortOrder SortOrder!	The order in which we will be sorting

StepStateInput

The input required to update the state of a step

Arguments

Name	Description
id String!	The globally unique id for the step
properties [StringMapEntryInput]!	The new properties for the step

StringMapEntryInput

String map entry input

Arguments

Name	Description
key String!	The key of the map entry
value String	The value fo the map entry

TagAssociationInput

Input provided when updating the association between a Metadata Entity and a Tag

Arguments

Name	Description
tagUrn String!	The primary key of the Tag to add or remove
resourceUrn String!	The target Metadata Entity to add or remove the Tag to
subResourceType SubResourceType	An optional type of a sub resource to attach the Tag to
subResource String	An optional sub resource identifier to attach the Tag to

TagAssociationUpdate

Deprecated, use addTag or removeTag mutation instead A tag update to be applied

Arguments

Name	Description
tag TagUpdateInput!	The tag being applied

TagUpdateInput

Deprecated, use addTag or removeTag mutations instead An update for a particular Tag entity

Arguments

Name	Description
urn String!	The primary key of the Tag
name String!	The display name of a Tag
description String	Description of the tag
ownership OwnershipUpdate	Ownership metadata of the tag

TermAssociationInput

Input provided when updating the association between a Metadata Entity and a Glossary Term

Arguments

Name	Description
termUrn String!	The primary key of the Glossary Term to add or remove
resourceUrn String!	The target Metadata Entity to add or remove the Glossary Term from
subResourceType SubResourceType	An optional type of a sub resource to attach the Glossary Term to
subResource String	An optional sub resource identifier to attach the Glossary Term to

TestDefinitionInput

Arguments

Name	Description
json String	The string representation of the Test

UpdateCorpUserViewsSettingsInput

Input required to update a users settings.

Arguments

Name	Description
defaultView String	The URN of the View that serves as this user's personal default. If not provided, any existing default view will be removed.

UpdateDataProductInput

Input properties required for update a DataProduct

Arguments

Name	Description
name String	A display name for the DataProduct
description String	An optional description for the DataProduct

UpdateDeprecationInput

Input provided when setting the Deprecation status for an Entity.

Arguments

Name	Description
urn String!	The urn of the Entity to set deprecation for.
deprecated Boolean!	Whether the Entity is marked as deprecated.
decommissionTime Long	Optional - The time user plan to decommission this entity
note String	Optional - Additional information about the entity deprecation plan

UpdateEmbedInput

Input required to set or clear information related to rendering a Data Asset inside of DataHub.

Arguments

Name	Description
urn String!	The URN associated with the Data Asset to update. Only dataset, dashboard, and chart urns are currently supported.
renderUrl String	Set or clear a URL used to render an embedded asset.

UpdateGlobalViewsSettingsInput

Input required to update Global View Settings.

Arguments

Name	Description
defaultView String	The URN of the View that serves as the Global, or organization-wide, default. If this field is not provided, the existing Global Default will be cleared.

UpdateIngestionSourceConfigInput

Input parameters for creating / updating an Ingestion Source

Arguments

Name	Description
recipe String!	A JSON-encoded recipe
version String	The version of DataHub Ingestion Framework to use when executing the recipe.
executorId String!	The id of the executor to use for executing the recipe
debugMode Boolean	Whether or not to run ingestion in debug mode

UpdateIngestionSourceInput

Input arguments for creating / updating an Ingestion Source

Arguments

Name	Description
name String!	A name associated with the ingestion source
type String!	The type of the source itself, e.g. mysql, bigquery, bigquery-usage. Should match the recipe.
description String	An optional description associated with the ingestion source
schedule UpdateIngestionSourceScheduleInput	An optional schedule for the ingestion source. If not provided, the source is only available for run on-demand.
config UpdateIngestionSourceConfigInput!	A set of type-specific ingestion source configurations

UpdateIngestionSourceScheduleInput

Input arguments for creating / updating the schedule of an Ingestion Source

Arguments

Name	Description
interval String!	The cron-formatted interval describing when the job should be executed
timezone String!	The name of the timezone in which the cron interval should be scheduled (e.g. America/Los Angeles)

UpdateLineageInput

Input required in order to upsert lineage edges

Arguments

Name	Description
edgesToAdd [LineageEdge]!	New lineage edges to upsert
edgesToRemove [LineageEdge]!	Lineage edges to remove. Takes precedence over edgesToAdd - so edges existing both edgesToAdd and edgesToRemove will be removed.

UpdateMediaInput

Input provided for filling in a post content

Arguments

Name	Description
type MediaType!	The type of media
location String!	The location of the media (a URL)

UpdateNameInput

Input for updating the name of an entity

Arguments

Name	Description
name String!	The new name
urn String!	The primary key of the resource to update the name for

UpdateOwnershipTypeInput

Arguments

Name	Description
name String	The name of the Custom Ownership Type
description String	The description of the Custom Ownership Type

UpdateParentNodeInput

Input for updating the parent node of a resource. Currently only GlossaryNodes and GlossaryTerms have parentNodes.

Arguments

Name	Description
parentNode String	The new parent node urn. If parentNode is null, this will remove the parent from this entity
resourceUrn String!	The primary key of the resource to update the parent node for

UpdatePostContentInput

Input provided for filling in a post content

Arguments

Name	Description
contentType PostContentType!	The type of post content
title String!	The title of the post
description String	Optional content of the post
link String	Optional link that the post is associated with
media UpdateMediaInput	Optional media contained in the post

UpdateQueryInput

Input required for updating an existing Query. Requires the 'Edit Queries' privilege for all query subjects.

Arguments

Name	Description
properties UpdateQueryPropertiesInput	Properties about the Query
subjects [UpdateQuerySubjectInput!]	Subjects for the query

UpdateQueryPropertiesInput

Input properties required for creating a Query. Any non-null fields will be updated if provided.

Arguments

Name	Description
name String	An optional display name for the Query
description String	An optional description for the Query
statement QueryStatementInput	The Query contents

UpdateQuerySubjectInput

Input required for creating a Query. For now, only datasets are supported.

Arguments

Name	Description
datasetUrn String!	The urn of the dataset that is the subject of the query

UpdateTestInput

Arguments

Name	Description
name String!	The name of the Test
category String!	The category of the Test (user defined)
description String	Description of the test
definition TestDefinitionInput!	The test definition

UpdateUserSettingInput

Input for updating a user setting

Arguments

Name	Description
name UserSetting!	The name of the setting
value Boolean!	The new value of the setting

UpdateViewInput

Input provided when updating a DataHub View

Arguments

Name	Description
name String	The name of the View
description String	An optional description of the View
definition DataHubViewDefinitionInput	The view definition itself