Jump to

• Request
• Response
• Examples

List Permissions Assigned to a Space

get

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

Retrieves all available permissions assigned to a space.

Request

Path Parameters

• spaceId: string
  The space ID

Back to Top

Response

Supported Media Types

• application/json
• application/xml;qs=0.9

200 Response

Success. Retrieve Space Permissions.

Body ()

Root Schema : schema

Type: array

Show Source

• Array of: object grant
  The representation of a Permission

{
    "type":"array",
    "items":{
        "$ref":"#/definitions/RestPermission"
    }
}

Nested 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 not found.

500 Response

Error in retrieving space permissions

Back to Top

Examples

The following example shows how to retrieve all available permissions assigned to a space 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

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.

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

{
  "items": [
    {
      "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"
        }
      ]
    }
  ],
  "links": [
    {
      "href": "http://example.com:7001/ic/api/process/v1/spaces/89f7e082-6855-4a75-b2a6-6a726aff7f23/permissions",
      "rel": "self"
    },
    {
      "href": "http://example.com:7001/ic/api/process/v1/spaces/89f7e082-6855-4a75-b2a6-6a726aff7f23/permissions",
      "rel": "canonical"
    },
    {
      "href": "http://example.com:7001/ic/api/process/v1/spaces/89f7e082-6855-4a75-b2a6-6a726aff7f23",
      "rel": "parent"
    }
  ]
}

Back to Top