Clear App Config
DELETE/api/v1/apps/:service/:instance/config
Remove options from the overlay, so the app runs its own default for each.
A cleared option reads back unset with provenance default, so it follows the
default when the default next moves. Writing the default back would instead
leave an override that only matches it today, and a PUT of null stores null,
which many options take as a value of its own.
A path the overlay does not hold is already clear and commits nothing. Clearing
a field beside a stored credential in the same mapping is a 400
credential_reentry_required, as the PUT of a new value there is, unless the
request clears that credential too.
Request
Responses
- 200
- 401
- 403
- 422
- default
Successful Response
No valid session: the credentials are missing, invalid or expired, or the account behind them is disabled or blocked
Refused: the session lacks the action this route checks, or its account must replace an issued password first. A SCIM route answers a refused action in the RFC 7644 error envelope
Validation Error
Problem details (RFC 9457)