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

Spaces method and path for this operation:

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.

Path parameters

  • id string(nonempty) Required

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

    Minimum length is 1.

Responses

  • 200 application/json

    Indicates a successful call. The conversation details are returned.

    Hide response attributes Show response attributes object
    • apiConfig object

      LLM API configuration.

      Hide apiConfig attributes Show apiConfig attributes object
      • actionTypeId string Required

        Action type ID

      • connectorId string Required

        Connector ID

      • defaultSystemPromptId string

        Default system prompt ID

      • model string

        Model

      • provider string

        Provider

        Values are OpenAI, Azure OpenAI, or Other.

    • category string Required

      The conversation category.

      Values are assistant or insights.

    • createdAt string Required

      The time conversation was created.

    • createdBy object Required

      The user who created the conversation.

      Hide createdBy attributes Show createdBy attributes object
      • id string

        User id.

      • name string

        User name.

    • excludeFromLastConversationStorage boolean

      Exclude from last conversation storage.

    • id string(nonempty) Required

      A string that does not contain only whitespace characters.

      Minimum length is 1.

    • messages array[object]

      The conversation messages.

      Hide messages attributes Show messages attributes object

      AI assistant conversation message.

      • content string Required

        Message content.

      • id string(nonempty)

        Message id

        Minimum length is 1.

      • isError boolean

        Is error message.

      • metadata object

        Metadata

        Hide metadata attributes Show metadata attributes object
        • contentReferences object

          Data referred to by the message content.

        • interruptResumeValue object

          One of:
        • interruptValue object

          One of:
      • reader object

        Message content.

        Additional properties are allowed.

      • refusal string

        Refusal reason returned by the model when content is filtered.

      • role string Required

        Message role.

        Values are system, user, or assistant.

      • timestamp string(nonempty) Required

        The timestamp message was sent or received.

        Minimum length is 1.

      • traceData object

        Trace data

        Hide traceData attributes Show traceData attributes object
        • traceId string

          Could be any string, not necessarily a UUID

        • transactionId string

          Could be any string, not necessarily a UUID

      • user object

        The user who sent the message.

        Hide user attributes Show user attributes object
        • id string

          User id.

        • name string

          User name.

    • namespace string Required

      Kibana space

    • replacements object

      Replacements object used to anonymize/deanonymize messages

      Hide replacements attribute Show replacements attribute object
      • * string Additional properties
    • timestamp string(nonempty)

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

      Minimum length is 1.

    • title string Required

      The conversation title.

    • updatedAt string

      The last time conversation was updated.

    • users array[object] Required

      Could be any string, not necessarily a UUID.

      Hide users attributes Show users attributes object

      Could be any string, not necessarily a UUID.

      • id string

        User id.

      • name string

        User name.

  • 400 application/json

    Generic Error. The request could not be processed due to an error.

    Hide response attributes Show response attributes object
    • error string
    • message string
    • statusCode number
GET /api/security_ai_assistant/current_user/conversations/{id}
curl \
 --request GET 'https://localhost:5601/api/security_ai_assistant/current_user/conversations/abc123' \
 --header "Authorization: $API_KEY"
Response examples (200)
{
  "apiConfig": {
    "actionTypeId": "67890",
    "connectorId": "12345"
  },
  "category": "assistant",
  "createdAt": "2023-10-31T12:01:00Z",
  "excludeFromLastConversationStorage": false,
  "id": "abc123",
  "messages": [
    {
      "content": "Hello, how can I assist you today?",
      "role": "system",
      "timestamp": "2023-10-31T12:00:00Z"
    }
  ],
  "replacements": {},
  "title": "Security Discussion",
  "updatedAt": "2023-10-31T12:01:00Z",
  "users": [
    {
      "id": "user1",
      "name": "John Doe"
    }
  ]
}