Jump to

• Request
• Response
• Examples

Update User Access

put

/rest/v19/companies/{companyName}/users/{userName}/accessPermissions

This endpoint replaces the access permissions of an existing user with new permissions passed in the request body.

Request

Supported Media Types

• application/json

Path Parameters

• companyName(required): string
  Company login name. For Host Company users, use _host. For Partner Organization users, use partner organization company login name.
• userName(required): string
  Login Id of the user

Body ()

Root Schema : accessPermissions-updateRequest

Type: object

Show Source

• items: array Access Permissions
  Title: Access Permissions

  List of access permissions to be updated for user, Entity's access will be removed if its details are not passed in request.

{
    "type":"object",
    "properties":{
        "items":{
            "type":"array",
            "description":"List of access permissions to be updated for user, Entity's access will be removed if its details are not passed in request.",
            "title":"Access Permissions",
            "items":{
                "$ref":"#/definitions/accessPermission"
            }
        }
    }
}

Nested Schema : Access Permissions

Type: array

Title: Access Permissions

List of access permissions to be updated for user, Entity's access will be removed if its details are not passed in request.

Show Source

• Array of: object Access Permission
  Title: Access Permission

  User access bits information

{
    "type":"array",
    "description":"List of access permissions to be updated for user, Entity's access will be removed if its details are not passed in request.",
    "title":"Access Permissions",
    "items":{
        "$ref":"#/definitions/accessPermission"
    }
}

Nested Schema : Access Permission

Type: object

Title: Access Permission

User access bits information

Show Source

• hasAccess: boolean
  Title: Has Access

  Flag to determine if user has access to the restricted entity
• name: string
  Title: Restricted Entity Name

  Name of the entity to which access restrictions apply
• type: string
  Title: Type

  Type of the restricted entity. Possible values productFamily, supportedProductFamily and dataTableFolder
• variableName: string
  Title: Restricted Entity Variable Name

  Variable name of the entity to which access restrictions apply

{
    "type":"object",
    "properties":{
        "name":{
            "type":"string",
            "description":"Name of the entity to which access restrictions apply",
            "title":"Restricted Entity Name"
        },
        "variableName":{
            "type":"string",
            "description":"Variable name of the entity to which access restrictions apply",
            "title":"Restricted Entity Variable Name"
        },
        "hasAccess":{
            "type":"boolean",
            "description":"Flag to determine if user has access to the restricted entity",
            "title":"Has Access"
        },
        "type":{
            "type":"string",
            "description":"Type of the restricted entity. Possible values productFamily, supportedProductFamily and dataTableFolder",
            "title":"Type"
        }
    },
    "title":"Access Permission",
    "description":"User access bits information"
}

Back to Top

Response

Supported Media Types

• application/json

Default Response

User Access Permissions

Body ()

Root Schema : Access Permissions

Type: object

Title: Access Permissions

Access Permissions of a user

Show Source

• items: array items
• links: array Links to the related objects
  Title: Links to the related objects

  Links to the related objects

{
    "type":"object",
    "properties":{
        "items":{
            "type":"array",
            "items":{
                "$ref":"#/definitions/accessPermission"
            }
        },
        "links":{
            "type":"array",
            "description":"Links to the related objects",
            "title":"Links to the related objects",
            "items":{
                "$ref":"#/definitions/link"
            }
        }
    },
    "title":"Access Permissions",
    "description":"Access Permissions of a user"
}

Nested Schema : items

Type: array

Show Source

• Array of: object Access Permission
  Title: Access Permission

  User access bits information

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

Nested Schema : Links to the related objects

Type: array

Title: Links to the related objects

Links to the related objects

Show Source

• Array of: object reference links
  Title: reference links

  Reference links for the Parent, Self, Children and Related as applicable

{
    "type":"array",
    "description":"Links to the related objects",
    "title":"Links to the related objects",
    "items":{
        "$ref":"#/definitions/link"
    }
}

Nested Schema : Access Permission

Type: object

Title: Access Permission

User access bits information

Show Source

• hasAccess: boolean
  Title: Has Access

  Flag to determine if user has access to the restricted entity
• name: string
  Title: Restricted Entity Name

  Name of the entity to which access restrictions apply
• type: string
  Title: Type

  Type of the restricted entity. Possible values productFamily, supportedProductFamily and dataTableFolder
• variableName: string
  Title: Restricted Entity Variable Name

  Variable name of the entity to which access restrictions apply

{
    "type":"object",
    "properties":{
        "name":{
            "type":"string",
            "description":"Name of the entity to which access restrictions apply",
            "title":"Restricted Entity Name"
        },
        "variableName":{
            "type":"string",
            "description":"Variable name of the entity to which access restrictions apply",
            "title":"Restricted Entity Variable Name"
        },
        "hasAccess":{
            "type":"boolean",
            "description":"Flag to determine if user has access to the restricted entity",
            "title":"Has Access"
        },
        "type":{
            "type":"string",
            "description":"Type of the restricted entity. Possible values productFamily, supportedProductFamily and dataTableFolder",
            "title":"Type"
        }
    },
    "title":"Access Permission",
    "description":"User access bits information"
}

Nested Schema : reference links

Type: object

Title: reference links

Reference links for the Parent, Self, Children and Related as applicable

Show Source

• href: string
  Title: URL to the related object

  URL to the related object
• name: string
• rel: string
  Title: Link Relationship to the current object

  Default Value: self

  Link Relationship to the current object

{
    "type":"object",
    "properties":{
        "rel":{
            "type":"string",
            "description":"Link Relationship to the current object",
            "title":"Link Relationship to the current object",
            "default":"self"
        },
        "href":{
            "type":"string",
            "description":"URL to the related object",
            "title":"URL to the related object"
        },
        "name":{
            "type":"string"
        }
    },
    "title":"reference links",
    "description":"Reference links for the Parent, Self, Children and Related as applicable"
}

Back to Top

Examples

This endpoint replaces the access permissions of an existing user with new permissions passed in the request body by submitting a PUT request to the REST resource using cURL. For more information about cURL, see Use cURL.

curl - X GET -H "Authorization: Bearer <token>" - H 
https://sitename.oracle.com/rest/v19/companies/_host/users/aavenkatbulk/accessPermissions

Request Body Sample

{
  "items": [{
      "name": "Testbed",
      "variableName": "testbed",
      "hasAccess": true,
      "type": "productFamily"
    }
  ]
}

Back to Top