Get a conversation

Base URL: https://{kibana_url}

GET /api/security_ai_assistant/current_user/conversations/{id}
GET /s/{space_id}/api/security_ai_assistant/current_user/conversations/{id}

Refer to Spaces for more information.

Get the details of an existing conversation using the conversation ID. This allows users to fetch the specific conversation data by its unique ID.

Authentication

Path parameters

Responses

Indicates a successful call. The conversation details are returned.

application/json

apiConfig object
category enum required: The conversation category.; Values: assistant insights
createdAt string required: The time conversation was created.
createdBy object required: Could be any string, not necessarily a UUID.
excludeFromLastConversationStorage boolean: Exclude from last conversation storage.
id string · format: nonempty · min length: 1 required: A string that does not contain only whitespace characters.
messages object[]: The conversation messages.
namespace string required: Kibana space
replacements map string to string: Replacements object used to anonymize/deanonymize messages
timestamp string · format: nonempty · min length: 1: A string that represents a timestamp in ISO 8601 format and does not contain only whitespace characters.
title string required: The conversation title.
updatedAt string: The last time conversation was updated.
users object[] required

Bad Request response.

application/json

Base URL: https://{kibana_url}

Examples

Request curl 1 / 1 language

curl Shell

curl \
 --request GET 'http://localhost:5601/api/security_ai_assistant/current_user/conversations/abc123' \
 --header "Authorization: $API_KEY"

Response

{
  "apiConfig": {
    "actionTypeId": "67890",
    "connectorId": "12345"
  },
  "category": "assistant",
  "createdAt": "2023-10-31T12:01:00Z",
  "createdBy": {
    "id": "user1",
    "name": "John Doe"
  },
  "excludeFromLastConversationStorage": false,
  "id": "abc123",
  "messages": [
    {
      "content": "Hello, how can I assist you today?",
      "role": "system",
      "timestamp": "2023-10-31T12:00:00Z"
    }
  ],
  "namespace": "default",
  "replacements": {},
  "title": "Security Discussion",
  "updatedAt": "2023-10-31T12:01:00Z",
  "users": [
    {
      "id": "user1",
      "name": "John Doe"
    }
  ]
}

{
  "error": "Bad Request",
  "message": "Invalid conversation ID",
  "statusCode": 400
}