
Explore the automation use cases the Ataccama ONE GraphQL API unlocks, then set up an API client and use the OAuth2 client credentials flow to obtain a bearer token for authenticated requests.
Learn the core GraphQL concepts of schema, type, query, and mutation, then use introspection and the ONE Playground to explore the API's schema and build your first query.
Write nested queries to retrieve catalog items with their business terms and DQ results, apply filter arguments, and paginate through large result sets.
Use createCatalogItem and updateCatalogItem mutations to build objects with required input types, handle validation errors, and confirm the created object with a follow-up query.
Move a catalog item from draft to published state via mutation, and parse the GraphQL errors array to build robust error handling into your automation scripts.
Open a GraphQL subscription over WebSocket to receive live governance events - new catalog items, DQ rule failures, approval requests - and route them into a downstream automation trigger.
Combine queries, mutations, and subscriptions into a single external script that integrates Ataccama ONE with a ticketing system or messaging platform, and package it for scheduled or event-driven execution.
This course contains the use of artificial intelligence.
The Ataccama ONE web app is great for humans. But once you need to automate governance work, integrate with other systems, or build internal tooling, you need to talk to the platform programmatically. That is what the ONE GraphQL API is for.
This course teaches you how to use the API end to end, starting from authentication and continuing through GraphQL fundamentals, queries, mutations, and real-time subscriptions. You will learn how to authenticate with OAuth2, query governance objects like catalog items and DQ results, create and update objects with mutations, handle errors, subscribe to live governance events, and combine everything into a complete automation script that integrates Ataccama ONE with an external system.
What you will build by the end of this course:
- An authenticated GraphQL client configured against the ONE API
- Queries that retrieve nested governance objects with filters and pagination
- Mutations that create, update, and publish catalog objects
- A subscription that reacts to governance events in real time
- A complete automation script integrating Ataccama ONE with an external system
Prerequisites: UDY01. Basic programming knowledge in any language.
What to take next: UDY11 (Customize the Ataccama ONE Platform) to extend the platform's UI and configuration alongside its API. Start extending Ataccama ONE with the GraphQL API today.