GET /api/app/getAccessProfiles

This API’s shutoff date has been extended to November 1st.

The replacement for this API is

For a full mapping of /api/app replacements, please see this doc

IDN-V2024 Public Preview Apps API mapping from legacy CC endpoints-090924-215538.pdf (595.0 KB)

v2024 experimental endpoints will be available by end of this week. Both beta and v2024 experimental may change with little to no notice. Please see our API versioning strategy for more information.

3 Likes

The replacement APIs are now available. Please see the first post for more details.

It looks like the documentation for the new API endpoint is missing the query parameter “offset”. I’ve tested this and can see that it does work, but would be good to have this documented and confirmed that this is going to be a supported query. We have applications with over 250 access profiles in them, so definitely need to be able to use offsets to query this API.
list-access-profiles-for-source-app | SailPoint Developer Community

1 Like

Thank you for reporting this. It looks like we forgot to document the offset query parameter. offset is supported, so if you can use it on an endpoint then you can rely on it being supported. We have a ticket ( DEVREL-1774) to document the offset query param for all the App endpoints.

For the replacement API, I see there is “/2024” in the endpoint URL. Are there plans to change this to be in line with the other non-experimental API endpoints? We need to start using the replacement API, but we need to understand if the URL will change. We rely on this functionality in production.

Hi William,

As you have noted, the replacement is currently in an “Experimental” state. You must set the experimental header in order to use it. Once it is out of experimental state, you do not need to update anything in your code. It will automatically use the production route.

Experimental endpoints may stay experimental for up to 6 months.

Reminder, this API will be turned off on November 1st, 2024. Please make sure you migrate to the replacement API ASAP.