REST API for Oracle Identity Governance Self Service

Delete account based on account id

delete

/iam/governance/selfservice/api/v1/accounts/{accountid}

Revokes the account instance specified by the account id which was provisioned one for a particular user. For example: To get a list of accounts provisioned to a user the URI is /account?userid={userKey}. Then obtain the ID from one of the accounts that is provisioned and able to be revoked, the {accountID}

Request

Supported Media Types

application/json

Path Parameters

accountid: string

Target Account ID

Response

Supported Media Types

application/json

200 Response

Successful

Headers

ResponseTime: string

Captures the time in milliseconds taken for processing the request.

Root Schema : SingleAccountDeleteResponse

Type: object

Show Source

id(optional): string
name(optional): string
requestId(optional): string
status(optional): string

{
    "properties":{
        "requestId":{
            "type":"string"
        },
        "status":{
            "type":"string"
        },
        "id":{
            "type":"string"
        },
        "name":{
            "type":"string"
        }
    }
}

401 Response

Unauthorized

404 Response

Requested entity not found

500 Response

Internal Server Error

Default Response

Unexpected error

Examples

This example demonstrates how to delete an account. The information shown here is against a pseudo system and serves as a prototype.

cURL Example

curl -k -X DELETE -H "Authorization: Bearer eyJhbGciOiJSUzblahblah.eysidfhlshfuiblahblah.fP__sJhuevcwOtdLAmkd69hzciI-_famO1ZvTX1blahblah" -H "Content-Type: application/json" 'https://idvm1.example.com:14001/iam/governance/selfservice/api/v1/accounts/53'

Example of GET Response Body

The following example shows the contents of the response body in JSON format.

{   
       "requestId": "", 
       "status": "Revoked",
       "id": "53",
       "name": "REST.USER03@EXAMPLE.COM"
}