Sign in

v53

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

Create a model response

Spaces method and path for this operation:

<div><span class="operation-verb post">post</span>&nbsp;<span class="operation-path">/s/{space_id}/api/security_ai_assistant/chat/complete</span></div>

Refer to Spaces for more information.

Create a model response for the given chat conversation.

post/api/security_ai_assistant/chat/complete

Query parameters

content_references_disabledboolean

If true, the response will not include content references.

Request body

connectorIdstring required

Required connector identifier to route the request.

conversationIdstring nonempty

A string that does not contain only whitespace characters.

isStreamboolean

If true, the response will be streamed in chunks.

langSmithApiKeystring

API key for LangSmith integration.

langSmithProjectstring

LangSmith project name for tracing.

modelstring

Model ID or name to use for the response.

persistboolean required

Whether to persist the chat and response to storage.

promptIdstring

Prompt template identifier.

responseLanguagestring

ISO language code for the assistant's response.

Example request

{
  "connectorId": "conn-001",
  "conversationId": "abc123",
  "isStream": true,
  "langSmithApiKey": "<LANGSMITH_API_KEY>",
  "langSmithProject": "security_ai_project",
  "messages": [
    {
      "content": "How do I detect ransomware on my endpoints?",
      "data": {
        "device_id": "device-567"
      },
      "fields_to_anonymize": [
        "device.name",
        "file.path"
      ],
      "role": "user"
    }
  ],
  "model": "gpt-4",
  "persist": true,
  "promptId": "prompt_456",
  "responseLanguage": "en"
}

Response

Indicates a successful model response call.