Download OpenAPI specification:Download
The console regroups the following engines:
Create an access key
| projectId required | string Project ID |
| name required | string AccessKey's name |
{- "name": "myAccessKey"
}{- "id": "5798f36a-7ddc-406e-92d9-1b2483883c16",
- "name": "myConsoleAccessKey",
- "createdAt": "2021-04-15T14:41:10+00:00",
- "secret": "b24f431a67edf5595925150610c162d0d7479303"
}A Custom Field allow you to send extra custom infos in your Analysis, either text in the body or files in the attachments
Create a Custom Field for an Environment
| environmentId required | integer Example: 1 Environment's Id |
| label required | string Custom Field label |
| name required | string Custom Field technical name |
| required required | boolean Is Custom Field required in Analysis |
| type required | string Enum: "body" "attachment" Type of the Custom Field |
{- "label": "otherAttachments",
- "name": "Field for other attachments",
- "required": true,
- "type": "body"
}{- "id": "3f6d03d1-065d-45c7-8baa-9216283e729d",
- "label": "otherAttachment",
- "name": "custom field for other attachment",
- "required": true
}Get all custom fields with an environment id
| environmentId required | integer Example: 1 Environment's Id |
[- {
- "id": "3f6d03d1-065d-45c7-8baa-9216283e729d",
- "label": "otherAttachment",
- "name": "custom field for other attachment",
- "required": true
}
]Update a Custom Field
| environmentId required | integer Example: 1 Environment's Id |
| customFieldId required | integer Example: 1 Custom Field's Id |
| label | string Custom Field label |
| name | string Custom Field technical name |
| active | boolean Is Custom Field active |
| required | boolean Is Custom Field required in Analysis |
| type | string Enum: "body" "attachment" Type of the Custom Field |
{- "label": "otherAttachments",
- "name": "Field for other attachments",
- "active": true,
- "required": true,
- "type": "body"
}{- "id": "3f6d03d1-065d-45c7-8baa-9216283e729d",
- "label": "otherAttachment",
- "name": "custom field for other attachment",
- "required": true
}This endpoint allow users to create Environments in a Project.
| projectId required | string Project ID |
t
| name required | string non-empty The name of the new environment |
{- "name": "client-demo"
}{- "id": 15,
- "name": "client-prod"
}Manipulate Environment
| projectId required | string Project ID |
| environmentId required | string Environment ID |
| code required | integer |
| message | string |
{- "name": "client-demo",
- "code": 1
}{- "id": 15,
- "name": "client-prod"
}Get all Interactions of one Environment
| environmentId required | integer Id of the Environment |
| contextId | integer To filter by contextId |
[- {
- "id": 1,
- "context": {
- "id": 1,
- "name": "My Context",
- "langs": [
- "fr"
]
}, - "idInteraction": "My Interaction",
- "enabled": true,
- "functions": [
- {
- "id": 1,
- "name": "foo",
- "functionName": "IsRightAfter",
- "functionParameters": [
- {
- "name": "interactionRightBefore",
- "interaction": "bar"
}
]
}
], - "descriptors": {
- "**langName**": [
- "foo"
]
}, - "ordonned": true,
- "parameters": [
- {
- "id": 1,
- "multiple": true,
- "optional": true,
- "idParameter": "bar",
- "resetConversation": true,
- "position": null,
- "archetype": {
- "id": 1,
- "name": "foo"
}, - "descriptors": {
- "**langName**": [
- "foo"
]
}, - "descriptorsLeft": {
- "**langName**": [
- "foo"
]
}, - "descriptorsRight": {
- "**langName**": [
- "foo"
]
}
}
]
}
]Create an Interaction for a Context
| idInteraction required | string Interaction's Name |
| enabled | boolean Is Interaction enable (false by default) |
| ordonned | boolean Are Interaction's Parameter Ordonned By Order (false by default) |
| contextId required | integer Context Id's |
{- "idInteraction": "foo",
- "enabled": true,
- "ordonned": true,
- "contextId": 1
}[- {
- "id": 1,
- "context": {
- "id": 1,
- "name": "My Context",
- "langs": [
- "fr"
]
}, - "idInteraction": "My Interaction",
- "enabled": true,
- "functions": [
- {
- "id": 1,
- "name": "foo",
- "functionName": "IsRightAfter",
- "functionParameters": [
- {
- "name": "interactionRightBefore",
- "interaction": "bar"
}
]
}
], - "descriptors": {
- "**langName**": [
- "foo"
]
}, - "ordonned": true,
- "parameters": [
- {
- "id": 1,
- "multiple": true,
- "optional": true,
- "idParameter": "bar",
- "resetConversation": true,
- "position": null,
- "archetype": {
- "id": 1,
- "name": "foo"
}, - "descriptors": {
- "**langName**": [
- "foo"
]
}, - "descriptorsLeft": {
- "**langName**": [
- "foo"
]
}, - "descriptorsRight": {
- "**langName**": [
- "foo"
]
}
}
]
}
]Get One Interaction With Id
| interactionId required | integer Id of the Interaction |
[- {
- "id": 1,
- "context": {
- "id": 1,
- "name": "My Context",
- "langs": [
- "fr"
]
}, - "idInteraction": "My Interaction",
- "enabled": true,
- "functions": [
- {
- "id": 1,
- "name": "foo",
- "functionName": "IsRightAfter",
- "functionParameters": [
- {
- "name": "interactionRightBefore",
- "interaction": "bar"
}
]
}
], - "descriptors": {
- "**langName**": [
- "foo"
]
}, - "ordonned": true,
- "parameters": [
- {
- "id": 1,
- "multiple": true,
- "optional": true,
- "idParameter": "bar",
- "resetConversation": true,
- "position": null,
- "archetype": {
- "id": 1,
- "name": "foo"
}, - "descriptors": {
- "**langName**": [
- "foo"
]
}, - "descriptorsLeft": {
- "**langName**": [
- "foo"
]
}, - "descriptorsRight": {
- "**langName**": [
- "foo"
]
}
}
]
}
]Update an Interaction
| interactionId required | integer Id of the Interaction |
| idInteraction | string Interaction's Name |
| enabled | boolean Is Interaction Enable |
| ordonned | boolean Are Interaction's Parameter Ordonned By Order |
Array of objects | |
Array of objects |
{- "idInteraction": "bar",
- "enabled": true,
- "ordonned": true,
- "parameters": [
- {
- "event": "string",
- "payload": {
- "archetype": "string",
- "multiple": true,
- "optional": true,
- "resetConversation": true,
- "idParameter": "string"
}, - "id": 0
}
], - "functions": [
- {
- "event": "IsAfterFoo",
- "id": 1,
- "payload": {
- "name": "string",
- "functionName": "string",
- "functionParameters": {
- "**paramName**": "foo"
}
}
}
]
}{- "id": 1,
- "context": {
- "id": 1,
- "name": "My Context",
- "langs": [
- "fr"
]
}, - "idInteraction": "My Interaction",
- "enabled": true,
- "functions": [
- {
- "id": 1,
- "name": "foo",
- "functionName": "IsRightAfter",
- "functionParameters": [
- {
- "name": "interactionRightBefore",
- "interaction": "bar"
}
]
}
], - "descriptors": {
- "**langName**": [
- "foo"
]
}, - "ordonned": true,
- "parameters": [
- {
- "id": 1,
- "multiple": true,
- "optional": true,
- "idParameter": "bar",
- "resetConversation": true,
- "position": null,
- "archetype": {
- "id": 1,
- "name": "foo"
}, - "descriptors": {
- "**langName**": [
- "foo"
]
}, - "descriptorsLeft": {
- "**langName**": [
- "foo"
]
}, - "descriptorsRight": {
- "**langName**": [
- "foo"
]
}
}
]
}Login on the Console with your username and password to get a bearer token.
Login to the Console to get an Bearer Token.
| username required | string Your username |
| password required | string Your password |
{- "username": "aUser",
- "password": "aPassword"
}{- "token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJpYXQiOjE2MTg1ODI4MDksImV4cCI6MTYxOTg3ODgwOSwicm9sZXMiOltdLCJ1c2VybmFtZSI6ImFubmUtc29waGllLnRhbmd1eUBnb2xlbS5haSJ9.TxJjklsd,sdl865lkJLKJjnSEbbnbnXy9456bKNKJ-KJ7gkR4hGFgd75rjhbKJHK-K5PulUnLJNjeq0J79RBPA0MwU2bhQrh0kKFTc2H_ON7MWCv8eNrEFb73J1IQJeETFe64Y2xWRqD62FQmR6IMrlKav8SXapvQIXOySaDDEirSi85r9xW7bsZua-IqnPayVWBfhE_0thKar4i-TlFXaWUAqb7SsIKp_Bscnn5eP6eL4EP-WlWlubNmeW1XibXx2Z360jTah_c5hndYRML5BAmO-Oy2X-879kljhgfyuiopkjhgfhgjyrtutiyopljkhGhjgjhGGHFHgfjhjHJKKJHKjhjkjh-3a_HwhfFeva0CHe5TPB42Y9Z2LuYijnS0hqkkhWT9WmjxxuPa8Iq4NitXAkql4rxIp2h7rqG6LDGTCUZTmCKMpkCbpDWWus440tJbUdrKKJ8Zdc72x_pl14P1PFFAsjC9U_rQJ4C7a0h-uckTHj3JDI2mUZ6QWt4q7iAvhxKvLPGxqx-pR4BTCMVCEN5KMVXoWR96PaNImR_wvu1r53Tx4J_V8KSbF12eJvMItBYFJ4S3W4bEusJc"
}Rename an organisation
| id required | string Organisation ID |
| name | string |
{- "name": "new organisation name"
}{- "id": 1,
- "name": "project's name",
- "createdAt": "2019-08-24T14:15:22Z"
}List organisation users
| id required | string Organisation ID |
[- {
- "id": 1,
- "roles": [
- "ROLE_ORGANISATION_ADMIN"
], - "active": true,
- "position": null,
- "lastname": "golem",
- "firstname": "golem",
- "recoveryToken": "72bd57c1158ec12872cb21bd6d307901de36d9c03",
- "recoveryTokenExpirationDate": "1970-01-01T00:00:00+00:00",
- "isHosted": true
}
]Invite an existing user to an organisation.
| id required | string Organisation ID |
| email required | string |
| roles | Array of strings |
| position | string |
{- "roles": [
- "ROLE_ORGANISATION_ADMIN"
], - "position": "Dev Ops"
}{- "id": 1,
- "username": "golem"
}Modify information of a user in your organisation
| userId required | integer User ID |
| organisationId required | integer Organisation ID |
| position | string |
string | |
| firstname | string |
| lastname | string |
{- "position": "string",
- "email": "string",
- "firstname": "string",
- "lastname": "string"
}{- "id": 1,
- "position": "Dev Ops",
- "lastname": "golem",
- "firstname": "golem",
- "username": "golem"
}Add roles to an user in your organisation
| organisationId required | integer Organisation ID |
| userId required | integer User ID |
| roles required | Array of strings |
{- "roles": [
- "ROLE_ORGANISATION_ADMIN"
]
}Remove permissions to a user
| organisationId required | integer Organisation ID |
| userId required | integer User ID |
| roles required | Array of strings |
{- "roles": [
- "ROLE_ORGANISATION_ADMIN"
]
}Generate a reset password token to a user and send him a mail with the link
| organisationId required | integer Organisation ID |
| userId required | integer User Id |
| recovery_url required | string |
{- "token": "c6c202523ff5e46adb55ed86b3945afc2cb7b0aa"
}Edit your password
| oldPass required | string |
| newPass required | string <password> |
| newPassConfirm required | string <password> |
{- "oldPass": "myOldPassword",
- "newPass": "myNewPassword*2",
- "newPassConfirm": "myNewPassword*2"
}{- "status": "ok",
- "message": "Votre mot de passe a correctement été mis à jour."
}Generate reset password token and send it by email
| email required | string <email> Your email to receive the link to reset your password |
| recovery_url required | string Url Sent in the Mail |
{
}Update your password
| token required | string User's Password Recovery Token |
| password required | string <password> |
| passwordConfirmation required | string <password> |
{- "token": "skldldfjdsfjsknrZdkdzl3439ds3",
- "password": "myNewPassword*2",
- "passwordConfirmation": "myNewPassword*2"
}Create a project
| name required | string Project's name |
| projectKind required | string Project's type. NLU or IC |
| organisation | integer The organisation containing the Project |
{- "name": "project name",
- "projectKind": "IC"
}{- "id": 3190,
- "name": "myProject",
- "createdAt": "1970-00-00T00:00:00+00:00",
- "organisation": {
- "id": 1,
- "name": "organisation name"
}, - "projectKind": "NLU",
- "lastEnv": 0,
- "environments": [
- {
- "id": 7652,
- "name": "dev",
- "isProduction": false,
- "createdAt": "1970-00-00T00:00:00+00:00",
- "extractor": 3,
- "langs": [
- "string"
]
}
]
}Get all projects
Project list filters
| name | string |
| sortField | string |
| asc | boolean |
{- "name": "string",
- "sortField": "string",
- "asc": true
}[- {
- "id": 3190,
- "name": "myProject",
- "createdAt": "1970-00-00T00:00:00+00:00",
- "organisation": {
- "id": 1,
- "name": "organisation name"
}, - "projectKind": "IC",
- "lastEnv": 0,
- "environments": [
- {
- "id": 7652,
- "name": "dev",
- "isProduction": false,
- "createdAt": "1970-00-00T00:00:00+00:00",
- "extractor": 3,
- "langs": [
- "string"
]
}
], - "permissions": [
- "ROLE_ORGANISATION_ADMIN"
]
}
]Rename a project
| projectID required | integer Example: 3193 Project's ID |
| name required | string Project's name |
{- "name": "myProject"
}{- "id": 3190,
- "name": "myProject",
- "createdAt": "1970-00-00T00:00:00+00:00",
- "organisation": {
- "id": 1,
- "name": "organisation name"
}, - "projectKind": "NLU",
- "lastEnv": 0,
- "environments": [
- {
- "id": 7652,
- "name": "dev",
- "isProduction": false,
- "createdAt": "1970-00-00T00:00:00+00:00",
- "extractor": 3,
- "langs": [
- "string"
]
}
]
}Changes a project organisation
| projectID required | integer Example: 3193 Project's ID |
| organisationId required | integer |
{- "organisationId": 1
}{- "id": 3190,
- "name": "myProject",
- "createdAt": "1970-00-00T00:00:00+00:00",
- "organisation": {
- "id": 1,
- "name": "organisation name"
}, - "projectKind": "NLU",
- "lastEnv": 0,
- "environments": [
- {
- "id": 7652,
- "name": "dev",
- "isProduction": false,
- "createdAt": "1970-00-00T00:00:00+00:00",
- "extractor": 3,
- "langs": [
- "string"
]
}
]
}Update last environment used
| projectId required | string Project's ID |
| environment required | integer Environment Id |
{- "environment": 123
}{- "id": 7661,
- "name": "dev",
- "createdAt": "1970-00-00T00:00:00+00:00",
}{- "id": 1,
- "name": "NLU Studio",
- "description": "The Mail Studio allow you to create your own tool to automated and get analyzed mails.",
- "icon": "nlu",
}{- "id": 11,
- "name": "v3.13_beta_test",
- "token": "f7cade1dae742a73a0072a76eeb118f5",
- "branch": "v3.13_prod",
- "replicas": 1,
- "aiType": "prod",
- "multi_lang": false,
- "status": "started",
- "contexts": [
- {
- "id": 10,
- "name": "aaa",
- "langs": [
- "fr",
- "en"
], - "type": "context",
- "countInteractions": 1
}
]
}{- "id": 1150,
- "lastname": "Tanguy",
- "firstname": "Anne-Sophie",
- "isAdmin": false,
- "canGhost": false,
- "isGhost": false,
- "organisations": [
- {
- "active": true,
- "id": 1,
- "name": "organisation name",
- "roles": [
- "ROLE_RIGHT_PROJECT_CREATE",
- "ROLE_RIGHT_PROJECT_RENAME"
], - "position": "Dev Ops"
}
], - "hostOrganisation": {
- "id": 1,
- "name": "organisation name"
}
}Edit your personal information
string <email> User's email | |
| firstname required | string User's firstname |
| lastname required | string User's lastname |
{- "firstname": "Lola",
- "lastname": "Deltoir"
}{- "status": "ok",
- "message": "Votre profil a correctement été mis à jour."
}Create a new user. If organisation exist the user is automatically added to the organisation.
string | |
| firstname | string |
| lastname | string |
| username | string |
| organisationId | integer |
| position | string |
| roles | Array of strings Refer to documentation on organisation-level roles |
{- "email": "string",
- "firstname": "string",
- "lastname": "string",
- "username": "string",
- "organisationId": 0,
- "position": "string",
- "roles": [
- "string"
]
}{- "id": 1,
- "username": "username",
- "recoveryToken": "523b4e564e825918566811ff9bbd78cb149840ba",
- "recoveryTokenExpirationDate": "1970-01-01T00:00:00+00:00"
}| organisationId required | integer Organisation Id |
| page | integer Table page |
| user | integer Filter by user |
| event | string Filter by event name |
| project | integer Filter by project |
| environment | integer Filter by environment |
{- "data": [
- {
- "id": "740326b2-c9c3-00ee-b778-0242sc170115",
- "user": {
- "id": 1,
- "username": "golem",
- "firstName": "golem",
- "lastName": "golem"
}, - "project": {
- "id": 1,
- "name": "project's name"
}, - "environment": [
- {
- "id": 1,
- "name": "environment's name"
}
], - "event": "organisation_permissions_update",
- "description": "Added permission \\\"ROLE_PROJECT_ADMIN\\\" to \\\"[email protected]\\\" on project \\\"My first nlu project\\\"",
- "date": "1970-01-01T00:00:00+00:00",
- "metadata": {
- "method": "added",
- "role": "ROLE_PROJECT_ADMIN"
}, - "accessKey": "ao19b403-febe-2s70-81e6-f61378098651"
}
], - "pagination": {
- "page": 1,
- "totalItems": 10,
- "totalPages": 4
}
}| organisationId required | integer Organisation Id |
| limit | integer How much items are returned |
| token | string <uuid> Return items after pagination token |
{- "next_token": "1sw78cve-d09e-01ce-8646-0242ze170005",
- "data": [
- {
- "id": "740326b2-c9c3-00ee-b778-0242sc170115",
- "user": {
- "id": 1,
- "username": "golem",
- "firstName": "golem",
- "lastName": "golem"
}, - "project": {
- "id": 1,
- "name": "project's name"
}, - "environment": [
- {
- "id": 1,
- "name": "environment's name"
}
], - "event": "organisation_permissions_update",
- "description": "Added permission \\\"ROLE_PROJECT_ADMIN\\\" to \\\"[email protected]\\\" on project \\\"My first nlu project\\\"",
- "date": "1970-01-01T00:00:00+00:00",
- "metadata": {
- "method": "added",
- "role": "ROLE_PROJECT_ADMIN"
}, - "accessKey": "ao19b403-febe-2s70-81e6-f61378098651"
}
], - "limit": 1
}