Welcome to the Alteryx Knowledge Base
Created/Edited -
- Alteryx Server version 2021.4 or above
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.
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.
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.
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.
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.
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