st.retrievePersonLanguages

This action allows you to retrieve information about a person's languages.

Constraints

Paramenters

{
  "actionType": "st.retrievePersonLanguages",
  "label": "person1Languages"
}

• label (optional) – custom label for tracking this action in workflow completion.

Result options

This action always completes successfully. Even if the person has no mentioned languages, it returns an empty array.

{
  "actionType": "st.retrievePersonLanguages",
  "label": "person1Languages",
  "success": true,
  "data": [
    {
      "name": "English",
      "proficiency": "nativeOrBilingual"
    },
    {
      "name": "Spanish",
      "proficiency": "professionalWorking"
    },
    {
      "name": "French",
      "proficiency": "limitedWorking"
    }
  ]
}

• label – included only if specified in the action parameters.
• data – array of person languages.
  • name – name of the language.
  • proficiency – proficiency level in the language. Enum with the following possible values:
    • elementary – basic understanding.
    • limitedWorking – limited ability for routine tasks.
    • professionalWorking – effective in professional settings.
    • fullProfessional – near-native proficiency.
    • nativeOrBilingual – fluent, like a native speaker.