Skip to main content
POST
/
talent-training
/
api
/
v1
/
trainings
Create a training
curl --request POST \
  --url https://{host}/talent-training/api/v1/trainings \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '{
  "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.",
  "providerId": 12,
  "level": "Beginner",
  "isCertifying": false,
  "isMandatory": false,
  "categoryId": 2
}'
{
  "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": {
        "Ff": "Langues",
        "Es": "Idiomas"
      }
    }
  }
}

Headers

​
Authorization
string
required

API key. Value must be formatted like so: lucca application={api_key}.

Body

application/json

A training is a structured program of study offered by a training provider, focused on teaching specific knowledge or skills.

​
title
string
required

Name of the training (maximum length = 250 characters)

​
subtitle
string
required

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

​
description
string
required

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

​
level
enum<string>
required
  • Beginner : For finding out about the subject
  • Middle : For deepening your knowledge
  • Expert : For becoming a specialist
Available options:
Beginner,
Middle,
Expert
​
isCertifying
boolean
required

Is it an accredited training?

​
isMandatory
boolean
required

Is the training mandatory according to legal requirements?

​
type
enum<string>

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

Available options:
External,
Internal
​
state
enum<string>
  • 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.
Available options:
Ready,
Archived

Response

201 - application/json

Created

A training is a structured program of study offered by a training provider, focused on teaching specific knowledge or skills.

​
title
string
required

Name of the training (maximum length = 250 characters)

​
subtitle
string
required

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

​
description
string
required

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

​
level
enum<string>
required
  • Beginner : For finding out about the subject
  • Middle : For deepening your knowledge
  • Expert : For becoming a specialist
Available options:
Beginner,
Middle,
Expert
​
isCertifying
boolean
required

Is it an accredited training?

​
isMandatory
boolean
required

Is the training mandatory according to legal requirements?

​
id
integer

Unique identifier of the training

​
type
enum<string>

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

Available options:
External,
Internal
​
state
enum<string>
  • 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.
Available options:
Ready,
Archived
​
provider
object
​
category
object