Get Conversation
curl --request GET \
--url https://app.backend.genezio.ai/customer/v1/brands/{brand_id}/conversations/{conversation_id} \
--header 'X-API-Key: <api-key>'import requests
url = "https://app.backend.genezio.ai/customer/v1/brands/{brand_id}/conversations/{conversation_id}"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://app.backend.genezio.ai/customer/v1/brands/{brand_id}/conversations/{conversation_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"brands": [
{
"is_own_brand": true,
"name": "<string>",
"position": 123,
"website": "<string>"
}
],
"citations": [
{
"domain": "<string>",
"url": "<string>",
"cited_text": [
"<string>"
]
}
],
"date": "2023-11-07T05:31:56Z",
"has_shopping": true,
"id": 123,
"mentioned": true,
"messages": [
{
"role": "user",
"text": "<string>"
}
],
"model": "<string>",
"recommended_brands": [
{
"is_own_brand": true,
"name": "<string>",
"position": 123,
"website": "<string>"
}
],
"scenario_id": 123,
"scenario_text": "<string>",
"topic_id": 123,
"fact_check_passed": true,
"position": 123,
"recommendation_position": 123,
"recommended": true
}{
"error": {
"code": "brand_access_denied",
"message": "This API key has no access to this brand",
"details": [
{
"field": "page_size",
"message": "Input should be less than or equal to 100"
}
],
"request_id": "4f3c2e1a-9b7d-4c1e-8f2a-1d3e5b7c9a0f"
}
}{
"error": {
"code": "brand_access_denied",
"message": "This API key has no access to this brand",
"details": [
{
"field": "page_size",
"message": "Input should be less than or equal to 100"
}
],
"request_id": "4f3c2e1a-9b7d-4c1e-8f2a-1d3e5b7c9a0f"
}
}{
"error": {
"code": "brand_access_denied",
"message": "This API key has no access to this brand",
"details": [
{
"field": "page_size",
"message": "Input should be less than or equal to 100"
}
],
"request_id": "4f3c2e1a-9b7d-4c1e-8f2a-1d3e5b7c9a0f"
}
}{
"error": {
"code": "brand_access_denied",
"message": "This API key has no access to this brand",
"details": [
{
"field": "page_size",
"message": "Input should be less than or equal to 100"
}
],
"request_id": "4f3c2e1a-9b7d-4c1e-8f2a-1d3e5b7c9a0f"
}
}{
"error": {
"code": "brand_access_denied",
"message": "This API key has no access to this brand",
"details": [
{
"field": "page_size",
"message": "Input should be less than or equal to 100"
}
],
"request_id": "4f3c2e1a-9b7d-4c1e-8f2a-1d3e5b7c9a0f"
}
}{
"error": {
"code": "brand_access_denied",
"message": "This API key has no access to this brand",
"details": [
{
"field": "page_size",
"message": "Input should be less than or equal to 100"
}
],
"request_id": "4f3c2e1a-9b7d-4c1e-8f2a-1d3e5b7c9a0f"
}
}Conversations
Get Conversation
One answer: the scenario, the text of the answer, the brands that it names and recommends in order, and the pages that it cites.
GET
/
customer
/
v1
/
brands
/
{brand_id}
/
conversations
/
{conversation_id}
Get Conversation
curl --request GET \
--url https://app.backend.genezio.ai/customer/v1/brands/{brand_id}/conversations/{conversation_id} \
--header 'X-API-Key: <api-key>'import requests
url = "https://app.backend.genezio.ai/customer/v1/brands/{brand_id}/conversations/{conversation_id}"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://app.backend.genezio.ai/customer/v1/brands/{brand_id}/conversations/{conversation_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"brands": [
{
"is_own_brand": true,
"name": "<string>",
"position": 123,
"website": "<string>"
}
],
"citations": [
{
"domain": "<string>",
"url": "<string>",
"cited_text": [
"<string>"
]
}
],
"date": "2023-11-07T05:31:56Z",
"has_shopping": true,
"id": 123,
"mentioned": true,
"messages": [
{
"role": "user",
"text": "<string>"
}
],
"model": "<string>",
"recommended_brands": [
{
"is_own_brand": true,
"name": "<string>",
"position": 123,
"website": "<string>"
}
],
"scenario_id": 123,
"scenario_text": "<string>",
"topic_id": 123,
"fact_check_passed": true,
"position": 123,
"recommendation_position": 123,
"recommended": true
}{
"error": {
"code": "brand_access_denied",
"message": "This API key has no access to this brand",
"details": [
{
"field": "page_size",
"message": "Input should be less than or equal to 100"
}
],
"request_id": "4f3c2e1a-9b7d-4c1e-8f2a-1d3e5b7c9a0f"
}
}{
"error": {
"code": "brand_access_denied",
"message": "This API key has no access to this brand",
"details": [
{
"field": "page_size",
"message": "Input should be less than or equal to 100"
}
],
"request_id": "4f3c2e1a-9b7d-4c1e-8f2a-1d3e5b7c9a0f"
}
}{
"error": {
"code": "brand_access_denied",
"message": "This API key has no access to this brand",
"details": [
{
"field": "page_size",
"message": "Input should be less than or equal to 100"
}
],
"request_id": "4f3c2e1a-9b7d-4c1e-8f2a-1d3e5b7c9a0f"
}
}{
"error": {
"code": "brand_access_denied",
"message": "This API key has no access to this brand",
"details": [
{
"field": "page_size",
"message": "Input should be less than or equal to 100"
}
],
"request_id": "4f3c2e1a-9b7d-4c1e-8f2a-1d3e5b7c9a0f"
}
}{
"error": {
"code": "brand_access_denied",
"message": "This API key has no access to this brand",
"details": [
{
"field": "page_size",
"message": "Input should be less than or equal to 100"
}
],
"request_id": "4f3c2e1a-9b7d-4c1e-8f2a-1d3e5b7c9a0f"
}
}{
"error": {
"code": "brand_access_denied",
"message": "This API key has no access to this brand",
"details": [
{
"field": "page_size",
"message": "Input should be less than or equal to 100"
}
],
"request_id": "4f3c2e1a-9b7d-4c1e-8f2a-1d3e5b7c9a0f"
}
}Authorizations
An API key of your account, from Settings > API Keys. It starts with gnz-.
Response
Successful Response
The brands that the answer names, in the order of the answer.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
The brands that the answer recommends, in the order of the answer.
Show child attributes
Show child attributes
The scenario, as the engine received it.