Create an employee event

post

/hcmRestApi/resources/11.13.18.05/communicateUIEmployeeEventDetails

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
Nested Schema : Employee Event Messages
Type: array
Title: Employee Event Messages
The child resource for event messages.
Show Source
Nested Schema : Employee Event Metrics
Type: array
Title: Employee Event Metrics
The child resource for event metrics.
Show Source
Nested Schema : Employee Event Owners
Type: array
Title: Employee Event Owners
The child resource that provides details of the owners of the employee event.
Show Source
Nested Schema : Questionnaires
Type: array
Title: Questionnaires
The questionnaires resource provides all the details of a questionnaire, its sections, questions, and the attachments defined.
Show Source
Nested Schema : Questions
Type: array
Title: Questions
The child resource for questionnaire questions.
Show Source
Nested Schema : communicateUIEmployeeEventDetails-eventMessages-item-post-request
Type: object
Show Source
Nested Schema : communicateUIEmployeeEventDetails-eventMetrics-item-post-request
Type: object
Show Source
Nested Schema : schema
Type: object
Show Source
Nested Schema : communicateUIEmployeeEventDetails-questionnaires-item-post-request
Type: object
Show Source
  • Title: In Use
    Maximum Length: 30
    Default Value: N
    Code that shows whether the participants have already responded to the questionnaire.
  • Title: Latest Version
    Maximum Length: 30
    Default Value: N
    Setting that indicates if this is the latest version of the questionnaire. This is a read-only attribute.
  • Title: Maximum Possible Score
    Sum of the maximum possible scores of all questions that are included in the questionnaire.
  • Title: Name
    Maximum Length: 240
    Name of the questionnaire.
  • Title: Questionnaire Code
    Maximum Length: 240
    Alphanumeric code that uniquely identifies a questionnaire defined for a subscriber.
  • Title: Questionnaire ID
    Surrogate identifier of the questionnaire.
  • Title: Questionnaire Version Number
    Default Value: 1
    Version number of the questionnaire. Version Number should be 1 when a new questionnaire is created.
  • Title: Score Questionnaire
    Maximum Length: 30
    Setting that indicates if the questionnaire is scored. This is a read-only attribute.
  • Sections
    Title: Sections
    The sections resource is a child resource of the questionnaires resource. It provides details of the sections defined in the questionnaire.
Nested Schema : Sections
Type: array
Title: Sections
The sections resource is a child resource of the questionnaires resource. It provides details of the sections defined in the questionnaire.
Show Source
Nested Schema : communicateUIEmployeeEventDetails-questionnaires-sections-item-post-request
Type: object
Show Source
Nested Schema : Questions
Type: array
Title: Questions
The child resource for questionnaire questions.
Show Source
Nested Schema : communicateUIEmployeeEventDetails-questionnaires-sections-questions-item-post-request
Type: object
Show Source
Nested Schema : Answers
Type: array
Title: Answers
The child resource for questionnaire question answers.
Show Source
Nested Schema : Questions
Type: array
Title: Questions
The questions resource is a child of the questionnaires resource. It provides details of the questions included in a section of the questionnaire.
Show Source
Nested Schema : schema
Type: object
Show Source
Nested Schema : schema
Type: object
Show Source
  • Title: Allow attachments
    Maximum Length: 30
    Default Value: false
    Indicates whether an attachment is allowed as a response to the question.
  • Title: Folder
    Surrogate identifier of the folder where the question is stored.
  • Maximum Length: 4000
    Instructions or additional information for the question.
  • Title: Latest Version
    Maximum Length: 30
    Default Value: N
    Setting that indicates if this is the latest version of the question. This is a read-only attribute.
  • Title: Owner
    Maximum Length: 64
    Person identifier of the person with the privileges to edit the question, if the question is marked as private. Required if question is marked as private.
  • Title: Privacy
    Maximum Length: 30
    Default Value: false
    Indicates whether the question is restricted for edits. A value of true indicates the question is private and the person specified as the owner can edit it.
  • Title: Question Code
    Maximum Length: 240
    Alphanumeric value that uniquely identifies a question defined for a subscriber.
  • Title: Question Code
    Surrogate identifier for the question.
  • Title: Question Text
    Maximum Length: 2000
    Text of the question being asked.
  • Title: Question Type
    Maximum Length: 30
    Default Value: TEXT
    Code identifying the type of question. Valid values are in the list commonLookupsLOV.
  • Title: Question Version Number
    Default Value: 1
    Version number of the question. New questions must have a version number of 1.
  • Title: Response Type
    Default Value: 1
    Surrogate identifier of the response type for the question.
  • Title: Status
    Maximum Length: 30
    Default Value: D
    Status of the question. Valid values are A for Active, I for Inactive and D for Draft.
  • Title: Subscriber
    Surrogate identifier for the subscriber.
Nested Schema : communicateUIEmployeeEventDetails-questions-item-post-request
Type: object
Show Source
Nested Schema : Answers
Type: array
Title: Answers
The child resource for questionnaire question answers.
Show Source
Nested Schema : communicateUIEmployeeEventDetails-questions-answers-item-post-request
Type: object
Show Source
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 : communicateUIEmployeeEventDetails-item-response
Type: object
Show Source
Nested Schema : Employee Event Messages
Type: array
Title: Employee Event Messages
The child resource for event messages.
Show Source
Nested Schema : Employee Event Metrics
Type: array
Title: Employee Event Metrics
The child resource for event metrics.
Show Source
Nested Schema : Employee Event Owners
Type: array
Title: Employee Event Owners
The child resource that provides details of the owners of the employee event.
Show Source
Nested Schema : Questionnaires
Type: array
Title: Questionnaires
The questionnaires resource provides all the details of a questionnaire, its sections, questions, and the attachments defined.
Show Source
Nested Schema : Questions
Type: array
Title: Questions
The child resource for questionnaire questions.
Show Source
Nested Schema : communicateUIEmployeeEventDetails-eventMessages-item-response
Type: object
Show Source
Nested Schema : communicateUIEmployeeEventDetails-eventMetrics-item-response
Type: object
Show Source
Nested Schema : communicateUIEmployeeEventDetails-owners-item-response
Type: object
Show Source
Nested Schema : communicateUIEmployeeEventDetails-questionnaires-item-response
Type: object
Show Source
  • Title: In Use
    Maximum Length: 30
    Default Value: N
    Code that shows whether the participants have already responded to the questionnaire.
  • Title: Latest Version
    Maximum Length: 30
    Default Value: N
    Setting that indicates if this is the latest version of the questionnaire. This is a read-only attribute.
  • Links
  • Title: Maximum Possible Score
    Sum of the maximum possible scores of all questions that are included in the questionnaire.
  • Title: Name
    Maximum Length: 240
    Name of the questionnaire.
  • Title: Questionnaire Code
    Maximum Length: 240
    Alphanumeric code that uniquely identifies a questionnaire defined for a subscriber.
  • Title: Questionnaire ID
    Surrogate identifier of the questionnaire.
  • Title: Questionnaire Version Number
    Default Value: 1
    Version number of the questionnaire. Version Number should be 1 when a new questionnaire is created.
  • Title: Score Questionnaire
    Maximum Length: 30
    Setting that indicates if the questionnaire is scored. This is a read-only attribute.
  • Sections
    Title: Sections
    The sections resource is a child resource of the questionnaires resource. It provides details of the sections defined in the questionnaire.
Nested Schema : Sections
Type: array
Title: Sections
The sections resource is a child resource of the questionnaires resource. It provides details of the sections defined in the questionnaire.
Show Source
Nested Schema : communicateUIEmployeeEventDetails-questionnaires-sections-item-response
Type: object
Show Source
Nested Schema : Questions
Type: array
Title: Questions
The child resource for questionnaire questions.
Show Source
Nested Schema : communicateUIEmployeeEventDetails-questionnaires-sections-questions-item-response
Type: object
Show Source
Nested Schema : Answers
Type: array
Title: Answers
The child resource for questionnaire question answers.
Show Source
Nested Schema : Questions
Type: array
Title: Questions
The questions resource is a child of the questionnaires resource. It provides details of the questions included in a section of the questionnaire.
Show Source
Nested Schema : communicateUIEmployeeEventDetails-questionnaires-sections-questions-answers-item-response
Type: object
Show Source
Nested Schema : communicateUIEmployeeEventDetails-questionnaires-sections-questions-questionDetails-item-response
Type: object
Show Source
  • Title: Allow attachments
    Maximum Length: 30
    Default Value: false
    Indicates whether an attachment is allowed as a response to the question.
  • Title: Folder
    Surrogate identifier of the folder where the question is stored.
  • Maximum Length: 4000
    Instructions or additional information for the question.
  • Title: Latest Version
    Maximum Length: 30
    Default Value: N
    Setting that indicates if this is the latest version of the question. This is a read-only attribute.
  • Links
  • Title: Owner
    Maximum Length: 64
    Person identifier of the person with the privileges to edit the question, if the question is marked as private. Required if question is marked as private.
  • Title: Privacy
    Maximum Length: 30
    Default Value: false
    Indicates whether the question is restricted for edits. A value of true indicates the question is private and the person specified as the owner can edit it.
  • Title: Question Code
    Maximum Length: 240
    Alphanumeric value that uniquely identifies a question defined for a subscriber.
  • Title: Question Code
    Surrogate identifier for the question.
  • Title: Question Text
    Maximum Length: 2000
    Text of the question being asked.
  • Title: Question Type
    Maximum Length: 30
    Default Value: TEXT
    Code identifying the type of question. Valid values are in the list commonLookupsLOV.
  • Title: Question Version Number
    Default Value: 1
    Version number of the question. New questions must have a version number of 1.
  • Title: Response Type
    Default Value: 1
    Surrogate identifier of the response type for the question.
  • Title: Status
    Maximum Length: 30
    Default Value: D
    Status of the question. Valid values are A for Active, I for Inactive and D for Draft.
  • Title: Subscriber
    Surrogate identifier for the subscriber.
Nested Schema : communicateUIEmployeeEventDetails-questions-item-response
Type: object
Show Source
Nested Schema : Answers
Type: array
Title: Answers
The child resource for questionnaire question answers.
Show Source
Nested Schema : communicateUIEmployeeEventDetails-questions-answers-item-response
Type: object
Show Source
Back to Top