Skip to main content
Version: Next

Mutations

acceptRole

Type: Boolean

Accept role using invite token

Arguments

NameDescription
input
AcceptRoleInput!

addBusinessAttribute

Type: Boolean

Add Business Attribute

Arguments

NameDescription
input
AddBusinessAttributeInput!

addGroupMembers

Type: Boolean

Add members to a group

Arguments

NameDescription
input
AddGroupMembersInput!

Type: Boolean

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

Arguments

NameDescription
input
AddLinkInput!

addOwner

Type: Boolean

Add an owner to a particular Entity

Arguments

NameDescription
input
AddOwnerInput!

addOwners

Type: Boolean

Add multiple owners to a particular Entity

Arguments

NameDescription
input
AddOwnersInput!

addRelatedTerms

Type: Boolean

Add multiple related Terms to a Glossary Term to establish relationships

Arguments

NameDescription
input
RelatedTermsInput!

addTag

Type: Boolean

Add a tag to a particular Entity or subresource

Arguments

NameDescription
input
TagAssociationInput!

addTags

Type: Boolean

Add multiple tags to a particular Entity or subresource

Arguments

NameDescription
input
AddTagsInput!

addTerm

Type: Boolean

Add a glossary term to a particular Entity or subresource

Arguments

NameDescription
input
TermAssociationInput!

addTerms

Type: Boolean

Add multiple glossary terms to a particular Entity or subresource

Arguments

NameDescription
input
AddTermsInput!

batchAddOwners

Type: Boolean

Add owners to multiple Entities

Arguments

NameDescription
input
BatchAddOwnersInput!

batchAddTags

Type: Boolean

Add tags to multiple Entities or subresources

Arguments

NameDescription
input
BatchAddTagsInput!

batchAddTerms

Type: Boolean

Add glossary terms to multiple Entities or subresource

Arguments

NameDescription
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

NameDescription
input
BatchAssignFormInput!

batchAssignRole

Type: Boolean

Batch assign roles to users

Arguments

NameDescription
input
BatchAssignRoleInput!

batchRemoveForm

Type: Boolean!

Remove a form from a given list of entities.

Arguments

NameDescription
input
BatchRemoveFormInput!

batchRemoveOwners

Type: Boolean

Remove owners from multiple Entities

Arguments

NameDescription
input
BatchRemoveOwnersInput!

batchRemoveTags

Type: Boolean

Remove tags from multiple Entities or subresource

Arguments

NameDescription
input
BatchRemoveTagsInput!

batchRemoveTerms

Type: Boolean

Remove glossary terms from multiple Entities or subresource

Arguments

NameDescription
input
BatchRemoveTermsInput!

batchSetDataProduct

Type: Boolean

Batch set or unset a DataProduct to a list of entities

Arguments

NameDescription
input
BatchSetDataProductInput!

Input for batch setting data product

batchSetDomain

Type: Boolean

Set domain for multiple Entities

Arguments

NameDescription
input
BatchSetDomainInput!

batchUpdateDeprecation

Type: Boolean

Updates the deprecation status for a batch of assets.

Arguments

NameDescription
input
BatchUpdateDeprecationInput!

batchUpdateSoftDeleted

Type: Boolean

Updates the soft deleted status for a batch of assets

Arguments

NameDescription
input
BatchUpdateSoftDeletedInput!

batchUpdateStepStates

Type: BatchUpdateStepStatesResult!

Batch update the state for a set of steps.

Arguments

NameDescription
input
BatchUpdateStepStatesInput!

cancelIngestionExecutionRequest

Type: String

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

Arguments

NameDescription
input
CancelIngestionExecutionRequestInput!

createAccessToken

Type: AccessToken

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

Arguments

NameDescription
input
CreateAccessTokenInput!

createBusinessAttribute

Type: BusinessAttribute

Create Business Attribute Api

Arguments

NameDescription
input
CreateBusinessAttributeInput!

Inputs required to create a new BusinessAttribute.

createDataProduct

Type: DataProduct

Create a new Data Product

Arguments

NameDescription
input
CreateDataProductInput!

Inputs required to create a new DataProduct.

createDatasetAssertion

Type: Assertion!

Experimental! Create an existing Dataset Assertion

Arguments

NameDescription
input
CreateDatasetAssertionInput!

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

NameDescription
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 Acryl DataHub.

Arguments

NameDescription
input
CreateDynamicFormAssignmentInput!

createERModelRelationship

Type: ERModelRelationship

Create a ERModelRelationship

Arguments

NameDescription
input
ERModelRelationshipUpdateInput!

Input required to create a new ERModelRelationship

createFieldAssertion

Type: Assertion!

Experimental! Create a new Field Assertion

Arguments

NameDescription
input
CreateFieldAssertionInput!

createFreshnessAssertion

Type: Assertion!

Experimental! Create an new Freshness Assertion

Arguments

NameDescription
input
CreateFreshnessAssertionInput!

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

NameDescription
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

NameDescription
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

NameDescription
input
CreateGroupInput!

createIngestionExecutionRequest

Type: String

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

Arguments

NameDescription
input
CreateIngestionExecutionRequestInput!

createIngestionSource

Type: String

Create a new ingestion source

Arguments

NameDescription
input
UpdateIngestionSourceInput!

createInviteToken

Type: InviteToken

Create invite token

Arguments

NameDescription
input
CreateInviteTokenInput!

createNativeUserResetToken

Type: ResetToken

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

Arguments

NameDescription
input
CreateNativeUserResetTokenInput!

createOwnershipType

Type: OwnershipTypeEntity

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

Arguments

NameDescription
input
CreateOwnershipTypeInput!

Inputs required to create a new Query.

createPolicy

Type: String

Create a policy and returns the resulting urn

Arguments

NameDescription
input
PolicyUpdateInput!

createPost

Type: Boolean

Create a post

Arguments

NameDescription
input
CreatePostInput!

createQuery

Type: QueryEntity

Create a new Query

Arguments

NameDescription
input
CreateQueryInput!

Inputs required to create a new Query.

createSecret

Type: String

Create a new Secret

Arguments

NameDescription
input
CreateSecretInput!

createSqlAssertion

Type: Assertion!

Experimental! Create a new Sql Assertion

Arguments

NameDescription
input
CreateSqlAssertionInput!

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

NameDescription
input
CreateTagInput!

Inputs required to create a new Tag.

createTest

Type: String

Create a new test

Arguments

NameDescription
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

NameDescription
input
CreateTestConnectionRequestInput!

createView

Type: DataHubView

Create a new DataHub View (Saved Filter)

Arguments

NameDescription
input
CreateViewInput!

Input required to create a new DataHub View

createVolumeAssertion

Type: Assertion!

Experimental! Create an new Volume Assertion

Arguments

NameDescription
input
CreateVolumeAssertionInput!

deleteAssertion

Type: Boolean

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

Arguments

NameDescription
urn
String!

The assertion to remove

deleteBusinessAttribute

Type: Boolean

Delete a Business Attribute by urn.

Arguments

NameDescription
urn
String!

Urn of the business attribute to remove.

deleteDataProduct

Type: Boolean

Delete a DataProduct by urn.

Arguments

NameDescription
urn
String!

Urn of the data product to remove.

deleteDomain

Type: Boolean

Delete a Domain

Arguments

NameDescription
urn
String!

The urn of the Domain to delete

deleteERModelRelationship

Type: Boolean

Delete a ERModelRelationship

Arguments

NameDescription
urn
String!

The urn of the ERModelRelationship to delete

deleteGlossaryEntity

Type: Boolean

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

Arguments

NameDescription
urn
String!

deleteIngestionSource

Type: String

Delete an existing ingestion source

Arguments

NameDescription
urn
String!

deleteOwnershipType

Type: Boolean

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

Arguments

NameDescription
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

NameDescription
urn
String!

deletePost

Type: Boolean

Delete a post

Arguments

NameDescription
urn
String!

deleteQuery

Type: Boolean

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

Arguments

NameDescription
urn
String!

Urn of the query to remove.

deleteSecret

Type: String

Delete a Secret

Arguments

NameDescription
urn
String!

deleteTag

Type: Boolean

Delete a Tag

Arguments

NameDescription
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

NameDescription
urn
String!

deleteView

Type: Boolean

Delete a DataHub View (Saved Filter)

Arguments

NameDescription
urn
String!

The urn of the View to delete

moveDomain

Type: Boolean

Moves a domain to be parented under another domain.

Arguments

NameDescription
input
MoveDomainInput!

removeBusinessAttribute

Type: Boolean

Remove Business Attribute

Arguments

NameDescription
input
AddBusinessAttributeInput!

removeGroup

Type: Boolean

Remove a group. Requires Manage Users & Groups Platform Privilege

Arguments

NameDescription
urn
String!

removeGroupMembers

Type: Boolean

Remove members from a group

Arguments

NameDescription
input
RemoveGroupMembersInput!

Type: Boolean

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

Arguments

NameDescription
input
RemoveLinkInput!

removeOwner

Type: Boolean

Remove an owner from a particular Entity

Arguments

NameDescription
input
RemoveOwnerInput!

removeRelatedTerms

Type: Boolean

Remove multiple related Terms for a Glossary Term

Arguments

NameDescription
input
RelatedTermsInput!

removeTag

Type: Boolean

Remove a tag from a particular Entity or subresource

Arguments

NameDescription
input
TagAssociationInput!

removeTerm

Type: Boolean

Remove a glossary term from a particular Entity or subresource

Arguments

NameDescription
input
TermAssociationInput!

removeUser

Type: Boolean

Remove a user. Requires Manage Users & Groups Platform Privilege

Arguments

NameDescription
urn
String!

reportOperation

Type: String

Report a new operation for an asset

Arguments

NameDescription
input
ReportOperationInput!

Input required to report an operation

revokeAccessToken

Type: Boolean!

Revokes access tokens.

Arguments

NameDescription
tokenId
String!

rollbackIngestion

Type: String

Rollback a specific ingestion execution run based on its runId

Arguments

NameDescription
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

NameDescription
entityUrn
String!
domainUrn
String!

setTagColor

Type: Boolean

Set the hex color associated with an existing Tag

Arguments

NameDescription
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

NameDescription
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

NameDescription
entityUrn
String!

updateAssertionMetadata

Type: Assertion!

Experimental! Update basic metadata for a given assertion, including description and actions.

Arguments

NameDescription
urn
String!
input
UpdateAssertionMetadataInput!

updateBusinessAttribute

Type: BusinessAttribute

Update Business Attribute

Arguments

NameDescription
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

NameDescription
urn
String!
input
ChartUpdateInput!

updateCorpGroupProperties

Type: CorpGroup

Update a particular Corp Group's editable properties

Arguments

NameDescription
urn
String!
input
CorpGroupUpdateInput!

updateCorpUserProperties

Type: CorpUser

Update a particular Corp User's editable properties

Arguments

NameDescription
urn
String!
input
CorpUserUpdateInput!

updateCorpUserViewsSettings

Type: Boolean

Update the View-related settings for a user.

Arguments

NameDescription
input
UpdateCorpUserViewsSettingsInput!

updateDashboard

Type: Dashboard

Update the metadata about a particular Dashboard

Arguments

NameDescription
urn
String!
input
DashboardUpdateInput!

updateDataFlow

Type: DataFlow

Update the metadata about a particular Data Flow (Pipeline)

Arguments

NameDescription
urn
String!
input
DataFlowUpdateInput!

updateDataJob

Type: DataJob

Update the metadata about a particular Data Job (Task)

Arguments

NameDescription
urn
String!
input
DataJobUpdateInput!

updateDataProduct

Type: DataProduct

Update a Data Product

Arguments

NameDescription
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

NameDescription
urn
String!
input
DatasetUpdateInput!

updateDatasetAssertion

Type: Assertion!

Experimental! Update an existing Dataset Assertion

Arguments

NameDescription
urn
String!
input
UpdateDatasetAssertionInput!

updateDatasets

Type: [Dataset]

Update the metadata about a batch of Datasets

Arguments

NameDescription
input
[BatchDatasetUpdateInput!]!

updateDeprecation

Type: Boolean

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

Arguments

NameDescription
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

NameDescription
input
DescriptionUpdateInput!

updateEmbed

Type: Boolean

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

Arguments

NameDescription
input
UpdateEmbedInput!

updateERModelRelationship

Type: Boolean

Update a ERModelRelationship

Arguments

NameDescription
urn
String!

The urn of the ERModelRelationship to update

input
ERModelRelationshipUpdateInput!

Input required to updat an existing DataHub View

updateGlobalViewsSettings

Type: Boolean!

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

Arguments

NameDescription
input
UpdateGlobalViewsSettingsInput!

updateIngestionSource

Type: String

Update an existing ingestion source

Arguments

NameDescription
urn
String!
input
UpdateIngestionSourceInput!

updateLineage

Type: Boolean

Update lineage for an entity

Arguments

NameDescription
input
UpdateLineageInput!

updateName

Type: Boolean

Updates the name of the entity.

Arguments

NameDescription
input
UpdateNameInput!

updateNotebook

Type: Notebook

Update the metadata about a particular Notebook

Arguments

NameDescription
urn
String!
input
NotebookUpdateInput!

updateOwnershipType

Type: OwnershipTypeEntity

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

Arguments

NameDescription
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

NameDescription
input
UpdateParentNodeInput!

updatePolicy

Type: String

Update an existing policy and returns the resulting urn

Arguments

NameDescription
urn
String!
input
PolicyUpdateInput!

updatePost

Type: Boolean

Update or edit a post

Arguments

NameDescription
input
UpdatePostInput!

updateQuery

Type: QueryEntity

Update an existing Query

Arguments

NameDescription
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

NameDescription
input
UpdateSecretInput!

updateTag

Type: Tag

Update the information about a particular Entity Tag

Arguments

NameDescription
urn
String!
input
TagUpdateInput!

updateTest

Type: String

Update an existing test

Arguments

NameDescription
urn
String!
input
UpdateTestInput!

updateUserSetting

Type: Boolean

Update a user setting

Arguments

NameDescription
input
UpdateUserSettingInput!

updateUserStatus

Type: String

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

Arguments

NameDescription
urn
String!
status
CorpUserStatus!

updateView

Type: DataHubView

Delete a DataHub View (Saved Filter)

Arguments

NameDescription
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

NameDescription
input
UpsertDataHubConnectionInput!

upsertStructuredProperties

Type: StructuredProperties!

Upsert structured properties onto a given asset

Arguments

NameDescription
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

NameDescription
input
VerifyFormInput!