v1

latestOpenAPI 3.1.02026-08-04164270844.7 KB
Learning Needs

List all learning needs

🔑

Required OAuth scope: learningNeeds:read.

📖

This endpoint is paginated with a page size of 500 learning needs. For more information, see the Pagination guide.

Lists all learning needs in your platform.

get/api/v2/learning-needs

Headers

360-api-version'v2.0' required

The version of the API.

Response

Returns one page of 500 learning needs.

_idstring ObjectId required

The unique ID of the learning need.

groupIdstring ObjectId required

The unique ID of the group the learning need belongs to.

namestring required

The name of the learning need.

status'new' | 'exploring' | 'onHold' | 'projectOngoing' | 'done' | 'alreadyExists' | 'discarded' required

The status of the learning need.

createdAtstring date-time required

The date when the learning need was created.

authorIdstring ObjectId required

The unique ID of the user who declared the learning need.

suggestedExpertIdsstring[] required

The unique IDs of the suggested experts for the learning need.

volunteerIdsstring[] required

The unique IDs of the users that volunteered for this learning need.

Example response

[
  {
    "_id": "507f1f77bcf86cd799439011",
    "groupId": "507f1f77bcf86cd799439011",
    "name": "Cross-Cultural Communication",
    "authorId": "507f1f77bcf86cd799439011",
    "questions": [
      {
        "title": "What is the problem that creating this training would solve?",
        "answer": "It would strengthen the ties between the US and French Staff."
      }
    ],
    "suggestedExpertIds": [
      "507f1f77bcf86cd799439011"
    ],
    "volunteerIds": [
      "507f1f77bcf86cd799439011"
    ]
  }
]