Update a conversation

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

Spaces method and path for this operation:

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

Refer to Spaces for more information.

Update an existing conversation using the conversation ID. This endpoint allows users to modify the details of an existing conversation.

Path parameters

id string(nonempty) Required

The conversation's id value.

Minimum length is 1.

application/json

Body Required

apiConfig object
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

The conversation category.

Values are assistant or insights.
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.
- isError boolean
  
  Is error message.
- metadata object
  
  Message metadata
  Hide metadata attribute Show metadata attribute object
  
  contentReferences object
  
  A union of all content reference types
- reader object
  
  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
  
  A string that represents a timestamp in ISO 8601 format and does not contain only whitespace characters.
  
  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
replacements object

Replacements object used to anonymize/deanonymize messages
Hide replacements attribute Show replacements attribute object
- * string Additional properties
summary object
Hide summary attributes Show summary attributes object
- confidence string
  
  The conversation confidence.
  
  Values are low, medium, or high.
- content string
  
  Summary text of the conversation over time.
- public boolean
  
  Define if summary is marked as publicly available.
- 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

The conversation title.

Responses

200 application/json

Indicates a successful call. The conversation was updated successfully.
Hide response attributes Show response attributes object
- apiConfig object
  
  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.
- 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.
  
  isError boolean
  
  Is error message.
  
  metadata object
  
  Message metadata
  
  Hide metadata attribute Show metadata attribute object
  
  contentReferences object
  
  A union of all content reference types
  
  reader object
  
  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
  
  A string that represents a timestamp in ISO 8601 format and does not contain only whitespace characters.
  
  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
- namespace string Required
  
  Kibana space
- replacements object
  
  Replacements object used to anonymize/deanonymize messages
  
  Hide replacements attribute Show replacements attribute object
  
  * string Additional properties
- summary object
  
  Hide summary attributes Show summary attributes object
  
  confidence string
  
  The conversation confidence.
  
  Values are low, medium, or high.
  
  content string
  
  Summary text of the conversation over time.
  
  public boolean
  
  Define if summary is marked as publicly available.
  
  timestamp string(nonempty)
  
  A string that represents a timestamp in ISO 8601 format and does not contain only whitespace characters.
  
  Minimum length is 1.
- 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
  
  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. This response indicates an issue with the request, such as missing required parameters or incorrect data.
Hide response attributes Show response attributes object
- error string
- message string
- statusCode number

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

curl \
 --request PUT 'https://localhost:5601/api/security_ai_assistant/current_user/conversations/abc123' \
 --header "Authorization: $API_KEY" \
 --header "Content-Type: application/json" \
 --data '{"apiConfig":{"actionTypeId":"09876","connectorId":"54321"},"category":"insights","excludeFromLastConversationStorage":true,"messages":[{"content":"The issue was resolved.","role":"assistant","timestamp":"2023-10-31T12:30:00Z"}],"replacements":{},"title":"Updated Security Discussion"}'

Request example

{
  "apiConfig": {
    "actionTypeId": "09876",
    "connectorId": "54321"
  },
  "category": "insights",
  "excludeFromLastConversationStorage": true,
  "messages": [
    {
      "content": "The issue was resolved.",
      "role": "assistant",
      "timestamp": "2023-10-31T12:30:00Z"
    }
  ],
  "replacements": {},
  "title": "Updated Security Discussion"
}

Response examples (200)

{
  "apiConfig": {
    "actionTypeId": "09876",
    "connectorId": "54321"
  },
  "category": "insights",
  "createdAt": "2023-10-31T12:01:00Z",
  "excludeFromLastConversationStorage": true,
  "id": "abc123",
  "messages": [
    {
      "content": "The issue was resolved.",
      "role": "assistant",
      "timestamp": "2023-10-31T12:30:00Z"
    }
  ],
  "replacements": {},
  "title": "Updated Security Discussion",
  "updatedAt": "2023-10-31T12:31:00Z",
  "users": [
    {
      "id": "user1",
      "name": "John Doe"
    }
  ]
}