Create a waitlist setting

post

/fscmRestApi/resources/11.13.18.05/waitlistSettings

Request

Header Parameters
  • 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".
  • 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.
  • Contains one of the following values: true or false. If true, the server performs an Upsert operation instead of a Create operation. During an Upsert operation, the server attempts to find an existing resource that matches the payload. If a match is found, the server updates the existing resource instead of creating a new one. If not found or false (default), the server performs a Create operation. Note that the Upsert operation isn't supported for date-effective REST resources.
Supported Media Types
Request Body - application/json ()
Root Schema : schema
Type: object
Show Source
  • Waitlist Settings Assignments
    Title: Waitlist Settings Assignments
    The assignments resource is used to list the academic entities assigned to the waitlist settings.
  • Title: Default Waitlist Capacity
    Default Value: 0
    The default capacity of the waitlist.
  • Title: Drop Waitlisted Sections After Enrollment
    Maximum Length: 1
    Default Value: false
    Indicates that the student will be dropped from the waitlist of other sections of a course after they have successfully enrolled in any sections for that course.
  • Title: Expired Invitation Action Code
    Maximum Length: 30
    The expired invitation action code. A list of accepted values is defined in the lookup type ORA_HER_EXPIRED_INVITATION_ACTION.
  • Title: Invitation Response Hours
    Default Value: 0
    The invitation response hours of the waitlist setting documenting how long a student has to respond to an open seat notification.
  • Title: Maximum Waitlist Control Type Code
    Maximum Length: 30
    The maximum waitlist control type code. Used to identify units or courses as the metric controlling maximum number of waitlists a student can be on at a given time. A list of accepted values is defined in the lookup type ORA_HER_MAX_WL_CONTROL_TYPE.
  • Title: Maximum Waitlist Control Units
    Default Value: 0
    The maximum number of control units that limits a student's ability to waitlist after this number is reached.
  • Title: Owning Entity ID
    The unique identifier of the owning entity.
  • Title: Owning Entity Type Code
    Maximum Length: 30
    The entity type code of the owning entity. A list of accepted values is defined in the lookup type ORA_HER_ASSOCIATED_OBJECT_TYPE.
  • Title: Waitlisting Enabled
    Maximum Length: 1
    Default Value: false
    Indicates that the waitlist setting is enabled.
Nested Schema : Waitlist Settings Assignments
Type: array
Title: Waitlist Settings Assignments
The assignments resource is used to list the academic entities assigned to the waitlist settings.
Show Source
Nested Schema : waitlistSettings-assignments-item-post-request
Type: object
Show Source
  • Title: Entity ID
    The unique identifier of the associated entity.
  • Title: Entity Type Code
    Maximum Length: 30
    The entity type code of the associated entity. A list of accepted values is defined in the lookup type ORA_HER_ASSOCIATED_OBJECT_TYPE.
  • Title: Assignment Method Code
    Maximum Length: 30
    Default Value: ORA_DIRECT
    The assignment method type code indicating how the settings are assigned to the entity. A list of accepted values is defined in the lookup type ORA_HEY_SETTINGS_ASSIGN_METHOD.
  • Title: Related Entity ID
    The unique identifier of the related entity.
  • Title: Related Entity Type Code
    Maximum Length: 30
    The entity type code of the associated entity. A list of accepted values is defined in the lookup type ORA_HER_ASSOCIATED_OBJECT_TYPE.
Back to Top

Response

Supported Media Types

Default Response

The following table describes the default response for this task.
Headers
  • 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".
  • 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 : waitlistSettings-item-response
Type: object
Show Source
  • Waitlist Settings Assignments
    Title: Waitlist Settings Assignments
    The assignments resource is used to list the academic entities assigned to the waitlist settings.
  • Title: Created By
    Read Only: true
    Maximum Length: 64
    The user who created the row.
  • Title: Creation Date
    Read Only: true
    The date the row was created.
  • Title: Default Waitlist Capacity
    Default Value: 0
    The default capacity of the waitlist.
  • Title: Drop Waitlisted Sections After Enrollment
    Maximum Length: 1
    Default Value: false
    Indicates that the student will be dropped from the waitlist of other sections of a course after they have successfully enrolled in any sections for that course.
  • Title: Expired Invitation Action
    Read Only: true
    Maximum Length: 80
    The meaning of the expired invitation action code. A list of accepted values and meanings is defined in the lookup type ORA_HER_EXPIRED_INVITATION_ACTION.
  • Title: Expired Invitation Action Code
    Maximum Length: 30
    The expired invitation action code. A list of accepted values is defined in the lookup type ORA_HER_EXPIRED_INVITATION_ACTION.
  • Title: Invitation Response Hours
    Default Value: 0
    The invitation response hours of the waitlist setting documenting how long a student has to respond to an open seat notification.
  • Title: Last Updated Date
    Read Only: true
    The date the row was last updated.
  • Title: Last Updated By
    Read Only: true
    Maximum Length: 64
    The user who last updated the row.
  • Links
  • Title: Maximum Waitlist Control Type
    Read Only: true
    Maximum Length: 80
    The maximum waitlist control type. Used to identify units or courses as the metric controlling maximum number of waitlists a student can be on at a given time. A list of accepted values is defined in the lookup type ORA_HER_MAX_WL_CONTROL_TYPE.
  • Title: Maximum Waitlist Control Type Code
    Maximum Length: 30
    The maximum waitlist control type code. Used to identify units or courses as the metric controlling maximum number of waitlists a student can be on at a given time. A list of accepted values is defined in the lookup type ORA_HER_MAX_WL_CONTROL_TYPE.
  • Title: Maximum Waitlist Control Units
    Default Value: 0
    The maximum number of control units that limits a student's ability to waitlist after this number is reached.
  • Title: Owning Entity Code
    Read Only: true
    Maximum Length: 100
    The user defined identifier of the associated entity.
  • Title: Owning Entity ID
    The unique identifier of the owning entity.
  • Title: Owning Entity Name
    Read Only: true
    Maximum Length: 100
    The name of the associated entity.
  • Title: Owning Entity Subtype Code
    Read Only: true
    Maximum Length: 30
    The entity subtype code of the associated entity.
  • Title: Owning Entity Subtype
    Read Only: true
    Maximum Length: 80
    The entity subtype of the associated entity.
  • Title: Owning Entity Type Code
    Maximum Length: 30
    The entity type code of the owning entity. A list of accepted values is defined in the lookup type ORA_HER_ASSOCIATED_OBJECT_TYPE.
  • Title: Owning Entity Type
    Read Only: true
    Maximum Length: 80
    The entity type of the associated entity. A list of accepted values is defined in the lookup type ORA_HER_ASSOCIATED_OBJECT_TYPE.
  • Title: Waitlisting Code
    Read Only: true
    Maximum Length: 150
    The alternate unique identifier for waitlist settings.
  • Title: Waitlisting Enabled
    Maximum Length: 1
    Default Value: false
    Indicates that the waitlist setting is enabled.
  • Title: Waitlist Settings ID
    Read Only: true
    The unique identifier for the waitlist settings.
Nested Schema : Waitlist Settings Assignments
Type: array
Title: Waitlist Settings Assignments
The assignments resource is used to list the academic entities assigned to the waitlist settings.
Show Source
Nested Schema : waitlistSettings-assignments-item-response
Type: object
Show Source
Back to Top