Skip to main content
POST
/
v1
/
app
/
project
/
{projectId}
/
chat
Create a ephemeral chat with a project
curl --request POST \
  --url https://{base_url}/v1/app/project/{projectId}/chat \
  --header 'Content-Type: application/json' \
  --data '
{
  "pgpt": {
    "messages": [
      {
        "role": "system",
        "content": [
          {
            "data": "<string>",
            "mime_type": "<string>",
            "start_timestamp": "<string>",
            "stop_timestamp": "<string>",
            "_meta": {}
          }
        ],
        "_meta": {}
      }
    ],
    "stream": true,
    "tools": [
      {
        "name": "<string>",
        "type": "<string>",
        "description": "<string>",
        "inputSchema": {
          "properties": {},
          "required": [
            "<string>"
          ],
          "type": "<string>"
        }
      }
    ],
    "tool_choice": {
      "type": "<string>",
      "name": "<string>",
      "disable_parallel_tool_use": true
    },
    "mcp_servers": [
      {
        "url": "<string>",
        "name": "<string>",
        "authorization_token": "<string>",
        "tool_configuration": {
          "enabled": true,
          "allowed_tools": [
            "<string>"
          ]
        },
        "type": "<string>"
      }
    ],
    "response_format": {
      "type": "text",
      "json_schema": {}
    },
    "system": {
      "use_default_prompt": true,
      "text": "<string>",
      "citations": {
        "enabled": true,
        "known_citations": [
          {
            "id": "<string>",
            "index": "<string>",
            "artifact_id": "<string>",
            "source_id": "<string>",
            "correlation_id": "<string>"
          }
        ]
      },
      "extensions": [
        "zylon"
      ]
    },
    "thinking": {
      "enabled": true
    },
    "priority": 123,
    "seed": 123,
    "min_p": 123,
    "top_p": 123,
    "temperature": 123,
    "top_k": 123,
    "repetition_penalty": 123,
    "presence_penalty": 123,
    "frequency_penalty": 123,
    "max_tokens": 123,
    "correlation_id": "<string>",
    "tool_context": [
      {
        "content": "<string>",
        "content_type": "<string>",
        "doc_metadata": {
          "file_name": "<string>",
          "file_type": "<string>"
        },
        "start_timestamp": "<string>",
        "stop_timestamp": "<string>",
        "_meta": {}
      }
    ]
  }
}
'

Path Parameters

projectId
string
required

The ID of the project

Body

application/json

Details of the chat to open with the project

pgpt
object
required
artifact_ids
string[]
all_artifacts
boolean