Get one record
curl --request POST \
--url https://gateway.jelou.ai/workflows/v2/memory/users/find-one \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"userReferenceId": "<string>",
"botId": "<string>",
"key": "<string>"
}
'import requests
url = "https://gateway.jelou.ai/workflows/v2/memory/users/find-one"
payload = {
"userReferenceId": "<string>",
"botId": "<string>",
"key": "<string>"
}
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({userReferenceId: '<string>', botId: '<string>', key: '<string>'})
};
fetch('https://gateway.jelou.ai/workflows/v2/memory/users/find-one', 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/workflows/v2/memory/users/find-one",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'userReferenceId' => '<string>',
'botId' => '<string>',
'key' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"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"
"strings"
"net/http"
"io"
)
func main() {
url := "https://gateway.jelou.ai/workflows/v2/memory/users/find-one"
payload := strings.NewReader("{\n \"userReferenceId\": \"<string>\",\n \"botId\": \"<string>\",\n \"key\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-api-key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
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/workflows/v2/memory/users/find-one")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"userReferenceId\": \"<string>\",\n \"botId\": \"<string>\",\n \"key\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://gateway.jelou.ai/workflows/v2/memory/users/find-one")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"userReferenceId\": \"<string>\",\n \"botId\": \"<string>\",\n \"key\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"status": "success",
"message": "Record retrieved successfully",
"data": "confirmacion"
}{
"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": {}
}{
"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": {}
}{
"message": "<string>",
"statusMessage": "<string>",
"status": 123,
"error": {
"code": "<string>",
"key": "<string>",
"description": "<string>",
"developerMessages": {},
"clientMessages": {}
},
"validationError": {}
}Read
Get one record
Get a single memory record for a user by key
POST
/
v2
/
memory
/
users
/
find-one
Get one record
curl --request POST \
--url https://gateway.jelou.ai/workflows/v2/memory/users/find-one \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"userReferenceId": "<string>",
"botId": "<string>",
"key": "<string>"
}
'import requests
url = "https://gateway.jelou.ai/workflows/v2/memory/users/find-one"
payload = {
"userReferenceId": "<string>",
"botId": "<string>",
"key": "<string>"
}
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({userReferenceId: '<string>', botId: '<string>', key: '<string>'})
};
fetch('https://gateway.jelou.ai/workflows/v2/memory/users/find-one', 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/workflows/v2/memory/users/find-one",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'userReferenceId' => '<string>',
'botId' => '<string>',
'key' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"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"
"strings"
"net/http"
"io"
)
func main() {
url := "https://gateway.jelou.ai/workflows/v2/memory/users/find-one"
payload := strings.NewReader("{\n \"userReferenceId\": \"<string>\",\n \"botId\": \"<string>\",\n \"key\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-api-key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
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/workflows/v2/memory/users/find-one")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"userReferenceId\": \"<string>\",\n \"botId\": \"<string>\",\n \"key\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://gateway.jelou.ai/workflows/v2/memory/users/find-one")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"userReferenceId\": \"<string>\",\n \"botId\": \"<string>\",\n \"key\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"status": "success",
"message": "Record retrieved successfully",
"data": "confirmacion"
}{
"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": {}
}{
"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": {}
}{
"message": "<string>",
"statusMessage": "<string>",
"status": 123,
"error": {
"code": "<string>",
"key": "<string>",
"description": "<string>",
"developerMessages": {},
"clientMessages": {}
},
"validationError": {}
}Description
Returns a single memory record for a user by itskey, identified by userReferenceId and botId.
Endpoint
POST https://gateway.jelou.ai/workflows/v2/memory/users/find-one
Body parameters
string
required
The user’s external reference identifier.
string
required
Identifier of the channel associated with the memory.
string
required
Key of the record to retrieve.
Authentication
Every request must include thex-api-key header with an API key that has the memory:read scope.
x-api-key: API_KEY
Request example
cURL
curl --request POST \
--url https://gateway.jelou.ai/workflows/v2/memory/users/find-one \
--header 'x-api-key: API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"userReferenceId": "USER_REFERENCE_ID",
"botId": "BOT_ID",
"key": "paso"
}'
Responses
| Code | Status | Description |
|---|---|---|
| 200 | OK | Record retrieved successfully. |
| 401 | Unauthorized | Invalid or missing authentication credentials. |
| 403 | Forbidden | The API key does not have the memory:read scope. |
| 404 | Not Found | No record exists with the given key. |
| 422 | Unprocessable Entity | Required fields are missing or the format is invalid. |
| 500 | Internal Server Error | Internal server error. |
Response example
{
"status": "success",
"message": "Record retrieved successfully",
"data": "confirmacion"
}
Authorizations
API key del proyecto de Jelou
Body
application/json
Was this page helpful?
⌘I