Transactional Service

The Transactional Service API handles all transactional services used in your flows.

API SUBPATH: eva-transactional-service

Pagination and Listing

Returng a pagination list of bot's transactional services

get

Path parameters

orgUUIDstringRequired

A valid organization Uuid

envUUIDstringRequired

A valid environment Uuid

botUUIDstringRequired

A valid bot Uuid

Query parameters

pageinteger · int32Optional

The number of page and the default is 1

Default: 1Example: 1

linesPerPageinteger · int32Optional

The number of services per pages and the default is 5

Default: 5Example: 1

orderBystringOptional

Field want to ordernate, the default is 'updatedAt'

Default: updatedAt

directionstringOptional

Direction of ordenation, ASC or DESC. The default is DESC

Default: DESC

searchTermsstring[]Optional

Names or tags to filter the search

Responses

200

Ok

*/*

totalPagesinteger · int32Optional

totalElementsinteger · int64Optional

numberOfElementsinteger · int32Optional

sizeinteger · int32Optional

numberinteger · int32Optional

firstbooleanOptional

lastbooleanOptional

emptybooleanOptional

400

Bad Request

*/*

401

Unauthorized

*/*

403

Forbidden

*/*

404

Not Found

*/*

409

Conflict

*/*

422

Unprocessable Entity

*/*

500

Internal Server Error

*/*

get

/org/{orgUUID}/env/{envUUID}/bot/{botUUID}/services/pagination

HTTPcURLJavaScriptPython

GET /org/{orgUUID}/env/{envUUID}/bot/{botUUID}/services/pagination HTTP/1.1
Accept: */*

{
  "totalPages": 1,
  "totalElements": 1,
  "pageable": {
    "paged": true,
    "pageNumber": 1,
    "pageSize": 1,
    "unpaged": true,
    "offset": 1,
    "sort": {
      "sorted": true,
      "unsorted": true,
      "empty": true
    }
  },
  "numberOfElements": 1,
  "size": 1,
  "content": [
    {
      "uuid": "text",
      "name": "text",
      "flows": [
        {
          "uuid": "text",
          "name": "text"
        }
      ],
      "tags": [
        {
          "name": "text"
        }
      ],
      "updatedAt": "text",
      "updatedBy": "text",
      "user": {
        "image": "text",
        "username": "text"
      }
    }
  ],
  "number": 1,
  "sort": {
    "sorted": true,
    "unsorted": true,
    "empty": true
  },
  "first": true,
  "last": true,
  "empty": true
}

Searches (greedily) for any Transaction Service names that exists in a bot, matching the typed term, left-to-right, and returns a list of up to 6 Strings, ordered alphabetically.

get

Path parameters

orgUUIDstringRequired

A valid organization Uuid

envUUIDstringRequired

A valid environment Uuid

botUUIDstringRequired

A valid bot Uuid

Query parameters

searchTermstringRequired

Word or part of word to get suggestion names of transactional services

limitinteger · int64Optional

The limit of suggestions names in the response. The default value is 6

Default: 6Example: 1

Responses

200

Ok

*/*

string[]Optional

400

Bad Request

*/*

401

Unauthorized

*/*

403

Forbidden

*/*

404

Not Found

*/*

408

Request Timeout

*/*

409

Conflict

*/*

422

Unprocessable Entity

*/*

500

Internal Server Error

*/*

get

/org/{orgUUID}/env/{envUUID}/bot/{botUUID}/services/quicksearch

HTTPcURLJavaScriptPython

GET /org/{orgUUID}/env/{envUUID}/bot/{botUUID}/services/quicksearch?searchTerm=text HTTP/1.1
Accept: */*

[
  "text"
]

Retrieves a list containing all Transactional Services from a Bot.

get

Path parameters

orgUUIDstringRequired

A valid organization Uuid

envUUIDstringRequired

A valid environment Uuid

botUUIDstringRequired

A valid bot Uuid

Responses

200

Ok

*/*

DTO response with transactional service list

400

Bad Request

*/*

401

Unauthorized

*/*

403

Forbidden

*/*

404

Not Found

*/*

408

Request Timeout

*/*

409

Conflict

*/*

422

Unprocessable Entity

*/*

500

Internal Server Error

*/*

get

/org/{orgUUID}/env/{envUUID}/bot/{botUUID}/services/list

HTTPcURLJavaScriptPython

GET /org/{orgUUID}/env/{envUUID}/bot/{botUUID}/services/list HTTP/1.1
Accept: */*

{
  "data": [
    {
      "uuid": "text",
      "name": "text",
      "content": [
        {
          "id": "text",
          "option": "text",
          "expressionCode": "text",
          "connectedTo": "text",
          "buttonText": "text",
          "buttonType": "text",
          "urlRedirect": true,
          "buttonUrl": "text",
          "cockpitUUID": "text"
        }
      ],
      "tags": [
        {
          "name": "text"
        }
      ]
    }
  ]
}

CRUD Operations

Create new services

post

Path parameters

orgUUIDstringRequired

A valid organization Uuid

envUUIDstringRequired

A valid environment Uuid

botUUIDstringRequired

A valid bot Uuid

Body

application/json

A body containing all necessary data to create a new Transactional Service

namestringRequired

Name of the transactional service

descriptionstringOptional

Description of the transactional service

webhookstringRequired

Webhook of the transactional service

authTypestring · enumOptional

Enum describing if cell uses an auth method, and which.

Possible values:

basicTokenstringOptional

Basic Token for Basic Auth Header

bearerTokenstringOptional

Bearer Token for Bearer Token Auth Header

oauthUrlstringOptional

URL for authentication with oAuth Method

grantTypestring · enumOptional

Grant type to be used with oAuth Method

Possible values:

clientIdstringOptional

Client Id to be used with oAuth Method

clientSecretstringOptional

Client Secret to be used with oAuth Method and grant type 'client_credentials'

authUsernamestringOptional

Username to be used with oAuth Method and grant type 'password'

authPasswordstringOptional

Password to be used with oAuth Method and grant type 'password'

Responses

201

Created

*/*

400

Bad Request

*/*

401

Unauthorized

*/*

403

Forbidden

*/*

404

Not Found

*/*

409

Conflict

*/*

422

Unprocessable Entity

*/*

500

Internal Server Error

*/*

post

/org/{orgUUID}/env/{envUUID}/bot/{botUUID}/services

HTTPcURLJavaScriptPython

POST /org/{orgUUID}/env/{envUUID}/bot/{botUUID}/services HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 508

{
  "name": "text",
  "description": "text",
  "webhook": "text",
  "headers": [
    {
      "header": "text",
      "value": "text"
    }
  ],
  "content": [
    {
      "id": "text",
      "option": "text",
      "expressionCode": "text",
      "connectedTo": "text",
      "buttonText": "text",
      "buttonType": "text",
      "urlRedirect": true,
      "buttonUrl": "text",
      "cockpitUUID": "text"
    }
  ],
  "tags": [
    {
      "name": "text"
    }
  ],
  "authType": "AUTH_NONE",
  "basicToken": "text",
  "bearerToken": "text",
  "oauthUrl": "text",
  "grantType": "CLIENT_CREDENTIALS",
  "clientId": "text",
  "clientSecret": "text",
  "authUsername": "text",
  "authPassword": "text"
}

{
  "uuid": "text"
}

Retrieves detailed information from a service.

get

Path parameters

orgUUIDstringRequired

A valid organization Uuid

envUUIDstringRequired

A valid environment Uuid

botUUIDstringRequired

A valid bot Uuid

serviceUUIDstringRequired

A valid service Uuid

Responses

200

Ok

*/*

DTO response when fetch successfully a transactional service

namestringRequired

Name of the transactional service

descriptionstringOptional

Description of the transactional service

webhookstringRequired

Webhook of the transactional service

authTypestring · enumOptional

Enum describing if cell uses an auth method, and which.

Possible values:

basicTokenstringOptional

Basic Token for Basic Auth Header

bearerTokenstringOptional

Bearer Token for Bearer Token Auth Header

oauthUrlstringOptional

URL for authentication with oAuth Method

grantTypestring · enumOptional

Grant type to be used with oAuth Method

Possible values:

clientIdstringOptional

Client Id to be used with oAuth Method

clientSecretstringOptional

Client Secret to be used with oAuth Method and grant type 'client_credentials'

authUsernamestringOptional

Username to be used with oAuth Method and grant type 'password'

authPasswordstringOptional

Password to be used with oAuth Method and grant type 'password'

uuidstringOptional

UUID of the transactional service

updatedAtstring · date-timeOptional

Datetime of last transactional service update

updatedBystringOptional

User uuid of last transactional service update

400

Bad Request

*/*

401

Unauthorized

*/*

403

Forbidden

*/*

404

Not Found

*/*

408

Request Timeout

*/*

409

Conflict

*/*

422

Unprocessable Entity

*/*

500

Internal Server Error

*/*

get

/org/{orgUUID}/env/{envUUID}/bot/{botUUID}/services/{serviceUUID}

HTTPcURLJavaScriptPython

GET /org/{orgUUID}/env/{envUUID}/bot/{botUUID}/services/{serviceUUID} HTTP/1.1
Accept: */*

{
  "name": "text",
  "description": "text",
  "webhook": "text",
  "headers": [
    {
      "header": "text",
      "value": "text"
    }
  ],
  "content": [
    {
      "id": "text",
      "option": "text",
      "expressionCode": "text",
      "connectedTo": "text",
      "buttonText": "text",
      "buttonType": "text",
      "urlRedirect": true,
      "buttonUrl": "text",
      "cockpitUUID": "text"
    }
  ],
  "tags": [
    {
      "name": "text"
    }
  ],
  "authType": "AUTH_NONE",
  "basicToken": "text",
  "bearerToken": "text",
  "oauthUrl": "text",
  "grantType": "CLIENT_CREDENTIALS",
  "clientId": "text",
  "clientSecret": "text",
  "authUsername": "text",
  "authPassword": "text",
  "uuid": "text",
  "flows": [
    {
      "uuid": "text",
      "name": "text"
    }
  ],
  "updatedAt": "2026-04-02T06:01:06.966Z",
  "updatedBy": "text"
}

Updates an existing Service.

put

Path parameters

orgUUIDstringRequired

A valid organization Uuid

envUUIDstringRequired

A valid environment Uuid

botUUIDstringRequired

A valid bot Uuid

serviceUUIDstringRequired

A valid service Uuid

Body

application/json

A body containing all necessary data to create a new Transactional Service

namestringRequired

Name of the transactional service

descriptionstringOptional

Description of the transactional service

webhookstringRequired

Webhook of the transactional service

authTypestring · enumOptional

Enum describing if cell uses an auth method, and which.

Possible values:

basicTokenstringOptional

Basic Token for Basic Auth Header

bearerTokenstringOptional

Bearer Token for Bearer Token Auth Header

oauthUrlstringOptional

URL for authentication with oAuth Method

grantTypestring · enumOptional

Grant type to be used with oAuth Method

Possible values:

clientIdstringOptional

Client Id to be used with oAuth Method

clientSecretstringOptional

Client Secret to be used with oAuth Method and grant type 'client_credentials'

authUsernamestringOptional

Username to be used with oAuth Method and grant type 'password'

authPasswordstringOptional

Password to be used with oAuth Method and grant type 'password'

Responses

200

Ok

*/*

DTO response when update successfully transactional service with ok message

messagestringOptional

Message 'OK'

datastringOptional

Message 'Service Updated'

400

Bad Request

*/*

401

Unauthorized

*/*

403

Forbidden

*/*

404

Not Found

*/*

408

Request Timeout

*/*

409

Conflict

*/*

422

Unprocessable Entity

*/*

500

Internal Server Error

*/*

put

/org/{orgUUID}/env/{envUUID}/bot/{botUUID}/services/{serviceUUID}

HTTPcURLJavaScriptPython

PUT /org/{orgUUID}/env/{envUUID}/bot/{botUUID}/services/{serviceUUID} HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 508

{
  "name": "text",
  "description": "text",
  "webhook": "text",
  "headers": [
    {
      "header": "text",
      "value": "text"
    }
  ],
  "content": [
    {
      "id": "text",
      "option": "text",
      "expressionCode": "text",
      "connectedTo": "text",
      "buttonText": "text",
      "buttonType": "text",
      "urlRedirect": true,
      "buttonUrl": "text",
      "cockpitUUID": "text"
    }
  ],
  "tags": [
    {
      "name": "text"
    }
  ],
  "authType": "AUTH_NONE",
  "basicToken": "text",
  "bearerToken": "text",
  "oauthUrl": "text",
  "grantType": "CLIENT_CREDENTIALS",
  "clientId": "text",
  "clientSecret": "text",
  "authUsername": "text",
  "authPassword": "text"
}

{
  "message": "text",
  "data": "text"
}

Removes an existing Service.

delete

Path parameters

orgUUIDstringRequired

A valid organization Uuid

envUUIDstringRequired

A valid environment Uuid

botUUIDstringRequired

A valid bot Uuid

serviceUUIDstringRequired

A valid service Uuid

Responses

204

No Content

400

Bad Request

*/*

401

Unauthorized

*/*

403

Forbidden

*/*

404

Not Found

*/*

408

Request Timeout

*/*

409

Conflict

*/*

422

Unprocessable Entity

*/*

500

Internal Server Error

*/*

delete

/org/{orgUUID}/env/{envUUID}/bot/{botUUID}/services/{serviceUUID}

HTTPcURLJavaScriptPython

DELETE /org/{orgUUID}/env/{envUUID}/bot/{botUUID}/services/{serviceUUID} HTTP/1.1
Accept: */*

No content