DELETE/api/apis/{api_server_id}/connect_app/{client_app_id}Authenticated

Disconnect an app from an API server

Revokes the client application's connection to the API server so it can no longer be issued access tokens for it. Responds 404 when the app was not connected.

operationId delete_api_apis_api_server_id_connect_app_client_app_idAPI servers

Authentication & permissionsAuthenticated

Any authenticated user

Accepted credentials: Auth server session (refresh token cookie)cookie "refresh_token_<auth_server_app_id>"
Access token (cookie)cookie "access_token_<auth_server_app_id>"
Access token (Bearer)Authorization: Bearer <JWT>
Who may call: Any authenticated user
Notes: The caller must own the client application (organization owner, owning user, or platform administrator) and, unless the API server is a public hardcoded one, must own the API server too.

Path parameters

Name	Type	Description
api_server_id*	string	API server id
client_app_id*	string	Client application id

Responses

application/json

SuccessMessageResponse

Property	Type	Description
success*	true
message*	string

JSONExample

"success"true

"message""string"

Example request

bashcurl

curl -X DELETE 'https://auth.schemavaults.com/api/apis/<api_server_id>/connect_app/<client_app_id>' \
  -b 'refresh_token_<auth_server_app_id>=<value>'

Authentication & permissionsAuthenticated

Path parameters

Responses

200The app was disconnected

400The request failed validation (issues lists the offending fields) or was refused by the handler

401No valid session cookie, access token cookie or bearer access token was presented, or the token was revoked

403The account is disabled, or the credential is valid but not allowed to perform this operation

404No such app, API server, or connection

500Failed to disconnect the app

Example request

Other methods on this path