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.
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
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.
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.