Create Thread

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/kortix-ai/suna/llms.txt

Use this file to discover all available pages before exploring further.

​

Overview

​

Request

​

Authentication

curl -X POST https://api.kortix.ai/threads \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "name=My Project"

from kortix import Kortix

client = Kortix(api_key="YOUR_API_KEY")

thread = client.threads.create(
    name="My Project"
)

print(f"Thread ID: {thread.thread_id}")
print(f"Project ID: {thread.project_id}")

import { Kortix } from 'kortix';

const client = new Kortix({
  apiKey: 'YOUR_API_KEY'
});

const thread = await client.threads.create({
  name: 'My Project'
});

console.log(`Thread ID: ${thread.thread_id}`);
console.log(`Project ID: ${thread.project_id}`);

​

Response

​

Response Example

{
  "thread_id": "550e8400-e29b-41d4-a716-446655440000",
  "project_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7"
}

​

Implementation Details

1. Limit Checks - Validates thread and project limits against your account plan (skipped in local environments)
2. Project Creation - Creates a new project with the specified name
3. Thread Creation - Creates a thread named “New Chat” within the project
4. Sandbox Provisioning - Automatically creates a sandbox environment with:
   • VNC access on port 6080
   • Web preview on port 8080
   • Unique authentication token
5. Resource Linking - Links the sandbox as a resource to the project
6. Cache Updates - Updates counters and metadata caches

​

Error Responses

{
  "detail": {
    "message": "Thread limit exceeded",
    "current_count": 10,
    "limit": 10,
    "error_code": "THREAD_LIMIT_EXCEEDED"
  }
}

{
  "detail": {
    "message": "Project limit exceeded",
    "current_count": 5,
    "limit": 5,
    "error_code": "PROJECT_LIMIT_EXCEEDED"
  }
}

{
  "detail": "Failed to create thread: <error message>"
}

​

Source Reference