Getting started with the APIs

Have more questions? Submit a request

Each update we make to our API documentation automatically builds a Postman collection. You can import all the API definitions and documentation into Postman using this collection. And then in Postman you can start exploring the APIs by running them directly against your own environment.

Import Postman collection

To import the Postman collection:

  1. In your Postman workspace, click the Import button.
  2. In the Import window, click the Link tab.
  3. Under Enter a URL paste this link β€” https://atlanhq.github.io/openapi/atlan_collection.json β€” and then click the Continue button.
  4. From the Import summary, click the Import button.

After a few moments the full set of APIs will be available in your workspace in a collection named Atlan API. πŸŽ‰

πŸ’ͺ Did you know? Each time we update our documentation, this collection is re-generated. The process outlined above is a one-off snapshot of the collection. If you want the latest collection, you need to import the collection again each time.

Define Postman environment

Before you can use the APIs in Postman, you will need to:

  1. Configure a Postman environment with the following variables:
    • baseUrl β€” the full URL for your environment, including the https:// (for example, https://tenant.atlan.com).
    • authToken β€” the bearer token you copied from Atlan when configuring an API token.
  2. Set the authToken variable as the bearer token on the collection itself.

You are then ready to use Postman to call the APIs! πŸŽ‰

Related articles

Was this article helpful?
1 out of 1 found this helpful