Skip to main content

SCIM Group type examples

Operations

This page shows the operations that can be performed for the Group Type object

List all

Request
GET https://<your-domain>/soffid/webservice/scim2/v1/GroupType
Response 200 OK
{
  "schemas": [
    "urn:ietf:params:scim:api:messages:2.0:ListResponse"
  ],
  "totalResults": 2,
  "startIndex": 1,
  "Resources": [
    {
      "roleHolder": false,true,
      "updatedBy": "admin",
      "createdBy": "admin",
      "meta": {
        "location": "http:https://soffid.pat.lab:8080/console.soffid4.local:8443/soffid/webservice/scim2/v1/OUType/504761"GroupType/24552",
        "resourceType": "OUType"GroupType"
      },
      "schemas": [
        "urn:soffid:com.soffid.iam.iga.api.OUType"GroupType"
      ],
      "name": "CC"App Billing Role",
      "description": "CostRole Center"Admin for Billing application",
      "id": 50476124552,
      "updatedOn": "2026-03-06 08:37:45",
      "createdOn": "2026-03-06 08:37:45"
    },
    {
      "roleHolder": false,true,
      "updatedBy": "admin",
      "createdBy": "admin",
      "meta": {
        "location": "http:https://soffid.pat.lab:8080/console.soffid4.local:8443/soffid/webservice/scim2/v1/OUType/504762"GroupType/24553",
        "resourceType": "OUType"GroupType"
      },
      "schemas": [
        "urn:soffid:com.soffid.iam.iga.api.OUType"GroupType"
      ],
      "name": "PC"Example group type",
      "description": "ProductiveExample center"group type",
      "id": 50476224553,
      "updatedOn": "2026-03-06 08:38:43",
      "createdOn": "2026-03-06 08:38:43"
    }
  ]
}

List by filter

List all group types with a filter expression.

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

Request
GET https://<your-domain>/soffid/webservice/scim2/v1/GroupType?filter=description co Costexa
Response 200 OK
{
  "schemas": [
    "urn:ietf:params:scim:api:messages:2.0:ListResponse"
  ],
  "totalResults": 1,
  "startIndex": 1,
  "Resources": [
    {
      "roleHolder": false,true,
      "updatedBy": "admin",
      "createdBy": "admin",
      "meta": {
        "location": "http:https://soffid.pat.lab:8080/console.soffid4.local:8443/soffid/webservice/scim2/v1/OUType/504761"GroupType/24553",
        "resourceType": "OUType"GroupType"
      },
      "schemas": [
        "urn:soffid:com.soffid.iam.iga.api.OUType"GroupType"
      ],
      "name": "CC"Example group type",
      "description": "CostExample Center"group type",
      "id": 50476124553,
      "updatedOn": "2026-03-06 08:38:43",
      "createdOn": "2026-03-06 08:38:43"
    }
  ]
}

Query by id

Query a group type by its id (primary key). 

Request
GET https://<your-domain>/soffid/webservice/scim2/v1/GroupType/50476124553
Response 200 OK
{
  "roleHolder": false,true,
  "updatedBy": "admin",
  "createdBy": "admin",
  "meta": {
    "location": "http:https://soffid.pat.lab:8080/console.soffid4.local:8443/soffid/webservice/scim2/v1/OUType/504761"GroupType/24553",
    "resourceType": "OUType"GroupType"
  },
  "schemas": [
    "urn:soffid:com.soffid.iam.iga.api.OUType"GroupType"
  ],
  "name": "CC"Example group type",
  "description": "CostExample Center"group type",
  "id": 50476124553,
  "updatedOn": "2026-03-06 08:38:43",
  "createdOn": "2026-03-06 08:38:43"
}

Create

Request

POST https://<your-domain>/soffid/webservice/scim2/v1/GroupType

JSON

{
    "schemas": [
        "urn:soffid:com.soffid.iam.iga.api.Role"GroupType"
    ],
    "name": "AppExample Billinggroup Role"type",
    "description": "RoleExample Admingroup for Billing application"type",
    "informationSystemName"roleHolder": "Operation/Business 2/App Billing",
    "system": "test",
    "password": false,
    "bpmEnabled": false,
    "enableByDefault": false,
    "granteeGroups": [],
    "ownedRoles": [],
    "ownerGroups": [],
    "ownerRoles": []true
}
Response 201 Created
{
  "roleHolder": true,
  "updatedBy": "admin",
  "createdBy": "admin",
  "meta": {
    "location": "https://console.soffid4.local:8443/soffid/webservice/scim2/v1/GroupType/24553",
    "resourceType": "GroupType"
  },
  "schemas": [
    "urn:soffid:com.soffid.iam.iga.api.OUType"GroupType"
  ],
  "name": "NewOU"Example group type",
  "description": "NewExample OU"group type",
  "id": 24553,
  "updatedOn": "2026-03-06 08:38:43.002",
  "createdOn": "2026-03-06 08:38:43.002"
}

Update partial

Only attributes with changes will be updated, the other will maintain the same value.

Request
PATCH https://<your-domain>/soffid/webservice/scim2/v1/GroupType/1976710

JSON

{
    "Operations": [
        {
            "op": "replace",
            "path": "name",
            "value": "OU"
        }
    ]
}
Response 200 OK
{
    "roleHolder": false,
    "meta": {
        "location": "http://soffid.pat.lab:8080/soffid/webservice/scim2/v1/OUType/GroupType/1976710",
        "resourceType": "OUType"
    },
    "schemas": [
        "urn:soffid:com.soffid.iam.iga.api.OUType"GroupType"
    ],
    "name": "OU",
    "description": "New OU",
    "id": 1976710
}

Update all

This operation replaces all values in the group type.

  • Note that the attribute id is required to confirm that the resource "...OUType/<id>" is the same that the JSON group type.
  • Note that all the attributes not included in the request will be cleared in the group 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 visit Resource data model page
Request
PUT https://<your-domain>/soffid/webservice/scim2/v1/GroupType/1976590

JSON

{
    "schemas": [
        "urn:soffid:com.soffid.iam.iga.api.OUType"GroupType"
    ],
    "id": 1976710,
    "name": "ChangeOU"
}
Response 200 OK
{
    "roleHolder": false,
    "meta": {
        "location": "http://soffid.pat.lab:8080/soffid/webservice/scim2/v1/OUType/GroupType/1976710",
        "resourceType": "OUType"
    },
    "schemas": [
        "urn:soffid:com.soffid.iam.base.api.OUType"GroupType"
    ],
    "name": "ChangeOU",
    "id": 1976710
}

Delete

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

Request
DELETE https://<your-omain>/soffid/webservice/scim2/v1/GroupType/1976710
Response 204 No Content
204 No Content

Error response

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


Back to top