Welcome to the Alteryx Knowledge Base

How to use the Alteryx Server Web API
user

Created/Edited - 12/6/2024 by Cristiano Joaquim | Alteryx

How To
Use the Alteryx Server Web API
Environment
  • Alteryx Server version 2021.4 or above
Prerequisites

API Access needs to be enabled for the user by the gallery administrator under the Admin > Users menu

The API key and secret can be found under the users profile after API access has been enabled by the gallery administrator.

Procedure

Please perform the following steps:

1. To access the Web API you must click on the question mark at the top right corner of the page then select API Documentation from the drop down menu. You will land on the Swagger Web Api page.
 

2023-09-01_8-03-03.jpg

 Alternatively, you can also use the Web API address found in the server's Alteryx System Settings followed by "swagger".  In this example the Web API address is "http://localhost/gallery/" + "swagger" or "http://localhost/gallery/swagger"
 

 API Swagger page is displayed.
 

2023-09-01_8-14-34.jpg

 

2. Select the desired API endpoint. For the purpose of this demonstration we will are picking GET /v3/collections. Click on the red circle with the exclamation point. The "Available authorizations" pop-up screen is displayed.  Enter your ClientId and Secret then click the Authorize button.
 

2023-09-01_8-22-38.jpg

 

3. Once authorized the previously red circle turns blue. There are no required parameters for this particular endpoint.  Click "Try it out!" button. The call is made and the response is displayed.

On the response you will receive the CURL command, the Request URL, the actual data, the Response Body, and the Response Headers.
 

 
Additional Information
Authentication is valid for one hour.  User can try multiple different endpoints within one hour without having to authorize again if done within one hour of when it was first authorized.

Note: It is not on the scope of Alteryx Support to troubleshoot external applications that use our API endpoints.  It is recommended to test the intended API endpoint using the Swagger API page and then use the response details created to transfer to the desired application.

Alteryx Server API V3 page contain the newest API Endpoints.  V1 and V2 are still available.  To switch to the other versions click on the Swagger URL drop-down to select the desired one then click on  the "Explore" button.
 

The Alteryx Server API endpoints can be imported into Postman by using the instructions on this article: How to Use Postman | Alteryx Help
For a few more details about API configuration and authorization see this article: Server API Configuration and Authorization | Alteryx Help
Was this article helpful?