Regenerate signing secret

Regenerate Signing Secret

curl --request POST \
  --url https://gateway.jelou.ai/platform/v1/external-support/{projectId}/secret/regenerate \
  --header 'x-api-key: <api-key>'

import requests

url = "https://gateway.jelou.ai/platform/v1/external-support/{projectId}/secret/regenerate"

headers = {"x-api-key": "<api-key>"}

response = requests.post(url, headers=headers)

print(response.text)

const options = {method: 'POST', headers: {'x-api-key': '<api-key>'}};

fetch('https://gateway.jelou.ai/platform/v1/external-support/{projectId}/secret/regenerate', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://gateway.jelou.ai/platform/v1/external-support/{projectId}/secret/regenerate",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://gateway.jelou.ai/platform/v1/external-support/{projectId}/secret/regenerate"

	req, _ := http.NewRequest("POST", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://gateway.jelou.ai/platform/v1/external-support/{projectId}/secret/regenerate")
  .header("x-api-key", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://gateway.jelou.ai/platform/v1/external-support/{projectId}/secret/regenerate")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "signingSecret": "e5f6g7h8...new_signing_secret_hex",
  "regeneratedAt": "2023-11-07T05:31:56Z"
}

{
  "message": "<string>",
  "statusMessage": "<string>",
  "status": 123,
  "error": {
    "code": "<string>",
    "key": "<string>",
    "description": "<string>",
    "developerMessages": {},
    "clientMessages": {}
  },
  "validationError": {}
}

{
  "message": "<string>",
  "statusMessage": "<string>",
  "status": 123,
  "error": {
    "code": "<string>",
    "key": "<string>",
    "description": "<string>",
    "developerMessages": {},
    "clientMessages": {}
  },
  "validationError": {}
}

POST

external-support

{projectId}

secret

regenerate

Regenerate Signing Secret

curl --request POST \
  --url https://gateway.jelou.ai/platform/v1/external-support/{projectId}/secret/regenerate \
  --header 'x-api-key: <api-key>'

import requests

url = "https://gateway.jelou.ai/platform/v1/external-support/{projectId}/secret/regenerate"

headers = {"x-api-key": "<api-key>"}

response = requests.post(url, headers=headers)

print(response.text)

const options = {method: 'POST', headers: {'x-api-key': '<api-key>'}};

fetch('https://gateway.jelou.ai/platform/v1/external-support/{projectId}/secret/regenerate', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://gateway.jelou.ai/platform/v1/external-support/{projectId}/secret/regenerate",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://gateway.jelou.ai/platform/v1/external-support/{projectId}/secret/regenerate"

	req, _ := http.NewRequest("POST", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://gateway.jelou.ai/platform/v1/external-support/{projectId}/secret/regenerate")
  .header("x-api-key", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://gateway.jelou.ai/platform/v1/external-support/{projectId}/secret/regenerate")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "signingSecret": "e5f6g7h8...new_signing_secret_hex",
  "regeneratedAt": "2023-11-07T05:31:56Z"
}

{
  "message": "<string>",
  "statusMessage": "<string>",
  "status": 123,
  "error": {
    "code": "<string>",
    "key": "<string>",
    "description": "<string>",
    "developerMessages": {},
    "clientMessages": {}
  },
  "validationError": {}
}

{
  "message": "<string>",
  "statusMessage": "<string>",
  "status": 123,
  "error": {
    "code": "<string>",
    "key": "<string>",
    "description": "<string>",
    "developerMessages": {},
    "clientMessages": {}
  },
  "validationError": {}
}

When regenerating the signing secret, the previous secret is immediately invalidated.

Description

Generates a new signingSecret for the specified project’s integration. The previous secret is invalidated immediately at the time of regeneration.

Endpoint

POST https://gateway.jelou.ai/platform/v1/external-support/{projectId}/secret/regenerate

Path parameters

string

required

Unique identifier of the Jelou project whose signing secret you want to regenerate.

Authentication

All requests must include the x-api-key header with your Jelou project API key.

x-api-key: API_KEY

Request example

The following example regenerates the signing secret for project PROJECT_ID. No request body is sent:

cURL

curl --request POST \
  --url https://gateway.jelou.ai/platform/v1/external-support/PROJECT_ID/secret/regenerate \
  --header 'x-api-key: API_KEY'

Responses

Code	Status	Description
200	OK	Signing secret regenerated successfully. Includes the new `signingSecret`.
401	Unauthorized	Invalid or missing authentication credentials.
404	Not Found	No integration exists for the specified `projectId`.
500	Internal Server Error	Internal server error.

Response example

{
  "message": [
    "Signing secret regenerated successfully"
  ],
  "statusMessage": "success",
  "status": 1,
  "data": {
    "brainId": "PROJECT_ID",
    "signingSecret": "SIGNING_SECRET"
  }
}

Security considerations

Store the new signingSecret securely (environment variables, vault, etc.).
The secret is only shown in the creation and regeneration responses; it cannot be retrieved afterwards.

Authorizations

x-api-key

string

header

required

API key del proyecto de Jelou

Path Parameters

projectId

string

required

Unique identifier of the Jelou project

Response

Signing secret regenerated successfully

signingSecret

string

Example:

"e5f6g7h8...new_signing_secret_hex"

regeneratedAt

string<date-time>

Delete integration

Start conversation

⌘I

API reference

Send Messages

Campaigns

Conversations

Metrics

Users

Resources

Widget

Datum

External Support Panel

Memory Management

Regenerate signing secret

Description

Endpoint

Path parameters

Authentication

Request example

Responses

Response example

Security considerations

Authorizations

Path Parameters

Response

​Description

​Endpoint

​Path parameters

​Authentication

​Request example

​Responses

​Response example

​Security considerations

Authorizations

Path Parameters

Response

Description

Endpoint

Path parameters

Authentication

Request example

Responses

Response example

Security considerations