v1

latestOpenAPI 3.1.0Apache 2.02026-07-22160175414.0 KB

Trainings

Create a training

Creates a training with the state 'ready', which by default is not displayed in the public catalog.

post/talent-training/api/v1/trainings

Request body

idinteger

Unique identifier of the training

type'External' | 'Internal'

External trainings are managed by external organizations, whereas internal trainings are managed by employees within your company.

state'Ready' | 'Archived'

ready: the training object is published and as such can be referenced by a new realized-training.
archived: the training object is archived and as such should no longer be referenced in new realized-trainings.

titlestring required

Name of the training (maximum length = 250 characters)

subtitlestring required

Short summary of the training (maximum length = 1000 characters)

descriptionstring required

Detailed description of the training (maximum length = 6000 characters)

level'Beginner' | 'Middle' | 'Expert' required

Beginner : For finding out about the subject
Middle : For deepening your knowledge
Expert : For becoming a specialist

isCertifyingboolean required

Is it an accredited training?

isMandatoryboolean required

Is the training mandatory according to legal requirements?

Example request

{
  "id": 45,
  "state": "Ready",
  "type": "External",
  "title": "Mastering French: From Basics to Fluency",
  "subtitle": "A Complete Training Program to Speak, Read, and Write with Confidence",
  "description": "Unlock the beauty of the French language with this immersive training designed for learners at all levels. Whether you're a complete beginner or looking to refine your skills, this course covers essential grammar, vocabulary, pronunciation, and real-world conversation practice. Through interactive lessons, cultural insights, and practical exercises, you’ll gain the tools and confidence to use French in everyday and professional settings.",
  "provider": {
    "id": 12,
    "name": "L'Élan Français",
    "websiteHref": "https://elan-francais.fr"
  },
  "level": "Beginner",
  "isCertifying": false,
  "isMandatory": false,
  "category": {
    "id": 2,
    "name": "Languages",
    "t9n": {
      "name": {
        "Fr": "Langues",
        "Es": "Idiomas"
      }
    }
  }
}

Response

Created