Example: Creating, Updating, and Deleting Apps and Authorizations
Reading apps and keys
This page covers creating, updating, and deleting apps and keys using the REST Platform API. For reading apps and keys, see Example: Obtaining apps and keys for users and teams.
The examples below use the REST Platform API.
Creating an app
You can use the POST Create App
endpoint to create an app for the team or personal account context selected in the team dropdown. In the body of the request, you must pass a JSON object with the name of the app, as well as an option description.
The call to Create App
returns the new appId
as well as the value of the X-RapidAPI-Key
that is automatically created when creating the app. The key is associated with the Production
applicationEnvironmentName. The Testing
applicationEnvironmentName is not used.
Here's an example where we create an app for Team A1
(selected in the team dropdown offscreen):
You can then view the new app in the team's Developer Dashboard (Apps). The appID
is shown under the new app name. The Description is shown in the Configuration tab. The X-RapidAPI-Key is in the Authorization tab.
The new app's information is also available programmatically. See Example: Obtaining apps and keys for users and teams.
If you have Admin access to the Platform API, you can use the optional on-behalf-of
header to create apps to be owned by any team or user. The value of the on-behalf-of
header is the team or user ID.
Here is an example that creates an app to be owned by a user with the ID of 5713300
:
Create an authorization within an app
Currently, you must use the GraphQL Platform API to create an authorization (or X-RapidAPI-Key) within an app. This uses mutation.createApplicationAuthorization
. See API Access Provisioning (Preview)
Updating an app
Use the PUT Update App
endpoint to update an app's name or description. You must pass the appId
(obtained above) to identify which app you would like to update.
If you have Admin access to the Platform API, you can use the optional on-behalf-of
header to update apps owned by any team or user. The value of the on-behalf-of
header is the team or user ID.
The Update App
endpoint returns 204 Success
if the update is successful.
Update an authorization within the app
Currently, you must use the GraphQL Platform API to update an authorization (or X-RapidAPI-Key) within an app. This uses mutation.updateApplicationAuthorization
. See Apps and authorizations.
Deleting an app
Use the DELETE DELETE App
endpoint to delete an app. You must pass the appId
(obtained above) to identify which app you would like to delete.
If you have Admin access to the Platform API, you can use the optional on-behalf-of
header to delete apps owned by any team or user. The value of the on-behalf-of
header is the team or user ID.
The Delete App
endpoint returns 204 Success
if the update is successful.
Delete an authorization within an app
Currently, you must use the GraphQL Platform API to delete an authorization (or X-RapidAPI-Key) within an app. This uses mutation.deleteApplicationAuthorization
. See Apps and authorizations.
Updated 11 months ago