POST /api/v1/learningneeds

Create learning needs.

Query body

All fields are mandatory.

NameTypeDescription
answersArray of strings (minimum 1 value, maximum 3 values)List of answers to the 3 questions of the learning need creation form.
authorString (1 value only)Email of the author.
nameStringName of the learning need.
groupString (1 value only)ID of the group linked to the learning need.
expertsArray of strings (can be empty)List of user IDs for suggested experts. Leave empty if you don’t want to suggest experts.
volunteersArray of strings (can be empty)List of user IDs for volunteers. Leave empty if you don’t want to add volunteers.

Return an error if a user in the experts or volunteer list doesn’t belong to the group.

Servers

Request headers

Name Type Required Description
Content-Type String Yes The media type of the request body.

Default value: "application/json"

Query parameters

Name Type Required Description
company String No

(Optional) Include the company ID to authenticate calls via the API key as query parameter. For more information on the authentication methods supported by our API, see Authentication Methods.

apiKey String No

(Optional) Include the API key to authenticate calls via the API key as query parameter. For more information on the authentication methods supported by our API, see Authentication Methods.

Request body fields

Name Type Required Description
learningNeedsFieldsList[] Array No
learningNeedsFieldsList[].name String No
learningNeedsFieldsList[].group String No
learningNeedsFieldsList[].answers[] Array No
learningNeedsFieldsList[].experts[] Array No
learningNeedsFieldsList[].volunteers[] Array No
learningNeedsFieldsList[].author String No

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. Search for the API you want to integrate with and click on the name.
    • This loads the API reference documentation and prepares the Http request settings.
  3. Click Test request to test run your request to the API and see the API's response.