Mutations

acceptRole

Type: Boolean

Accept role using invite token

Arguments

Name	Description
input AcceptRoleInput!

addBusinessAttribute

Type: Boolean

Add Business Attribute

Arguments

Name	Description
input AddBusinessAttributeInput!

addGroupMembers

Type: Boolean

Add members to a group

Arguments

Name	Description
input AddGroupMembersInput!

addLink

Type: Boolean

Add a link, or institutional memory, from a particular Entity

Arguments

Name	Description
input AddLinkInput!

addOwner

Type: Boolean

Add an owner to a particular Entity

Arguments

Name	Description
input AddOwnerInput!

addOwners

Type: Boolean

Add multiple owners to a particular Entity

Arguments

Name	Description
input AddOwnersInput!

addRelatedTerms

Type: Boolean

Add multiple related Terms to a Glossary Term to establish relationships

Arguments

Name	Description
input RelatedTermsInput!

addTag

Type: Boolean

Add a tag to a particular Entity or subresource

Arguments

Name	Description
input TagAssociationInput!

addTags

Type: Boolean

Add multiple tags to a particular Entity or subresource

Arguments

Name	Description
input AddTagsInput!

addTerm

Type: Boolean

Add a glossary term to a particular Entity or subresource

Arguments

Name	Description
input TermAssociationInput!

addTerms

Type: Boolean

Add multiple glossary terms to a particular Entity or subresource

Arguments

Name	Description
input AddTermsInput!

batchAddOwners

Type: Boolean

Add owners to multiple Entities

Arguments

Name	Description
input BatchAddOwnersInput!

batchAddTags

Type: Boolean

Add tags to multiple Entities or subresources

Arguments

Name	Description
input BatchAddTagsInput!

batchAddTerms

Type: Boolean

Add glossary terms to multiple Entities or subresource

Arguments

Name	Description
input BatchAddTermsInput!

batchAssignForm

Type: Boolean

Assign a form to different entities. This will be a patch by adding this form to the list of forms on an entity.

Arguments

Name	Description
input BatchAssignFormInput!

batchAssignRole

Type: Boolean

Batch assign roles to users

Arguments

Name	Description
input BatchAssignRoleInput!

batchRemoveForm

Type: Boolean!

Remove a form from a given list of entities.

Arguments

Name	Description
input BatchRemoveFormInput!

batchRemoveOwners

Type: Boolean

Remove owners from multiple Entities

Arguments

Name	Description
input BatchRemoveOwnersInput!

batchRemoveTags

Type: Boolean

Remove tags from multiple Entities or subresource

Arguments

Name	Description
input BatchRemoveTagsInput!

batchRemoveTerms

Type: Boolean

Remove glossary terms from multiple Entities or subresource

Arguments

Name	Description
input BatchRemoveTermsInput!

batchSetDataProduct

Type: Boolean

Batch set or unset a DataProduct to a list of entities

Arguments

Name	Description
input BatchSetDataProductInput!	Input for batch setting data product

batchSetDomain

Type: Boolean

Set domain for multiple Entities

Arguments

Name	Description
input BatchSetDomainInput!

batchUpdateDeprecation

Type: Boolean

Updates the deprecation status for a batch of assets.

Arguments

Name	Description
input BatchUpdateDeprecationInput!

batchUpdateSoftDeleted

Type: Boolean

Updates the soft deleted status for a batch of assets

Arguments

Name	Description
input BatchUpdateSoftDeletedInput!

batchUpdateStepStates

Type: BatchUpdateStepStatesResult!

Batch update the state for a set of steps.

Arguments

Name	Description
input BatchUpdateStepStatesInput!

cancelIngestionExecutionRequest

Type: String

Cancel a running execution request, provided the urn of the original execution request

Arguments

Name	Description
input CancelIngestionExecutionRequestInput!

createAccessToken

Type: AccessToken

Generates an access token for DataHub APIs for a particular user & of a particular type

Arguments

Name	Description
input CreateAccessTokenInput!

createBusinessAttribute

Type: BusinessAttribute

Create Business Attribute Api

Arguments

Name	Description
input CreateBusinessAttributeInput!	Inputs required to create a new BusinessAttribute.

createDataProduct

Type: DataProduct

Create a new Data Product

Arguments

Name	Description
input CreateDataProductInput!	Inputs required to create a new DataProduct.

createDomain

Type: String

Create a new Domain. Returns the urn of the newly created Domain. Requires the 'Create Domains' or 'Manage Domains' Platform Privilege. If a Domain with the provided ID already exists, it will be overwritten.

Arguments

Name	Description
input CreateDomainInput!

createDynamicFormAssignment

Type: Boolean

Creates a filter for a form to apply it to certain entities. Entities that match this filter will have a given form applied to them. This feature is ONLY supported in DataHub Cloud.

Arguments

Name	Description
input CreateDynamicFormAssignmentInput!

createERModelRelationship

Type: ERModelRelationship

Create a ERModelRelationship

Arguments

Name	Description
input ERModelRelationshipUpdateInput!	Input required to create a new ERModelRelationship

createForm

Type: Form!

Create a new form based on the input

Arguments

Name	Description
input CreateFormInput!

createGlossaryNode

Type: String

Create a new GlossaryNode. Returns the urn of the newly created GlossaryNode. If a node with the provided ID already exists, it will be overwritten.

Arguments

Name	Description
input CreateGlossaryEntityInput!

createGlossaryTerm

Type: String

Create a new GlossaryTerm. Returns the urn of the newly created GlossaryTerm. If a term with the provided ID already exists, it will be overwritten.

Arguments

Name	Description
input CreateGlossaryEntityInput!

createGroup

Type: String

Create a new group. Returns the urn of the newly created group. Requires the Manage Users & Groups Platform Privilege

Arguments

Name	Description
input CreateGroupInput!

createIngestionExecutionRequest

Type: String

Create a request to execute an ingestion job input: Input required for creating an ingestion execution request

Arguments

Name	Description
input CreateIngestionExecutionRequestInput!

createIngestionSource

Type: String

Create a new ingestion source

Arguments

Name	Description
input UpdateIngestionSourceInput!

createInviteToken

Type: InviteToken

Create invite token

Arguments

Name	Description
input CreateInviteTokenInput!

createNativeUserResetToken

Type: ResetToken

Generates a token that can be shared with existing native users to reset their credentials.

Arguments

Name	Description
input CreateNativeUserResetTokenInput!

createOwnershipType

Type: OwnershipTypeEntity

Create a Custom Ownership Type. This requires the 'Manage Ownership Types' Metadata Privilege.

Arguments

Name	Description
input CreateOwnershipTypeInput!	Inputs required to create a new Query.

createPolicy

Type: String

Create a policy and returns the resulting urn

Arguments

Name	Description
input PolicyUpdateInput!

createPost

Type: Boolean

Create a post

Arguments

Name	Description
input CreatePostInput!

createQuery

Type: QueryEntity

Create a new Query

Arguments

Name	Description
input CreateQueryInput!	Inputs required to create a new Query.

createSecret

Type: String

Create a new Secret

Arguments

Name	Description
input CreateSecretInput!

createStructuredProperty

Type: StructuredPropertyEntity!

Create a new structured property

Arguments

Name	Description
input CreateStructuredPropertyInput!

createTag

Type: String

Create a new tag. Requires the 'Manage Tags' or 'Create Tags' Platform Privilege. If a Tag with the provided ID already exists, it will be overwritten.

Arguments

Name	Description
input CreateTagInput!	Inputs required to create a new Tag.

createTest

Type: String

Create a new test

Arguments

Name	Description
input CreateTestInput!

createTestConnectionRequest

Type: String

Create a request to execute a test ingestion connection job input: Input required for creating a test connection request

Arguments

Name	Description
input CreateTestConnectionRequestInput!

createView

Type: DataHubView

Create a new DataHub View (Saved Filter)

Arguments

Name	Description
input CreateViewInput!	Input required to create a new DataHub View

deleteAssertion

Type: Boolean

Remove an assertion associated with an entity. Requires the 'Edit Assertions' privilege on the entity.

Arguments

Name	Description
urn String!	The assertion to remove

deleteBusinessAttribute

Type: Boolean

Delete a Business Attribute by urn.

Arguments

Name	Description
urn String!	Urn of the business attribute to remove.

deleteDataProduct

Type: Boolean

Delete a DataProduct by urn.

Arguments

Name	Description
urn String!	Urn of the data product to remove.

deleteDomain

Type: Boolean

Delete a Domain

Arguments

Name	Description
urn String!	The urn of the Domain to delete

deleteERModelRelationship

Type: Boolean

Delete a ERModelRelationship

Arguments

Name	Description
urn String!	The urn of the ERModelRelationship to delete

deleteForm

Type: Boolean!

Delete a given form

Arguments

Name	Description
input DeleteFormInput!

deleteGlossaryEntity

Type: Boolean

Remove a glossary entity (GlossaryTerm or GlossaryNode). Return boolean whether it was successful or not.

Arguments

Name	Description
urn String!

deleteIngestionSource

Type: String

Delete an existing ingestion source

Arguments

Name	Description
urn String!

deleteOwnershipType

Type: Boolean

Delete a Custom Ownership Type by urn. This requires the 'Manage Ownership Types' Metadata Privilege.

Arguments

Name	Description
urn String!	Urn of the Custom Ownership Type to remove.
deleteReferences Boolean

deletePolicy

Type: String

Remove an existing policy and returns the policy urn

Arguments

Name	Description
urn String!

deletePost

Type: Boolean

Delete a post

Arguments

Name	Description
urn String!

deleteQuery

Type: Boolean

Delete a Query by urn. This requires the 'Edit Queries' Metadata Privilege.

Arguments

Name	Description
urn String!	Urn of the query to remove.

deleteSecret

Type: String

Delete a Secret

Arguments

Name	Description
urn String!

deleteTag

Type: Boolean

Delete a Tag

Arguments

Name	Description
urn String!	The urn of the Tag to delete

deleteTest

Type: Boolean

Delete an existing test - note that this will NOT delete dangling pointers until the next execution of the test.

Arguments

Name	Description
urn String!

deleteView

Type: Boolean

Delete a DataHub View (Saved Filter)

Arguments

Name	Description
urn String!	The urn of the View to delete

moveDomain

Type: Boolean

Moves a domain to be parented under another domain.

Arguments

Name	Description
input MoveDomainInput!

raiseIncident

Type: String

Create a new incident for a resource (asset)

Arguments

Name	Description
input RaiseIncidentInput!	Input required to create a new incident

removeBusinessAttribute

Type: Boolean

Remove Business Attribute

Arguments

Name	Description
input AddBusinessAttributeInput!

removeGroup

Type: Boolean

Remove a group. Requires Manage Users & Groups Platform Privilege

Arguments

Name	Description
urn String!

removeGroupMembers

Type: Boolean

Remove members from a group

Arguments

Name	Description
input RemoveGroupMembersInput!

removeLink

Type: Boolean

Remove a link, or institutional memory, from a particular Entity

Arguments

Name	Description
input RemoveLinkInput!

removeOwner

Type: Boolean

Remove an owner from a particular Entity

Arguments

Name	Description
input RemoveOwnerInput!

removeRelatedTerms

Type: Boolean

Remove multiple related Terms for a Glossary Term

Arguments

Name	Description
input RelatedTermsInput!

removeStructuredProperties

Type: StructuredProperties!

Upsert structured properties onto a given asset

Arguments

Name	Description
input RemoveStructuredPropertiesInput!

removeTag

Type: Boolean

Remove a tag from a particular Entity or subresource

Arguments

Name	Description
input TagAssociationInput!

removeTerm

Type: Boolean

Remove a glossary term from a particular Entity or subresource

Arguments

Name	Description
input TermAssociationInput!

removeUser

Type: Boolean

Remove a user. Requires Manage Users & Groups Platform Privilege

Arguments

Name	Description
urn String!

reportAssertionResult

Type: Boolean!

Report result for an assertion

Arguments

Name	Description
urn String!	Urn of custom assertion.
result AssertionResultInput!	Input for reporting result of the assertion

reportOperation

Type: String

Report a new operation for an asset

Arguments

Name	Description
input ReportOperationInput!	Input required to report an operation

revokeAccessToken

Type: Boolean!

Revokes access tokens.

Arguments

Name	Description
tokenId String!

rollbackIngestion

Type: String

Rollback a specific ingestion execution run based on its runId

Arguments

Name	Description
input RollbackIngestionInput!

setDomain

Type: Boolean

Sets the Domain for a Dataset, Chart, Dashboard, Data Flow (Pipeline), or Data Job (Task). Returns true if the Domain was successfully added, or already exists. Requires the Edit Domains privilege for the Entity.

Arguments

Name	Description
entityUrn String!
domainUrn String!

setTagColor

Type: Boolean

Set the hex color associated with an existing Tag

Arguments

Name	Description
urn String!
colorHex String!

submitFormPrompt

Type: Boolean

Submit a response to a prompt from a form collecting metadata on different entities. Provide the urn of the entity you're submitting a form response as well as the required input.

Arguments

Name	Description
urn String!
input SubmitFormPromptInput!

unsetDomain

Type: Boolean

Sets the Domain for a Dataset, Chart, Dashboard, Data Flow (Pipeline), or Data Job (Task). Returns true if the Domain was successfully removed, or was already removed. Requires the Edit Domains privilege for an asset.

Arguments

Name	Description
entityUrn String!

updateBusinessAttribute

Type: BusinessAttribute

Update Business Attribute

Arguments

Name	Description
urn String!	The urn identifier for the Business Attribute to update.
input UpdateBusinessAttributeInput!	Inputs required to create a new Business Attribute.

updateChart

Type: Chart

Update the metadata about a particular Chart

Arguments

Name	Description
urn String!
input ChartUpdateInput!

updateCorpGroupProperties

Type: CorpGroup

Update a particular Corp Group's editable properties

Arguments

Name	Description
urn String!
input CorpGroupUpdateInput!

updateCorpUserProperties

Type: CorpUser

Update a particular Corp User's editable properties

Arguments

Name	Description
urn String!
input CorpUserUpdateInput!

updateCorpUserViewsSettings

Type: Boolean

Update the View-related settings for a user.

Arguments

Name	Description
input UpdateCorpUserViewsSettingsInput!

updateDashboard

Type: Dashboard

Update the metadata about a particular Dashboard

Arguments

Name	Description
urn String!
input DashboardUpdateInput!

updateDataFlow

Type: DataFlow

Update the metadata about a particular Data Flow (Pipeline)

Arguments

Name	Description
urn String!
input DataFlowUpdateInput!

updateDataJob

Type: DataJob

Update the metadata about a particular Data Job (Task)

Arguments

Name	Description
urn String!
input DataJobUpdateInput!

updateDataProduct

Type: DataProduct

Update a Data Product

Arguments

Name	Description
urn String!	The urn identifier for the Data Product to update.
input UpdateDataProductInput!	Inputs required to create a new DataProduct.

updateDataset

Type: Dataset

Update the metadata about a particular Dataset

Arguments

Name	Description
urn String!
input DatasetUpdateInput!

updateDatasets

Type: [Dataset]

Update the metadata about a batch of Datasets

Arguments

Name	Description
input [BatchDatasetUpdateInput!]!

updateDeprecation

Type: Boolean

Sets the Deprecation status for a Metadata Entity. Requires the Edit Deprecation status privilege for an entity.

Arguments

Name	Description
input UpdateDeprecationInput!	Input required to set deprecation for an Entity.

updateDescription

Type: Boolean

Incubating. Updates the description of a resource. Currently only supports Dataset Schema Fields, Containers

Arguments

Name	Description
input DescriptionUpdateInput!

updateDocPropagationSettings

Type: Boolean!

Update the doc propagation settings.

Arguments

Name	Description
input UpdateDocPropagationSettingsInput!

updateEmbed

Type: Boolean

Update the Embed information for a Dataset, Dashboard, or Chart.

Arguments

Name	Description
input UpdateEmbedInput!

updateERModelRelationship

Type: Boolean

Update a ERModelRelationship

Arguments

Name	Description
urn String!	The urn of the ERModelRelationship to update
input ERModelRelationshipUpdateInput!	Input required to updat an existing DataHub View

updateForm

Type: Form!

Update an existing form based on the input

Arguments

Name	Description
input UpdateFormInput!

updateGlobalViewsSettings

Type: Boolean!

Update the global settings related to the Views feature. Requires the 'Manage Global Views' Platform Privilege.

Arguments

Name	Description
input UpdateGlobalViewsSettingsInput!

updateIncidentStatus

Type: Boolean

Update an existing incident for a resource (asset)

Arguments

Name	Description
urn String!	The urn for an existing incident
input UpdateIncidentStatusInput!	Input required to update the state of an existing incident

updateIngestionSource

Type: String

Update an existing ingestion source

Arguments

Name	Description
urn String!
input UpdateIngestionSourceInput!

updateLineage

Type: Boolean

Update lineage for an entity

Arguments

Name	Description
input UpdateLineageInput!

updateName

Type: Boolean

Updates the name of the entity.

Arguments

Name	Description
input UpdateNameInput!

updateNotebook

Type: Notebook

Update the metadata about a particular Notebook

Arguments

Name	Description
urn String!
input NotebookUpdateInput!

updateOwnershipType

Type: OwnershipTypeEntity

Update an existing Query. This requires the 'Manage Ownership Types' Metadata Privilege.

Arguments

Name	Description
urn String!	The urn identifier for the custom ownership type to update.
input UpdateOwnershipTypeInput!	Inputs required to update an existing Custom Ownership Type.

updateParentNode

Type: Boolean

Updates the parent node of a resource. Currently only GlossaryNodes and GlossaryTerms have parentNodes.

Arguments

Name	Description
input UpdateParentNodeInput!

updatePolicy

Type: String

Update an existing policy and returns the resulting urn

Arguments

Name	Description
urn String!
input PolicyUpdateInput!

updatePost

Type: Boolean

Update or edit a post

Arguments

Name	Description
input UpdatePostInput!

updateQuery

Type: QueryEntity

Update an existing Query

Arguments

Name	Description
urn String!	The urn identifier for the query to update.
input UpdateQueryInput!	Inputs required to update a Query.

updateSecret

Type: String

Update a Secret

Arguments

Name	Description
input UpdateSecretInput!

updateStructuredProperty

Type: StructuredPropertyEntity!

Update an existing structured property

Arguments

Name	Description
input UpdateStructuredPropertyInput!

updateTag

Type: Tag

Update the information about a particular Entity Tag

Arguments

Name	Description
urn String!
input TagUpdateInput!

updateTest

Type: String

Update an existing test

Arguments

Name	Description
urn String!
input UpdateTestInput!

updateUserSetting

Type: Boolean

Update a user setting

Arguments

Name	Description
input UpdateUserSettingInput!

updateUserStatus

Type: String

Change the status of a user. Requires Manage Users & Groups Platform Privilege

Arguments

Name	Description
urn String!
status CorpUserStatus!

updateView

Type: DataHubView

Delete a DataHub View (Saved Filter)

Arguments

Name	Description
urn String!	The urn of the View to update
input UpdateViewInput!	Input required to updat an existing DataHub View

upsertConnection

Type: DataHubConnection!

Upsert a particular connection. This requires the 'Manage Connections' platform privilege.

Arguments

Name	Description
input UpsertDataHubConnectionInput!

upsertCustomAssertion

Type: Assertion!

Upsert a Custom Assertion

Arguments

Name	Description
urn String	Urn of custom assertion. If not provided, one will be generated.
input UpsertCustomAssertionInput!	Input for upserting a custom assertion.

upsertDataContract

Type: DataContract!

Create or update a data contract for a given dataset. Requires the "Edit Data Contract" privilege for the provided dataset.

Arguments

Name	Description
urn String
input UpsertDataContractInput!

upsertStructuredProperties

Type: StructuredProperties!

Upsert structured properties onto a given asset

Arguments

Name	Description
input UpsertStructuredPropertiesInput!

verifyForm

Type: Boolean

Verifies a form on an entity when all of the required questions on the form are complete and the form is of type VERIFICATION.

Arguments

Name	Description
input VerifyFormInput!