REST API for Oracle Integration

Retrieve Permission Details

get

/ic/api/process/v1/spaces/{spaceId}/permissions/{principal}

Retrieve details of the specified permission including the name of the user, the role.

Request

Path Parameters

principal(required): string

The principal ID
spaceId(required): string

The space ID

Response

Supported Media Types

application/json
application/xml;qs=0.9

200 Response

Success. Retrieve Space Permission.

Root Schema : grant

Type: object

The representation of a Permission

401 Response

Unauthorized

403 Response

Privileges required. User can't view the space permissions

404 Response

Space/Space Permissions not found.

500 Response

Error in retrieving space permission

Examples

The following example shows how to retrieve details of a permissions by submitting a GET request on the REST resource.

Send Request

The following example shows the contents of the send request:

https://example.com/ic/api/process/v1/spaces/<spaceId>/permissions/<principal>

Where,

example.com is the host where Oracle Integration is running.
<spaceId> is the unique ID for a space. To retrieve available spaces, see Retrieve Spaces.
<principal> is the user name. To retrieve available permissions for a space, see List all permissions assigned to the given space.

Example of Response Header

Status Code: 200 OK
Date:  Tue, 21 Mar 2017 08:39:54 GMT
Content-Type:  application/json

Example of Response Body

{
  "user": "jsmith",
  "role": "OWNER",
  "links": [
    {
      "href": "http://example.com:7001/ic/api/process/v1/spaces/89f7e082-6855-4a75-b2a6-6a726aff7f23/permissions/jsmith",
      "rel": "self"
    },
    {
      "href": "http://example.com:7001/ic/api/process/v1/spaces/89f7e082-6855-4a75-b2a6-6a726aff7f23/permissions/jsmith",
      "rel": "canonical"
    },
    {
      "href": "http://example.com:7001/ic/api/process/v1/spaces/89f7e082-6855-4a75-b2a6-6a726aff7f23",
      "rel": "parent"
    }
  ]
}