Skills

This resource allows you to query the skills associated with your bot.

Get Skills

GET https://api.jelou.ai/v1/bots/:botId/skills

cURL

curl --request GET \
  --url https://api.jelou.ai/v1/bots/BOT_ID/skills \
  --header 'Authorization: Basic {{Base64EncodedUsername:Password}}'

Responses

200

{
  "message": [
    "Skills retrieved succesfully!"
  ],
  "statusMessage": "success",
  "status": 1,
  "data": [
    {
      "id": 1,
      "name": "Jelou",
      "description": "Jelou",
      "type": "BRAIN",
      "createdAt": "2024-10-24T11:18:05.000Z",
      "updatedAt": "2024-10-24T11:18:05.000Z",
      "state": true,
      "default": false
    },
    {
      "id": 2,
      "name": "Jelou World",
      "description": "Jelou World",
      "type": "BRAIN",
      "createdAt": "2024-10-24T11:13:32.000Z",
      "updatedAt": "2024-10-24T11:17:44.000Z",
      "state": true,
      "default": false
    }
  ]
}

404

{
  "message": [
    "The Bot could not be found at the moment."
  ],
  "statusMessage": "failed",
  "status": 0,
  "error": {
    "code": "E1019",
    "key": "BOT_NOT_FOUND",
    "description": "Error to be thrown when trying to get a Bot.",
    "developerMessages": {
      "es": "El botId no se encuentra en la base de datos o ha sido eliminado.",
      "en": "The botId is not found in the database or has been deleted.",
      "pt": "A botId não é encontrada no banco de dados ou foi apagada."
    },
    "clientMessages": {
      "es": "El Bot no se pudo encontrar por el momento.",
      "en": "The Bot could not be found at the moment.",
      "pt": "A Bot não pôde ser encontrada no momento."
    }
  }
}

500

{
  "message": [
    "We are having trouble processing your request. Please try again later."
  ],
  "statusMessage": "failed",
  "status": 0,
  "error": {
    "code": "E0000",
    "key": "UNKNOWN_ERROR",
    "description": "Error to be thrown when it couldn't be determined the reason of failure",
    "developerMessages": {
      "es": "Error inesperado occurido, revisar logs.",
      "en": "Unexpected error occurred, check logs."
    },
    "clientMessages": {
      "es": "Estamos teniendo problemas procesando la solicitud. Por favor intenta mas tarde.",
      "en": "We are having trouble processing your request. Please try again later."
    }
  }
}so

Response detail

The response will provide us with detailed information about the skills and their current status.

Field	Type	Description
id	Integer	id of the Skill. This id must be set in the HSM configuration
name	String	Skill name
description	String	Skill description
status	Boolean	Skill status. Only skills with status true should be configured in the HSM API
default	Boolean	Skill is selected as default for the bot
createdAt	Date	Flow creation date
updatedAt	Date	Flow update date