Courses and events (Lära)

TABLE OF CONTENTS
Courses and events: Workspace/get
Courses and events: workspace/getlist
Courses and events: workspace/search
Courses and events: workspace/gettypes
Courses and events: workspace/create
Courses and events: workspace/edit
Courses and events: workspace/delete
Courses and events: workspace/getequivalences
Courses and events: workspace/geturl
Courses and events: workspace/getadminbranches
Courses and events: workspace/addadminbranches
Courses and events: workspace/removeadminbranches
Error code descriptions for courses and events

Courses and events

A "Course" or an "Event" are represented by tiles in the catalogue and can issue a certificate when one of their sessions is completed. They are named "workspace" in the API.

Courses and events: Workspace/get

Retrieves information about an existing course.
API call address : https://.../lmsapi/workspace/get

Request

Example of request call content for information about a course:

{
  "id": "vBW5xMw1VQ2A8DFaNy22zA%3d%3d"
}

Field descriptions

Name 

Required

Comments/description

id

X

Unique identifier of the course.
(String type)

Response

Example of the response call content for an information request about a course:

 {
  "id": "vBW5xMw1VQ2A8DFaNy22zA%3d%3d",
  "websiteId": "vBW5xMw1VQ2A8DFaNy22zA%3d%3d",
  "creationDate": "2016-11-16T14:52:27.353",
  "name": "Ma formation",
  "categoryId": "",
  "coverId": "",
  "visibilityType": 0,
  "maxParticipants": 0,
  "minParticipants": 0,
  "type": "vBW5xMw1VQ2A8DFaNy22zA%3d%3d",
   "providerId" : "Mw1VQ2A8DFaNy22zA%3d%3d",
  "language": 1,
  "description": "",
  "shortDescription": "",
  "subscriptionType": 0,
  "startDate": "0001-01-01T00:00:00",
  "endDate": "0001-01-01T00:00:00",
  "isOverBookingSubscription": true,
  "authorizationType": 0,
  "needAdminApproval": true,
  "enrolmentType": 0,
  "externalLink": "monURL",
  "catalogLink": "UrlToPublicCatalog",
  "keywords": "mot,clef,formation",
  "showAvailableSubscriptions": true,
  "certificateId": "",
  "credits": 0.0,
  "nbUsersSubbed": -1,
  "nbUsersQueue": -1,
  "instanceDaysAvailable": 365,
  "instanceDaysToComplete": 180,
  "isAutodeclaration": true,
  "accreditationNumber": "12345-e",
  "autodeclarationStartDate": "0001-01-01T00:00:00",
  "autodeclarationEndDate": "0001-01-01T00:00:00",
  "autodeclarationOrganization": "",
  "autodeclarationApprovalRequired": true,
  "autodeclarationProofUpload": true,
  "autodeclarationProofRequired": true,
  "autodeclarationWorkspaceAndOrganizationEditable": false,
  "autodeclarationSolemnDeclaration": true,
  "autodeclarationPrice": 15.5,
  "lastModificationDate": "0001-01-01T00:00:00",
  "taxEnabled": true,  
  "taxCountryId": 123,  
  "taxStateId": 321,
  "isPlannedActivityDisplayInCatalog": true,
  "isCreditCategorySplitManually": false,
  "canDeclareMultipleTimes": false,
  "autodeclarationPresenceActivitiesRequired": true,
  "customFields": {
    "Champ1": "Snow",
    "Test": ""
  }

}

Field descriptions

Name 

Comments/description

id

This is the unique database identifier. This parameter must be empty when the WorkspaceCreate method is used, but is required in order to call WorkspaceEdit. (String type)

websiteId

This is the unique identifier used when accessing the portal pages.

creationDate

Creation date of the workspace (get only). String type (YYYY-MM-DDTHH:MM:SSZ)

type

Unique identifier of the type of the course or event. Refer to the edit page of the desired type to retrieve this identifier, or to workspace/gettypes

name

Name of the course or event as displayed in the portal (String type, between 5 and 250 characters)

 

language

Language of the course or event

  • 1 = French (Canada) 
  • 2 = English
  • 3 = French (France)
  • 4 = Spanish

 (Number type)

categoryId

The identifier of the category with which your course or event is associated. If several categories are already defined, they will be cleared so that only this category is kept. Returns the identifier of the first associated category.

(String type).

coverId

The identifier of the cover image of your course. Your item can be associated with only one cover image. (String type)

providerId

The identifier of the service provider with which your course or event is associated. Your item can be associated with only one service provider. (String type) In create, the default service provider is used.

visibilityType 

Visibility type in the catalogues

  • 0 = PublicVisibility = public, unauthenticated visitors
  • 1 = AuthenticatedVisibility = authenticated users
  • 2 = SubscribedVisibility = enrolled users only
  • 3 = MaskedVisibility = hidden 

(Number type)

maxParticipants

Maximum number of users who can enrol (if the waiting list is not enabled) 

(Number type)

A value of 0 means no maximum

minParticipants

Minimum number of enrolled users required for the course to take place.

(Number type)

A value of 0 means no minimum

description

Description of the course; this will be displayed in the catalogue and in the course. (String type)

shortDescription

Short description of the course; this will be displayed in the catalogue.

(String type)

subscriptionType

Determines whether the event or course accepts enrolments: 

  • 0 = Open for enrolment (default value) 
  • 1 = Closed 
  • 2 = Open for enrolment for a specific period

startDate

 

This value is required if the specific SubscriptionType (2) is selected. It determines the start of the range during which enrolments are accepted.

(Date type YYYY-MM-DDTHH:MM:SSZ)

endDate

This value is required if the specific SubscriptionType (2) is selected. It determines the end of the range during which enrolments are accepted. 

(Date type YYYY-MM-DDTHH:MM:SSZ)

isOverBookingSubscription

Boolean - this enables the waiting list. The default value is false. 

authorizationType

Accepted authorization types: 

  • 0 = Approval by an administrator
  • 1 = Automatic
needAdminApprovalBoolean - By default this value is "false".  This value determines whether the course requires an approver to be set at the time of enrolment.

enrolmentType

Accepted enrolment types: 

  • 0 = Self-enrolment
  • 1 = Manual  (administrative)
  • 2 = External 

externalLink

Redirect URL applied to the "enrol" link to redirect the user to an external site for enrolment. Maximum 250 characters.

catalogLink

URL to the public catalogue page for this course. The URL provided points to the default portal. 

 

(Get only)

keywords

Search keywords for the course. Maximum 250 characters.

showAvailableSubscriptions

Boolean - By default this value is "false". Displays the number of available and total seats in the catalogue when users enrol. 

certificateId

 

Identifier of the certificate associated with the course or event. It is awarded automatically based on the completion criteria of the workspace. (String type)

credits

Number of credits associated with the successful completion of this course. It cannot be specified if the course or event already has several categories.

Number type

nbUsersSubbed

Value available in GET only, used to obtain the number of users enrolled across all sessions of the course or event

Number type

nbUsersQueue

Value available in GET only, used to obtain the number of users on the waiting list across all sessions of the course or event

Number type

 

instanceDaysAvailable

Determines the number of days after a user's enrolment during which they have access to the content.

This value can be redefined for each session.

A value of 0 means always accessible

instanceDaysToComplete

Determines the maximum number of days after a user's enrolment by which they must have completed the content.

This value can be redefined for each session.

A value of 0 means no completion deadline

isAutodeclaration

Determines whether the workspace can be used as a template to self-declare an accreditation.

Boolean type

accreditationNumber

Determines the accreditation number for a self-declaration

Required only if isAutodeclaration is set to True

autodeclarationStartDate

Determines the earliest date for self-declaring this workspace as an accreditation.

(Date type YYYY-MM-DDTHH:MM:SSZ)

autodeclarationEndDate

Determines the latest date for self-declaring this workspace as an accreditation.

(Date type YYYY-MM-DDTHH:MM:SSZ)

autodeclarationOrganization

Determines the default organization name to display for a new self-declaration.

autodeclarationApprovalRequired

Determines whether the self-declaration must be approved by an administrator

autodeclarationProofUpload

Determines whether the self-declaration allows supporting documents to be uploaded

autodeclarationProofRequired

Determines whether the self-declaration requires supporting documents to be uploaded

autodeclarationSolemnDeclaration

Determines whether the self-declaration requires a solemn declaration from the user before being submitted

autodeclarationPriceIndicates the price of the self-declaration.
Leave empty if the self-declaration is disabled or free.
Type: decimal

catalogId

Only when creating a course or event.

Identifier of the catalogue to which this course or event is to be added.

lastModificationDate

Date of the last modification of the course

Cannot be modified. Available in get and getlist.

customFields

Custom fields linked to the course or event.

taxEnabled

Indicates whether taxes are enabled on the course or event.

(Boolean type)

taxCountryId

Number indicating the country of the course or event

 Number type (See Appendix 3: Countries and States/Provinces)

taxStateId

Number indicating the state of the course or event. 

Number type (See Appendix 3: Countries and States/Provinces)

isPlannedActivityDisplayInCatalogUsed to display planned activities in the catalogue or not.
categoriesList of categories that can categorize the course or event. The number of credits the course or event is worth can be defined for each associated category.
isCreditCategorySplitManuallyDetermines whether the distribution of credits across the various categories is managed manually or not
canDeclareMultipleTimesDetermines whether the course can be self-declared several times by the same user (in a program or regulation context)
autodeclarationPresenceActivitiesRequiredDetermines whether the self-declaration requires activities or workshops to be entered. By default this value is "true" when
the isAutodeclaration field is set to "true".
(Boolean type)
autodeclarationWorkspaceAndOrganizationEditableDetermines whether the self-declaration requires the user to manually enter the title of the course and the name of the organization.
By default this value is "false" when
the isAutodeclaration field is set to "true".
(Boolean type)
isRecognizedInCycleDetermines whether the course is recognized in the regulations.
By default this value is "true" upon creation.
(Boolean type)


Courses and events: workspace/getlist

https://www.domaine.com/lmsapi/workspace/getlist

Retrieves the list of all courses and events.
API call address : https://.../lmsapi/workspace/getlist

Request

Example of request call content for information about a list of courses: 

{
  "filterDate": “YYYY-MM-DDTHH:MM:SSZ”,
  "filterEditDate": “YYYY-MM-DDTHH:MM:SSZ”
}

The filterDate filter parameter is optional and corresponds to the creation date of the element. The method returns the list of objects that were created after the date passed as a filter. 

Type: String (YYYY-MM-DDTHH:MM:SSZ)


The optional filterEditDate filter parameter, for its part, corresponds to the last modification date of the element. The method returns the list of objects that were modified after the date passed as a filter.

A modification made to a course may correspond to:

  • Modification of the administrative settings of the course;
  • Addition or removal of catalogues;
  • Addition or removal of equivalences;

Type: String (YYYY-MM-DDTHH:MM:SSZ) 

Note: At the time of creation, the modification date is also updated at the same time.


Field descriptions

Name 

Required

Comments/description

filterDate

 

Optional parameter corresponding to the creation date of the element. The method returns the list of objects that were created after the date passed as a filter.
Type: String (YYYY-MM-DDTHH:MM:SSZ)

filterEditDate

 

Optional parameter corresponding to the last modification date of the element. The method returns the list of objects that were modified after the date passed as a filter.
Type: String (YYYY-MM-DDTHH:MM:SSZ)

Response

Example of response call content for information about a list of courses: 

[
    {
        "id": "U81AT3R55%2bykP3AsmHqhXw%3d%3d",
        "websiteId": "d4cRnrPVqw1M7s6vlDo%2bCw%3d%3d",
        "creationDate": "2019-07-31T09:59:29.033",
        "type": "cifkD36ecwRFOjpZouBG9w%3d%3d",
        "name": "Conférence annuelle",
        "active": false,
        "language": 1,
        "categoryId": "zPX7k7Km0Do8l2VO6H0fHQ%3d%3d",
        "categories": [
            {
                "id": "zPX7k7Km0Do8l2VO6H0fHQ%3d%3d",
                "credits": 18.0
            }
        ],
        "isCreditCategorySplitManually": false,
        "providerId": "BjUWWGtm6EWiymvxCSL%2bbg%3d%3d",
        "visibilityType": 0,
        "maxParticipants": 150,
        "minParticipants": 0,
        "description": "",
        "shortDescription": "",
        "subscriptionType": 1,
        "startDate": "0001-01-01T00:00:00",
        "endDate": "0001-01-01T00:00:00",
        "isOverBookingSubscription": true,
        "authorizationType": 1,
        "needAdminApproval": false,
        "enrolmentType": 0,
        "keywords": "Conférence 2019",
        "showAvailableSubscriptions": false,
        "certificateId": "lXbTj07FzAnfUsMA9h91HQ%3d%3d",
        "credits": 18.000,
        "coverId": "j9XoGU3mn7f5K7vuvsg9LQ%3d%3d",
        "nbUsersSubbed": 0,
        "nbUsersQueue": 2,
        "isAutodeclaration": false,
        "accreditationNumber": "",
        "autodeclarationStartDate": "0001-01-01T00:00:00",
        "autodeclarationEndDate": "0001-01-01T00:00:00",
        "autodeclarationOrganization": "",
        "autodeclarationApprovalRequired": false,
        "autodeclarationProofUpload": false,
        "autodeclarationProofRequired": false,
        "autodeclarationWorkspaceAndOrganizationEditable": false,
        "autodeclarationSolemnDeclaration": false,
        "autodeclarationPrice": 0.0,
        "instanceDaysAvailable": 0,
        "instanceDaysToComplete": 0,
        "createdByUserID": "xDRTdsQdpthWlNm1CX8H%2bg%3d%3d",
        "taxEnabled": true,
        "customFields": {
            "trainingInstructor": ""
        },
        "isCatalogLinkPublic": true,
        "isPlannedActivityDisplayInCatalog": true,
        "catalogLink": "https://laralms.sviesolutions.com/Web/MyCatalog/ViewP?id=d4cRnrPVqw1M7s6vlDo%2bCw%3d%3d&pid=9tmgrGZzfp8dSpE0tz3tgQ%3d%3d",
        "lastModificationDate": "2023-10-19T09:41:54.893",
        "canDeclareMultipleTimes": false,
        "autodeclarationPresenceActivitiesRequired": false,
        "IsRecognizedInCycle": true
    },
...

Field descriptions

Name 

Comments/description

id

This is the unique database identifier. This parameter must be empty when the WorkspaceCreate method is used, but is required in order to call WorkspaceEdit. (String type)

websiteId

This is the unique identifier used when accessing the portal pages.

creationDate

Creation date of the workspace (get only). String type (YYYY-MM-DDTHH:MM:SSZ)

type

Unique identifier of the type of the course or event. Refer to the edit page of the desired type to retrieve this identifier, or to workspace/gettypes

name

Name of the course or event as displayed in the portal (String type, between 5 and 250 characters)

 

language

Language of the course or event

  • 1 = French (Canada) 
  • 2 = English
  • 3 = French (France)
  • 4 = Spanish

 (Number type)

categoryId

The identifier of the category with which your course or event is associated. If several categories are already defined, they will be cleared so that only this category is kept. Returns the identifier of the first associated category.

(String type).

coverId

The identifier of the cover image of your course. Your item can be associated with only one cover image. (String type)

providerId

The identifier of the service provider with which your course or event is associated. Your item can be associated with only one service provider. (String type) In create, the default service provider is used. 

visibilityType 

Visibility type in the catalogues

  • 0 = PublicVisibility = public, unauthenticated visitors
  • 1 = AuthenticatedVisibility = authenticated users
  • 2 = SubscribedVisibility = enrolled users only
  • 3 = MaskedVisibility = hidden 

(Number type)

maxParticipants

Maximum number of users who can enrol (if the waiting list is not enabled) 

(Number type)

A value of 0 means no maximum

minParticipants

Minimum number of enrolled users required for the course to take place.

(Number type)

A value of 0 means no minimum

description

Description of the course; this will be displayed in the catalogue and in the course. (String type)

shortDescription

Short description of the course; this will be displayed in the catalogue.

(String type)

subscriptionType

Determines whether the event or course accepts enrolments: 

  • 0 = Open for enrolment (default value) 
  • 1 = Closed 
  • 2 = Open for enrolment for a specific period

startDate

 

This value is required if the specific SubscriptionType (2) is selected. It determines the start of the range during which enrolments are accepted.

(Date type YYYY-MM-DDTHH:MM:SSZ)

endDate

This value is required if the specific SubscriptionType (2) is selected. It determines the end of the range during which enrolments are accepted. 

(Date type YYYY-MM-DDTHH:MM:SSZ)

isOverBookingSubscription

Boolean - this enables the waiting list. The default value is false. 

authorizationType

Accepted authorization types: 

  • 0 = Approval by an administrator
  • 1 = Automatic
needAdminApprovalBoolean - By default this value is "false".  This value determines whether the course requires an approver to be set at the time of enrolment.

enrolmentType

Accepted enrolment types: 

  • 0 = Self-enrolment
  • 1 = Manual  (administrative)
  • 2 = External 

externalLink

Redirect URL applied to the "enrol" link to redirect the user to an external site for enrolment. Maximum 250 characters.

catalogLink

URL to the public catalogue page for this course. The URL provided points to the default portal. 

 

(Get only)

keywords

Search keywords for the course. Maximum 250 characters.

showAvailableSubscriptions

Boolean - By default this value is "false". Displays the number of available and total seats in the catalogue when users enrol. 

certificateId

 

Identifier of the certificate associated with the course or event. It is awarded automatically based on the completion criteria of the workspace. (String type)

credits

Number of credits associated with the successful completion of this course. It cannot be specified if the course or event already has several categories.

Number type

nbUsersSubbed

Value available in GET only, used to obtain the number of users enrolled across all sessions of the course or event

Number type

nbUsersQueue

Value available in GET only, used to obtain the number of users on the waiting list across all sessions of the course or event

Number type

 

instanceDaysAvailable

Determines the number of days after a user's enrolment during which they have access to the content.

This value can be redefined for each session.

A value of 0 means always accessible

instanceDaysToComplete

Determines the maximum number of days after a user's enrolment by which they must have completed the content.

This value can be redefined for each session.

A value of 0 means no completion deadline

isAutodeclaration

Determines whether the workspace can be used as a template to self-declare an accreditation.

Boolean type

accreditationNumber

Determines the accreditation number for a self-declaration

Required only if isAutodeclaration is set to True

autodeclarationStartDate

Determines the earliest date for self-declaring this workspace as an accreditation.

(Date type YYYY-MM-DDTHH:MM:SSZ)

autodeclarationEndDate

Determines the latest date for self-declaring this workspace as an accreditation.

(Date type YYYY-MM-DDTHH:MM:SSZ)

autodeclarationOrganization

Determines the default organization name to display for a new self-declaration.

autodeclarationApprovalRequired

Determines whether the self-declaration must be approved by an administrator

autodeclarationProofUpload

Determines whether the self-declaration allows supporting documents to be uploaded

autodeclarationProofRequired

Determines whether the self-declaration requires supporting documents to be uploaded

autodeclarationSolemnDeclaration

Determines whether the self-declaration requires a solemn declaration from the user before being submitted

autodeclarationPriceIndicates the price of the self-declaration.
Leave empty if the self-declaration is disabled or free.
Type: decimal

catalogId

Only when creating a course or event.

Identifier of the catalogue to which this course or event is to be added.

lastModificationDate

Date of the last modification of the course

Cannot be modified. Available in get and getlist.

customFields

Custom fields linked to the course or event.

taxEnabled

Indicates whether taxes are enabled on the course or event.

(Boolean type)

taxCountryId

Number indicating the country of the course or event

 Number type (See Appendix 3: Countries and States/Provinces)

taxStateId

Number indicating the state of the course or event. 

Number type (See Appendix 3: Countries and States/Provinces)

isPlannedActivityDisplayInCatalogUsed to display planned activities in the catalogue or not.
categoriesList of categories that can categorize the course or event. The number of credits the course or event is worth can be defined for each associated category.
isCreditCategorySplitManuallyDetermines whether the distribution of credits across the various categories is managed manually or not
canDeclareMultipleTimesDetermines whether the course can be self-declared several times by the same user (in a program or regulation context)
autodeclarationPresenceActivitiesRequiredDetermines whether the self-declaration requires activities or workshops to be entered. By default this value is "true" when
the isAutodeclaration field is set to "true".
(Boolean type)
autodeclarationWorkspaceAndOrganizationEditableDetermines whether the self-declaration requires the user to manually enter the title of the course and the name of the organization.
By default this value is "false" when
the isAutodeclaration field is set to "true".
(Boolean type)
isRecognizedInCycleDetermines whether the course is recognized in the regulations.
By default this value is "true" upon creation.
(Boolean type)

Courses and events: workspace/search

https://www.domaine.com/lmsapi/workspace/search

Searches for a course or an event by one or more fields.
API call address : https://.../lmsapi/workspace/search

Request

Example of request call content to search for a course: 

{
"websiteId": "vBW5xMw1VQ2A8DFaNy22zA%3d%3d"
}

IMPORTANT: search values are cumulative. For example, if you search for a name and a type, only the records matching both criteria will be returned ("AND").

Field descriptions

Name 

Required

Comments/description

websiteId

 (X)

Unique identifier used when accessing the portal pages.
(String type)

id

 (X)

Unique database identifier of the course or event.
(String type)

name

 (X)

Name of the course or event as displayed in the portal.
(String type)

type

 (X)

Unique identifier of the type of the course or event. Refer to workspace/gettypes.
(String type)

Response

Example of response call content when searching for a course: 

{
  "id": "vBW5xMw1VQ2A8DFaNy22zA%3d%3d",
  "websiteId": "vBW5xMw1VQ2A8DFaNy22zA%3d%3d",
  "creationDate": "2016-11-16T14:52:27.353",
  "name": "Ma formation",
  "categoryId": "",
  "coverId": "",
  "visibilityType": 0,
  "maxParticipants": 0,
  "minParticipants": 0,
  "type": "vBW5xMw1VQ2A8DFaNy22zA%3d%3d",
   "providerId" : "Mw1VQ2A8DFaNy22zA%3d%3d",
  "language": 1,
  "description": "",
  "shortDescription": "",
  "subscriptionType": 0,
  "startDate": "0001-01-01T00:00:00",
  "endDate": "0001-01-01T00:00:00",
  "isOverBookingSubscription": true,
  "authorizationType": 0,
  "needAdminApproval": true,
  "enrolmentType": 0,
  "externalLink": "monURL",
  "catalogLink": "UrlToPublicCatalog",
  "keywords": "mot,clef,formation",
  "showAvailableSubscriptions": true,
  "certificateId": "",
  "credits": 0.0,
  "nbUsersSubbed": -1,
  "nbUsersQueue": -1,
  "instanceDaysAvailable": 365,
  "instanceDaysToComplete": 180,
  "isAutodeclaration": true,
  "accreditationNumber": "12345-e",
  "autodeclarationStartDate": "0001-01-01T00:00:00",
  "autodeclarationEndDate": "0001-01-01T00:00:00",
  "autodeclarationOrganization": "",
  "autodeclarationApprovalRequired": true,
  "autodeclarationProofUpload": true,
  "autodeclarationProofRequired": true,
  "autodeclarationWorkspaceAndOrganizationEditable": true,
  "autodeclarationSolemnDeclaration": true,
  "autodeclarationPrice": 15.5,
  "lastModificationDate": "0001-01-01T00:00:00",
  "canDeclareMultipleTimes": false,
  "autodeclarationPresenceActivitiesRequired": false,
  "customFields": {
    "Champ1": "Snow",
    "Test": ""
  }

}

Field descriptions

Name 

Comments/description

id

This is the unique database identifier. This parameter must be empty when the WorkspaceCreate method is used, but is required in order to call WorkspaceEdit. (String type)

websiteId

This is the unique identifier used when accessing the portal pages.

creationDate

Creation date of the workspace (get only). String type (YYYY-MM-DDTHH:MM:SSZ)

type

Unique identifier of the type of the course or event. Refer to the edit page of the desired type to retrieve this identifier, or to workspace/gettypes

name

Name of the course or event as displayed in the portal (String type, between 5 and 250 characters)

 

language

Language of the course or event

  • 1 = French (Canada) 
  • 2 = English
  • 3 = French (France)
  • 4 = Spanish

 (Number type)

categoryId

The identifier of the category with which your course or event is associated. If several categories are already defined, they will be cleared so that only this category is kept. Returns the identifier of the first associated category.

(String type).

coverId

The identifier of the cover image of your course. Your item can be associated with only one cover image. (String type)

providerId

The identifier of the service provider with which your course or event is associated. Your item can be associated with only one service provider. (String type) In create, the default service provider is used. 

visibilityType 

Visibility type in the catalogues

  • 0 = PublicVisibility = public, unauthenticated visitors
  • 1 = AuthenticatedVisibility = authenticated users
  • 2 = SubscribedVisibility = enrolled users only
  • 3 = MaskedVisibility = hidden 

(Number type)

maxParticipants

Maximum number of users who can enrol (if the waiting list is not enabled) 

(Number type)

A value of 0 means no maximum

minParticipants

Minimum number of enrolled users required for the course to take place.

(Number type)

A value of 0 means no minimum

description

Description of the course; this will be displayed in the catalogue and in the course. (String type)

shortDescription

Short description of the course; this will be displayed in the catalogue.

(String type)

subscriptionType

Determines whether the event or course accepts enrolments: 

  • 0 = Open for enrolment (default value) 
  • 1 = Closed 
  • 2 = Open for enrolment for a specific period

startDate

 

This value is required if the specific SubscriptionType (2) is selected. It determines the start of the range during which enrolments are accepted.

(Date type YYYY-MM-DDTHH:MM:SSZ)

endDate

This value is required if the specific SubscriptionType (2) is selected. It determines the end of the range during which enrolments are accepted. 

(Date type YYYY-MM-DDTHH:MM:SSZ)

isOverBookingSubscription

Boolean - this enables the waiting list. The default value is false. 

authorizationType

Accepted authorization types: 

  • 0 = Approval by an administrator
  • 1 = Automatic
needAdminApprovalBoolean - By default this value is "false".  This value determines whether the course requires an approver to be set at the time of enrolment.

enrolmentType

Accepted enrolment types: 

  • 0 = Self-enrolment
  • 1 = Manual  (administrative)
  • 2 = External 

externalLink

Redirect URL applied to the "enrol" link to redirect the user to an external site for enrolment. Maximum 250 characters.

catalogLink

URL to the public catalogue page for this course. The URL provided points to the default portal. 

 

(Get only)

keywords

Search keywords for the course. Maximum 250 characters.

showAvailableSubscriptions

Boolean - By default this value is "false". Displays the number of available and total seats in the catalogue when users enrol. 

certificateId

 

Identifier of the certificate associated with the course or event. It is awarded automatically based on the completion criteria of the workspace. (String type)

credits

Number of credits associated with the successful completion of this course. It cannot be specified if the course or event already has several categories.

Number type

nbUsersSubbed

Value available in GET only, used to obtain the number of users enrolled across all sessions of the course or event

Number type

nbUsersQueue

Value available in GET only, used to obtain the number of users on the waiting list across all sessions of the course or event

Number type

 

instanceDaysAvailable

Determines the number of days after a user's enrolment during which they have access to the content.

This value can be redefined for each session.

A value of 0 means always accessible

instanceDaysToComplete

Determines the maximum number of days after a user's enrolment by which they must have completed the content.

This value can be redefined for each session.

A value of 0 means no completion deadline

isAutodeclaration

Determines whether the workspace can be used as a template to self-declare an accreditation.

Boolean type

accreditationNumber

Determines the accreditation number for a self-declaration

Required only if isAutodeclaration is set to True

autodeclarationStartDate

Determines the earliest date for self-declaring this workspace as an accreditation.

(Date type YYYY-MM-DDTHH:MM:SSZ)

autodeclarationEndDate

Determines the latest date for self-declaring this workspace as an accreditation.

(Date type YYYY-MM-DDTHH:MM:SSZ)

autodeclarationOrganization

Determines the default organization name to display for a new self-declaration.

autodeclarationApprovalRequired

Determines whether the self-declaration must be approved by an administrator

autodeclarationProofUpload

Determines whether the self-declaration allows supporting documents to be uploaded

autodeclarationProofRequired

Determines whether the self-declaration requires supporting documents to be uploaded

autodeclarationSolemnDeclaration

Determines whether the self-declaration requires a solemn declaration from the user before being submitted

autodeclarationPriceIndicates the price of the self-declaration.
Leave empty if the self-declaration is disabled or free.
Type: decimal

catalogId

Only when creating a course or event.

Identifier of the catalogue to which this course or event is to be added.

lastModificationDate

Date of the last modification of the course

Cannot be modified. Available in get and getlist.

customFields

Custom fields linked to the course or event.

taxEnabled

Indicates whether taxes are enabled on the course or event.

(Boolean type)

taxCountryId

Number indicating the country of the course or event

 Number type (See Appendix 3: Countries and States/Provinces)

taxStateId

Number indicating the state of the course or event. 

Number type (See Appendix 3: Countries and States/Provinces)

isPlannedActivityDisplayInCatalogUsed to display planned activities in the catalogue or not.
categoriesList of categories that can categorize the course or event. The number of credits the course or event is worth can be defined for each associated category.
isCreditCategorySplitManuallyDetermines whether the distribution of credits across the various categories is managed manually or not
canDeclareMultipleTimesDetermines whether the course can be self-declared several times by the same user (in a program or regulation context)
autodeclarationPresenceActivitiesRequiredDetermines whether the self-declaration requires activities or workshops to be entered. By default this value is "true" when
the isAutodeclaration field is set to "true".
(Boolean type)
autodeclarationWorkspaceAndOrganizationEditableDetermines whether the self-declaration requires the user to manually enter the title of the course and the name of the organization.
By default this value is "false" when
the isAutodeclaration field is set to "true".
(Boolean type)
isRecognizedInCycleDetermines whether the course is recognized in the regulations.
By default this value is "true" upon creation.
(Boolean type)

Courses and events: workspace/gettypes

https://www.domaine.com/lmsapi/workspace/gettypes

Retrieves the list of all course and event types.
API call address : https://.../lmsapi/workspace/gettypes

Request

Example of request call content for course types: 

IMPORTANT: The method does not require any parameter.

Field descriptions

Name 

Required

Comments/description

 

 

The method does not require any parameter.

Response

Example of response call content when retrieving course types: 

[
  {
    "id": "vrj0IrWe0HF%2bK9OKGpDF5A%3d%3d",
    "name": {
      "texts": [{
        "text": "Test Nom",
        "languageId": 1
        }
      ]
    },
    "description": {
      "texts": [{
        "text": "Test Description",
        "languageId": 1
        }
      ]
    },
    "type": 0,
    "isDefault": true,
    "iconType": 0,
    "isActive": true,
    "autodeclarationPrice": 15.5,
    "providerId": "vrj0IrWe0HF%2bK9OKGpDF5A%3d%3d"
  }
]

Field descriptions

Name 

Comments/description

id

Unique identifier of the course or event type. This identifier is used in the type field of the workspace/create and workspace/edit methods.
(String type)

name

Name of the type, returned as multilingual texts (texts).

description

Description of the type, returned as multilingual texts (texts).

text

Text of the name or description in the corresponding language.
(String type)

languageId

Identifier of the language of the text.
1 = French (Canada), 2 = English, 3 = French (France), 4 = Spanish
(Number type)

type

Category of the type (course or event).
(Number type)

isDefault

Indicates whether this is the type used by default.
(Boolean type)

iconType

Icon associated with the type.
(Number type)

isActive

Indicates whether the type is active and can be used.
(Boolean type)

autodeclarationPrice

Indicates the price of the self-declaration associated with this type.
Type: decimal

providerId

The identifier of the service provider associated with the type.
(String type)

Courses and events: workspace/create

https://www.domaine.com/lmsapi/workspace/create

Creates a course or an event.
API call address : https://.../lmsapi/workspace/create

Request

Example of request call content to create a course: 

{
  "name": "Ma formation",
  "categoryId": null,
  "coverId": null,
  "visibilityType": 0, 
  "maxParticipants": 0, 
  "minParticipants": 0, 
  "type": "O%252f9dsKKECyJSUWkOK37D8g%253d%253d", 
  "providerId" : "Mw1VQ2A8DFaNy22zA%3d%3d",
  "language": 1,
  "description": "",
  "shortDescription": "",
  "subscriptionType": 0, 
  "startDate": "0001-01-01T00:00:00",
  "endDate": "0001-01-01T00:00:00",
  "isOverBookingSubscription": true, 
  "authorizationType": 0, 
  "needAdminApproval": true,
  "enrolmentType": 0,
  "externalLink": “monURL”,
  "keywords": “mot,clef,formation”,
  "showAvailableSubscriptions": true,
  "certificateId": 0,
  “isAutodeclaration”: true,
  “accreditationNumber”, “12345-a”, 
  “autodeclarationStartDate”: "0001-01-01T00:00:00",
  “autodeclarationEndDate”: "0001-01-01T00:00:00",
  “catalogId”: "O%252f9dsKKECyJSUWkOK37D8g%253d%253d",
  "canDeclareMultipleTimes": false,
  "autodeclarationPresenceActivitiesRequired": false,
  "categories": [
      { "id": "uprlbtvuqNuwmncYPu1ljg%3d%3d", "credits": 1 },
      { "id": "ZP8QuKCp1lvGwyjiTn8SPw%3d%3d", "credits": 2 }
  ],
  "customFields": {
    "Champ1": "Snow",
    "Test": ""
  }
}

Field descriptions

Name 

Required

Comments/description

id


This is the unique database identifier. This parameter must be empty when the WorkspaceCreate method is used, but is required in order to call WorkspaceEdit. (String type)

type

X

Unique identifier of the type of the course or event. Refer to the edit page of the desired type to retrieve this identifier, or to workspace/gettypes

name

X

Name of the course or event as displayed in the portal (String type, between 5 and 250 characters)

 

language

 

Language of the course or event

  • 1 = French (Canada) 
  • 2 = English
  • 3 = French (France)
  • 4 = Spanish

 (Number type)

categoryId

 

The identifier of the category with which your course or event is associated. If several categories are already defined, they will be cleared so that only this category is kept. Returns the identifier of the first associated category.

(String type).

coverId

 

The identifier of the cover image of your course. Your item can be associated with only one cover image. (String type)

providerId

 

The identifier of the service provider with which your course or event is associated. Your item can be associated with only one service provider. (String type) In create, the default service provider is used. 

visibilityType 

X

Visibility type in the catalogues

  • 0 = PublicVisibility = public, unauthenticated visitors
  • 1 = AuthenticatedVisibility = authenticated users
  • 2 = SubscribedVisibility = enrolled users only
  • 3 = MaskedVisibility = hidden 

(Number type)

maxParticipants

X

Maximum number of users who can enrol (if the waiting list is not enabled) 

(Number type)

A value of 0 means no maximum

minParticipants

X

Minimum number of enrolled users required for the course to take place.

(Number type)

A value of 0 means no minimum

description

 

Description of the course; this will be displayed in the catalogue and in the course. (String type)

shortDescription

 

Short description of the course; this will be displayed in the catalogue.

(String type)

subscriptionType

X

Determines whether the event or course accepts enrolments: 

  • 0 = Open for enrolment (default value) 
  • 1 = Closed 
  • 2 = Open for enrolment for a specific period

startDate

 

 

This value is required if the specific SubscriptionType (2) is selected. It determines the start of the range during which enrolments are accepted.

(Date type YYYY-MM-DDTHH:MM:SSZ)

endDate

 

This value is required if the specific SubscriptionType (2) is selected. It determines the end of the range during which enrolments are accepted. 

(Date type YYYY-MM-DDTHH:MM:SSZ)

isOverBookingSubscription

X

Boolean - this enables the waiting list. The default value is false.

authorizationType

X

Accepted authorization types: 

  • 0 = Approval by an administrator
  • 1 = Automatic
needAdminApproval
Boolean - By default this value is "false".  This value determines whether the course requires an approver to be set at the time of enrolment.

enrolmentType

 

Accepted enrolment types: 

  • 0 = Self-enrolment
  • 1 = Manual  (administrative)
  • 2 = External 

externalLink

 

Redirect URL applied to the "enrol" link to redirect the user to an external site for enrolment. Maximum 250 characters.

keywords

 

Search keywords for the course. Maximum 250 characters.

showAvailableSubscriptions

X

Boolean - By default this value is "false". Displays the number of available and total seats in the catalogue when users enrol. 

certificateId

 

 

Identifier of the certificate associated with the course or event. It is awarded automatically based on the completion criteria of the workspace. (String type)

credits

 

Number of credits associated with the successful completion of this course. It cannot be specified if the course or event already has several categories.

Number type

nbUsersSubbed

 

Value available in GET only, used to obtain the number of users enrolled across all sessions of the course or event

Number type

nbUsersQueue

 

Value available in GET only, used to obtain the number of users on the waiting list across all sessions of the course or event

Number type

 

instanceDaysAvailable


Determines the number of days after a user's enrolment during which they have access to the content.

This value can be redefined for each session.

A value of 0 means always accessible

instanceDaysToComplete


Determines the maximum number of days after a user's enrolment by which they must have completed the content.

This value can be redefined for each session.

A value of 0 means no completion deadline

isAutodeclaration

 

Determines whether the workspace can be used as a template to self-declare an accreditation.

Boolean type

accreditationNumber

 

Determines the accreditation number for a self-declaration

Required only if isAutodeclaration is set to True

autodeclarationStartDate

 

Determines the earliest date for self-declaring this workspace as an accreditation.

(Date type YYYY-MM-DDTHH:MM:SSZ)

autodeclarationEndDate

 

Determines the latest date for self-declaring this workspace as an accreditation.

(Date type YYYY-MM-DDTHH:MM:SSZ)

autodeclarationOrganization

 

Determines the default organization name to display for a new self-declaration.

autodeclarationApprovalRequired

 

Determines whether the self-declaration must be approved by an administrator

autodeclarationProofUpload

 

Determines whether the self-declaration allows supporting documents to be uploaded

autodeclarationProofRequired

 

Determines whether the self-declaration requires supporting documents to be uploaded

autodeclarationSolemnDeclaration

 

Determines whether the self-declaration requires a solemn declaration from the user before being submitted

autodeclarationPrice
Indicates the price of the self-declaration.
Leave empty if the self-declaration is disabled or free.
Type: decimal

catalogId

 

Only when creating a course or event.

Identifier of the catalogue to which this course or event is to be added.

lastModificationDate

 

Date of the last modification of the course

Cannot be modified. Available in get and getlist.

customFields

 

Custom fields linked to the course or event.

taxEnabled

 

Indicates whether taxes are enabled on the course or event.

(Boolean type)

taxCountryId

 

Number indicating the country of the course or event

 Number type (See Appendix 3: Countries and States/Provinces)

taxStateId

 

Number indicating the state of the course or event. 

Number type (See Appendix 3: Countries and States/Provinces)

isPlannedActivityDisplayInCatalog
Used to display planned activities in the catalogue or not.
categories
List of categories that can categorize the course or event. The number of credits the course or event is worth can be defined for each associated category.
isCreditCategorySplitManually
Determines whether the distribution of credits across the various categories is managed manually or not.
canDeclareMultipleTimes
Determines whether the course can be self-declared several times by the same user (in a program or regulation context).
autodeclarationPresenceActivitiesRequired
Determines whether the self-declaration requires activities or workshops to be entered. By default this value is "true" when
the isAutodeclaration field is set to "true".
(Boolean type)
autodeclarationWorkspaceAndOrganizationEditable
Determines whether the self-declaration requires the user to manually enter the title of the course and the name of the organization.
By default this value is "false" when
the isAutodeclaration field is set to "true".
(Boolean type)
isRecognizedInCycle
Determines whether the course is recognized in the regulations.
By default this value is "true" upon creation.
(Boolean type)

Response

Example of response call content when creating a course: 

{
  "id": "vBW5xMw1VQ2A8DFaNy22zA%3d%3d"
}

Field descriptions

Name 

Comments/description

id

Unique identifier of the created course or event.
(String type)

Courses and events: workspace/edit

https://www.domaine.com/lmsapi/workspace/edit

Modifies an existing course or event.
API call address : https://.../lmsapi/workspace/edit

Request

Example of request call content to edit a course: 

{
  "id": "vBW5xMw1VQ2A8DFaNy22zA%3d%3d", 
  "name": "Ma formation",
  "categoryId": null,
  "coverId": null,
  "visibilityType": 0, 
  "maxParticipants": 0, 
  "minParticipants": 0, 
  "type": "O%252f9dsKKECyJSUWkOK37D8g%253d%253d", 
  "providerId" : "Mw1VQ2A8DFaNy22zA%3d%3d",
  "language": 1,
  "description": "",
  "shortDescription": "",
  "subscriptionType": 0, 
  "startDate": "0001-01-01T00:00:00",
  "endDate": "0001-01-01T00:00:00",
  "isOverBookingSubscription": true, 
  "authorizationType": 0, 
  "needAdminApproval": true,
  "enrolmentType": 0,
  "externalLink": "monURL",
  "keywords": "mot,clef,formation",
  "showAvailableSubscriptions": true,
  "certificateId": 0,
  "isAutodeclaration”: true,
  "accreditationNumber", "12345-a",
  "autodeclarationEndDate": "0001-01-01T00:00:00",
  "autodeclarationWorkspaceAndOrganizationEditable": false,
  "instanceDaysAvailable", 365,
  "instanceDaysToComplete", 180,
  "canDeclareMultipleTimes": false,
  "autodeclarationPresenceActivitiesRequired": false,
  "categories": [
      { "id": "uprlbtvuqNuwmncYPu1ljg%3d%3d", "credits": 1 },
      { "id": "ZP8QuKCp1lvGwyjiTn8SPw%3d%3d", "credits": 2 }
  ],
  "customFields": {
    "Champ1": "Snow",
    "Test": ""
  }
}

IMPORTANT: When editing, only the Id value is required.

Field descriptions

Name 

Required

Comments/description

id

X

This is the unique database identifier. This parameter must be empty when the WorkspaceCreate method is used, but is required in order to call WorkspaceEdit. (String type)

type


Unique identifier of the type of the course or event. Refer to the edit page of the desired type to retrieve this identifier, or to workspace/gettypes

name


Name of the course or event as displayed in the portal (String type, between 5 and 250 characters)

 

language

 

Language of the course or event

  • 1 = French (Canada) 
  • 2 = English
  • 3 = French (France)
  • 4 = Spanish

 (Number type)

categoryId

 

The identifier of the category with which your course or event is associated. If several categories are already defined, they will be cleared so that only this category is kept. Returns the identifier of the first associated category.

(String type).

coverId

 

The identifier of the cover image of your course. Your item can be associated with only one cover image. (String type)

providerId

 

The identifier of the service provider with which your course or event is associated. Your item can be associated with only one service provider. (String type) In create, the default service provider is used. 

visibilityType 


Visibility type in the catalogues

  • 0 = PublicVisibility = public, unauthenticated visitors
  • 1 = AuthenticatedVisibility = authenticated users
  • 2 = SubscribedVisibility = enrolled users only
  • 3 = MaskedVisibility = hidden 

(Number type)

maxParticipants


Maximum number of users who can enrol (if the waiting list is not enabled) 

(Number type)

A value of 0 means no maximum

minParticipants


Minimum number of enrolled users required for the course to take place.

(Number type)

A value of 0 means no minimum

description


Description of the course; this will be displayed in the catalogue and in the course. (String type)

shortDescription


Short description of the course; this will be displayed in the catalogue.

(String type)

subscriptionType


Determines whether the event or course accepts enrolments: 

  • 0 = Open for enrolment (default value) 
  • 1 = Closed 
  • 2 = Open for enrolment for a specific period

startDate

 


This value is required if the specific SubscriptionType (2) is selected. It determines the start of the range during which enrolments are accepted.

(Date type YYYY-MM-DDTHH:MM:SSZ)

endDate


This value is required if the specific SubscriptionType (2) is selected. It determines the end of the range during which enrolments are accepted. 

(Date type YYYY-MM-DDTHH:MM:SSZ)

isOverBookingSubscription


Boolean - this enables the waiting list. The default value is false. 

authorizationType


Accepted authorization types: 

  • 0 = Approval by an administrator
  • 1 = Automatic
needAdminApproval
Boolean - By default this value is "false". This value determines whether the course requires an approver to be set at the time of enrolment.

enrolmentType


Accepted enrolment types: 

  • 0 = Self-enrolment
  • 1 = Manual  (administrative)
  • 2 = External 

externalLink


Redirect URL applied to the "enrol" link to redirect the user to an external site for enrolment. Maximum 250 characters.

catalogLink


URL to the public catalogue page for this course. The URL provided points to the default portal. 

 

(Get only)

keywords


Search keywords for the course. Maximum 250 characters.

showAvailableSubscriptions


Boolean - By default this value is "false". Displays the number of available and total seats in the catalogue when users enrol. 

certificateId

 


Identifier of the certificate associated with the course or event. It is awarded automatically based on the completion criteria of the workspace. (String type)

credits


Number of credits associated with the successful completion of this course. It cannot be specified if the course or event already has several categories.

Number type

nbUsersSubbed


Value available in GET only, used to obtain the number of users enrolled across all sessions of the course or event

Number type

nbUsersQueue


Value available in GET only, used to obtain the number of users on the waiting list across all sessions of the course or event

Number type

 

instanceDaysAvailable


Determines the number of days after a user's enrolment during which they have access to the content.

This value can be redefined for each session.

A value of 0 means always accessible

instanceDaysToComplete


Determines the maximum number of days after a user's enrolment by which they must have completed the content.

This value can be redefined for each session.

A value of 0 means no completion deadline

isAutodeclaration


Determines whether the workspace can be used as a template to self-declare an accreditation.

Boolean type

accreditationNumber


Determines the accreditation number for a self-declaration

Required only if isAutodeclaration is set to True

autodeclarationStartDate


Determines the earliest date for self-declaring this workspace as an accreditation.

(Date type YYYY-MM-DDTHH:MM:SSZ)

autodeclarationEndDate


Determines the latest date for self-declaring this workspace as an accreditation.

(Date type YYYY-MM-DDTHH:MM:SSZ)

autodeclarationOrganization


Determines the default organization name to display for a new self-declaration.

autodeclarationApprovalRequired


Determines whether the self-declaration must be approved by an administrator

autodeclarationProofUpload


Determines whether the self-declaration allows supporting documents to be uploaded

autodeclarationProofRequired


Determines whether the self-declaration requires supporting documents to be uploaded

autodeclarationSolemnDeclaration


Determines whether the self-declaration requires a solemn declaration from the user before being submitted

autodeclarationPrice
Indicates the price of the self-declaration.
Leave empty if the self-declaration is disabled or free.
Type: decimal

catalogId


Only when creating a course or event.

Identifier of the catalogue to which this course or event is to be added.

lastModificationDate


Date of the last modification of the course

Cannot be modified. Available in get and getlist.

customFields


Custom fields linked to the course or event.

taxEnabled


Indicates whether taxes are enabled on the course or event.

(Boolean type)

taxCountryId


Number indicating the country of the course or event

 Number type (See Appendix 3: Countries and States/Provinces)

taxStateId


Number indicating the state of the course or event. 

Number type (See Appendix 3: Countries and States/Provinces)

isPlannedActivityDisplayInCatalog
Used to display planned activities in the catalogue or not.
categories
List of categories that can categorize the course or event. The number of credits the course or event is worth can be defined for each associated category.
isCreditCategorySplitManually
Determines whether the distribution of credits across the various categories is managed manually or not
canDeclareMultipleTimes
Determines whether the course can be self-declared several times by the same user (in a program or regulation context)
autodeclarationPresenceActivitiesRequired
Determines whether the self-declaration requires activities or workshops to be entered. By default this value is "true" when
the isAutodeclaration field is set to "true".
(Boolean type)
autodeclarationWorkspaceAndOrganizationEditable
Determines whether the self-declaration requires the user to manually enter the title of the course and the name of the organization.
By default this value is "false" when
the isAutodeclaration field is set to "true".
(Boolean type)
isRecognizedInCycle
Determines whether the course is recognized in the regulations.
By default this value is "true" upon creation.
(Boolean type)

Response

Example of response content for a request to edit a course: 

{
  "id": "vBW5xMw1VQ2A8DFaNy22zA%3d%3d"
}

Field descriptions

Name 

Comments/description

id

Unique identifier of the modified course or event.
(String type)

Courses and events: workspace/delete

https://www.domaine.com/lmsapi/workspace/delete

Deletes an existing course or event.
API call address : https://.../lmsapi/workspace/delete

Request

Example of request call content to delete a course: 

{
  "id": "vBW5xMw1VQ2A8DFaNy22zA%3d%3d" 
}

IMPORTANT: The id value is required for this method. 

Field descriptions

Name 

Required

Comments/description

id

X

Unique identifier of the course.
(String type)

Response

Example of response call content when deleting a course: 

{
  "id": "vBW5xMw1VQ2A8DFaNy22zA%3d%3d"
}

Field descriptions

Name 

Comments/description

id

Unique identifier of the deleted course or event.
(String type)

Courses and events: workspace/getequivalences

https://www.domaine.com/lmsapi/workspace/getequivalences

Retrieves the list of equivalent courses or events.
API call address : https://.../lmsapi/workspace/getequivalences

Request

Example of request call content to retrieve the equivalences of a course: 

{
  "id": "vBW5xMw1VQ2A8DFaNy22zA%3d%3d" 
}

IMPORTANT: The id value is required for this method.

Field descriptions

Name 

Required

Comments/description

id

X

Unique identifier of the course.
(String type)

Response

Example of response call content when retrieving the equivalences of a course: 

[
  {
    "id": "vBW5xMw1VQ2A8DFaNy22zA%3d%3d",
    "equivalenceId": "AcLsGid1Op46%2bB3ap%2bwoeA%3d%3d",
    "credits": 4.0
  },
  {
    "id": "vBW5xMw1VQ2A8DFaNy22zA%3d%3d",
    "equivalenceId": "uXKrQaur%2fIQ7aFslJTtZVg%3d%3d",
    "credits": 2.0
  },
  {
    "id": "vBW5xMw1VQ2A8DFaNy22zA%3d%3d",
    "equivalenceId": "paIkOU7nZFfUhMSPlj5iPg%3d%3d",
    "credits": 3.0
  }
]

Field descriptions

Name 

Comments/description

id

This is the unique database identifier of the course or event with which an equivalence is associated.
(String type)

equivalenceId

The unique database identifier of the equivalent course or event.
(String type)

credits

Number of equivalence credits associated with the successful completion of this course or event.
(Number type)

Courses and events: workspace/geturl

https://www.domaine.com/lmsapi/workspace/geturl

Retrieves the list of public catalogue URLs for this course or event.
API call address : https://.../lmsapi/workspace/geturl

Request

Example of request call content to retrieve the catalogue URL of a course: 

{
  "id": "vBW5xMw1VQ2A8DFaNy22zA%3d%3d",
  "filterId" : "aoflemrnQ2A8DFaNy22zA%3d%3d"
}

IMPORTANT: The id value is required for this method. 

IMPORTANT: The filterId value (optional) is a portal identifier used to receive only the URL of this course for that specific portal

Field descriptions

Name 

Required

Comments/description

id

X

Unique identifier of the course.
(String type)

filterId

 

Portal identifier used to receive only the URL of this course for that specific portal.
(String type)

Response

Example of response call content when retrieving the catalogue URL of a course: 

[
  {
    "portalId": "vBW5xMw1VQ2A8DFaNy22zA%3d%3d",
    "url": "UrlPourLePortail"
  },
  {
    "portalId": "h89s6rd8hVQ2A8DFaNy22zA%3d%3d",
    "url": "UrlPourLePortail"
  }
]

Field descriptions

Name 

Comments/description

portalId

Unique identifier of the portal for which the URL is returned.
(String type)

url

URL to the public catalogue page of this course or event for the corresponding portal.
(String type)

Courses and events: workspace/getadminbranches

https://www.domaine.com/lmsapi/workspace/getadminbranches

Retrieves the list of administrative branches associated with a course or event.
API call address : https://.../lmsapi/workspace/getadminbranches

Request

Example of request call content for the branch or branches of a course: 

{
  "id": "68a9Y6p%2bhVsJJBRcIMOo0w%3d%3d"
}

Field descriptions

Name 

Required

Comments/description

id

X

Unique identifier of the course.
(String type)

Response

Example of response call content for the branch or branches of a course: 

[
  "vrj0IrWe0HF%2bK9OKGpDF5A%3d%3d",
    "6d7yavtJwLemtOAO2HF5BQ%3d%3d"
]

Field descriptions

Name 

Comments/description

branches

List of the unique identifiers of the administrative branches associated with the course or event.
(List of strings type)

Courses and events: workspace/addadminbranches

https://www.domaine.com/lmsapi/workspace/addadminbranches

Adds administrative branches to a course or event.
API call address : https://.../lmsapi/workspace/addadminbranches

Request

Example of request call content to add a course to one or more branches: 

{
  "id": "68a9Y6p%2bhVsJJBRcIMOo0w%3d%3d",
  branches: [
    "vrj0IrWe0HF%2bK9OKGpDF5A%3d%3d",
    "6d7yavtJwLemtOAO2HF5BQ%3d%3d"
  ]
}

Field descriptions

Name 

Required

Comments/description

id

X

Unique identifier of the course.
(String type)

branches

X

List of the unique identifiers of the administrative branches.
(List of strings type)

Response

Example of response call content when adding a course to one or more branches: 

{
  "id": "68a9Y6p%2bhVsJJBRcIMOo0w%3d%3d"
}

Field descriptions

Name 

Comments/description

id

Unique identifier of the course or event to which the branches were added.
(String type)

Courses and events: workspace/removeadminbranches

https://www.domaine.com/lmsapi/workspace/removeadminbranches

Removes administrative branches from a course or event.
API call address : https://.../lmsapi/workspace/removeadminbranches

Request

Example of request call content to remove a course from one or more branches: 

{
  "id": "68a9Y6p%2bhVsJJBRcIMOo0w%3d%3d",
  branches: [
    "vrj0IrWe0HF%2bK9OKGpDF5A%3d%3d",
    "6d7yavtJwLemtOAO2HF5BQ%3d%3d"
  ]
}

Field descriptions

Name 

Required

Comments/description

id

X

Unique identifier of the course.
(String type)

branches

X

List of the unique identifiers of the administrative branches.
(List of strings type)

Response

Example of response call content when removing a course from one or more branches: 

{
  "id": "68a9Y6p%2bhVsJJBRcIMOo0w%3d%3d"
}

Field descriptions

Name 

Comments/description

id

Unique identifier of the course or event from which the branches were removed.
(String type)


Error code descriptions for courses and events

Number

Message

Comments/description

400

Required id

You must provide an identifier for the course or event.

401

Invalid id

The identifier provided for the course or event is invalid.

402

Required type

You must provide an identifier for the type of the course or event.

403

Invalid type

The identifier provided for the type of the course or event is not valid.

404

Required name

You must provide a name for the course or event.

405

Invalid name length

The name provided for the course or event must contain between 5 and 250 characters inclusively. 

406

Required minParticipants

You must provide a minimum number of participants.

407

Invalid minParticipants

The minimum number of participants provided must be greater than or equal to 0.

408

Required maxParticipants

You must provide a maximum number of participants.

409

Invalid maxParticipants

The maximum number of participants provided must be greater than or equal to 0.

410

Required subscriptionType

You must provide the enrolment type.

411

Required isOverBookingSubscription

You must provide "True" or "False".

412

Required authorizationType

You must provide the authorization type for enrolments.

413

Required visibilityType

You must provide the visibility type of the course.

414

Required showAvailableSubscriptions

You must provide "True" or "False".

415

Required accreditationNumber

If self-declaration is enabled, you must provide an accreditation number.

416

Invalid accreditationNumber length

The accreditation number provided is invalid.

417

Required autodeclarationOrganization

When self-declaration is enabled, you must provide an organization name.

418

Invalid autodeclarationOrganization length

The length of the organization name provided for the self-declaration must be between 3 and 250 characters inclusively.

419

Invalid instanceDaysAvailable

The number of days provided for the availability of the course or event is invalid.

420

Invalid instanceDaysToComplete

The number of days provided to complete the course is invalid.

421

Invalid providerId

The identifier provided for the provider is invalid.

422

Certificate requires providerId

When you provide a certificate identifier, you must provide an identifier for the provider.

423

Invalid certificateId

The identifier provided for the certificate is invalid.

424

Invalid catalogId

The identifier provided for the catalogue is invalid.

425

Invalid coverId

The identifier provided for the cover image selection is invalid.

426

Required externalLink

If the accepted enrolment type is external, you must provide a redirect link.

427

Invalid externalLink length

If the accepted enrolment type is external, the redirect link provided must contain between 5 and 250 characters inclusively.

428

Invalid keywords length

The keyword list must contain a maximum of 250 characters inclusively.

429

Invalid workspaceType ID

The identifier provided for the course or event type is invalid.

430

Autodeclaration not enabled

You must enable self-declaration in order to modify its settings.

431

Invalid shortDescription Length

The short description must contain a maximum of 200 characters inclusively.

432

Invalid filterId

The identifier provided to perform the filter is invalid.

433

Invalid public id

The public identifier provided for the course or event is invalid.

434Missing required branchesThe "branches" parameter is required.
435Invalid branchIdA branch identifier is invalid.
436Cannot remove all branchesAll administrative branches of a course cannot be removed.
437Cannot add branchesThe administrative branches cannot be added to a course because some branches have already been added.
438Cannot remove branchesThe administrative branches of a course cannot be removed because some branches are not associated.

439Invalid language

The value provided for the language is invalid.

440Cannot specify both categoryId and categoriesCannot specify both  the category identifier and the categories
441Cannot change overall credits when there are multiple categoriesThe total number of credits cannot be changed when there are several categories
442Invalid Category IdThe value of the category identifier is invalid
443Invalid Authorization TypeThe value provided for the authorization type does not match the information provided
444Invalid AutodeclarationPriceThe value of the self-declaration price is invalid
445Cannot edit AutodeclarationPresenceActivitiesRequired from the moment a self-declaration is in the courseThe required attendance activities option of the self-declarations cannot be modified once there is a self-declaration in the course


Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.