Skip to main content

SCIM TaskInstance examples

Operations

List all

List all GroupUser.TaskInstances.

Request
GET http://<your-domain>/soffid/webservice/scim2/v1/GroupUserTaskInstance
Response 200 OK
{
    "schemas": [
        "urn:ietf:params:scim:api:messages:2.0:ListResponse"
    ],
    "totalResults": 25,6,
    "startIndex": 1,
    "Resources": [
        {
            "groupDescription"variables": {
                "requester": "Enterprise"admin",
                "grants": [
                    {
                        "ownersString": "SOFFID_ADMIN ",
                        "comments": "",
                        "roleId": 393447,
                        "userFullName": "Soffid Administrator",
                        "owners": [
                            "SOFFID_ADMIN"
                        ],
                        "userName": "admin",
                        "approved": false,
                        "applicationDescription": "SOFFID Identity Manager",
                        "taskInstance": 1762656,
                        "schemas": [
                            "urn:soffid:com.soffid.iam.addons.bpm.common.RoleRequestInfo"
                        ],
                        "denied": false,
                        "roleDescription": "Accounting Manager",
                        "applicationName": "Container/Business 2/SOFFID"
                    }
                ],
                "requesterName": "Soffid Administrator"
            },
            "processDefinition": 1762352,
            "description": "Approve ",
            "pooledActors": [
                "SOFFID_ADMIN"
            ],
            "priority": 3,
            "transitions": [
                "Rechazar",
                "Aceptar"
            ],
            "dummyTask": false,
            "processName": "Modificar permisos",
            "processId": 1762544,
            "blocking": false,
            "meta": {
                "location": "http://soffid.pat.lab:8080/webservice/scim2/v1/GroupUser/480412"TaskInstance/1762656",
                "resourceType": "GroupUser"TaskInstance"
            },
            "schemas": [
                "urn:soffid:com.soffid.iam.bpm.api.GroupUser"TaskInstance"
            ],
            "start"name": "2020-07-02 12:14:48"Approve",
            "fullName"create": "test2021-03-30 User"19:57:35",
            "disabled"cancelled": false,
            "attributes": {},
            "id": 480412,1762656,
            "user"open": "test2",true,
            "primaryGroup"signalling": false,
            "group": "enterprise"true
        },
        {
            "groupDescription"variables": {
                "requester": "Worldadmin",
                Modified""grants": [
                    {
                        "ownersString": "admin ",
                        "comments": "",
                        "roleId": 393447,
                        "userFullName": "Soffid Administrator",
                        "owners": [
                            "admin"
                        ],
                        "userName": "admin",
                        "approved": false,
                        "applicationDescription": "SOFFID Identity Manager",
                        "taskInstance": 1861549,
                        "schemas": [
                            "urn:soffid:com.soffid.iam.addons.bpm.common.RoleRequestInfo"
                        ],
                        "denied": false,
                        "roleDescription": "Accounting Manager",
                        "applicationName": "Operation/Business 2/SOFFID"
                    }
                ],
                "requesterName": "Soffid Administrator"
            },
            "processDefinition": 1946303,
            "description": "Approve pending permissions",
            "pooledActors": [
                "admin"
            ],
            "priority": 3,
            "transitions": [
                "Reject",
                "Approve"
            ],
            "dummyTask": false,
            "processName": "Permissions request",
            "processId": 1861537,
            "blocking": false,
            "meta": {
                "location": "http://soffid.pat.lab:8080/webservice/scim2/v1/GroupUser/503629"TaskInstance/1861549",
                "resourceType": "GroupUser"TaskInstance"
            },
            "schemas": [
                "urn:soffid:com.soffid.iam.bpm.api.GroupUser"TaskInstance"
            ],
            "start"name": "2020-08-06 15:52:12"Approve",
            "fullName": "test User",
            "end"create": "2021-02-2604-17 13:05:44"21:00:46",
            "disabled"cancelled": false,
            "id": 1861549,
            "open": true,
            "attributes"signalling": {},
            "id": 503629,
            "user": "test2",
            "primaryGroup": false,
            "group": "world2"true
        },
      {
            "groupDescription": "Enterprise Administrators Group",
            "meta": {
                "location": "http://soffid.pat.lab:8080/webservice/scim2/v1/GroupUser/1182887",
                "resourceType": "GroupUser"
            },
            "schemas": [
                "urn:soffid:com.soffid.iam.api.GroupUser"
            ],
            "start": "2020-12-31 16:48:58",
            "fullName": "John Smith",
            "disabled": false,
            "attributes": {
                "comments": "This is a test",
                "startDate": "2021-01-01 00:00:00"
            },
            "id": 1182887,
            "user": "jsmith",
            "primaryGroup": false,
            "group": "admingroup"
        },
      ....................
    ]
}

List by filter

List all GroupUsersTaskInstances with a filter expression.

It is allowed to use pagination and sort the information, for more information visit the Sorting and Pagination information.

Request

List all GroupUser with a filter expression. 

GET http://<your-domain>/soffid/webservice/scim2/v1/GroupUser?TaskInstance?count=2&filter=groupDescriptionprocessName eq "WorldPermissions Modified"request" and name eq Approve
Response 200 OK
{
    "schemas": [
        "urn:ietf:params:scim:api:messages:2.0:ListResponse"
    ],
    "totalResults": 4,
    "startIndex": 1,
    "Resources": [
        {
            "groupDescription"variables": {
                "requester": "Worldadmin",
                Modified""grants": [
                    {
                        "ownersString": "admin ",
                        "comments": "",
                        "roleId": 393447,
                        "userFullName": "Soffid Administrator",
                        "owners": [
                            "admin"
                        ],
                        "userName": "admin",
                        "approved": false,
                        "applicationDescription": "SOFFID Identity Manager",
                        "taskInstance": 1861549,
                        "schemas": [
                            "urn:soffid:com.soffid.iam.addons.bpm.common.RoleRequestInfo"
                        ],
                        "denied": false,
                        "roleDescription": "Accounting Manager",
                        "applicationName": "Operation/Business 2/SOFFID"
                    }
                ],
                "requesterName": "Soffid Administrator"
            },
            "processDefinition": 1946303,
            "description": "Approve pending permissions",
            "pooledActors": [
                "admin"
            ],
            "priority": 3,
            "transitions": [
                "Reject",
                "Approve"
            ],
            "dummyTask": false,
            "processName": "Permissions request",
            "processId": 1861537,
            "blocking": false,
            "meta": {
                "location": "http://soffid.pat.lab:8080/webservice/scim2/v1/GroupUser/503629"TaskInstance/1861549",
                "resourceType": "GroupUser"TaskInstance"
            },
            "schemas": [
                "urn:soffid:com.soffid.iam.bpm.api.GroupUser"TaskInstance"
            ],
            "start"name": "2020-08-06 15:52:12"Approve",
            "fullName": "test User",
            "end"create": "2021-02-2604-17 13:05:44"21:00:46",
            "disabled"cancelled": false,
            "id": 1861549,
            "open": true,
            "attributes"signalling": {},
            "id": 503629,
            "user": "test2",
            "primaryGroup": false,
            "group": "world2"true
        },
        {
            "groupDescription"variables": {
                "requester": "Worldadmin",
                Modified""grants": [
                    {
                        "ownersString": "admin ",
                        "comments": "",
                        "roleId": 393103,
                        "userFullName": "Soffid Administrator",
                        "owners": [
                            "admin"
                        ],
                        "userName": "admin",
                        "approved": false,
                        "applicationDescription": "Active Directory",
                        "taskInstance": 1638273,
                        "schemas": [
                            "urn:soffid:com.soffid.iam.addons.bpm.common.RoleRequestInfo"
                        ],
                        "denied": false,
                        "roleDescription": "Enterprise Administrators",
                        "applicationName": "Container/Business process/ad"
                    }
                ],
                "requesterName": "Soffid Administrator"
            },
            "processDefinition": 1946303,
            "start": "2021-05-10 12:57:31",
            "description": "Approve pending permissions",
            "pooledActors": [
                "admin"
            ],
            "priority": 3,
            "transitions": [
                "Reject",
                "Approve"
            ],
            "dummyTask": false,
            "actorId": "admin",
            "processName": "Permissions request",
            "processId": 1638261,
            "blocking": false,
            "meta": {
                "location": "http://soffid.pat.lab:8080/webservice/scim2/v1/GroupUser/1519730"TaskInstance/1638273",
                "resourceType": "GroupUser"TaskInstance"
            },
            "schemas": [
                "urn:soffid:com.soffid.iam.bpm.api.GroupUser"TaskInstance"
            ],
            "start"name": "Approve",
            "create": "2021-02-2003-11 18:08:23"16:33:41",
            "fullName"cancelled": "Dilbert ADAMS .",false,
            "end"id": "2021-02-20 19:07:45",1638273,
            "disabled"open": true,
            "attributes"signalling": {},
            "id": 1519730,
            "user": "dilbert",
            "primaryGroup": false,
            "group": "world2"true
        },
      {
            "groupDescription": "World Modified",
            "meta": {
                "location": "http://soffid.pat.lab:8080/webservice/scim2/v1/GroupUser/1521501",
                "resourceType": "GroupUser"
            },
            "schemas": [
                "urn:soffid:com.soffid.iam.api.GroupUser"
            ],
            "start": "2021-02-20 20:21:06",
            "fullName": "Dilbert ADAMS .",
            "disabled": false,
            "attributes": {},
            "id": 1521501,
            "user": "dilbert",
            "primaryGroup": false,
            "group": "world2"
        },
        {
            "groupDescription": "World Modified",
            "meta": {
                "location": "http://soffid.pat.lab:8080/webservice/scim2/v1/GroupUser/1558480",
                "resourceType": "GroupUser"
            },
            "schemas": [
                "urn:soffid:com.soffid.iam.api.GroupUser"
            ],
            "start": "2021-02-26 13:06:24",
            "fullName": "test User",
            "disabled": false,
            "attributes": {},
            "id": 1558480,
            "user": "test2",
            "primaryGroup": false,
            "group": "world2"
        }.............
    ]
}

Query by id

Query a GroupUser by its id (primary key). 

Request
GET http://<your-domain>/soffid/webservice/scim2/v1/GroupUser/1974296TaskInstance/1861549
Response 200 OK
{
    "groupDescription"variables": {
        "requester": "Helpadmin",
        desk"grants": support[
            team"{
                "ownersString": "admin ",
                "comments": "",
                "roleId": 393447,
                "userFullName": "Soffid Administrator",
                "owners": [
                    "admin"
                ],
                "userName": "admin",
                "approved": false,
                "applicationDescription": "SOFFID Identity Manager",
                "taskInstance": 1861549,
                "schemas": [
                    "urn:soffid:com.soffid.iam.addons.bpm.common.RoleRequestInfo"
                ],
                "denied": false,
                "roleDescription": "Accounting Manager",
                "applicationName": "Operation/Business 2/SOFFID"
            }
        ],
        "requesterName": "Soffid Administrator"
    },
    "processDefinition": 1946303,
    "description": "Approve pending permissions",
    "pooledActors": [
        "admin"
    ],
    "priority": 3,
    "transitions": [
        "Reject",
        "Approve"
    ],
    "dummyTask": false,
    "processName": "Permissions request",
    "processId": 1861537,
    "blocking": false,
    "meta": {
        "location": "http://soffid.pat.lab:8080/webservice/scim2/v1/GroupUser/1974296"TaskInstance/1861549",
        "resourceType": "GroupUser"TaskInstance"
    },
    "schemas": [
        "urn:soffid:com.soffid.iam.bpm.api.GroupUser"TaskInstance"
    ],
    "start"name": "Approve",
    "create": "2021-05-0504-17 12:49:51"21:00:46",
    "fullName": "John Smith",
    "disabled"cancelled": false,
    "attributes": {
        "startDate": "2021-05-04 00:00:00"
    },
    "id": 1974296,1861549,
    "user"open": "jsmith",true,
    "primaryGroup"signalling": false,
    "group": "it"true
}

Create

To create a GroupUser.TaskInstance.

Request

POST http://<your-domain>/soffid/webservice/scim2/v1/GroupUser

JSON

{
    "schemas": [
        "urn:soffid:com.soffid.iam.api.GroupUser"
    ],
    "group": "it",
    "groupDescription": "Help desk support team",
    "user": "ckelp",
    "fullName": "Casey Kelp",
    "primaryGroup": true,
    "attributes": {}
}-
Response 201 Created
{
    "groupDescription": "Help desk support team",
    "meta": {
        "location": "http://soffid.pat.lab:8080/webservice/scim2/v1/GroupUser/1976741",
        "resourceType": "GroupUser"
    },
    "schemas": [
        "urn:soffid:com.soffid.iam.api.GroupUser"
    ],
    "start": "2021-05-11 10:39:23",
    "fullName": "Casey Kelp",
    "disabled": false,
    "attributes": {},
    "id": 1976741,
    "user": "ckelp",
    "primaryGroup": true,
    "group": "it"
}-

Update partial

Update only of the attributes with changes, only these atrributes will be updated, the rest will maintain the same value.

Request
PATCH http://<your-domain>/soffid/webservice/scim2/v1/GroupUser/1976741

JSON

{
    "Operations": [
        {
            "op": "replace",
            "path": "groupDescription",
            "value": "Enterprise engineering team"
        },
        {
            "op": "replace",
            "path": "group",
            "value": "EngineeringTeam"
        }
    ]
}-
Response 200 OK
{
    "groupDescription": "Enterprise engineering team",
    "meta": {
        "location": "http://soffid.pat.lab:8080/webservice/scim2/v1/GroupUser/1976741",
        "resourceType": "GroupUser"
    },
    "schemas": [
        "urn:soffid:com.soffid.iam.api.GroupUser"
    ],
    "start": "2021-05-11 10:39:23",
    "fullName": "Casey Kelp",
    "disabled": false,
    "attributes": {},
    "id": 1976741,
    "user": "ckelp",
    "primaryGroup": true,
    "group": "EngineeringTeam"
}-

Update all

This operation replacereplaces all values in the GroupUser.

  • Note that the attribute id is required to confirm that the resource "...GroupUser/TaskInstance/<id>" is the same that the JSON GroupUser.TaskInstance.
  • Note that all the attributes not included in the request will be cleared in the GroupUserTaskInstance type and their data will be lost.
  • Note that not all the attributes are updatable, for example tag meta, avoid these tags. For more information seevisit Resource data model page
Request
PUT http://<your-domain>/soffid/webservice/scim2/v1/GroupUser/1976741-

JSON

{
    "schemas": [
        "urn:soffid:com.soffid.iam.api.GroupUser"
    ],
    "id": 1976741,
    "group": "it",
    "groupDescription": "Help desk support team",
     "user": "ckelp",
    "fullName": "Casey Kelp",
    "primaryGroup": true,
    "attributes": {}
}-
Response 200 OK
{
    "groupDescription": "Help desk support team",
    "meta": {
        "location": "http://soffid.pat.lab:8080/webservice/scim2/v1/GroupUser/1976741",
        "resourceType": "GroupUser"
    },
    "schemas": [
        "urn:soffid:com.soffid.iam.api.GroupUser"
    ],
    "fullName": "Casey Kelp",
    "disabled": false,
    "attributes": {},
    "id": 1976741,
    "user": "ckelp",
    "primaryGroup": true,
    "group": "it"
}-

Delete

Delete a role.

Please note after this delete, the account has to be created again to use it in the next examples.

Request
DELETE http://<your-omain>/soffid/webservice/scim2/v1/GroupUser/1976741-
Response 204 No Content
204 No Content

Error response

For more infomationinformation about error response visit https://bookstack.soffid.com/link/116#bkmrk-error-response