Developer apps API
Manage developers that register apps.
Resource Types
APIProductRef
Method | Endpoint | Description |
---|---|---|
post | /organizations/{org_name}/developers/{developer_email}/apps | Creates an app associated with a developer, associates the app with an API product, and auto-generates an API key for the app to use in calls to API proxies inside the API product. The name is the unique ID of the app that you can use in Edge API calls. The The Ensure optimal API product and app security An organization-level property,
Note: Setting this organization property requires system administrator privileges. Edge for Private Cloud system administrators can add this property when updating organization properties. If you are an Edge for Public Cloud user, contact Apigee Support to set the organization property. |
delete | /organizations/{org_name}/developers/{developer_email}/apps/{app_name} | Deletes a developer app. With Apigee Edge for Public Cloud, deletion of the developer app and associated artifacts happens asynchronously. The developer app is deleted immediately, but the resources associated with that developer app, such as app keys or access tokens, may take anywhere from a few seconds to a few minutes to be automatically deleted. |
get | /organizations/{org_name}/developers/{developer_email}/apps/{app_name} | Gets the profile of a specific developer app. |
post | /organizations/{org_name}/developers/{developer_email}/apps/{app_name} | Approves, revokes, or generates an API key for a developer app. To approve or revoke the API key for a developer app, set Note: As a convenience, you can call the API with the To generate a new consumer key and consumer secret for the developer app, pass the required details, such as API products, in the request body. Rather than replace an existing key, the API generates a new key. For example, if you're using API key rotation, you can generate new keys with expiration times that overlap keys that will be out of rotation when they expire. You might also generate a new key/secret if the security of the original key/secret is compromised. After the new API key is generated, multiple key pairs will be associated with a single app. Each key pair has an independent status (revoked or approved) and an independent expiration time. Any non-expired, approved key can be used in an API call. You should revoke an API key that has been compromised. Note: You must include all current attribute and callback values in the payload; otherwise, the existing values are removed. If you want to set the consumer key and consumer secret rather than having Edge generate them randomly, see Import existing consumer keys and secrets. (However, that API does not let you set an expiration time.) |
put | /organizations/{org_name}/developers/{developer_email}/apps/{app_name} | Updates an existing developer app. You can add an app to an API product with this API, which automatically generates an API key for the app to use when calling APIs in the product. (Alternatively, you can add an API product to an existing key.) Note: You must include all current attribute, API product, and callback values in the payload along with any changes you want to make; otherwise, the existing values are removed. To display the current values, get the developer app profile. You cannot update the scopes associated with the app by using this API. Instead, use Update app scope API. Apigee Edge for Public Cloud only: OAuth access tokens and Key Management Service (KMS) entities (apps, developers, and API products) are cached for 180 seconds (current default). Any custom attributes associated with these entities also get cached for at least 180 seconds after the entity is accessed at runtime. Therefore, an |
Attribute
Method | Endpoint | Description |
---|---|---|
post | /organizations/{org_name}/developers/{developer_email}/apps | Creates an app associated with a developer, associates the app with an API product, and auto-generates an API key for the app to use in calls to API proxies inside the API product. The name is the unique ID of the app that you can use in Edge API calls. The The Ensure optimal API product and app security An organization-level property,
Note: Setting this organization property requires system administrator privileges. Edge for Private Cloud system administrators can add this property when updating organization properties. If you are an Edge for Public Cloud user, contact Apigee Support to set the organization property. |
delete | /organizations/{org_name}/developers/{developer_email}/apps/{app_name} | Deletes a developer app. With Apigee Edge for Public Cloud, deletion of the developer app and associated artifacts happens asynchronously. The developer app is deleted immediately, but the resources associated with that developer app, such as app keys or access tokens, may take anywhere from a few seconds to a few minutes to be automatically deleted. |
get | /organizations/{org_name}/developers/{developer_email}/apps/{app_name} | Gets the profile of a specific developer app. |
post | /organizations/{org_name}/developers/{developer_email}/apps/{app_name} | Approves, revokes, or generates an API key for a developer app. To approve or revoke the API key for a developer app, set Note: As a convenience, you can call the API with the To generate a new consumer key and consumer secret for the developer app, pass the required details, such as API products, in the request body. Rather than replace an existing key, the API generates a new key. For example, if you're using API key rotation, you can generate new keys with expiration times that overlap keys that will be out of rotation when they expire. You might also generate a new key/secret if the security of the original key/secret is compromised. After the new API key is generated, multiple key pairs will be associated with a single app. Each key pair has an independent status (revoked or approved) and an independent expiration time. Any non-expired, approved key can be used in an API call. You should revoke an API key that has been compromised. Note: You must include all current attribute and callback values in the payload; otherwise, the existing values are removed. If you want to set the consumer key and consumer secret rather than having Edge generate them randomly, see Import existing consumer keys and secrets. (However, that API does not let you set an expiration time.) |
put | /organizations/{org_name}/developers/{developer_email}/apps/{app_name} | Updates an existing developer app. You can add an app to an API product with this API, which automatically generates an API key for the app to use when calling APIs in the product. (Alternatively, you can add an API product to an existing key.) Note: You must include all current attribute, API product, and callback values in the payload along with any changes you want to make; otherwise, the existing values are removed. To display the current values, get the developer app profile. You cannot update the scopes associated with the app by using this API. Instead, use Update app scope API. Apigee Edge for Public Cloud only: OAuth access tokens and Key Management Service (KMS) entities (apps, developers, and API products) are cached for 180 seconds (current default). Any custom attributes associated with these entities also get cached for at least 180 seconds after the entity is accessed at runtime. Therefore, an |
get | /organizations/{org_name}/developers/{developer_email}/apps/{app_name}/attributes | Gets developer app attributes and their values. |
post | /organizations/{org_name}/developers/{developer_email}/apps/{app_name}/attributes | Updates app attributes. This API replaces the current list of attributes with the attributes specified in the request body. This lets you update existing attributes, add new attributes, or delete existing attributes by omitting them from the request body. Apigee Edge for Public Cloud only: OAuth access tokens and Key Management Service (KMS) entities (apps, developers, and API products) are cached for 180 seconds (current default). Any custom attributes associated with these entities also get cached for at least 180 seconds after the entity is accessed at runtime. Therefore, an |
delete | /organizations/{org_name}/developers/{developer_email}/apps/{app_name}/attributes/{attribute_name} | Deletes a developer app attribute. |
get | /organizations/{org_name}/developers/{developer_email}/apps/{app_name}/attributes/{attribute_name} | Gets a developer app attribute. |
post | /organizations/{org_name}/developers/{developer_email}/apps/{app_name}/attributes/{attribute_name} | Updates a developer app attribute. Apigee Edge for Public Cloud only: OAuth access tokens and Key Management Service (KMS) entities (apps, developers, and API products) are cached for 180 seconds (current default). Any custom attributes associated with these entities also get cached for at least 180 seconds after the entity is accessed at runtime. Therefore, an |
Attributes
Method | Endpoint | Description |
---|---|---|
get | /organizations/{org_name}/developers/{developer_email}/apps/{app_name}/attributes | Gets developer app attributes and their values. |
post | /organizations/{org_name}/developers/{developer_email}/apps/{app_name}/attributes | Updates app attributes. This API replaces the current list of attributes with the attributes specified in the request body. This lets you update existing attributes, add new attributes, or delete existing attributes by omitting them from the request body. Apigee Edge for Public Cloud only: OAuth access tokens and Key Management Service (KMS) entities (apps, developers, and API products) are cached for 180 seconds (current default). Any custom attributes associated with these entities also get cached for at least 180 seconds after the entity is accessed at runtime. Therefore, an |
DeveloperApp
Method | Endpoint | Description |
---|---|---|
post | /organizations/{org_name}/developers/{developer_email}/apps | Creates an app associated with a developer, associates the app with an API product, and auto-generates an API key for the app to use in calls to API proxies inside the API product. The name is the unique ID of the app that you can use in Edge API calls. The The Ensure optimal API product and app security An organization-level property,
Note: Setting this organization property requires system administrator privileges. Edge for Private Cloud system administrators can add this property when updating organization properties. If you are an Edge for Public Cloud user, contact Apigee Support to set the organization property. |
delete | /organizations/{org_name}/developers/{developer_email}/apps/{app_name} | Deletes a developer app. With Apigee Edge for Public Cloud, deletion of the developer app and associated artifacts happens asynchronously. The developer app is deleted immediately, but the resources associated with that developer app, such as app keys or access tokens, may take anywhere from a few seconds to a few minutes to be automatically deleted. |
get | /organizations/{org_name}/developers/{developer_email}/apps/{app_name} | Gets the profile of a specific developer app. |
post | /organizations/{org_name}/developers/{developer_email}/apps/{app_name} | Approves, revokes, or generates an API key for a developer app. To approve or revoke the API key for a developer app, set Note: As a convenience, you can call the API with the To generate a new consumer key and consumer secret for the developer app, pass the required details, such as API products, in the request body. Rather than replace an existing key, the API generates a new key. For example, if you're using API key rotation, you can generate new keys with expiration times that overlap keys that will be out of rotation when they expire. You might also generate a new key/secret if the security of the original key/secret is compromised. After the new API key is generated, multiple key pairs will be associated with a single app. Each key pair has an independent status (revoked or approved) and an independent expiration time. Any non-expired, approved key can be used in an API call. You should revoke an API key that has been compromised. Note: You must include all current attribute and callback values in the payload; otherwise, the existing values are removed. If you want to set the consumer key and consumer secret rather than having Edge generate them randomly, see Import existing consumer keys and secrets. (However, that API does not let you set an expiration time.) |
put | /organizations/{org_name}/developers/{developer_email}/apps/{app_name} | Updates an existing developer app. You can add an app to an API product with this API, which automatically generates an API key for the app to use when calling APIs in the product. (Alternatively, you can add an API product to an existing key.) Note: You must include all current attribute, API product, and callback values in the payload along with any changes you want to make; otherwise, the existing values are removed. To display the current values, get the developer app profile. You cannot update the scopes associated with the app by using this API. Instead, use Update app scope API. Apigee Edge for Public Cloud only: OAuth access tokens and Key Management Service (KMS) entities (apps, developers, and API products) are cached for 180 seconds (current default). Any custom attributes associated with these entities also get cached for at least 180 seconds after the entity is accessed at runtime. Therefore, an |
DeveloperAppRequest
Method | Endpoint | Description |
---|---|---|
post | /organizations/{org_name}/developers/{developer_email}/apps | Creates an app associated with a developer, associates the app with an API product, and auto-generates an API key for the app to use in calls to API proxies inside the API product. The name is the unique ID of the app that you can use in Edge API calls. The The Ensure optimal API product and app security An organization-level property,
Note: Setting this organization property requires system administrator privileges. Edge for Private Cloud system administrators can add this property when updating organization properties. If you are an Edge for Public Cloud user, contact Apigee Support to set the organization property. |
put | /organizations/{org_name}/developers/{developer_email}/apps/{app_name} | Updates an existing developer app. You can add an app to an API product with this API, which automatically generates an API key for the app to use when calling APIs in the product. (Alternatively, you can add an API product to an existing key.) Note: You must include all current attribute, API product, and callback values in the payload along with any changes you want to make; otherwise, the existing values are removed. To display the current values, get the developer app profile. You cannot update the scopes associated with the app by using this API. Instead, use Update app scope API. Apigee Edge for Public Cloud only: OAuth access tokens and Key Management Service (KMS) entities (apps, developers, and API products) are cached for 180 seconds (current default). Any custom attributes associated with these entities also get cached for at least 180 seconds after the entity is accessed at runtime. Therefore, an |