Jump to

• Request
• Response

Create a managed student group's member request

post

/fscmRestApi/resources/11.13.18.05/hedProxyGroupMemberRequests

Request

Header Parameters

• Metadata-Context: string
  If the REST API supports runtime customizations, the shape of the service may change during runtime. The REST client may isolate itself from these changes or choose to interact with the latest version of the API by specifying this header. For example: Metadata-Context:sandbox="TrackEmployeeFeature".
• REST-Framework-Version: string
  The protocol version between a REST client and service. If the client does not specify this header in the request the server will pick a default version for the API.

Supported Media Types

• application/json

Request Body - application/json ()

Root Schema : schema

Type: object

Show Source

• EmailAddress: string
  Title: Email

  Email address of the group member.
• LastName: string
  Title: Last Name

  Last name of the group member.
• MemberPartyId(required): integer (int64)
  The unique identifier of a group member.
• MemberTypeCode(required): string
  Maximum Length: 30

  The type code of a member in a managed student group. A list of acceptable values is defined in the lookup type ORA_HEY_MEMBER_TYPE_CODE.
• ProxyGroupId(required): integer (int64)
  The unique identifier of a managed student group.
• relationshipRequests: array Relationship Requests
  Title: Relationship Requests

  The relationship requests resource is used to view or create a relationship request for a student member with the group owner of the managed student group.
• Username: string
  Title: User Name

  User name of a group member.

{
    "required":[
        "MemberPartyId",
        "MemberTypeCode",
        "ProxyGroupId"
    ],
    "type":"object",
    "properties":{
        "MemberPartyId":{
            "type":"integer",
            "description":"The unique identifier of a group member.",
            "format":"int64",
            "nullable":false,
            "x-hints":{
                "precision":18
            }
        },
        "Username":{
            "title":"User Name",
            "type":"string",
            "description":"User name of a group member.",
            "nullable":true,
            "x-queryable":false,
            "x-hints":{
                "dependencies":[
                    "UserId"
                ]
            }
        },
        "ProxyGroupId":{
            "type":"integer",
            "description":"The unique identifier of a managed student group.",
            "format":"int64",
            "nullable":false,
            "x-hints":{
                "precision":18
            }
        },
        "LastName":{
            "title":"Last Name",
            "type":"string",
            "description":"Last name of the group member.",
            "nullable":true,
            "x-hints":{
                "dependencies":[
                    "PartyId"
                ]
            }
        },
        "MemberTypeCode":{
            "maxLength":30,
            "type":"string",
            "description":"The type code of a member in a managed student group. A list of acceptable values is defined in the lookup type ORA_HEY_MEMBER_TYPE_CODE.",
            "nullable":false,
            "x-hints":{
                "controlType":"choice"
            }
        },
        "relationshipRequests":{
            "title":"Relationship Requests",
            "type":"array",
            "description":"The relationship requests resource is used to view or create a relationship request for a student member with the group owner of the managed student group.",
            "items":{
                "$ref":"#/components/schemas/hedProxyGroupMemberRequests-relationshipRequests-item-post-request"
            }
        },
        "EmailAddress":{
            "title":"Email",
            "type":"string",
            "description":"Email address of the group member.",
            "nullable":true,
            "x-hints":{
                "dependencies":[
                    "PartyId"
                ]
            }
        }
    }
}

Nested Schema : Relationship Requests

Type: array

Title: Relationship Requests

The relationship requests resource is used to view or create a relationship request for a student member with the group owner of the managed student group.

Show Source

• Array of: object hedProxyGroupMemberRequests-relationshipRequests-item-post-request

{
    "title":"Relationship Requests",
    "type":"array",
    "description":"The relationship requests resource is used to view or create a relationship request for a student member with the group owner of the managed student group.",
    "items":{
        "$ref":"#/components/schemas/hedProxyGroupMemberRequests-relationshipRequests-item-post-request"
    }
}

Nested Schema : hedProxyGroupMemberRequests-relationshipRequests-item-post-request

Type: object

Show Source

• ObjectMemberId: integer (int64)
  Unique identifier of a member in the managed student group.
• RelationshipCode: string
  Maximum Length: 30

  The code of the relationship with the group member.
• RelationshipTypeCode: string
  Maximum Length: 30

  The type code of the relationship with the group member.

{
    "type":"object",
    "properties":{
        "RelationshipTypeCode":{
            "maxLength":30,
            "type":"string",
            "description":"The type code of the relationship with the group member.",
            "nullable":false
        },
        "ObjectMemberId":{
            "type":"integer",
            "description":"Unique identifier of a member in the managed student group.",
            "format":"int64",
            "nullable":false,
            "x-hints":{
                "precision":18
            }
        },
        "RelationshipCode":{
            "maxLength":30,
            "type":"string",
            "description":"The code of the relationship with the group member.",
            "nullable":false,
            "x-hints":{
                "controlType":"choice"
            }
        }
    }
}

Back to Top

Response

Supported Media Types

• application/json

Default Response

The following table describes the default response for this task.

Headers

• Metadata-Context:
  If the REST API supports runtime customizations, the shape of the service may change during runtime. The REST client may isolate itself from these changes or choose to interact with the latest version of the API by specifying this header. For example: Metadata-Context:sandbox="TrackEmployeeFeature".
• REST-Framework-Version:
  The protocol version between a REST client and service. If the client does not specify this header in the request the server will pick a default version for the API.

Body ()

Root Schema : hedProxyGroupMemberRequests-item-response

Type: object

Show Source

• EmailAddress: string
  Title: Email

  Email address of the group member.
• FirstName: string
  Title: First Name

  Read Only: true

  Maximum Length: 150

  First name of the group member.
• FullName: string
  Title: Full Name

  Read Only: true

  Maximum Length: 360

  Full name of the group member.
• LastName: string
  Title: Last Name

  Last name of the group member.
• links: array Links
  Title: Links

  The link relations associated with the resource instance.
• MemberId: integer (int64)
  Read Only: true

  The unique identifier of a group member in a managed student group.
• MemberPartyId: integer (int64)
  The unique identifier of a group member.
• MembershipStatusCode: string
  Read Only: true

  Maximum Length: 30

  Default Value: ORA_HEY_PENDING

  The current status code of the group member. A list of acceptable values is defined in the lookup type ORA_HEY_PROXY_MBR_STATUS_CODE.
• MembershipStatusMeaning: string
  Title: Meaning

  Read Only: true

  Maximum Length: 80

  The Meaning of the status code of the group member. A list of acceptable values is defined in the lookup type ORA_HEY_PROXY_MBR_STATUS_CODE.
• MemberTypeCode: string
  Maximum Length: 30

  The type code of a member in a managed student group. A list of acceptable values is defined in the lookup type ORA_HEY_MEMBER_TYPE_CODE.
• MemberTypeMeaning: string
  Title: Meaning

  Read Only: true

  Maximum Length: 80

  The meaning of the member type code. A list of acceptable values is defined in the lookup type ORA_HEY_MEMBER_TYPE_CODE.
• MiddleName: string
  Title: Middle Name

  Read Only: true

  Maximum Length: 60

  Middle name of the group member.
• ProxyGroupId: integer (int64)
  The unique identifier of a managed student group.
• relationshipRequests: array Relationship Requests
  Title: Relationship Requests

  The relationship requests resource is used to view or create a relationship request for a student member with the group owner of the managed student group.
• Username: string
  Title: User Name

  User name of a group member.

{
    "type":"object",
    "properties":{
        "FirstName":{
            "title":"First Name",
            "maxLength":150,
            "type":"string",
            "description":"First name of the group member.",
            "nullable":true,
            "readOnly":true,
            "x-hints":{
                "protectionKey":"PersonDEO.PersonFirstName",
                "protectionObjectTitle":"Contact",
                "protectionState":"TOKENIZED",
                "protectionAttributeTitle":"First Name"
            },
            "x-queryable":true
        },
        "ProxyGroupId":{
            "type":"integer",
            "description":"The unique identifier of a managed student group.",
            "format":"int64",
            "nullable":false,
            "x-hints":{
                "precision":18
            },
            "x-queryable":true
        },
        "MiddleName":{
            "title":"Middle Name",
            "maxLength":60,
            "type":"string",
            "description":"Middle name of the group member.",
            "nullable":true,
            "readOnly":true,
            "x-hints":{
                "protectionKey":"PersonDEO.PersonMiddleName",
                "protectionObjectTitle":"Contact",
                "protectionState":"TOKENIZED",
                "protectionAttributeTitle":"Middle Name"
            },
            "x-queryable":true
        },
        "MemberTypeCode":{
            "maxLength":30,
            "type":"string",
            "description":"The type code of a member in a managed student group. A list of acceptable values is defined in the lookup type ORA_HEY_MEMBER_TYPE_CODE.",
            "nullable":false,
            "x-hints":{
                "controlType":"choice"
            },
            "x-queryable":true
        },
        "relationshipRequests":{
            "title":"Relationship Requests",
            "type":"array",
            "description":"The relationship requests resource is used to view or create a relationship request for a student member with the group owner of the managed student group.",
            "items":{
                "$ref":"#/components/schemas/hedProxyGroupMemberRequests-relationshipRequests-item-response"
            }
        },
        "EmailAddress":{
            "title":"Email",
            "type":"string",
            "description":"Email address of the group member.",
            "nullable":true,
            "x-hints":{
                "dependencies":[
                    "PartyId"
                ]
            },
            "x-queryable":true
        },
        "MembershipStatusCode":{
            "maxLength":30,
            "type":"string",
            "description":"The current status code of the group member. A list of acceptable values is defined in the lookup type ORA_HEY_PROXY_MBR_STATUS_CODE.",
            "nullable":false,
            "readOnly":true,
            "default":"ORA_HEY_PENDING",
            "x-queryable":true
        },
        "MemberPartyId":{
            "type":"integer",
            "description":"The unique identifier of a group member.",
            "format":"int64",
            "nullable":false,
            "x-hints":{
                "precision":18
            },
            "x-queryable":true
        },
        "MemberId":{
            "type":"integer",
            "description":"The unique identifier of a group member in a managed student group.",
            "format":"int64",
            "nullable":false,
            "readOnly":true,
            "x-hints":{
                "precision":18,
                "fnd:GLOBALLY_UNIQUE":"true"
            },
            "x-queryable":true
        },
        "Username":{
            "title":"User Name",
            "type":"string",
            "description":"User name of a group member.",
            "nullable":true,
            "x-queryable":false,
            "x-hints":{
                "dependencies":[
                    "UserId"
                ]
            }
        },
        "MembershipStatusMeaning":{
            "title":"Meaning",
            "maxLength":80,
            "type":"string",
            "description":"The Meaning of the status code of the group member. A list of acceptable values is defined in the lookup type ORA_HEY_PROXY_MBR_STATUS_CODE.",
            "nullable":false,
            "readOnly":true,
            "x-queryable":true
        },
        "FullName":{
            "title":"Full Name",
            "maxLength":360,
            "type":"string",
            "description":"Full name of the group member.",
            "nullable":false,
            "readOnly":true,
            "x-queryable":true
        },
        "MemberTypeMeaning":{
            "title":"Meaning",
            "maxLength":80,
            "type":"string",
            "description":"The meaning of the member type code. A list of acceptable values is defined in the lookup type ORA_HEY_MEMBER_TYPE_CODE.",
            "nullable":false,
            "readOnly":true,
            "x-queryable":true
        },
        "links":{
            "title":"Links",
            "type":"array",
            "description":"The link relations associated with the resource instance.",
            "items":{
                "$ref":"#/components/schemas/link"
            }
        },
        "LastName":{
            "title":"Last Name",
            "type":"string",
            "description":"Last name of the group member.",
            "nullable":true,
            "x-hints":{
                "dependencies":[
                    "PartyId"
                ]
            },
            "x-queryable":true
        }
    }
}

Nested Schema : Links

Type: array

Title: Links

The link relations associated with the resource instance.

Show Source

• Array of: object link

{
    "title":"Links",
    "type":"array",
    "description":"The link relations associated with the resource instance.",
    "items":{
        "$ref":"#/components/schemas/link"
    }
}

Nested Schema : Relationship Requests

Type: array

Title: Relationship Requests

The relationship requests resource is used to view or create a relationship request for a student member with the group owner of the managed student group.

Show Source

• Array of: object hedProxyGroupMemberRequests-relationshipRequests-item-response

{
    "title":"Relationship Requests",
    "type":"array",
    "description":"The relationship requests resource is used to view or create a relationship request for a student member with the group owner of the managed student group.",
    "items":{
        "$ref":"#/components/schemas/hedProxyGroupMemberRequests-relationshipRequests-item-response"
    }
}

Nested Schema : link

Type: object

Show Source

• href: string
  Title: hyperlink reference

  The URI to the related resource.
• kind: string
  Title: kind

  Allowed Values: [ "collection", "item", "describe", "other" ]

  The kind of the related resource.
• name: string
  Title: name

  The name of the link to the related resource.
• properties: object properties
• rel: string
  Title: relation

  Allowed Values: [ "self", "lov", "parent", "canonical", "child", "enclosure", "action", "custom" ]

  The name of the relation to the resource instance. Example: self.

{
    "type":"object",
    "properties":{
        "kind":{
            "title":"kind",
            "type":"string",
            "description":"The kind of the related resource.",
            "enum":[
                "collection",
                "item",
                "describe",
                "other"
            ]
        },
        "rel":{
            "title":"relation",
            "type":"string",
            "description":"The name of the relation to the resource instance.  Example: self.",
            "enum":[
                "self",
                "lov",
                "parent",
                "canonical",
                "child",
                "enclosure",
                "action",
                "custom"
            ]
        },
        "name":{
            "title":"name",
            "type":"string",
            "description":"The name of the link to the related resource."
        },
        "href":{
            "title":"hyperlink reference",
            "type":"string",
            "description":"The URI to the related resource."
        },
        "properties":{
            "type":"object",
            "properties":{
                "changeIndicator":{
                    "type":"string",
                    "description":"Change indicator or the ETag value of the resource instance."
                }
            }
        }
    }
}

Nested Schema : properties

Type: object

Show Source

• changeIndicator: string
  Change indicator or the ETag value of the resource instance.

{
    "type":"object",
    "properties":{
        "changeIndicator":{
            "type":"string",
            "description":"Change indicator or the ETag value of the resource instance."
        }
    }
}

Nested Schema : hedProxyGroupMemberRequests-relationshipRequests-item-response

Type: object

Show Source

• links: array Links
  Title: Links

  The link relations associated with the resource instance.
• ObjectMemberEmailAddress: string
  Title: Primary Email

  Read Only: true

  Maximum Length: 320

  Email address of the person related to the group member.
• ObjectMemberFirstName: string
  Title: First Name

  Read Only: true

  Maximum Length: 150

  First name of the person related to the group member.
• ObjectMemberFullName: string
  Title: Name

  Read Only: true

  Maximum Length: 360

  Full name of the person related to the group member.
• ObjectMemberId: integer (int64)
  Unique identifier of a member in the managed student group.
• ObjectMemberLastName: string
  Title: Last Name

  Read Only: true

  Maximum Length: 150

  Last name of the person related to the group member.
• ObjectMemberMiddleName: string
  Title: Middle Name

  Read Only: true

  Maximum Length: 60

  Middle name of the person related to the group member.
• RelationshipCode: string
  Maximum Length: 30

  The code of the relationship with the group member.
• RelationshipMeaning: string
  Read Only: true

  Maximum Length: 80

  The meaning of the relationship code.
• RelationshipRequestId: integer (int64)
  Read Only: true

  Unique identifier of a relationship request for a member in the managed student group.
• RelationshipTypeCode: string
  Maximum Length: 30

  The type code of the relationship with the group member.
• RelationshipTypeMeaning: string
  Read Only: true

  Maximum Length: 80

  The meaning of the relationship type code.

{
    "type":"object",
    "properties":{
        "ObjectMemberFirstName":{
            "title":"First Name",
            "maxLength":150,
            "type":"string",
            "description":"First name of the person related to the group member.",
            "nullable":true,
            "readOnly":true,
            "x-hints":{
                "protectionKey":"PersonDEO.PersonFirstName",
                "protectionObjectTitle":"Contact",
                "protectionState":"TOKENIZED",
                "protectionAttributeTitle":"First Name"
            },
            "x-queryable":true
        },
        "ObjectMemberFullName":{
            "title":"Name",
            "maxLength":360,
            "type":"string",
            "description":"Full name of the person related to the group member.",
            "nullable":false,
            "readOnly":true,
            "x-queryable":true
        },
        "RelationshipTypeMeaning":{
            "maxLength":80,
            "type":"string",
            "description":"The meaning of the relationship type code.",
            "nullable":false,
            "readOnly":true,
            "x-queryable":true
        },
        "RelationshipMeaning":{
            "maxLength":80,
            "type":"string",
            "description":"The meaning of the relationship code.",
            "nullable":false,
            "readOnly":true,
            "x-queryable":true
        },
        "RelationshipTypeCode":{
            "maxLength":30,
            "type":"string",
            "description":"The type code of the relationship with the group member.",
            "nullable":false,
            "x-queryable":true
        },
        "RelationshipRequestId":{
            "type":"integer",
            "description":"Unique identifier of a relationship request for a member in the managed student group.",
            "format":"int64",
            "nullable":false,
            "readOnly":true,
            "x-hints":{
                "precision":18,
                "fnd:GLOBALLY_UNIQUE":"true"
            },
            "x-queryable":true
        },
        "ObjectMemberId":{
            "type":"integer",
            "description":"Unique identifier of a member in the managed student group.",
            "format":"int64",
            "nullable":false,
            "x-hints":{
                "precision":18
            },
            "x-queryable":true
        },
        "RelationshipCode":{
            "maxLength":30,
            "type":"string",
            "description":"The code of the relationship with the group member.",
            "nullable":false,
            "x-hints":{
                "controlType":"choice"
            },
            "x-queryable":true
        },
        "ObjectMemberEmailAddress":{
            "title":"Primary Email",
            "maxLength":320,
            "type":"string",
            "description":"Email address of the person related to the group member.",
            "nullable":true,
            "readOnly":true,
            "x-hints":{
                "protectionKey":"EmailEO.EmailAddress",
                "protectionObjectTitle":"Email",
                "protectionState":"TOKENIZED",
                "protectionAttributeTitle":"Email"
            },
            "x-queryable":true
        },
        "links":{
            "title":"Links",
            "type":"array",
            "description":"The link relations associated with the resource instance.",
            "items":{
                "$ref":"#/components/schemas/link"
            }
        },
        "ObjectMemberMiddleName":{
            "title":"Middle Name",
            "maxLength":60,
            "type":"string",
            "description":"Middle name of the person related to the group member.",
            "nullable":true,
            "readOnly":true,
            "x-hints":{
                "protectionKey":"PersonDEO.PersonMiddleName",
                "protectionObjectTitle":"Contact",
                "protectionState":"TOKENIZED",
                "protectionAttributeTitle":"Middle Name"
            },
            "x-queryable":true
        },
        "ObjectMemberLastName":{
            "title":"Last Name",
            "maxLength":150,
            "type":"string",
            "description":"Last name of the person related to the group member.",
            "nullable":true,
            "readOnly":true,
            "x-hints":{
                "protectionKey":"PersonDEO.PersonLastName",
                "protectionObjectTitle":"Contact",
                "protectionState":"TOKENIZED",
                "protectionAttributeTitle":"Last Name"
            },
            "x-queryable":true
        }
    }
}

Nested Schema : Links

Type: array

Title: Links

The link relations associated with the resource instance.

Show Source

• Array of: object link

{
    "title":"Links",
    "type":"array",
    "description":"The link relations associated with the resource instance.",
    "items":{
        "$ref":"#/components/schemas/link"
    }
}

Links

memberTypeCodesLOV

Operation: /fscmRestApi/resources/11.13.18.05/heyLookups

Parameters:

• finder: ByLookupTypeFinder%3BLookupType%3DORA_HEY_MEMBER_TYPE_CODE%2CLookupCode%3D{MemberTypeCode}

The following properties are defined on the LOV link relation:

• Source Attribute: MemberTypeCode; Target Attribute: LookupCode
• Display Attribute: Meaning

relationshipRequests

Operation: /fscmRestApi/resources/11.13.18.05/hedProxyGroupMemberRequests/{MemberId}/child/relationshipRequests

Parameters:

• MemberId: $request.path.MemberId

The relationship requests resource is used to view or create a relationship request for a student member with the group owner of the managed student group.

Back to Top