Managing Access to a Marketplace Listing with the API

Using this API select an access management option to grant or revoke access to a Marketplace listing owned by your organization.

To update access for a Marketplace listing you need the following:

Subscription Locator — The Subscription Locator of the Organization you want to access. To find Subscription Locators for your organizations use the GET /v1/userinfo method to return a list of all of the organizations for your OAuth Token with their Subscription Locators. You can use 0 as the Subscription Locator for the organization that owns the OAuth token. This is the Subscription Locator for the organization that owns the Marketplace listing.
Listing ID — ID of the Marketplace listing, which can be retrieved using the GET /v1/subscriptions/{subscriptionLocator}/marketplace/listings method.
Customer Subscription Locator — The Subscription Locator of the organization for which you are granting or revoking access.
Action — The access action you want to perform. Actions include:
- approve — Grant access to the organization designated in the customerSubscriptionLocator field.
- reject — Reject a request for access for the organization designated in the customerSubscriptionLocator field.
- revoke — Remove access for the organization designated in the customerSubscriptionLocator field.
- unrevoke — If you have revoked access for an organization, you can re-grant access to the organization designated in the customerSubscriptionLocator field.

Call the POST /v1/subscriptions/{subscriptionLocator}/marketplace/listings/{listingId}/access method to update access for the selected customer and Marketplace listing.
Use the listingId parameter to indicate the listing for the customer.
Use the customerSubscriptionLocator parameter to select the organization for which you are granting or revoking access.
Use the action parameter to grant or remove access for a customer organization.
Use the GET /v1/subscriptions/{subscriptionLocator}/marketplace/customers method to verify that the customer access to the listing has been updated.

Role Requirements

This method requires an Admin role.