Create a project

Learn about the Create endpoint in the Project collection.

This API lets you create a new project and define its data inputs.

API request

Sample

POST {{ServerURL}}/api/services/app/Project/Create

Body

{
  "projectName": "Museum Digital Guide",
  "project_Domain_Id": 4,
  "project_Function_Id": 10,
  "project_Purpose": "General",
  "isRecurringUser": false,
  "productCalibrationStatus": true,
  "interactionSetups": [
    {
      "interaction_setup_id": 5,
      "interaction_mode": "diagnostics"
    },{
      "interaction_setup_id": 3,
      "interaction_mode": "diagnostics"
    },{
     "interaction_setup_id": 3
      "interaction_mode": "user_calibration"
    },{
      "interaction_setup_id": 8,
      "interaction_mode": "user_calibration"
    }
  ]
}

Parameters

Parameter
Description

projectName

Name of the project

project_Domain_Id

Unique identifier of the project's domain.

Note: Whether or not you need to enter the project domain ID depends on your user account;

  • If you are working with a private solution, you might need to enter the project ID instead of the project domain ID.

  • On the other hand, if you are working with a public solution, you might need to enter the project domain and function ID.

This parameter can have the following values:

ID
Domain

-1

No Domain

2

Security & Safety

3

Human wellbeing

4

Digital user experience

project_Function_Id

Unique identifier of the project's function based on the project's domain.

Note: Whether or not you need to enter the project function ID depends on your user account;

  • If you are working with a private solution, you might need to enter the project ID instead of the project domain ID.

  • On the other hand, if you are working with a public solution, you might need to enter the project domain and function ID.

This parameter can have the following values:

  • For No domain (when project_Domain_Id is -1)

ID
Function
Motivation

-1

No Function

-

  • For Security & Safety (when project_Domain_Id is 2)

ID
Function
Motivation

1

Anticipation of drivers' distraction

Imposed

2

Employees' malicious patterns prediction (i.e. security staff of jewellery, bank, etc.)

Free

3

Autonomous digital assistant to access and support safety & security operators duties

Imposed

4

Detection of potential user malicious psychological profile (i.e. before flight onboarding)

Free

  • For Human wellbeing (when project_Domain_Id is 3)

ID
Function
Motivation

5

Work out personalization

Free

6

High-performance athlete's training personalization

Imposed

7

Real-time and historical data of the psychological well being of the employee

Free

8

Users' psychological assessments in real-time (i.e. digital psychologist

Free

  • For Digital user experience (project_Domain_Id is 4)

ID
Function
Motivation

9

Irony detection

Free

10

Music personalisation by emotions

Imposed

11

Marketplace recommendations

Free

12

Virtual soul recreation (i.e. personality) for bots and iNFT

Free

13

Neuro-architecture

Free

duplicate_Project_Id

Indicates whether the project was created by duplicating an existing one. By default, the value of this parameter is null.

project_Purpose

Purpose of the project.

This parameter can have the following values:

  • General

  • Data_Collection

  • Simulation

  • Simulation_bulk By default, the value of this parameter is General.

relatesTo_Project_Id

Unique identifier of another project to which the project is related. Note: When working with solutions that implement simulation, you can have two projects; one for raw data collection (RDC) and the other for running the simulation. In the simulation project, you can enter the project ID of the RDC project so that the results or data gathered in the RDC process can be used for the simulation.

isRecurringUser

Indicates whether the users will interact with Affective Computing (powered by Virtue) once or multiple times. By default, the value of this parameter is false.

productCalibrationStatus

Indicates whether the project is operating in product calibration mode.

interactionSetups

The data inputs you want to configure for the new project. You must enter the following information for each data input:

Field
Description

interaction_setup_id

Unique identifier of the data input. To learn more about which interaction setup ID represents which data input, see View all available data inputs (interaction setups).

interaction_mode

Indicates the process during which the interaction (between a user and the solution) would occurs. This field can have one of the following values:

  • diagnostics

  • user_calibration

  • action

API response

Sample

{
    "result": {
        "projectName": "Museum Digital Guide",
        "duplicated_Project_Id": null,
        "duplicated_Project_Name": null,
        "project_Domain_Id": 4,
        "project_Function_Id": 10,
        "project_Domain_Name": null,
        "project_Function_Name": null,
        "productCalibrationStatus": true,
        "isRecurringUser": false,
        "project_Purpose": "General",
        "relatesTo_Project_Id": null,
        "project_Status": "draft",
        "id": 1234
    },
    "targetUrl": null,
    "success": true,
    "error": null,
    "unAuthorizedRequest": false,
    "__abp": true
}

Attributes

Attribute
Description

id

Unique identifier of the project

projectName

Name of the project

duplicated_Project_Id

The ID of the original project from which the (current) project was cloned, if applicable. Note: This data is available only if the project was cloned (duplicated) from an existing one.

duplicated_Project_Name

The name of the original project from which the (current) project was cloned, if applicable. Note: This data is available only if the project was cloned (duplicated) from an existing one.

project_Domain_Id

Unique identifier of the project's domain.

This parameter can have the following values:

ID
Domain

-1

No Domain

2

Security & Safety

3

Human wellbeing

4

Digital user experience

project_Function_Id

Unique identifier of the project's function based on the project's domain.

Note: Whether or not you need to enter the project function ID depends on your user account;

  • If you are working with a private solution, you might need to enter the project ID instead of the project domain ID.

  • On the other hand, if you are working with a public solution, you might need to enter the project domain and function ID.

This parameter can have the following values:

  • For No domain (when project_Domain_Id is -1)

ID
Function
Motivation

-1

No Function

-

  • For Security & Safety (when project_Domain_Id is 2)

ID
Function
Motivation

1

Anticipation of drivers' distraction

Imposed

2

Employees' malicious patterns prediction (i.e. security staff of jewellery, bank, etc.)

Free

3

Autonomous digital assistant to access and support safety & security operators duties

Imposed

4

Detection of potential user malicious psychological profile (i.e. before flight onboarding)

Free

  • For Human wellbeing (when project_Domain_Id is 3)

ID
Function
Motivation

5

Work out personalization

Free

6

High-performance athlete's training personalization

Imposed

7

Real-time and historical data of the psychological well being of the employee

Free

8

Users' psychological assessments in real-time (i.e. digital psychologist

Free

  • For Digital user experience (project_Domain_Id is 4)

ID
Function
Motivation

9

Irony detection

Free

10

Music personalisation by emotions

Imposed

11

Marketplace recommendations

Free

12

Virtual soul recreation (i.e. personality) for bots and iNFT

Free

13

Neuro-architecture

Free

project_Domain_Name

Name of the project domain.

project_Function_Name

Name of the project function.

productCalibrationStatus

Indicates whether the project is operating in product calibration mode.

isRecurringUser

Indicates whether the project's user will interact with Affective Computing (powered by Virtue) one or multiple times.

project_Purpose

Purpose of the project.

relatesTo_Project_Id

Unique identifier of another project to which the (current) project is related. Note: A project can be linked with another one to enable the data collected by it in the other one too. This data is available in this attribute only if the project is linked to another one. For example, in simulation solutions, the RDC and simulation projects might be linked to facilitate using RDC data for the simulation.

project_Status

Indicates whether the project is released to production.


Understanding data inputsViewing available data inputs (interaction setups)

Last updated

Was this helpful?