Jump to

• Request
• Response
• Examples

Grant or Revoke Preferences for the Logged in User

post

/ic/api/process/v1/preferences

Grant or revoke user preferences and application preferences for the logged in user. You must be an administrator to grant or revoke application preferences

Request

Supported Media Types

• application/json

Query Parameters

• operation: string
  Operation - grant OR revoke. Default operation is grant

  Default Value: grant

Body ()

PreferenceRequest Object

Root Schema : preferencesResponse

Type: object

Show Source

• appPrefKeys: array appPrefKeys
• appPrefReq: object appPrefReq
  Additional Properties Allowed: additionalProperties
• deleteAllAppPreferences: boolean
• deleteAllUserPreferences: boolean
• userPrefKeys: array userPrefKeys
• userPrefReq: object userPrefReq
  Additional Properties Allowed: additionalProperties

{
    "type":"object",
    "properties":{
        "userPrefReq":{
            "type":"object",
            "additionalProperties":{
                "type":"object"
            }
        },
        "appPrefReq":{
            "type":"object",
            "additionalProperties":{
                "type":"object"
            }
        },
        "userPrefKeys":{
            "type":"array",
            "items":{
                "type":"string"
            }
        },
        "appPrefKeys":{
            "type":"array",
            "items":{
                "type":"string"
            }
        },
        "deleteAllUserPreferences":{
            "type":"boolean"
        },
        "deleteAllAppPreferences":{
            "type":"boolean"
        }
    },
    "xml":{
        "name":"preferencesResponse",
        "namespace":"http://xmlns.oracle.com/bpm/rest/preference"
    }
}

Nested Schema : appPrefKeys

Type: array

Show Source

• Array of: string

{
    "type":"array",
    "items":{
        "type":"string"
    }
}

Nested Schema : appPrefReq

Type: object

Additional Properties Allowed

Show Source

• object additionalProperties

{
    "type":"object",
    "additionalProperties":{
        "type":"object"
    }
}

Nested Schema : userPrefKeys

Type: array

Show Source

• Array of: string

{
    "type":"array",
    "items":{
        "type":"string"
    }
}

Nested Schema : userPrefReq

Type: object

Additional Properties Allowed

Show Source

• object additionalProperties

{
    "type":"object",
    "additionalProperties":{
        "type":"object"
    }
}

Nested Schema : additionalProperties

Type: object

Nested Schema : additionalProperties

Type: object

Back to Top

Response

Supported Media Types

• application/json

200 Response

Success

Body ()

Root Schema : preferencesResponse

Type: object

Show Source

• appPrefResponse: object appPrefResponse
  Additional Properties Allowed: additionalProperties
• invalidUsers: array invalidUsers
• levels: integer(int32)
• links: array links
• message: string
• title: string
• userPrefResponse: object userPrefResponse
  Additional Properties Allowed: additionalProperties

{
    "type":"object",
    "properties":{
        "userPrefResponse":{
            "type":"object",
            "additionalProperties":{
                "type":"string"
            }
        },
        "appPrefResponse":{
            "type":"object",
            "additionalProperties":{
                "type":"string"
            }
        },
        "levels":{
            "type":"integer",
            "format":"int32",
            "xml":{
                "attribute":true
            }
        },
        "links":{
            "type":"array",
            "items":{
                "xml":{
                    "name":"links"
                },
                "$ref":"#/definitions/Link"
            }
        },
        "title":{
            "type":"string"
        },
        "invalidUsers":{
            "type":"array",
            "items":{
                "type":"string"
            }
        },
        "message":{
            "type":"string"
        }
    },
    "xml":{
        "name":"preferencesResponse",
        "namespace":"http://xmlns.oracle.com/bpm/rest/preference"
    }
}

Nested Schema : appPrefResponse

Type: object

Additional Properties Allowed

Show Source

• string

{
    "type":"object",
    "additionalProperties":{
        "type":"string"
    }
}

Nested Schema : invalidUsers

Type: array

Show Source

• Array of: string

{
    "type":"array",
    "items":{
        "type":"string"
    }
}

Nested Schema : links

Type: array

Show Source

• Array of: object Link

{
    "type":"array",
    "items":{
        "xml":{
            "name":"links"
        },
        "$ref":"#/definitions/Link"
    }
}

Nested Schema : userPrefResponse

Type: object

Additional Properties Allowed

Show Source

• string

{
    "type":"object",
    "additionalProperties":{
        "type":"string"
    }
}

Nested Schema : Link

Type: object

Show Source

• href: string
• mediaType: string
• rel: string

{
    "type":"object",
    "properties":{
        "rel":{
            "type":"string"
        },
        "href":{
            "type":"string"
        },
        "mediaType":{
            "type":"string"
        }
    }
}

400 Response

Bad request

401 Response

Unauthorized

500 Response

Internal Server Error

Back to Top

Examples

The following examples show how to set user and application preferences for the logged in user by submitting a POST request on the REST resource.

Example: Set user and application preferences for the logged in user

Send Request:

POST https://example.com/ic/api/process/v1/preferences

Request Body:

Start and end date must be in ISO-8601 format.

{
 "userPrefReq" : {
                "NOTIFICATION_TZ": "PST",
                "TASKLIST_FETCH_SIZE" : "50",
                "TASKLIST_DEFAULT_GROUPING" : "PROCESS_NAME",
                "VACATION_RULE": {
                        "targetUser" : "jcooper", 
                        "detail" : { "action":"DELEGATE", "startDate" : "2019-10-07", "endDate" : "2019-12-09"}
                                 }
                 },
 "appPrefReq" : {
                    "TASKLIST_FETCH_SIZE" : "50",
                    "TASKLIST_DEFAULT_GROUPING" : "PROCESS_NAME"
                }
}

Back to Top