Explore the App Center API Service with swagger.
Navigate to https://appcenter.ms and login with your account information.
On the bottom left corner, click your username and select Account Settings.
In the middle panel, select API Tokens from the menu list.
On the top right corner, click New API token.
In the text field, enter a descriptive name for your token.
Select the type of access for your API token:
Full Access: A full access API token has all the permissions that the associated user has for that app. For example, if the user does not have manager or developer permissions for an app, the user cannot run a test (which requires developer or manager permissions) even though the user is using a full access API token.
Read Only: A read only API token has viewer access permissions. For example, with a read only API token, the user can perform actions such as reading data from crashes, analytics, and getting basic app information. Users cannot perform actions such as changing the app settings, triggering a build, creating an export configuration etc.
At the bottom of the panel, click Add new API token.
This will generate a pop up with your API token. Copy and store it in a secure location for later use. For security reasons, you will not be able to see or generate the same token again after you click the Close button.
Click the Close button.
Navigate to App Center's swagger page to explore our APIs.
On the upper right corner, click on the Authorize button.
Under the APIToken section, paste the API token value that you just copied into the text field titled Value and click Authorize.
If it shows "Authorized" and a Logout-Button, authorization was successful. On the top right corner of the pop up, click the "X" to exit the pop up.
You are now able to use any App Center API and see the response. Enjoy!
Running your first API call
This section shows you how to use App Center's swagger page by using the API call
GET /v0.1/user. This API call returns the user's profile data.
- Complete steps 1-14 in the previous section.
- Navigate to App Center's swagger page to explore our APIs.
- Under Account, click on
- On the left-hand corner, click the Try it out button.
- Click the Execute button under the Parameters section.
- Awesome! You can now see the response under the Responses section.
How to find your app name and owner name
Some of App Center's API and CLI require an app name and owner name as parameters. An example is the API call to remove the user from the app,
You can find the app name and owner name from your App Center app URL, or using the App Center CLI.
Here are the steps to do so:
From App Center app URL
- Navigate to https://appcenter.ms.
- Navigate to your app.
- When you look at your app's URL, it is in the format
Owners can be user or org. For example,
|Owner||URL||Owner name||App name|
From App Center CLI
App Center CLI requires Node.js version 8 or higher.
- Open your terminal window in Mac or Linux, or command prompt in Windows.
npm install -g appcenter-cli.
appcenter apps list. You will see a list of apps with the format
Please refer to App Center CLI for the full documentation and list of commands.