Sign in

8b7b1f99e308

latestOpenAPI 3.0.3raw.githubusercontent.com2026-08-116771,7565.2 MB
Security AI Assistant API

Get conversations

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/_find</span></div>

Refer to Spaces for more information.

Get a list of all conversations for the current user. This endpoint allows users to search, filter, sort, and paginate through their conversations.

get/api/security_ai_assistant/current_user/conversations/_find

Query parameters

fieldsstring[]

A list of fields to include in the response. If omitted, all fields are returned.

[
  "id",
  "title",
  "createdAt"
]
filterstring
Example:Security Issue

A search query to filter the conversations. Can match against titles, messages, or other conversation attributes.

sort_field'created_at' | 'title' | 'updated_at'

The field by which to sort the conversations. Possible values are created_at, title, and updated_at.

Example:created_at

The field by which to sort the results. Valid fields are created_at, title, and updated_at.

sort_order'asc' | 'desc'

The order in which results are sorted.

Example:asc

The order in which to sort the results. Can be either asc for ascending or desc for descending.

pageinteger
Example:1

The page number of the results to retrieve. Default is 1.

per_pageinteger
Example:20

The number of conversations to return per page. Default is 20.

is_ownerboolean
Example:true

Whether to return conversations that the current user owns. If true, only conversations owned by the user are returned.

Response

Successful response, returns a paginated list of conversations matching the specified criteria.

pageinteger required

The current page of the results.

perPageinteger required

The number of results returned per page.

totalinteger required

The total number of conversations matching the filter criteria.

Example response

{
  "data": [
    {
      "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"
        }
      ]
    }
  ],
  "page": 1,
  "perPage": 20,
  "total": 100
}