Sign in
Security AI Assistant API

Get a conversation

Spaces method and path for this operation:

<div><span class="operation-verb get">get</span>&nbsp;<span class="operation-path">/s/{space_id}/api/security_ai_assistant/current_user/conversations/{id}</span></div>

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.

get/api/security_ai_assistant/current_user/conversations/{id}

Path parameters

idstring nonempty required

A string that does not contain only whitespace characters.

Example:I am a string

The conversation's id value, a unique identifier for the conversation.

Response

Indicates a successful call. The conversation details are returned.

category'assistant' | 'insights' required

The conversation category.

createdAtstring required

The time conversation was created.

excludeFromLastConversationStorageboolean

Exclude from last conversation storage.

idstring nonempty required

A string that does not contain only whitespace characters.

namespacestring required

Kibana space

replacementsSecurityAIAssistantAPIReplacements

Replacements object used to anonymize/deanonymize messages

timestampstring nonempty

A string that represents a timestamp in ISO 8601 format and does not contain only whitespace characters.

titlestring required

The conversation title.

updatedAtstring

The last time conversation was updated.

Example response

{
  "apiConfig": {
    "actionTypeId": "actionType456",
    "connectorId": "connector123",
    "defaultSystemPromptId": "systemPrompt001",
    "model": "gpt-4",
    "provider": "OpenAI"
  },
  "category": "assistant",
  "createdAt": "2025-04-30T14:00:00Z",
  "createdBy": {
    "id": "user123",
    "name": "John Doe"
  },
  "id": "I am a string",
  "messages": [
    {
      "content": "Hello, how can I assist you today?",
      "id": "I am a string",
      "metadata": {
        "interruptResumeValue": {
          "type": "SELECT_OPTION",
          "value": "option_1"
        },
        "interruptValue": {
          "threadId": "<UUID>",
          "type": "SELECT_OPTION",
          "description": "Select one of the options",
          "options": [
            {
              "label": "Option 1"
            },
            {
              "label": "Option 2"
            }
          ]
        }
      },
      "role": "assistant",
      "timestamp": "2023-10-31T12:00:00Z",
      "traceData": {
        "traceId": "d9876543-f0a1-2345-6789-abcdef123456",
        "transactionId": "a1234567-bc89-0def-1234-56789abcdef0"
      },
      "user": {
        "id": "user123",
        "name": "John Doe"
      }
    }
  ],
  "namespace": "default",
  "timestamp": "2023-10-31T12:00:00Z",
  "title": "Security AI Assistant Setup",
  "updatedAt": "2025-04-30T16:30:00Z",
  "users": [
    {
      "id": "user123",
      "name": "John Doe"
    }
  ]
}

Changes

No recorded changes to this endpoint across all 92 revisions of this API.