Revoke a plan grant from a user
/apiplatform/management/v1/plans/{planId}/grants/{grantType}/users/{userId}
Revokes the {grantType}
grant for the {planId}
plan from the {userId}
user.
Users accessing this resource must be issued the API Manager role and must be issued the Manage API grant for the API associated with the specified plan.
Request
- application/json
-
grantType: string
The grant type.
-
planId: string
A unique ID referencing a specific plan.
-
userId: string
A unique ID referencing a specific user.
Response
- application/json
204 Response
403 Response
object
-
detail(optional):
string
Detailed error message
-
errorCode(optional):
string
Application specific error code
-
errorDetails(optional):
array errorDetails
additional errors
-
errorPath(optional):
string
-
instance(optional):
string
URI to the link that provides more detail about the error
-
status(optional):
string
HTTP status code
-
title:
string
Summary error message
-
type:
string
Error type
500 Response
object
-
detail(optional):
string
Detailed error message
-
errorCode(optional):
string
Application specific error code
-
errorDetails(optional):
array errorDetails
additional errors
-
errorPath(optional):
string
-
instance(optional):
string
URI to the link that provides more detail about the error
-
status(optional):
string
HTTP status code
-
title:
string
Summary error message
-
type:
string
Error type
Examples
The following example shows how to revoke a plan grant issued to a user by submitting a DELETE request on the REST resource using cURL. For more information about cURL, see Use cURL
curl -i -X DELETE
-H "Authorization: Bearer access_token"
https://example.com/apiplatform/management/v1/plans/{planId}/grants/{grantType}/users/{userId}
-
{planId}
is the unique Id for a plan. To retrieve available plan Ids, see Get plans. -
{grantType}
is the type of plan grant. To retrieve plan grants, see Get plan grants. -
{userId}
is the ID of the user you want to revoke the grant from. To retrieve the assigned this grant, see Get grants issued for a plan.
Example of Response Headers
The following shows an example of the response headers.
HTTP/1.1 204 No Content Server: Oracle-Traffic-Director/12.2.1.0.0 Date: Wed, 22 Mar 2017 08:54:00 GMT X-oracle-dms-ecid: 49d14691-2176-4c99-aed3-38438604f528-00001e65 X-oracle-dms-rid: 0:1 Via: 1.1 otd_opc Proxy-agent: Oracle-Traffic-Director/12.2.1.0.0