Jump to

• Request
• Response

Modify a group

patch

/iam/directory/oud/scim/v1/Groups/{entryUUID}

by giving the EntryUUID

Request

Supported Media Types

• application/scim+json

Path Parameters

• entryUUID: string
  LDAP DN of the entry to be modified

Body ()

Entry that needs to be modified

Root Schema : PatchRequest

Type: object

Show Source

• Operations: array Operations
  Modifications (Patch operations) to be performed on the User.
• schemas: array schemas
  The schema for the Patch operation type

{
    "type":"object",
    "required":[
        "schemas",
        "Operations"
    ],
    "properties":{
        "schemas":{
            "description":"The schema for the Patch operation type",
            "default":[
                "urn:ietf:params:scim:api:messages:2.0:PatchOp"
            ],
            "type":"array",
            "items":{
                "type":"string"
            }
        },
        "Operations":{
            "type":"array",
            "description":"Modifications (Patch operations) to be performed on the User.",
            "items":{
                "$ref":"#/definitions/PatchOperation"
            }
        }
    }
}

Nested Schema : Operations

Type: array

Modifications (Patch operations) to be performed on the User.

Show Source

• Array of: object PatchOperation

{
    "type":"array",
    "description":"Modifications (Patch operations) to be performed on the User.",
    "items":{
        "$ref":"#/definitions/PatchOperation"
    }
}

Nested Schema : schemas

Type: array

The schema for the Patch operation type

Default Value: [ "urn:ietf:params:scim:api:messages:2.0:PatchOp" ]

Show Source

• Array of: string

{
    "description":"The schema for the Patch operation type",
    "default":[
        "urn:ietf:params:scim:api:messages:2.0:PatchOp"
    ],
    "type":"array",
    "items":{
        "type":"string"
    }
}

Nested Schema : PatchOperation

Type: object

Show Source

• op: string
  Allowed Values: [ "add", "delete", "replace" ]

  The type of the Patch Operation.
• path: string
  The path of the entry attribute to be modified.
• value: array value
  • The entire complex attributes like addresses
  • The value of simple attributeThe attribute values to be updated.

{
    "type":"object",
    "required":[
        "op",
        "path",
        "value"
    ],
    "properties":{
        "op":{
            "description":"The type of the Patch Operation.",
            "type":"string",
            "enum":[
                "add",
                "delete",
                "replace"
            ]
        },
        "path":{
            "type":"string",
            "description":"The path of the entry attribute to be modified."
        },
        "value":{
            "type":"array",
            "description":"<ul><li>The entire complex attributes like addresses</li><li>The value of simple attribute</li</ul>The attribute values to be updated.",
            "items":{
                "type":"object"
            }
        }
    }
}

Nested Schema : value

Type: array

• The entire complex attributes like addresses
• The value of simple attributeThe attribute values to be updated.

Show Source

• Array of: object items

{
    "type":"array",
    "description":"<ul><li>The entire complex attributes like addresses</li><li>The value of simple attribute</li</ul>The attribute values to be updated.",
    "items":{
        "type":"object"
    }
}

Nested Schema : items

Type: object

Back to Top

Response

Supported Media Types

• application/scim+json

200 Response

OK

Body ()

Root Schema : GroupSuccessResponse

Type: object

Show Source

• Resources: array Resources
  Number of search result entries returned after the LDAP operation.
• schemas: string
  Default Value: urn:ietf:params:scim:api:messages:2.0:ListResponse

  The REST message schema
• totalResults: integer(int32)
  Specifies the number of entries created, and returned.

{
    "type":"object",
    "required":[
        "schemas",
        "totalResults",
        "Resources"
    ],
    "properties":{
        "schemas":{
            "description":"The REST message schema",
            "type":"string",
            "default":"urn:ietf:params:scim:api:messages:2.0:ListResponse"
        },
        "totalResults":{
            "type":"integer",
            "format":"int32",
            "description":"Specifies the number of entries created, and returned."
        },
        "Resources":{
            "type":"array",
            "description":"Number of search result entries returned after the LDAP operation.",
            "items":{
                "$ref":"#/definitions/GroupSearchResultEntry"
            }
        }
    }
}

Nested Schema : Resources

Type: array

Number of search result entries returned after the LDAP operation.

Show Source

• Array of: object GroupSearchResultEntry

{
    "type":"array",
    "description":"Number of search result entries returned after the LDAP operation.",
    "items":{
        "$ref":"#/definitions/GroupSearchResultEntry"
    }
}

Nested Schema : GroupSearchResultEntry

Type: object

Show Source

• schemas: string
  Allowed Values: [ "urn:ietf:params:scim:schemas:core:2.0:Group", "urn:ietf:params:scim:schemas:extension:oracle:2.0:OUD:Group" ]

  The Schemas to be included for the schema type.
• urn:ietf:params:scim:schemas:core:2.0:Group(optional): object Core Group Properties
• urn:ietf:params:scim:schemas:extension:oracle:2.0:OUD:Group(optional): object Oracle specific Group Properties

{
    "type":"object",
    "required":[
        "schemas"
    ],
    "properties":{
        "schemas":{
            "description":"The Schemas to be included for the schema type.",
            "type":"string",
            "enum":[
                "urn:ietf:params:scim:schemas:core:2.0:Group",
                "urn:ietf:params:scim:schemas:extension:oracle:2.0:OUD:Group"
            ]
        },
        "urn:ietf:params:scim:schemas:core:2.0:Group":{
            "$ref":"#/definitions/Core Group Properties"
        },
        "urn:ietf:params:scim:schemas:extension:oracle:2.0:OUD:Group":{
            "$ref":"#/definitions/Oracle specific Group Properties"
        }
    }
}

Nested Schema : Core Group Properties

Type: object

Show Source

• displayName: string
  Display name for the group.
• members: array members
  Members belonging to the Group.

{
    "type":"object",
    "required":[
        "members",
        "displayName"
    ],
    "properties":{
        "members":{
            "type":"array",
            "description":"Members belonging to the Group.",
            "items":{
                "type":"string"
            }
        },
        "displayName":{
            "type":"string",
            "description":"Display name for the group."
        }
    }
}

Nested Schema : Oracle specific Group Properties

Type: object

Show Source

• businessCategory(optional): array businessCategory
  Buisness Category of the Group.
• description(optional): array description
  Description of the Group.
• o(optional): array o
  Organiation the group is a part of.
• objectClass(optional): array objectClass
  Objectclass(es) required for the Group.
• ou(optional): array ou
  Organizational Unit the Group is a part of.
• owner(optional): array owner
  Owner of the group.

{
    "type":"object",
    "properties":{
        "objectClass":{
            "type":"array",
            "description":"Objectclass(es) required for the Group.",
            "items":{
                "type":"string"
            }
        },
        "description":{
            "type":"array",
            "description":"Description of the Group.",
            "items":{
                "type":"string"
            }
        },
        "owner":{
            "type":"array",
            "description":"Owner of the group.",
            "items":{
                "type":"string"
            }
        },
        "ou":{
            "type":"array",
            "description":"Organizational Unit the Group is a part of.",
            "items":{
                "type":"string"
            }
        },
        "businessCategory":{
            "type":"array",
            "description":"Buisness Category of the Group.",
            "items":{
                "type":"string"
            }
        },
        "o":{
            "type":"array",
            "description":"Organiation the group is a part of.",
            "items":{
                "type":"string"
            }
        }
    }
}

Nested Schema : members

Type: array

Members belonging to the Group.

Show Source

• Array of: string

{
    "type":"array",
    "description":"Members belonging to the Group.",
    "items":{
        "type":"string"
    }
}

Nested Schema : businessCategory

Type: array

Buisness Category of the Group.

Show Source

• Array of: string

{
    "type":"array",
    "description":"Buisness Category of the Group.",
    "items":{
        "type":"string"
    }
}

Nested Schema : description

Type: array

Description of the Group.

Show Source

• Array of: string

{
    "type":"array",
    "description":"Description of the Group.",
    "items":{
        "type":"string"
    }
}

Nested Schema : o

Type: array

Organiation the group is a part of.

Show Source

• Array of: string

{
    "type":"array",
    "description":"Organiation the group is a part of.",
    "items":{
        "type":"string"
    }
}

Nested Schema : objectClass

Type: array

Objectclass(es) required for the Group.

Show Source

• Array of: string

{
    "type":"array",
    "description":"Objectclass(es) required for the Group.",
    "items":{
        "type":"string"
    }
}

Nested Schema : ou

Type: array

Organizational Unit the Group is a part of.

Show Source

• Array of: string

{
    "type":"array",
    "description":"Organizational Unit the Group is a part of.",
    "items":{
        "type":"string"
    }
}

Nested Schema : owner

Type: array

Owner of the group.

Show Source

• Array of: string

{
    "type":"array",
    "description":"Owner of the group.",
    "items":{
        "type":"string"
    }
}

400 Response

ERROR

406 Response

Not Acceptable

Body ()

Root Schema : ErrorResponse

Type: object

Show Source

• detail: string
  Error message returned returned for the operation.
• schemas: string
  Default Value: urn:ietf:params:scim:api:messages:2.0:Error

  The REST message type
• status: integer(int32)
  Specifies the HTTP status error code returned for the operation.

{
    "type":"object",
    "required":[
        "schemas",
        "detail",
        "status"
    ],
    "properties":{
        "schemas":{
            "description":"The REST message type",
            "default":"urn:ietf:params:scim:api:messages:2.0:Error",
            "type":"string"
        },
        "detail":{
            "description":"Error message returned returned for the operation.",
            "type":"string"
        },
        "status":{
            "type":"integer",
            "format":"int32",
            "description":"Specifies the HTTP status error code returned for the operation."
        }
    }
}

Back to Top