API Documentation

Complete guide to integrating with TellsTree's powerful storytelling API.

Quick Start

Get up and running with the TellsTree API in minutes

Get JWT Token

Make API Calls

Start Building

Features

✓

RESTful API

CRUD operations & consistent JSON responses

✓

No Complex Setup

Get JWT Token → Make API Calls → Start Building

✓

Copy & Paste Examples

Working code for JavaScript, Python, PHP, cURL

✓

Clear Error Messages

HTTP status codes and RFC 7807 compliant error messages

✓

Generous Limits

60 api calls per minute

Ressources

Projects /api/projects

Nodes /api/nodes

Edges /api/edges

Media /api/media

Comments /api/comments

Themes /api/themes

Designs /api/designs

Rate Limits

API rate limiting prevents abuse and ensures fair usage. Limits are enforced per IP address and vary by endpoint type.

All API responses include rate limit information in the headers. When limits are exceeded, a 429 status is returned.

Header Fields

X-RateLimit-LimitMaximum requests allowed in the current window
X-RateLimit-RemainingRemaining requests in the current window
Retry-AfterSeconds to wait before retry (429 responses only)

API 300 requests/minute General API limit (optimized for graph editor)

AUTH 5 attempts/minute Login attempts

REFRESH 30 requests/minute Token refresh

REG 3 attempts/10 minutes User registration

Error Handling

The API uses conventional HTTP response codes to indicate success or failure. All error responses follow a consistent JSON format with RFC 7807 Problem Details.

Error responses include a `type` (URL to error documentation), `title` (human-readable summary), `detail` (explanation), and `status` (HTTP code).

2xx 200, 201, 204 Success responses

4xx 400, 401, 403, 404, 422, 429 Client errors

5xx 500, 503 Server errors

Authentication

The TellsTree API uses JWT (JSON Web Token) based authentication. You need to obtain a token by logging in with valid credentials.

POST /api/auth/login Login / Obtain token

GET /api/auth/me Get current user info

POST /api/auth/refresh Refresh token

POST /api/auth/logout Logout / Invalidate token

GET /api/.well-known/jwks.json Public keys (JWKS)

Login

Most API endpoints require authentication. Get your JWT token through the authentication endpoint.

Required Credentials

email - Your account email
password - Your account password

Response

200 Success / Login successful

401 Authentication failed / Invalid credentials

422 Validation failed / Missing fields

429 Too Many Requests / Rate limited

POSThttps://tellstree.com/api/auth/login

{
    "data": {
        "user": {
            "id": 105,
            "name": "Owner",
            "email": "***REDACTED***",
            "created_at": "2025-10-01T13:25:26.000000Z"
        },
        "token": {
            "access_token": "***REDACTED***",
            "token_type": "Bearer",
            "expires_in": 3600,
            "expires_at": "2025-10-17T23:41:32+00:00"
        }
    }
}

{
    "method": "POST",
    "url": "/api/auth/login",
    "headers": [],
    "payload": {
        "email": "***REDACTED***",
        "password": "***REDACTED***"
    },
    "recorded_at": "2025-10-17T22:41:33+00:00"
}

// Login to TellsTree API
const loginResponse = await fetch('https://tellstree.com/api/auth/login', {
    method: 'POST',
    headers: {
        'Content-Type': 'application/json',
        'Accept': 'application/json'
    },
    body: JSON.stringify({
        email: 'your-email@example.com',
        password: 'your-password'
    })
});

const loginData = await loginResponse.json();

if (loginResponse.ok) {
    console.log('Login successful!');
    console.log('User:', loginData.data.user);
    console.log('Access token:', loginData.data.token.access_token);
    console.log('Token expires in:', loginData.data.token.expires_in, 'seconds');
    
    // Store token for further API calls
    const accessToken = loginData.data.token.access_token;
} else {
    console.error('Login failed:', loginData.error, loginData.message);
}

# Login to TellsTree API
import requests

def login(email, password):
    """
    Login to TellsTree API and get JWT token
    
    Args:
        email (str): Your account email
        password (str): Your account password
    
    Returns:
        dict: API response with token data
    """
    response = requests.post(
        'https://tellstree.com/api/auth/login',
        headers={
            'Content-Type': 'application/json',
            'Accept': 'application/json'
        },
        json={
            'email': email,
            'password': password
        }
    )
    
    if response.status_code == 200:
        data = response.json()
        print('Login successful!')
        print(f'User: {data["data"]["user"]}')
        print(f'Access token: {data["data"]["token"]["access_token"]}')
        print(f'Token expires in: {data["data"]["token"]["expires_in"]} seconds')
        return data
    else:
        error_data = response.json()
        print(f'Login failed: {error_data.get("error", "Unknown error")}')
        print(f'Message: {error_data.get("message", "")}')
        return None

# Example usage
if __name__ == '__main__':
    result = login('your-email@example.com', 'your-password')
    if result:
        access_token = result['data']['token']['access_token']

<?php
/**
 * Login to TellsTree API
 */

function tellstree_login($email, $password) {
    $data = [
        'email' => $email,
        'password' => $password
    ];

    $context = stream_context_create([
        'http' => [
            'method' => 'POST',
            'header' => [
                'Content-Type: application/json',
                'Accept: application/json'
            ],
            'content' => json_encode($data),
            'ignore_errors' => true
        ]
    ]);

    $response = file_get_contents('https://tellstree.com/api/auth/login', false, $context);
    
    if ($response !== false) {
        $result = json_decode($response, true);
        $status_code = intval(substr($http_response_header[0], 9, 3));
        
        if ($status_code === 200) {
            echo "Login successful!\n";
            echo "User: " . json_encode($result['data']['user']) . "\n";
            echo "Access token: " . $result['data']['token']['access_token'] . "\n";
            echo "Token expires in: " . $result['data']['token']['expires_in'] . " seconds\n";
            return $result;
        } else {
            echo "Login failed: " . ($result['error'] ?? 'Unknown error') . "\n";
            echo "Message: " . ($result['message'] ?? '') . "\n";
            return null;
        }
    } else {
        echo "Request failed\n";
        return null;
    }
}

// Example usage
$result = tellstree_login('your-email@example.com', 'your-password');
if ($result) {
    $access_token = $result['data']['token']['access_token'];
}
?>

#!/bin/bash
# Login to TellsTree API

curl -X POST "https://tellstree.com/api/auth/login" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "email": "your-email@example.com",
    "password": "your-password"
  }'

Refresh Token

Tokens expire after 1 hour. Use the refresh endpoint to get a new access token without re-authentication.

Token Refresh

• Refresh token is stored as HttpOnly cookie
• No request body required
• Returns new access token
• Include cookies with request

Response

200 Success / Token refreshed

401 Unauthorized / Invalid refresh token

403 Forbidden / Token expired

POSThttps://tellstree.com/api/auth/refresh

{
    "data": {
        "token": {
            "access_token": "***REDACTED***",
            "token_type": "bearer",
            "expires_in": 3600,
            "expires_at": "2025-10-17T23:41:33+00:00"
        }
    }
}

{
    "method": "POST",
    "url": "/api/auth/refresh",
    "headers": [],
    "payload": null,
    "recorded_at": "2025-10-17T22:41:33+00:00"
}

// Refresh JWT token
const refreshResponse = await fetch('https://tellstree.com/api/auth/refresh', {
    method: 'POST',
    headers: {
        'Content-Type': 'application/json',
        'Accept': 'application/json'
    },
    credentials: 'include'  // Important: Include cookies for refresh token
});

const refreshData = await refreshResponse.json();

if (refreshResponse.ok) {
    console.log('Token refreshed successfully!');
    console.log('New access token:', refreshData.access_token);
    console.log('Token expires in:', refreshData.expires_in, 'seconds');
    
    // Update stored token
    const newAccessToken = refreshData.access_token;
} else {
    console.error('Token refresh failed:', refreshData);
    // Redirect to login page or handle re-authentication
}

# Refresh JWT token
import requests

def refresh_token(session=None):
    """
    Refresh JWT token using refresh token from cookie
    
    Args:
        session (requests.Session, optional): Session object with cookies
    
    Returns:
        dict: New token data
    """
    if session is None:
        session = requests.Session()
    
    response = session.post(
        'https://tellstree.com/api/auth/refresh',
        headers={
            'Content-Type': 'application/json',
            'Accept': 'application/json'
        }
    )
    
    if response.status_code == 200:
        data = response.json()
        print('Token refreshed successfully!')
        print(f'New access token: {data["access_token"]}')
        print(f'Token expires in: {data["expires_in"]} seconds')
        return data
    else:
        print(f'Token refresh failed. Status: {response.status_code}')
        return None

# Example usage
if __name__ == '__main__':
    # Use session to maintain cookies from login
    session = requests.Session()
    new_token = refresh_token(session)

# Refresh JWT token (create PHP refresh function)
<?php
/**
 * Refresh JWT token using refresh token cookie
 */

function tellstree_refresh_token() {
    $context = stream_context_create([
        'http' => [
            'method' => 'POST',
            'header' => [
                'Content-Type: application/json',
                'Accept: application/json',
                'Cookie: ' . ($_SERVER['HTTP_COOKIE'] ?? '')
            ],
            'ignore_errors' => true
        ]
    ]);

    $response = file_get_contents('https://tellstree.com/api/auth/refresh', false, $context);
    
    if ($response !== false) {
        $result = json_decode($response, true);
        $status_code = intval(substr($http_response_header[0], 9, 3));
        
        if ($status_code === 200) {
            echo "Token refreshed successfully!\n";
            echo "New access token: " . $result['access_token'] . "\n";
            echo "Token expires in: " . $result['expires_in'] . " seconds\n";
            return $result;
        } else {
            echo "Token refresh failed. Status: " . $status_code . "\n";
            return null;
        }
    } else {
        echo "Request failed\n";
        return null;
    }
}

// Example usage
$new_token = tellstree_refresh_token();
?>

#!/bin/bash
# Refresh JWT token

curl -X POST "https://tellstree.com/api/auth/refresh" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -b "refresh_token=YOUR_REFRESH_TOKEN_COOKIE"

Get Current User

Get information about the currently authenticated user and token details.

Authentication Required

• Include JWT token in Authorization header
• Returns user profile and token information
• Useful for validating token status

Response

200 Success / User information

401 Unauthorized / Missing or invalid token

GEThttps://tellstree.com/api/auth/me

{
    "data": {
        "user": {
            "id": "01KHF8MP96QY9KMPXF67Z5ZE3R",
            "name": "Owner",
            "email": "***REDACTED***",
            "created_at": "2025-12-17T15:11:38.000000Z",
            "last_api_access": "2026-09-13T19:37:55.000000Z"
        },
        "token": {
            "token_type": "Bearer",
            "expires_in": 3599,
            "expires_at": "2026-09-13T20:37:54+00:00",
            "issued_at": "2026-09-13T19:37:54+00:00"
        }
    }
}

{
    "method": "GET",
    "url": "/api/auth/me",
    "headers": {
        "Authorization": [
            "***REDACTED***"
        ]
    },
    "payload": null,
    "recorded_at": "2026-09-13T19:37:55+00:00"
}

// Get current user information
const accessToken = 'your-access-token-here';

const response = await fetch('https://tellstree.com/api/auth/me', {
    method: 'GET',
    headers: {
        'Authorization': `Bearer ${accessToken}`,
        'Accept': 'application/json'
    }
});

const data = await response.json();

if (response.ok) {
    console.log('User info:', data.data.user);
    console.log('Token info:', data.data.token_info);
} else {
    console.error('Failed to get user info:', data);
}

# Get current user information
import requests

def get_current_user(access_token):
    """
    Get current user information using JWT token
    
    Args:
        access_token (str): JWT access token
    
    Returns:
        dict: User information and token details
    """
    response = requests.get(
        'https://tellstree.com/api/auth/me',
        headers={
            'Authorization': f'Bearer {access_token}',
            'Accept': 'application/json'
        }
    )
    
    if response.status_code == 200:
        data = response.json()
        print('User info retrieved successfully!')
        print(f'User: {data["data"]["user"]["name"]} ({data["data"]["user"]["email"]})')
        print(f'Token expires at: {data["data"]["token_info"]["expires_at"]}')
        return data
    else:
        print(f'Failed to get user info. Status: {response.status_code}')
        return None

# Example usage
if __name__ == '__main__':
    token = 'your-access-token-here'
    user_info = get_current_user(token)

<?php
/**
 * Get current user information
 */

function tellstree_get_current_user($access_token) {
    $context = stream_context_create([
        'http' => [
            'method' => 'GET',
            'header' => [
                'Authorization: Bearer ' . $access_token,
                'Accept: application/json'
            ],
            'ignore_errors' => true
        ]
    ]);

    $response = file_get_contents('https://tellstree.com/api/auth/me', false, $context);
    
    if ($response !== false) {
        $result = json_decode($response, true);
        $status_code = intval(substr($http_response_header[0], 9, 3));
        
        if ($status_code === 200) {
            echo "User info retrieved successfully!\n";
            echo "User: " . $result['data']['user']['name'] . " (" . $result['data']['user']['email'] . ")\n";
            echo "Token expires at: " . $result['data']['token_info']['expires_at'] . "\n";
            return $result;
        } else {
            echo "Failed to get user info. Status: " . $status_code . "\n";
            return null;
        }
    } else {
        echo "Request failed\n";
        return null;
    }
}

// Example usage
$access_token = 'your-access-token-here';
$user_info = tellstree_get_current_user($access_token);
?>

#!/bin/bash
# Get current user information

curl -X GET "https://tellstree.com/api/auth/me" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN_HERE" \
  -H "Accept: application/json"

Logout

Logout and invalidate all tokens for the current user. This prevents further API access with existing tokens.

Token Invalidation

• Invalidates current access token
• Invalidates refresh token
• Increments user token version
• Clears authentication cookies

Response

204 No Content / Logout successful

401 Unauthorized / Invalid token

POSThttps://tellstree.com/api/auth/logout

{
    "method": "POST",
    "url": "/api/auth/logout",
    "headers": {
        "Authorization": [
            "***REDACTED***"
        ]
    },
    "payload": null,
    "recorded_at": "2026-09-13T19:37:55+00:00"
}

// Logout and invalidate tokens
const accessToken = 'your-access-token-here';

const logoutResponse = await fetch('https://tellstree.com/api/auth/logout', {
    method: 'POST',
    headers: {
        'Authorization': `Bearer ${accessToken}`,
        'Accept': 'application/json'
    }
});

// Logout returns 204 No Content on success
if (logoutResponse.status === 204) {
    console.log('Logout successful!');
    // Clear stored tokens
    localStorage.removeItem('access_token');
    sessionStorage.removeItem('access_token');
    // Redirect to login page
    window.location.href = '/login';
} else {
    console.error('Logout failed:', logoutResponse.status);
}

# Logout and invalidate tokens
import requests

def logout(access_token):
    """
    Logout and invalidate JWT tokens
    
    Args:
        access_token (str): JWT access token
    
    Returns:
        bool: True if logout successful, False otherwise
    """
    response = requests.post(
        'https://tellstree.com/api/auth/logout',
        headers={
            'Authorization': f'Bearer {access_token}',
            'Accept': 'application/json'
        }
    )
    
    # Logout returns 204 No Content on success
    if response.status_code == 204:
        print('Logout successful!')
        return True
    else:
        print(f'Logout failed. Status: {response.status_code}')
        return False

# Example usage
if __name__ == '__main__':
    token = 'your-access-token-here'
    success = logout(token)
    if success:
        print('You have been logged out successfully.')

<?php
/**
 * Logout and invalidate tokens
 */

function tellstree_logout($access_token) {
    $context = stream_context_create([
        'http' => [
            'method' => 'POST',
            'header' => [
                'Authorization: Bearer ' . $access_token,
                'Accept: application/json'
            ],
            'ignore_errors' => true
        ]
    ]);

    $response = file_get_contents('https://tellstree.com/api/auth/logout', false, $context);
    
    if ($response !== false) {
        $status_code = intval(substr($http_response_header[0], 9, 3));
        
        // Logout returns 204 No Content on success
        if ($status_code === 204) {
            echo "Logout successful!\n";
            return true;
        } else {
            echo "Logout failed. Status: " . $status_code . "\n";
            return false;
        }
    } else {
        echo "Request failed\n";
        return false;
    }
}

// Example usage
$access_token = 'your-access-token-here';
$success = tellstree_logout($access_token);
if ($success) {
    echo "You have been logged out successfully.\n";
}
?>

#!/bin/bash
# Logout and invalidate tokens
# Returns 204 No Content on success

curl -X POST "https://tellstree.com/api/auth/logout" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN_HERE" \
  -H "Accept: application/json" \
  -w "HTTP Status: %{http_code}\n"

JSON Web Key Set (JWKS)

Public cryptographic keys for verifying JWT tokens issued by TellsTree. Required for external systems that need to validate TellsTree tokens independently.

Use Cases

• Microservices: Verify TellsTree tokens without API calls
• API Gateways: Validate tokens at gateway level
• Single Sign-On (SSO): Enable SSO integrations
• Third-party Apps: Verify token authenticity offline

Technical Details

• Standard RFC 7517 compliant endpoint
• RSA-256 public keys included
• Key rotation support via 'kid' field
• No authentication required (public endpoint)

Response

200 Success / Public keys

GEThttps://tellstree.com/api/.well-known/jwks.json

{
    "data": {
        "keys": [
            {
                "kty": "RSA",
                "use": "sig",
                "alg": "RS256",
                "kid": "c48cf1222c05070a",
                "n": "sRlgwhSbh4tZQOu_UDciJpBu9OeoiOiEooZxQaypsRtKcd-kb7QN-cDQqIauH7-oa0Z4tEhp1Fwb8oWeG7dSDOWJsmC5l0o0Xg7B09VGxtgV1KnVp_I_89tTMEReAfDexe5oDdQK-DyiZ_oFMkKuIE3x3byn0gGsoC7UaBzKDc0D4Rb6FgYTX2KaUUfET74H7LbFeDrXVmCnuDwgfMMdT77I5jNSAD3NI2_ZAV-EhCiNIuy-P3Cx-LmCDbj-TNviKwSsdBzCkd2g6kiUj3pfUBjbed9-LzvDJcBNQUjgLsf08RK2gRHuIXHJJDDDRYE7SfXxQw0lN-BdXuoZ2OK7cw",
                "e": "AQAB"
            }
        ]
    }
}

{
    "method": "GET",
    "url": "/api/.well-known/jwks.json",
    "headers": [],
    "payload": null,
    "recorded_at": "2026-09-13T19:37:55+00:00"
}

// Get JWKS (JSON Web Key Set) for token verification
const jwksResponse = await fetch('https://tellstree.com/api/.well-known/jwks.json', {
    method: 'GET',
    headers: {
        'Accept': 'application/json'
    }
});

const jwksData = await jwksResponse.json();

if (jwksResponse.ok) {
    console.log('JWKS keys:', jwksData.keys);
    // Use these keys to verify JWT tokens client-side if needed
    jwksData.keys.forEach(key => {
        console.log(`Key ID: ${key.kid}, Algorithm: ${key.alg}`);
    });
} else {
    console.error('Failed to fetch JWKS:', jwksData);
}

# Get JWKS (JSON Web Key Set) for token verification
import requests

def get_jwks():
    """
    Get public keys for JWT token verification
    
    Returns:
        dict: JWKS response with public keys
    """
    response = requests.get(
        'https://tellstree.com/api/.well-known/jwks.json',
        headers={
            'Accept': 'application/json'
        }
    )
    
    if response.status_code == 200:
        data = response.json()
        print('JWKS retrieved successfully!')
        print(f'Number of keys: {len(data["keys"])}')
        for key in data['keys']:
            print(f'Key ID: {key["kid"]}, Algorithm: {key["alg"]}')
        return data
    else:
        print(f'Failed to fetch JWKS. Status: {response.status_code}')
        return None

# Example usage
if __name__ == '__main__':
    jwks = get_jwks()

<?php
/**
 * Get JWKS (JSON Web Key Set) for token verification
 */

function tellstree_get_jwks() {
    $context = stream_context_create([
        'http' => [
            'method' => 'GET',
            'header' => [
                'Accept: application/json'
            ],
            'ignore_errors' => true
        ]
    ]);

    $response = file_get_contents('https://tellstree.com/api/.well-known/jwks.json', false, $context);
    
    if ($response !== false) {
        $result = json_decode($response, true);
        $status_code = intval(substr($http_response_header[0], 9, 3));
        
        if ($status_code === 200) {
            echo "JWKS retrieved successfully!\n";
            echo "Number of keys: " . count($result['keys']) . "\n";
            foreach ($result['keys'] as $key) {
                echo "Key ID: " . $key['kid'] . ", Algorithm: " . $key['alg'] . "\n";
            }
            return $result;
        } else {
            echo "Failed to fetch JWKS. Status: " . $status_code . "\n";
            return null;
        }
    } else {
        echo "Request failed\n";
        return null;
    }
}

// Example usage
$jwks = tellstree_get_jwks();
?>

#!/bin/bash
# Get JWKS (JSON Web Key Set) for token verification

curl -X GET "https://tellstree.com/api/.well-known/jwks.json" \
  -H "Accept: application/json"

Using Tokens for API Access

Once you have an access token, include it in the Authorization header for all API requests.

Authorization Header

Authorization: Bearer YOUR_TOKEN
• Required for all protected endpoints
• Token expires after 1 hour
• Use refresh endpoint to get new tokens

Example API Call

GET /api/projects
Authorization: Bearer eyJ0eXAiOiJKV1Q...
Accept: application/json

GEThttps://tellstree.com/api/projects

{
    "data": {
        "projects": [
            {
                "project_id": 1,
                "title": "Tells Adventure",
                "description": "An interactive tale of courage and consequence - guide your choices through arrows, words and fate.",
                "media": null,
                "is_public": true,
                "created_at": "2025-10-01T13:25:26.000000Z",
                "updated_at": "2025-10-01T13:25:26.000000Z",
                "is_locked": false,
                "nodes": {
                    "nodes_count": 9
                },
                "edges": {
                    "edges_count": 6
                },
                "members": {
                    "members_count": 1,
                    "owner": {
                        "user_id": null,
                        "user_name": "Owner"
                    }
                },
                "theme": {
                    "theme_id": 9,
                    "name": "Dialog",
                    "domain": "dialog"
                },
                "design": {
                    "design_id": 11,
                    "name": "Original",
                    "domain": "original"
                },
                "capabilities": {
                    "userCanDelete": false
                },
                "comments": {
                    "comments_count": 3,
                    "comments_rating": 4.7
                }
            },
            {
                "project_id": 2,
                "title": "The Dragon's Quest",
                "description": "An epic adventure story where choices matter and every decision shapes your destiny through mystical lands.",
                "media": null,
                "is_public": true,
                "created_at": "2025-10-01T13:25:26.000000Z",
                "updated_at": "2025-10-01T13:25:26.000000Z",
                "is_locked": false,
                "nodes": {
                    "nodes_count": 7
                },
                "edges": {
                    "edges_count": 4
                },
                "members": {
                    "members_count": 1,
                    "owner": {
                        "user_id": null,
                        "user_name": "Owner"
                    }
                },
                "theme": {
                    "theme_id": 9,
                    "name": "Dialog",
                    "domain": "dialog"
                },
                "design": {
                    "design_id": 11,
                    "name": "Original",
                    "domain": "original"
                },
                "capabilities": {
                    "userCanDelete": false
                },
                "comments": {
                    "comments_count": 3,
                    "comments_rating": 4
                }
            },
            {
                "project_id": 3,
                "title": "Mystery at Moonlight Manor",
                "description": "A thrilling mystery with multiple endings. Solve the case and uncover the dark secrets of the manor.",
                "media": null,
                "is_public": true,
                "created_at": "2025-10-01T13:25:26.000000Z",
                "updated_at": "2025-10-01T13:25:26.000000Z",
                "is_locked": false,
                "nodes": {
                    "nodes_count": 34
                },
                "edges": {
                    "edges_count": 39
                },
                "members": {
                    "members_count": 1,
                    "owner": {
                        "user_id": null,
                        "user_name": "Owner"
                    }
                },
                "theme": {
                    "theme_id": 9,
                    "name": "Dialog",
                    "domain": "dialog"
                },
                "design": {
                    "design_id": 11,
                    "name": "Original",
                    "domain": "original"
                },
                "capabilities": {
                    "userCanDelete": false
                },
                "comments": {
                    "comments_count": 3,
                    "comments_rating": 4.3
                }
            },
            {
                "project_id": 4,
                "title": "Galactic Romance",
                "description": "Love among the stars in this sci-fi romance adventure across the galaxy and beyond.",
                "media": null,
                "is_public": true,
                "created_at": "2025-10-01T13:25:26.000000Z",
                "updated_at": "2025-10-01T13:25:26.000000Z",
                "is_locked": false,
                "nodes": {
                    "nodes_count": 7
                },
                "edges": {
                    "edges_count": 4
                },
                "members": {
                    "members_count": 1,
                    "owner": {
                        "user_id": null,
                        "user_name": "Owner"
                    }
                },
                "theme": {
                    "theme_id": 9,
                    "name": "Dialog",
                    "domain": "dialog"
                },
                "design": {
                    "design_id": 11,
                    "name": "Original",
                    "domain": "original"
                },
                "capabilities": {
                    "userCanDelete": false
                },
                "comments": {
                    "comments_count": 3,
                    "comments_rating": 4.7
                }
            },
            {
                "project_id": 5,
                "title": "Kaffeehaus-Gespr\u00e4ch",
                "description": "Eine Demonstration des Dialog-Theme Systems mit Charakteren und Gespr\u00e4chsverl\u00e4ufen",
                "media": null,
                "is_public": true,
                "created_at": "2025-10-01T13:25:26.000000Z",
                "updated_at": "2025-10-01T13:25:26.000000Z",
                "is_locked": false,
                "nodes": {
                    "nodes_count": 8
                },
                "edges": {
                    "edges_count": 5
                },
                "members": {
                    "members_count": 1,
                    "owner": {
                        "user_id": null,
                        "user_name": "Owner"
                    }
                },
                "theme": {
                    "theme_id": 9,
                    "name": "Dialog",
                    "domain": "dialog"
                },
                "design": {
                    "design_id": 11,
                    "name": "Original",
                    "domain": "original"
                },
                "capabilities": {
                    "userCanDelete": false
                },
                "comments": {
                    "comments_count": 3,
                    "comments_rating": 4.3
                }
            },
            {
                "project_id": 7,
                "title": "Mystery Novel",
                "description": "Ein klassischer Whodunit: Ein Mord in einem abgelegenen Leuchtturm w\u00e4hrend eines Sturms. Sechs Verd\u00e4chtige, dunkle Geheimnisse und nur Sie k\u00f6nnen den wahren T\u00e4ter entlarven. Sammeln Sie Hinweise und treffen Sie Entscheidungen, die zum M\u00f6rder f\u00fchren.",
                "media": null,
                "is_public": true,
                "created_at": "2025-10-01T13:25:26.000000Z",
                "updated_at": "2025-10-01T13:25:26.000000Z",
                "is_locked": false,
                "nodes": {
                    "nodes_count": 8
                },
                "edges": {
                    "edges_count": 4
                },
                "members": {
                    "members_count": 1,
                    "owner": {
                        "user_id": null,
                        "user_name": "Editor"
                    }
                },
                "theme": {
                    "theme_id": 9,
                    "name": "Dialog",
                    "domain": "dialog"
                },
                "design": {
                    "design_id": 11,
                    "name": "Original",
                    "domain": "original"
                },
                "capabilities": {
                    "userCanDelete": false
                },
                "comments": {
                    "comments_count": 3,
                    "comments_rating": 4.3
                }
            },
            {
                "project_id": 9,
                "title": "About Apples",
                "description": "A poetic journey through orchards, legends, and the symbolism of apples across history and myth.",
                "media": null,
                "is_public": true,
                "created_at": "2025-10-01T13:25:26.000000Z",
                "updated_at": "2025-10-01T13:25:26.000000Z",
                "is_locked": false,
                "nodes": {
                    "nodes_count": 7
                },
                "edges": {
                    "edges_count": 4
                },
                "members": {
                    "members_count": 1,
                    "owner": {
                        "user_id": null,
                        "user_name": "Owner"
                    }
                },
                "theme": {
                    "theme_id": 9,
                    "name": "Dialog",
                    "domain": "dialog"
                },
                "design": {
                    "design_id": 11,
                    "name": "Original",
                    "domain": "original"
                },
                "capabilities": {
                    "userCanDelete": false
                },
                "comments": {
                    "comments_count": 2,
                    "comments_rating": 4.5
                }
            }
        ],
        "pagination": {
            "page": 1,
            "per_page": 15,
            "total": 7
        }
    }
}

{
    "method": "GET",
    "url": "/api/projects",
    "headers": {
        "Authorization": [
            "***REDACTED***"
        ]
    },
    "payload": null,
    "recorded_at": "2025-10-17T22:41:34+00:00"
}

// Using JWT token for API access
const accessToken = 'your-access-token-here';

const response = await fetch('https://tellstree.com/api/projects', {
    method: 'GET',
    headers: {
        'Authorization': `Bearer ${accessToken}`,
        'Accept': 'application/json'
    }
});

const data = await response.json();
console.log('Projects:', data);

# Using JWT token for API access
import requests

access_token = 'your-access-token-here'

response = requests.get(
    'https://tellstree.com/api/projects',
    headers={
        'Authorization': f'Bearer {access_token}',
        'Accept': 'application/json'
    }
)

data = response.json()
print('Projects:', data)

<?php
// Using JWT token for API access
$access_token = 'your-access-token-here';

$context = stream_context_create([
    'http' => [
        'method' => 'GET',
        'header' => [
            'Authorization: Bearer ' . $access_token,
            'Accept: application/json'
        ]
    ]
]);

$response = file_get_contents('https://tellstree.com/api/projects', false, $context);
$result = json_decode($response, true);

echo 'Projects: ';
var_dump($result);
?>

# Using JWT token for API access
curl -X GET "https://tellstree.com/api/projects" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN_HERE" \
  -H "Accept: application/json"

?? Projects

Projects are the top-level containers for your storytelling content. Each project can contain multiple nodes (story elements) and edges (connections).

GET /api/projects List all projects

POST /api/projects Create project

GET /api/projects/{id} Get project

PUT /api/projects/{id} Update project

DELETE /api/projects/{id} Delete project

GET /api/projects/{id}/activity Poll for activity updates

List Public Projects

Retrieve all publicly available projects. No authentication required.

Query Parameters

query[is_public] Set to true to get public projects

query[page] Page number (default: 1)

query[per_page] Items per page (default: 15)

Response

200 Success, Returns paginated list of public projects

GEThttps://tellstree.com/api/projects

{
    "data": {
        "projects": [
            {
                "title": "Pit Repro 169 oeffentlich ohne Mitglieder",
                "description": "Pruefprojekt fuer TKT-2026090169",
                "media": null,
                "is_public": true,
                "created_at": "2026-09-13T23:15:15.000000Z",
                "updated_at": "2026-09-13T23:15:15.000000Z",
                "project_id": "HJ7EJ26TGJKK63WVMJSEGDNFHZ",
                "is_locked": false,
                "nodes": {
                    "nodes_count": 0
                },
                "edges": {
                    "edges_count": 0
                },
                "members": {
                    "members_count": 0,
                    "owner": null
                },
                "theme": {
                    "theme_id": "WV5SV6ZRCNBGFP892EZDX12J9M",
                    "name": "Game Theme",
                    "domain": "game"
                },
                "design": {
                    "design_id": "1YMJCVSPEM79S5N7DM5XY54D4T",
                    "name": "Original",
                    "domain": "original"
                },
                "capabilities": {
                    "userCanDelete": false
                },
                "comments": {
                    "comments_count": 0,
                    "comments_rating": 0
                }
            },
            {
                "title": "Adventure Quest",
                "description": null,
                "media": null,
                "is_public": true,
                "created_at": "2026-09-13T19:38:35.000000Z",
                "updated_at": "2026-09-13T19:38:35.000000Z",
                "project_id": "SXW5F0ZN48Q1DH839KFVWKS59A",
                "is_locked": false,
                "nodes": {
                    "nodes_count": 0
                },
                "edges": {
                    "edges_count": 0
                },
                "members": {
                    "members_count": 0,
                    "owner": null
                },
                "theme": {
                    "theme_id": "QDEET0HVSC5CRJPJ5BJJAA3TRQ",
                    "name": "Story Theme",
                    "domain": "story"
                },
                "design": {
                    "design_id": "1YMJCVSPEM79S5N7DM5XY54D4T",
                    "name": "Original",
                    "domain": "original"
                },
                "capabilities": {
                    "userCanDelete": false
                },
                "comments": {
                    "comments_count": 0,
                    "comments_rating": 0
                }
            },
            {
                "title": "Mystery Novel",
                "description": "Eum est laboriosam nesciunt ut quod. Perferendis excepturi aperiam est natus. Fugiat magnam illum qui facere nobis magni.",
                "media": null,
                "is_public": true,
                "created_at": "2026-09-13T19:38:35.000000Z",
                "updated_at": "2026-09-13T19:38:35.000000Z",
                "project_id": "1MZ32AE6H7Z2HJ179R6F24N4KR",
                "is_locked": false,
                "nodes": {
                    "nodes_count": 0
                },
                "edges": {
                    "edges_count": 0
                },
                "members": {
                    "members_count": 0,
                    "owner": null
                },
                "theme": {
                    "theme_id": "QDEET0HVSC5CRJPJ5BJJAA3TRQ",
                    "name": "Story Theme",
                    "domain": "story"
                },
                "design": {
                    "design_id": "1YMJCVSPEM79S5N7DM5XY54D4T",
                    "name": "Original",
                    "domain": "original"
                },
                "capabilities": {
                    "userCanDelete": false
                },
                "comments": {
                    "comments_count": 0,
                    "comments_rating": 0
                }
            },
            {
                "title": "Explicabo minus quo.",
                "description": null,
                "media": null,
                "is_public": true,
                "created_at": "2026-09-13T19:36:50.000000Z",
                "updated_at": "2026-09-13T19:36:50.000000Z",
                "project_id": "1N71903A1ZMW7XSQ4BR3W25ZAB",
                "is_locked": false,
                "nodes": {
                    "nodes_count": 0
                },
                "edges": {
                    "edges_count": 0
                },
                "members": {
                    "members_count": 1,
                    "owner": {
                        "user_id": "8STAWGGBPMHMXYHYR6KNSRG1Q4",
                        "user_name": "Dariana Walker"
                    }
                },
                "theme": {
                    "theme_id": "QDEET0HVSC5CRJPJ5BJJAA3TRQ",
                    "name": "Story Theme",
                    "domain": "story"
                },
                "design": {
                    "design_id": "1YMJCVSPEM79S5N7DM5XY54D4T",
                    "name": "Original",
                    "domain": "original"
                },
                "capabilities": {
                    "userCanDelete": false
                },
                "comments": {
                    "comments_count": 0,
                    "comments_rating": 0
                }
            },
            {
                "title": "Laboriosam non dolore.",
                "description": "Voluptate modi quia inventore autem. Est quod sint voluptatem nulla atque est laudantium. Quo nulla dolor sed et.",
                "media": null,
                "is_public": true,
                "created_at": "2026-09-13T19:36:49.000000Z",
                "updated_at": "2026-09-13T19:36:49.000000Z",
                "project_id": "6JAP2X5JFRMW8D70P4GB7AQ71T",
                "is_locked": false,
                "nodes": {
                    "nodes_count": 0
                },
                "edges": {
                    "edges_count": 0
                },
                "members": {
                    "members_count": 1,
                    "owner": {
                        "user_id": "DPSK5Z9ZXZVMQF49S8HZ9GHE7K",
                        "user_name": "Prof. Mavis Toy IV"
                    }
                },
                "theme": {
                    "theme_id": "QDEET0HVSC5CRJPJ5BJJAA3TRQ",
                    "name": "Story Theme",
                    "domain": "story"
                },
                "design": {
                    "design_id": "1YMJCVSPEM79S5N7DM5XY54D4T",
                    "name": "Original",
                    "domain": "original"
                },
                "capabilities": {
                    "userCanDelete": false
                },
                "comments": {
                    "comments_count": 0,
                    "comments_rating": 0
                }
            }
        ],
        "pagination": {
            "page": 1,
            "per_page": 5,
            "total": 5
        }
    }
}

{
    "method": "GET",
    "url": "http://localhost:8000/api/projects",
    "headers": [],
    "payload": {
        "query": {
            "is_public": true,
            "page": 1,
            "per_page": 5
        }
    },
    "recorded_at": "2026-09-13T23:18:54+00:00"
}

/**
 * TellsTree Projects API - List Public Projects
 * 
 * This example demonstrates how to fetch all publicly available projects.
 * No authentication required for public projects.
 */

// Get public projects with pagination
const response = await fetch("https://tellstree.com/api/projects?query[is_public]=true&query[page]=1&query[per_page]=15", {
  method: "GET",
  headers: {
    "Accept": "application/json"
  }
});

const data = await response.json();
console.log(data);

// Alternative: Using URLSearchParams for cleaner query building
const params = new URLSearchParams({
  'query[is_public]': 'true',
  'query[page]': '1',
  'query[per_page]': '15'
});

const response2 = await fetch(`https://tellstree.com/api/projects?${params}`, {
  method: "GET",
  headers: {
    "Accept": "application/json"
  }
});

const publicProjects = await response2.json();
console.log('Public projects:', publicProjects.data.projects);

"""
TellsTree Projects API - List Public Projects

This example demonstrates how to fetch all publicly available projects.
No authentication required for public projects.

Requirements:
pip install requests
"""

import requests

# Get public projects with pagination
params = {
    'query[is_public]': 'true',
    'query[page]': '1',
    'query[per_page]': '15'
}

headers = {
    "Accept": "application/json"
}

response = requests.get(
    "https://tellstree.com/api/projects",
    headers=headers,
    params=params
)

if response.status_code == 200:
    data = response.json()
    print("Public projects:", data['data']['projects'])
    print("Pagination:", data['data']['pagination'])
else:
    print(f"Error: {response.status_code} - {response.text}")

# Alternative: Search public projects
search_params = {
    'query[is_public]': 'true',
    'query[q]': 'adventure'
}

search_response = requests.get(
    "https://tellstree.com/api/projects",
    headers=headers,
    params=search_params
)

if search_response.status_code == 200:
    search_data = search_response.json()
    print("Search results:", search_data['data']['projects'])

<?php
/**
 * TellsTree Projects API - List Public Projects
 * 
 * This example demonstrates how to fetch all publicly available projects.
 * No authentication required for public projects.
 */

// Get public projects with pagination
$queryParams = http_build_query([
    'query' => [
        'is_public' => 'true',
        'page' => '1',
        'per_page' => '15'
    ]
]);

$headers = [
    "Accept: application/json"
];

$context = stream_context_create([
    "http" => [
        "method" => "GET",
        "header" => implode("\r\n", $headers)
    ]
]);

$response = file_get_contents(
    "https://tellstree.com/api/projects?" . $queryParams,
    false,
    $context
);

if ($response !== false) {
    $data = json_decode($response, true);
    echo "Public projects:\n";
    print_r($data['data']['projects']);
    echo "\nPagination info:\n";
    print_r($data['data']['pagination']);
} else {
    echo "Error: Could not fetch public projects\n";
}

// Alternative: Using cURL for better error handling
$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => "https://tellstree.com/api/projects?" . $queryParams,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => $headers,
]);

$curlResponse = curl_exec($curl);
$httpCode = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);

if ($httpCode === 200) {
    $curlData = json_decode($curlResponse, true);
    echo "\nPublic projects (via cURL):\n";
    echo "Total: " . count($curlData['data']['projects']) . " projects\n";
}
?>

# TellsTree Projects API - List Public Projects
# 
# This example demonstrates how to fetch all publicly available projects.
# No authentication required for public projects.

# Get public projects with pagination
curl -H "Accept: application/json" \
     "https://tellstree.com/api/projects?query%5Bis_public%5D=true&query%5Bpage%5D=1&query%5Bper_page%5D=15"

# Alternative: More readable URL encoding
curl -H "Accept: application/json" \
     -G \
     -d "query[is_public]=true" \
     -d "query[page]=1" \
     -d "query[per_page]=15" \
     "https://tellstree.com/api/projects"

# Search public projects
curl -H "Accept: application/json" \
     -G \
     -d "query[is_public]=true" \
     -d "query[q]=adventure" \
     "https://tellstree.com/api/projects"

List Private Projects

Retrieve all projects that the authenticated user has access to. Authentication required.

Headers

Authorization Bearer {your_jwt_token}

Query Parameters

query[page] Page number (optional)

query[per_page] Items per page (optional)

Response

200 Success, Returns paginated list of user's projects

401 Unauthorized, Invalid or missing token

GEThttps://tellstree.com/api/projects

{
    "data": {
        "projects": [
            {
                "title": "Pit Repro 169 oeffentlich ohne Mitglieder",
                "description": "Pruefprojekt fuer TKT-2026090169",
                "media": null,
                "is_public": true,
                "created_at": "2026-09-13T23:15:15.000000Z",
                "updated_at": "2026-09-13T23:15:15.000000Z",
                "project_id": "HJ7EJ26TGJKK63WVMJSEGDNFHZ",
                "is_locked": false,
                "nodes": {
                    "nodes_count": 0
                },
                "edges": {
                    "edges_count": 0
                },
                "members": {
                    "members_count": 0,
                    "owner": null
                },
                "theme": {
                    "theme_id": "WV5SV6ZRCNBGFP892EZDX12J9M",
                    "name": "Game Theme",
                    "domain": "game"
                },
                "design": {
                    "design_id": "1YMJCVSPEM79S5N7DM5XY54D4T",
                    "name": "Original",
                    "domain": "original"
                },
                "capabilities": {
                    "userCanDelete": false
                },
                "comments": {
                    "comments_count": 0,
                    "comments_rating": 0
                }
            },
            {
                "title": "Adventure Quest",
                "description": null,
                "media": null,
                "is_public": true,
                "created_at": "2026-09-13T19:38:35.000000Z",
                "updated_at": "2026-09-13T19:38:35.000000Z",
                "project_id": "SXW5F0ZN48Q1DH839KFVWKS59A",
                "is_locked": false,
                "nodes": {
                    "nodes_count": 0
                },
                "edges": {
                    "edges_count": 0
                },
                "members": {
                    "members_count": 0,
                    "owner": null
                },
                "theme": {
                    "theme_id": "QDEET0HVSC5CRJPJ5BJJAA3TRQ",
                    "name": "Story Theme",
                    "domain": "story"
                },
                "design": {
                    "design_id": "1YMJCVSPEM79S5N7DM5XY54D4T",
                    "name": "Original",
                    "domain": "original"
                },
                "capabilities": {
                    "userCanDelete": false
                },
                "comments": {
                    "comments_count": 0,
                    "comments_rating": 0
                }
            },
            {
                "title": "Mystery Novel",
                "description": "Eum est laboriosam nesciunt ut quod. Perferendis excepturi aperiam est natus. Fugiat magnam illum qui facere nobis magni.",
                "media": null,
                "is_public": true,
                "created_at": "2026-09-13T19:38:35.000000Z",
                "updated_at": "2026-09-13T19:38:35.000000Z",
                "project_id": "1MZ32AE6H7Z2HJ179R6F24N4KR",
                "is_locked": false,
                "nodes": {
                    "nodes_count": 0
                },
                "edges": {
                    "edges_count": 0
                },
                "members": {
                    "members_count": 0,
                    "owner": null
                },
                "theme": {
                    "theme_id": "QDEET0HVSC5CRJPJ5BJJAA3TRQ",
                    "name": "Story Theme",
                    "domain": "story"
                },
                "design": {
                    "design_id": "1YMJCVSPEM79S5N7DM5XY54D4T",
                    "name": "Original",
                    "domain": "original"
                },
                "capabilities": {
                    "userCanDelete": false
                },
                "comments": {
                    "comments_count": 0,
                    "comments_rating": 0
                }
            },
            {
                "title": "Explicabo minus quo.",
                "description": null,
                "media": null,
                "is_public": true,
                "created_at": "2026-09-13T19:36:50.000000Z",
                "updated_at": "2026-09-13T19:36:50.000000Z",
                "project_id": "1N71903A1ZMW7XSQ4BR3W25ZAB",
                "is_locked": false,
                "nodes": {
                    "nodes_count": 0
                },
                "edges": {
                    "edges_count": 0
                },
                "members": {
                    "members_count": 1,
                    "owner": {
                        "user_id": "8STAWGGBPMHMXYHYR6KNSRG1Q4",
                        "user_name": "Dariana Walker"
                    }
                },
                "theme": {
                    "theme_id": "QDEET0HVSC5CRJPJ5BJJAA3TRQ",
                    "name": "Story Theme",
                    "domain": "story"
                },
                "design": {
                    "design_id": "1YMJCVSPEM79S5N7DM5XY54D4T",
                    "name": "Original",
                    "domain": "original"
                },
                "capabilities": {
                    "userCanDelete": false
                },
                "comments": {
                    "comments_count": 0,
                    "comments_rating": 0
                }
            },
            {
                "title": "Laboriosam non dolore.",
                "description": "Voluptate modi quia inventore autem. Est quod sint voluptatem nulla atque est laudantium. Quo nulla dolor sed et.",
                "media": null,
                "is_public": true,
                "created_at": "2026-09-13T19:36:49.000000Z",
                "updated_at": "2026-09-13T19:36:49.000000Z",
                "project_id": "6JAP2X5JFRMW8D70P4GB7AQ71T",
                "is_locked": false,
                "nodes": {
                    "nodes_count": 0
                },
                "edges": {
                    "edges_count": 0
                },
                "members": {
                    "members_count": 1,
                    "owner": {
                        "user_id": "DPSK5Z9ZXZVMQF49S8HZ9GHE7K",
                        "user_name": "Prof. Mavis Toy IV"
                    }
                },
                "theme": {
                    "theme_id": "QDEET0HVSC5CRJPJ5BJJAA3TRQ",
                    "name": "Story Theme",
                    "domain": "story"
                },
                "design": {
                    "design_id": "1YMJCVSPEM79S5N7DM5XY54D4T",
                    "name": "Original",
                    "domain": "original"
                },
                "capabilities": {
                    "userCanDelete": false
                },
                "comments": {
                    "comments_count": 0,
                    "comments_rating": 0
                }
            }
        ],
        "pagination": {
            "page": 1,
            "per_page": 5,
            "total": 5
        }
    }
}

{
    "method": "GET",
    "url": "http://localhost:8000/api/projects",
    "headers": {
        "Authorization": [
            "***REDACTED***"
        ],
        "Accept": "application/json",
        "Content-Type": "application/json"
    },
    "payload": {
        "query": {
            "is_public": false,
            "page": 1,
            "per_page": 5
        }
    },
    "recorded_at": "2026-09-13T23:18:54+00:00"
}

/**
 * TellsTree Projects API - List Private Projects
 * 
 * This example demonstrates how to fetch all private projects for the authenticated user.
 * Authentication required - replace 'your_jwt_token' with your actual token.
 */

// Get authenticated user's private projects
const response = await fetch("https://tellstree.com/api/projects", {
  method: "GET",
  headers: {
    "Authorization": "Bearer your_jwt_token",
    "Accept": "application/json"
  }
});

const data = await response.json();
console.log(data);

// With optional pagination
const params = new URLSearchParams({
  'query[page]': '1',
  'query[per_page]': '10'
});

const response2 = await fetch(`https://tellstree.com/api/projects?${params}`, {
  method: "GET",
  headers: {
    "Authorization": "Bearer your_jwt_token",
    "Accept": "application/json"
  }
});

const privateProjects = await response2.json();
console.log('User projects:', privateProjects.data.projects);

"""
TellsTree Projects API - List Private Projects

This example demonstrates how to fetch all private projects for the authenticated user.
Authentication required - replace 'your_jwt_token' with your actual token.

Requirements:
pip install requests
"""

import requests

# Get authenticated user's private projects
headers = {
    "Authorization": "Bearer your_jwt_token",
    "Accept": "application/json"
}

response = requests.get(
    "https://tellstree.com/api/projects",
    headers=headers
)

if response.status_code == 200:
    data = response.json()
    print("User projects:", data['data']['projects'])
    print("Total projects:", len(data['data']['projects']))
elif response.status_code == 401:
    print("Error: Invalid or missing authentication token")
else:
    print(f"Error: {response.status_code} - {response.text}")

# With pagination
params = {
    'query[page]': '1', 
    'query[per_page]': '10'
}

paginated_response = requests.get(
    "https://tellstree.com/api/projects",
    headers=headers,
    params=params
)

if paginated_response.status_code == 200:
    paginated_data = paginated_response.json()
    print("Paginated results:", paginated_data['data']['projects'])
    print("Pagination info:", paginated_data['data']['pagination'])

<?php
/**
 * TellsTree Projects API - List Private Projects
 * 
 * This example demonstrates how to fetch all private projects for the authenticated user.
 * Authentication required - replace 'your_jwt_token' with your actual token.
 */

// Get authenticated user's private projects
$accessToken = 'your_jwt_token';

$headers = [
    "Authorization: Bearer " . $accessToken,
    "Accept: application/json"
];

$context = stream_context_create([
    "http" => [
        "method" => "GET",
        "header" => implode("\r\n", $headers)
    ]
]);

$response = file_get_contents(
    "https://tellstree.com/api/projects",
    false,
    $context
);

if ($response !== false) {
    $data = json_decode($response, true);
    echo "User projects:\n";
    print_r($data['data']['projects']);
    echo "\nTotal: " . count($data['data']['projects']) . " projects\n";
} else {
    echo "Error: Could not fetch user projects (check authentication)\n";
}

// With pagination using cURL
$queryParams = http_build_query([
    'query' => [
        'page' => '1',
        'per_page' => '10'
    ]
]);

$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => "https://tellstree.com/api/projects?" . $queryParams,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => $headers,
]);

$curlResponse = curl_exec($curl);
$httpCode = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);

if ($httpCode === 200) {
    $paginatedData = json_decode($curlResponse, true);
    echo "\nPaginated results:\n";
    print_r($paginatedData['data']['pagination']);
} elseif ($httpCode === 401) {
    echo "Error: Invalid or missing authentication token\n";
} else {
    echo "Error: HTTP $httpCode\n";
}
?>

# TellsTree Projects API - List Private Projects
# 
# This example demonstrates how to fetch all private projects for the authenticated user.
# Authentication required - replace 'your_jwt_token' with your actual token.

# Get authenticated user's private projects
curl -H "Authorization: Bearer your_jwt_token" \
     -H "Accept: application/json" \
     "https://tellstree.com/api/projects"

# With pagination
curl -H "Authorization: Bearer your_jwt_token" \
     -H "Accept: application/json" \
     -G \
     -d "query[page]=1" \
     -d "query[per_page]=10" \
     "https://tellstree.com/api/projects"

# With search within user projects (if supported)
curl -H "Authorization: Bearer your_jwt_token" \
     -H "Accept: application/json" \
     -G \
     -d "query[q]=my project" \
     "https://tellstree.com/api/projects"

Create New Project

Create a new storytelling project with a theme and design.

Response

201 Created, data.project{} (Complete Project object with theme, design, nodes, edges, members, capabilities, comments)

422 Invalid data, Validation errors in data.errors{}

401 Unauthorized, Invalid token

POSThttps://tellstree.com/api/projects

{
    "data": {
        "project": {
            "title": "API Test Project 1789341534",
            "description": "Created by automated test",
            "is_public": false,
            "created_at": "2026-09-13T23:18:54.000000Z",
            "updated_at": "2026-09-13T23:18:54.000000Z",
            "project_id": "NMWFMX40NVJBWVF6E6WADVQY51",
            "is_locked": false,
            "nodes": {
                "nodes_count": 2
            },
            "edges": {
                "edges_count": 0
            },
            "members": {
                "members_count": 1,
                "owner": {
                    "user_id": "01KHF8MP96QY9KMPXF67Z5ZE3R",
                    "user_name": "Owner"
                }
            },
            "theme": {
                "theme_id": "QDEET0HVSC5CRJPJ5BJJAA3TRQ",
                "name": "Story Theme",
                "domain": "story"
            },
            "design": {
                "design_id": "1YMJCVSPEM79S5N7DM5XY54D4T",
                "name": "Original",
                "domain": "original"
            },
            "capabilities": {
                "userCanDelete": true
            },
            "comments": {
                "comments_count": 0,
                "comments_rating": 0
            }
        }
    }
}

{
    "method": "POST",
    "url": "http://localhost:8000/api/projects",
    "headers": {
        "Authorization": [
            "***REDACTED***"
        ],
        "Accept": "application/json",
        "Content-Type": "application/json"
    },
    "payload": {
        "title": "API Test Project 1789341534",
        "theme_id": "QDEET0HVSC5CRJPJ5BJJAA3TRQ",
        "design_id": "1YMJCVSPEM79S5N7DM5XY54D4T",
        "is_public": false,
        "description": "Created by automated test"
    },
    "recorded_at": "2026-09-13T23:18:54+00:00"
}

/**
 * TellsTree Projects API - Create Project
 * 
 * This example demonstrates how to create a new project.
 * Replace 'your_jwt_token' with your actual authentication token.
 */

// Create a new project
const response = await fetch("https://tellstree.com/api/projects", {
  method: "POST",
  headers: {
    "Authorization": "Bearer your_jwt_token",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    title: "My New Story",
    description: "An interactive storytelling project",
    theme_id: "dialog",
    design_id: "original",
    is_public: false
  })
});

const data = await response.json();
console.log(data);

"""
TellsTree Projects API - Create Project

This example demonstrates how to create a new project.
Replace 'your_jwt_token' with your actual authentication token.

Requirements:
pip install requests
"""

# Create a new project
import requests

headers = {
    "Authorization": "Bearer your_jwt_token",
    "Content-Type": "application/json"
}

payload = {
    "title": "My New Story",
    "description": "An interactive storytelling project",
    "theme_id": "dialog",
    "design_id": "original",
    "is_public": False
}

response = requests.post(
    "https://tellstree.com/api/projects",
    headers=headers,
    json=payload
)

data = response.json()
print(data)

<?php
/**
 * TellsTree Projects API - Create Project
 * 
 * This example demonstrates how to create a new project.
 * Replace 'your_jwt_token' with your actual authentication token.
 */

// Create a new project
$accessToken = 'your_jwt_token';

$data = [
    'title' => 'My New Story',
    'description' => 'An interactive storytelling project',
    'theme_id' => 'dialog',
    'design_id' => 'original',
    'is_public' => false
];

$context = stream_context_create([
    'http' => [
        'method' => 'POST',
        'header' => "Authorization: Bearer " . $accessToken . "\r\n" .
                   "Content-Type: application/json",
        'content' => json_encode($data)
    ]
]);

$response = file_get_contents(
    'https://tellstree.com/api/projects',
    false,
    $context
);

$result = json_decode($response);
var_dump($result);
?>

# TellsTree Projects API - Create Project
# 
# This example demonstrates how to create a new project.
# Replace 'your_jwt_token' with your actual authentication token.

# Create a new project
curl -X POST \
  "https://tellstree.com/api/projects" \
  -H "Authorization: Bearer your_jwt_token" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "My New Story",
    "description": "An interactive storytelling project",
    "theme_id": "dialog",
    "design_id": "original",
    "is_public": false
  }'

Get Single Project

Retrieve detailed information about a specific project.

Response

200 Success, Returns complete project details

404 Project not found

403 Forbidden, No access

GEThttps://tellstree.com/api/projects/{id}

{
    "data": {
        "project": {
            "title": "API Test Project 1789341534",
            "description": "Created by automated test",
            "media": null,
            "is_public": false,
            "created_at": "2026-09-13T23:18:54.000000Z",
            "updated_at": "2026-09-13T23:18:54.000000Z",
            "project_id": "NMWFMX40NVJBWVF6E6WADVQY51",
            "is_locked": false,
            "nodes": {
                "nodes_count": 2
            },
            "edges": {
                "edges_count": 0
            },
            "members": {
                "members_count": 1,
                "owner": {
                    "user_id": "01KHF8MP96QY9KMPXF67Z5ZE3R",
                    "user_name": "Owner"
                }
            },
            "theme": {
                "theme_id": "QDEET0HVSC5CRJPJ5BJJAA3TRQ",
                "name": "Story Theme",
                "domain": "story"
            },
            "design": {
                "design_id": "1YMJCVSPEM79S5N7DM5XY54D4T",
                "name": "Original",
                "domain": "original"
            },
            "capabilities": {
                "userCanDelete": true
            },
            "comments": {
                "comments_count": 0,
                "comments_rating": 0
            }
        }
    }
}

{
    "method": "GET",
    "url": "http://localhost:8000/api/projects/NMWFMX40NVJBWVF6E6WADVQY51",
    "headers": {
        "Authorization": [
            "***REDACTED***"
        ],
        "Accept": "application/json",
        "Content-Type": "application/json"
    },
    "payload": null,
    "recorded_at": "2026-09-13T23:18:54+00:00"
}

/**
 * TellsTree Projects API - Read Project
 * 
 * This example demonstrates how to fetch a specific project by ID.
 * Replace 'your_jwt_token' with your actual authentication token.
 */

// Get single project
const projectId = 1;
const response = await fetch(`https://tellstree.com/api/projects/${projectId}`, {
  method: "GET",
  headers: {
    "Authorization": "Bearer your_jwt_token",
    "Accept": "application/json"
  }
});

const data = await response.json();
console.log(data);

"""
TellsTree Projects API - Read Project

This example demonstrates how to fetch a specific project by ID.
Replace 'your_jwt_token' with your actual authentication token.

Requirements:
pip install requests
"""

# Get single project
import requests

project_id = 1
headers = {
    "Authorization": "Bearer your_jwt_token",
    "Accept": "application/json"
}

response = requests.get(
    f"https://tellstree.com/api/projects/{project_id}",
    headers=headers
)

data = response.json()
print(data)

<?php
/**
 * TellsTree Projects API - Read Project
 * 
 * This example demonstrates how to fetch a specific project by ID.
 * Replace 'your_jwt_token' with your actual authentication token.
 */

// Get single project
$accessToken = 'your_jwt_token';
$projectId = 1;

$headers = [
    "Authorization: Bearer " . $accessToken,
    "Accept: application/json"
];

$context = stream_context_create([
    "http" => [
        "method" => "GET",
        "header" => implode("\r\n", $headers)
    ]
]);

$response = file_get_contents(
    "https://tellstree.com/api/projects/{$projectId}",
    false,
    $context
);

$project = json_decode($response);
var_dump($project);
?>

# TellsTree Projects API - Read Project
# 
# This example demonstrates how to fetch a specific project by ID.
# Replace 'your_jwt_token' with your actual authentication token.

# Get single project
curl -H "Authorization: Bearer your_jwt_token" \
     -H "Accept: application/json" \
     "https://tellstree.com/api/projects/1"

Update Project

Update an existing project's properties, theme, or design.

🔒 Lock Management

Lock/unlock functionality is integrated into the update endpoint:

• is_locked: true - Lock project for current user
• is_locked: false - Unlock project (only by lock owner)
• Response includes is_locked: true/false
• Auto-unlock: Locks expire automatically after 300 seconds when project is accessed

Response

200 Success, Project updated successfully

422 Invalid data, Validation errors

404 Project not found

403 Forbidden, No permission

PUThttps://tellstree.com/api/projects/{id}

{
    "data": {
        "project": {
            "title": "API Test Project 1789341534 updated",
            "description": "Created by automated test",
            "media": null,
            "is_public": false,
            "created_at": "2026-09-13T23:18:54.000000Z",
            "updated_at": "2026-09-13T23:18:54.000000Z",
            "project_id": "NMWFMX40NVJBWVF6E6WADVQY51",
            "is_locked": true,
            "nodes": {
                "nodes_count": 2
            },
            "edges": {
                "edges_count": 0
            },
            "members": {
                "members_count": 1,
                "owner": {
                    "user_id": "01KHF8MP96QY9KMPXF67Z5ZE3R",
                    "user_name": "Owner"
                }
            },
            "theme": {
                "theme_id": "QDEET0HVSC5CRJPJ5BJJAA3TRQ",
                "name": "Story Theme",
                "domain": "story"
            },
            "design": {
                "design_id": "1YMJCVSPEM79S5N7DM5XY54D4T",
                "name": "Original",
                "domain": "original"
            },
            "capabilities": {
                "userCanDelete": true
            },
            "comments": {
                "comments_count": 0,
                "comments_rating": 0
            }
        }
    }
}

{
    "method": "PUT",
    "url": "http://localhost:8000/api/projects/NMWFMX40NVJBWVF6E6WADVQY51",
    "headers": {
        "Authorization": [
            "***REDACTED***"
        ],
        "Accept": "application/json",
        "Content-Type": "application/json"
    },
    "payload": {
        "title": "API Test Project 1789341534 updated",
        "is_locked": true
    },
    "recorded_at": "2026-09-13T23:18:54+00:00"
}

/**
 * TellsTree Projects API - Update Project
 * 
 * This example demonstrates how to update an existing project.
 * Replace 'your_jwt_token' with your actual authentication token.
 */

// Update project
const projectId = 1;
const response = await fetch(`https://tellstree.com/api/projects/${projectId}`, {
  method: "PUT",
  headers: {
    "Authorization": "Bearer your_jwt_token",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    title: "My Updated Story",
    description: "Updated description",
    theme_id: "adventure",
    design_id: "modern",
    is_public: true,
    is_locked: true  // Optional: Lock for current user, or false to unlock
  })
});

const data = await response.json();
console.log(data);

"""
TellsTree Projects API - Update Project

This example demonstrates how to update an existing project.
Replace 'your_jwt_token' with your actual authentication token.

Requirements:
pip install requests
"""

# Update project
import requests

project_id = 1
headers = {
    "Authorization": "Bearer your_jwt_token",
    "Content-Type": "application/json"
}

payload = {
    "title": "My Updated Story",
    "description": "Updated description",
    "theme_id": "adventure",
    "design_id": "modern",
    "is_public": True
}

response = requests.put(
    f"https://tellstree.com/api/projects/{project_id}",
    headers=headers,
    json=payload
)

data = response.json()
print(data)

<?php
/**
 * TellsTree Projects API - Update Project
 * 
 * This example demonstrates how to update an existing project.
 * Replace 'your_jwt_token' with your actual authentication token.
 */

// Update project
$accessToken = 'your_jwt_token';
$projectId = 1;

$data = [
    'title' => 'My Updated Story',
    'description' => 'Updated description',
    'theme_id' => 'adventure',
    'design_id' => 'modern',
    'is_public' => true,
    'is_locked' => true  // Optional: Lock for current user, or false to unlock
];

$context = stream_context_create([
    'http' => [
        'method' => 'PUT',
        'header' => "Authorization: Bearer " . $accessToken . "\r\n" .
                   "Content-Type: application/json",
        'content' => json_encode($data)
    ]
]);

$response = file_get_contents(
    "https://tellstree.com/api/projects/{$projectId}",
    false,
    $context
);

$result = json_decode($response);
var_dump($result);
?>

# TellsTree Projects API - Update Project
# 
# This example demonstrates how to update an existing project.
# Replace 'your_jwt_token' with your actual authentication token.

# Update project
curl -X PUT \
  "https://tellstree.com/api/projects/1" \
  -H "Authorization: Bearer your_jwt_token" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "My Updated Story",
    "description": "Updated description",
    "theme_id": "adventure",
    "design_id": "modern",
    "is_public": true
  }'

Delete Project

Permanently delete a project and all its content.

Response

204 No Content, Project deleted successfully

404 Project not found

403 Forbidden, No permission

DELETEhttps://tellstree.com/api/projects/{id}

{
    "method": "DELETE",
    "url": "http://localhost:8000/api/projects/NMWFMX40NVJBWVF6E6WADVQY51",
    "headers": {
        "Authorization": [
            "***REDACTED***"
        ],
        "Accept": "application/json",
        "Content-Type": "application/json"
    },
    "payload": null,
    "recorded_at": "2026-09-13T23:18:54+00:00"
}

/**
 * TellsTree Projects API - Delete Project
 * 
 * This example demonstrates how to delete a project.
 * Replace 'your_jwt_token' with your actual authentication token.
 */

// Delete project
const projectId = 1;
const response = await fetch(`https://tellstree.com/api/projects/${projectId}`, {
  method: "DELETE",
  headers: {
    "Authorization": "Bearer your_jwt_token",
    "Accept": "application/json"
  }
});

if (response.status === 204) {
  console.log("Project deleted successfully");
} else {
  const data = await response.json();
  console.log(data);
}

"""
TellsTree Projects API - Delete Project

This example demonstrates how to delete a project.
Replace 'your_jwt_token' with your actual authentication token.

Requirements:
pip install requests
"""

# Delete project
import requests

project_id = 1
headers = {
    "Authorization": "Bearer your_jwt_token",
    "Accept": "application/json"
}

response = requests.delete(
    f"https://tellstree.com/api/projects/{project_id}",
    headers=headers
)

if response.status_code == 204:
    print("Project deleted successfully")
else:
    data = response.json()
    print(data)

<?php
/**
 * TellsTree Projects API - Delete Project
 * 
 * This example demonstrates how to delete a project.
 * Replace 'your_jwt_token' with your actual authentication token.
 */

// Delete project
$accessToken = 'your_jwt_token';
$projectId = 1;

$headers = [
    "Authorization: Bearer " . $accessToken,
    "Accept: application/json"
];

$context = stream_context_create([
    "http" => [
        "method" => "DELETE",
        "header" => implode("\r\n", $headers)
    ]
]);

$response = file_get_contents(
    "https://tellstree.com/api/projects/{$projectId}",
    false,
    $context
);

// HTTP 204 returns no content
if ($response === false) {
    $headers = get_headers("https://tellstree.com/api/projects/{$projectId}");
    if (strpos($headers[0], '204') !== false) {
        echo "Project deleted successfully";
    }
}
?>

# TellsTree Projects API - Delete Project
# 
# This example demonstrates how to delete a project.
# Replace 'your_jwt_token' with your actual authentication token.

# Delete project
curl -X DELETE \
  "https://tellstree.com/api/projects/1" \
  -H "Authorization: Bearer your_jwt_token" \
  -H "Accept: application/json"

Poll for Activity Updates

Retrieve IDs of resources that have been modified since a given timestamp. Enables real-time collaborative editing. Authentication required.

Headers

Authorization Bearer {your_jwt_token}

Query Parameters

since Unix timestamp - only return activities after this time (optional)

Response

200 Success, Returns activity updates since timestamp

401 Unauthorized, Invalid or missing token

403 Forbidden, User is not a project member

GEThttps://tellstree.com/api/projects/{id}/activity

{
    "nodes": [
        "SGQ4A9SQRXWYK1Y1TJ09S5D1QZ"
    ],
    "edges": [],
    "users": [],
    "timestamp": 1789328271
}

{
    "method": "GET",
    "url": "/api/projects/5DV2WVZVP96X272PH8JYPV2NYV/activity",
    "headers": {
        "Authorization": [
            "***REDACTED***"
        ],
        "Accept": "application/json",
        "Content-Type": "application/json"
    },
    "payload": null,
    "recorded_at": "2026-09-13T19:37:51+00:00"
}

// Poll for project activity updates
// GET /api/projects/{id}/activity

import apiClient from './client.js';

class ActivityPoller {
    constructor(projectId, options = {}) {
        this.projectId = projectId;
        this.lastTimestamp = Math.floor(Date.now() / 1000);
        this.intervalId = null;
        this.pollInterval = options.pollInterval || 5000; // 5 seconds default
        this.onActivity = options.onActivity || (() => {});
        this.onError = options.onError || console.error;
    }

    /**
     * Start polling for activity updates
     */
    start() {
        if (this.intervalId) {
            return; // Already polling
        }

        // Initial poll
        this.poll();

        // Set up interval
        this.intervalId = setInterval(() => this.poll(), this.pollInterval);
    }

    /**
     * Stop polling
     */
    stop() {
        if (this.intervalId) {
            clearInterval(this.intervalId);
            this.intervalId = null;
        }
    }

    /**
     * Perform a single poll
     */
    async poll() {
        try {
            const response = await apiClient.get(
                `/api/projects/${this.projectId}/activity`,
                {
                    params: { since: this.lastTimestamp }
                }
            );

            const { nodes, edges, users, timestamp } = response.data;

            // Update timestamp for next poll
            this.lastTimestamp = timestamp;

            // Notify if there are any updates
            if (nodes.length > 0 || edges.length > 0 || users.length > 0) {
                this.onActivity({ nodes, edges, users, timestamp });
            }
        } catch (error) {
            this.onError(error);
        }
    }
}

// Example usage:
const poller = new ActivityPoller(1, {
    pollInterval: 5000,
    onActivity: ({ nodes, edges, users }) => {
        console.log('Activity detected:', { nodes, edges, users });
        
        // Fetch full data for updated entities
        nodes.forEach(async (nodeId) => {
            const node = await apiClient.get(`/api/nodes/${nodeId}`);
            // Update UI with node data
        });
    },
    onError: (error) => {
        console.error('Polling error:', error);
    }
});

poller.start();

// Stop when leaving project
// poller.stop();

"""
Poll for project activity updates
GET /api/projects/{id}/activity
"""

import requests
import time
from typing import Callable, Optional

class ActivityPoller:
    def __init__(
        self,
        base_url: str,
        token: str,
        project_id: int,
        poll_interval: int = 5,
        on_activity: Optional[Callable] = None
    ):
        self.base_url = base_url
        self.token = token
        self.project_id = project_id
        self.poll_interval = poll_interval
        self.on_activity = on_activity or (lambda x: None)
        self.last_timestamp = int(time.time())
        self.running = False

    def start(self):
        """Start polling for activity updates"""
        self.running = True
        
        while self.running:
            try:
                self.poll()
                time.sleep(self.poll_interval)
            except KeyboardInterrupt:
                self.stop()
            except Exception as e:
                print(f"Polling error: {e}")

    def stop(self):
        """Stop polling"""
        self.running = False

    def poll(self):
        """Perform a single poll"""
        headers = {
            'Authorization': f'Bearer {self.token}',
            'Accept': 'application/json'
        }
        
        params = {'since': self.last_timestamp}
        
        response = requests.get(
            f'{self.base_url}/api/projects/{self.project_id}/activity',
            headers=headers,
            params=params
        )
        
        response.raise_for_status()
        data = response.json()
        
        # Update timestamp
        self.last_timestamp = data['timestamp']
        
        # Notify if there are updates
        nodes = data.get('nodes', [])
        edges = data.get('edges', [])
        users = data.get('users', [])
        
        if nodes or edges or users:
            self.on_activity({
                'nodes': nodes,
                'edges': edges,
                'users': users,
                'timestamp': data['timestamp']
            })

# Example usage:
def handle_activity(activity):
    print(f"Activity detected: {activity}")
    # Fetch full data for updated entities
    for node_id in activity['nodes']:
        # Fetch node data
        pass

poller = ActivityPoller(
    base_url='https://tellstree.com',
    token='YOUR_JWT_TOKEN',
    project_id=1,
    poll_interval=5,
    on_activity=handle_activity
)

# Start polling (blocking)
# poller.start()

<?php
/**
 * Poll for project activity updates
 * GET /api/projects/{id}/activity
 */

class ActivityPoller
{
    private $baseUrl;
    private $token;
    private $projectId;
    private $pollInterval;
    private $lastTimestamp;
    private $running = false;
    private $onActivity;

    public function __construct(
        string $baseUrl,
        string $token,
        int $projectId,
        int $pollInterval = 5,
        ?callable $onActivity = null
    ) {
        $this->baseUrl = $baseUrl;
        $this->token = $token;
        $this->projectId = $projectId;
        $this->pollInterval = $pollInterval;
        $this->lastTimestamp = time();
        $this->onActivity = $onActivity;
    }

    public function start(): void
    {
        $this->running = true;

        while ($this->running) {
            try {
                $this->poll();
                sleep($this->pollInterval);
            } catch (Exception $e) {
                error_log("Polling error: " . $e->getMessage());
            }
        }
    }

    public function stop(): void
    {
        $this->running = false;
    }

    private function poll(): void
    {
        $url = sprintf(
            '%s/api/projects/%d/activity?since=%d',
            $this->baseUrl,
            $this->projectId,
            $this->lastTimestamp
        );

        $ch = curl_init($url);
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
        curl_setopt($ch, CURLOPT_HTTPHEADER, [
            'Authorization: Bearer ' . $this->token,
            'Accept: application/json'
        ]);

        $response = curl_exec($ch);
        $statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
        curl_close($ch);

        if ($statusCode !== 200) {
            throw new Exception("HTTP $statusCode");
        }

        $data = json_decode($response, true);

        // Update timestamp
        $this->lastTimestamp = $data['timestamp'];

        // Notify if there are updates
        $nodes = $data['nodes'] ?? [];
        $edges = $data['edges'] ?? [];
        $users = $data['users'] ?? [];

        if (!empty($nodes) || !empty($edges) || !empty($users)) {
            if ($this->onActivity) {
                ($this->onActivity)([
                    'nodes' => $nodes,
                    'edges' => $edges,
                    'users' => $users,
                    'timestamp' => $data['timestamp']
                ]);
            }
        }
    }
}

// Example usage:
$poller = new ActivityPoller(
    baseUrl: 'https://tellstree.com',
    token: 'YOUR_JWT_TOKEN',
    projectId: 1,
    pollInterval: 5,
    onActivity: function($activity) {
        echo "Activity detected: " . json_encode($activity) . "\n";
        
        // Fetch full data for updated entities
        foreach ($activity['nodes'] as $nodeId) {
            // Fetch node data
        }
    }
);

// Start polling (blocking)
// $poller->start();

#!/bin/bash

# Poll for project activity updates
# GET /api/projects/{id}/activity

# Configuration
BASE_URL="https://tellstree.com"
PROJECT_ID=1
JWT_TOKEN="YOUR_JWT_TOKEN"
POLL_INTERVAL=5

# Get current timestamp
LAST_TIMESTAMP=$(date +%s)

echo "Starting activity polling for project $PROJECT_ID..."
echo "Press Ctrl+C to stop"
echo ""

# Polling loop
while true; do
    # Make the request
    RESPONSE=$(curl -s -w "\n%{http_code}" -X GET \
        "${BASE_URL}/api/projects/${PROJECT_ID}/activity?since=${LAST_TIMESTAMP}" \
        -H "Authorization: Bearer ${JWT_TOKEN}" \
        -H "Accept: application/json")
    
    # Extract HTTP status code
    HTTP_CODE=$(echo "$RESPONSE" | tail -n1)
    BODY=$(echo "$RESPONSE" | sed '$d')
    
    if [ "$HTTP_CODE" = "200" ]; then
        # Parse response
        NODES=$(echo "$BODY" | jq -r '.nodes[]' 2>/dev/null)
        EDGES=$(echo "$BODY" | jq -r '.edges[]' 2>/dev/null)
        USERS=$(echo "$BODY" | jq -r '.users[]' 2>/dev/null)
        NEW_TIMESTAMP=$(echo "$BODY" | jq -r '.timestamp')
        
        # Check if there are any updates
        if [ -n "$NODES" ] || [ -n "$EDGES" ] || [ -n "$USERS" ]; then
            echo "[$(date '+%Y-%m-%d %H:%M:%S')] Activity detected:"
            [ -n "$NODES" ] && echo "  Nodes: $NODES"
            [ -n "$EDGES" ] && echo "  Edges: $EDGES"
            [ -n "$USERS" ] && echo "  Users: $USERS"
            echo ""
            
            # Fetch full data for updated nodes
            for NODE_ID in $NODES; do
                echo "  Fetching node $NODE_ID..."
                curl -s -X GET \
                    "${BASE_URL}/api/nodes/${NODE_ID}" \
                    -H "Authorization: Bearer ${JWT_TOKEN}" \
                    -H "Accept: application/json" | jq '.'
            done
        fi
        
        # Update timestamp
        LAST_TIMESTAMP=$NEW_TIMESTAMP
    else
        echo "[$(date '+%Y-%m-%d %H:%M:%S')] Error: HTTP $HTTP_CODE"
        echo "$BODY"
    fi
    
    # Wait before next poll
    sleep $POLL_INTERVAL
done

📋 Nodes

Nodes are the building blocks of your story. Each node represents a narrative element like a scene, chapter or character. A Node can contain text, media, and interactive elements.

GET /api/nodes List all nodes

POST /api/nodes Create new node

GET /api/nodes?query[include]=ids Get specific nodes (lazy loading)

GET /api/nodes/{node} Get node details

PUT /api/nodes/{node} Update node

DELETE /api/nodes/{node} Delete node

List Nodes

Retrieve all nodes or filter by project, including their content, position, and metadata.

Query Parameters

query[project_id] - Filter by project ID (required)
query[page] - Page number (optional, default: 1)
query[per_page] - Items per page (optional, default: 20)

Response

200 Success / Nodes list

400 Missing project_id parameter

401 Unauthorized / Invalid token

GEThttps://tellstree.com/api/nodes

{
    "data": {
        "nodes": [
            {
                "node_id": "PKDJSHNTAAACVDPR22JAV4F7P6",
                "project_id": "01KHFBZSS300011X6EQ7H267R2",
                "type": "start",
                "label": "Start",
                "content": [],
                "media": [],
                "created_at": "2025-12-17T15:11:39.000000Z",
                "updated_at": "2026-02-18T03:06:52.000000Z",
                "outgoing_edges_count": 4,
                "incoming_edges_count": 0,
                "is_locked": false,
                "locked_by": null,
                "locked_at": null
            },
            {
                "node_id": "G1EA86336NCVQSX6K7SQPR2V0G",
                "project_id": "01KHFBZSS300011X6EQ7H267R2",
                "type": "end",
                "label": "End",
                "content": [],
                "media": [],
                "created_at": "2025-12-17T15:11:39.000000Z",
                "updated_at": "2026-02-15T01:10:44.000000Z",
                "outgoing_edges_count": 0,
                "incoming_edges_count": 4,
                "is_locked": false,
                "locked_by": null,
                "locked_at": null
            },
            {
                "node_id": "JVRMME1XQVKFZT5W4KHGNFHQ17",
                "project_id": "01KHFBZSS300011X6EQ7H267R2",
                "type": "character",
                "label": "Wilhelm Tell",
                "content": {
                    "name": "Wilhelm Tell",
                    "description": "A silent hero of justice - a man of few words, but unshakable principles. He values freedom over obedience, and would rather risk death than bow to a tyrant."
                },
                "media": [],
                "created_at": "2025-12-17T15:11:39.000000Z",
                "updated_at": "2025-12-17T15:11:39.000000Z",
                "outgoing_edges_count": 0,
                "incoming_edges_count": 0,
                "is_locked": false,
                "locked_by": null,
                "locked_at": null
            },
            {
                "node_id": "YM17E03PC6FY6FKGKV9V5QH792",
                "project_id": "01KHFBZSS300011X6EQ7H267R2",
                "type": "character",
                "label": "Walter Tell",
                "content": {
                    "name": "Walter Tell",
                    "description": "Wilhelm Tells son."
                },
                "media": [],
                "created_at": "2025-12-17T15:11:39.000000Z",
                "updated_at": "2025-12-17T15:11:39.000000Z",
                "outgoing_edges_count": 0,
                "incoming_edges_count": 0,
                "is_locked": false,
                "locked_by": null,
                "locked_at": null
            },
            {
                "node_id": "QNKW04Z1ET7HTCGC4A3CA8PGW0",
                "project_id": "01KHFBZSS300011X6EQ7H267R2",
                "type": "dialog-entry",
                "label": "Trust me!",
                "content": {
                    "message": "Trust me!",
                    "speaker": "JVRMME1XQVKFZT5W4KHGNFHQ17"
                },
                "media": [],
                "created_at": "2025-12-17T15:11:39.000000Z",
                "updated_at": "2026-02-19T14:34:59.000000Z",
                "outgoing_edges_count": 1,
                "incoming_edges_count": 1,
                "is_locked": false,
                "locked_by": null,
                "locked_at": null
            },
            {
                "node_id": "122Q411CBPB1VSFWYJ3VS8AB4F",
                "project_id": "01KHFBZSS300011X6EQ7H267R2",
                "type": "dialog-entry",
                "label": "Are you sure you won\u00b4t kill me?",
                "content": {
                    "message": "Are you sure you won\u00b4t kill me?",
                    "speaker": "YM17E03PC6FY6FKGKV9V5QH792",
                    "speaker_int_backup": 4
                },
                "media": [],
                "created_at": "2025-12-17T15:11:39.000000Z",
                "updated_at": "2026-02-19T14:03:06.000000Z",
                "outgoing_edges_count": 4,
                "incoming_edges_count": 1,
                "is_locked": false,
                "locked_by": null,
                "locked_at": null
            },
            {
                "node_id": "8FJW80RHSQE75PMD4CCKYMJ5RN",
                "project_id": "01KHFBZSS300011X6EQ7H267R2",
                "type": "dialog-entry",
                "label": "You are right. I can't do that.",
                "content": {
                    "message": "You are right. I can't do that.",
                    "speaker": "JVRMME1XQVKFZT5W4KHGNFHQ17",
                    "speaker_int_backup": 3
                },
                "media": [],
                "created_at": "2025-12-17T15:11:39.000000Z",
                "updated_at": "2026-02-15T01:11:13.000000Z",
                "outgoing_edges_count": 1,
                "incoming_edges_count": 1,
                "is_locked": false,
                "locked_by": null,
                "locked_at": null
            },
            {
                "node_id": "NKZKBJBHZQ7WKHH8P9FJ2MMSD4",
                "project_id": "01KHFBZSS300011X6EQ7H267R2",
                "type": "dialog-entry",
                "label": "Trust me son!",
                "content": {
                    "message": "Trust me son!",
                    "speaker": "JVRMME1XQVKFZT5W4KHGNFHQ17",
                    "speaker_int_backup": 3
                },
                "media": [],
                "created_at": "2025-12-17T15:11:39.000000Z",
                "updated_at": "2025-12-17T15:11:39.000000Z",
                "outgoing_edges_count": 1,
                "incoming_edges_count": 1,
                "is_locked": false,
                "locked_by": null,
                "locked_at": null
            },
            {
                "node_id": "SMAQ85Q79CYZZVCGXCP61B971X",
                "project_id": "01KHFBZSS300011X6EQ7H267R2",
                "type": "dialog-entry",
                "label": "Son just stop shaking!",
                "content": {
                    "message": "Son just stop shaking!",
                    "speaker": "JVRMME1XQVKFZT5W4KHGNFHQ17",
                    "speaker_int_backup": 3
                },
                "media": [],
                "created_at": "2025-12-17T15:11:39.000000Z",
                "updated_at": "2025-12-17T15:11:39.000000Z",
                "outgoing_edges_count": 1,
                "incoming_edges_count": 1,
                "is_locked": false,
                "locked_by": null,
                "locked_at": null
            },
            {
                "node_id": "GG4Q99Q64Q1W7753R9R0M03HGS",
                "project_id": "01KHFBZSS300011X6EQ7H267R2",
                "type": "dialog",
                "label": "Apple Shot Talk",
                "content": {
                    "title": "Apple Shot Talk",
                    "description": "Wilhelm wants his son to calm down."
                },
                "media": [],
                "created_at": "2025-12-18T03:10:33.000000Z",
                "updated_at": "2025-12-18T03:10:33.000000Z",
                "outgoing_edges_count": 0,
                "incoming_edges_count": 0,
                "is_locked": false,
                "locked_by": null,
                "locked_at": null
            },
            {
                "node_id": "Z1GQ4GPM30V2JHJ3V841KWP01Z",
                "project_id": "01KHFBZSS300011X6EQ7H267R2",
                "type": "scene",
                "label": "The Apple Shot",
                "content": {
                    "title": "The Apple Shot",
                    "description": "The famous apple shot scene."
                },
                "media": [],
                "created_at": "2025-12-18T03:15:59.000000Z",
                "updated_at": "2025-12-18T03:15:59.000000Z",
                "outgoing_edges_count": 0,
                "incoming_edges_count": 0,
                "is_locked": false,
                "locked_by": null,
                "locked_at": null
            },
            {
                "node_id": "BCSVNRRE72XMV9QDBNASZTH00T",
                "project_id": "01KHFBZSS300011X6EQ7H267R2",
                "type": "chapter",
                "label": "Chapter 1",
                "content": {
                    "title": "Chapter 1",
                    "summary": "This is the very first chapter."
                },
                "media": [],
                "created_at": "2025-12-18T03:17:30.000000Z",
                "updated_at": "2025-12-18T03:17:30.000000Z",
                "outgoing_edges_count": 1,
                "incoming_edges_count": 1,
                "is_locked": false,
                "locked_by": null,
                "locked_at": null
            },
            {
                "node_id": "PE2051MQEYT7ER5HSDBTQZ56MB",
                "project_id": "01KHFBZSS300011X6EQ7H267R2",
                "type": "chapter",
                "label": "Chapter 2",
                "content": {
                    "title": "Chapter 2",
                    "summary": "This is the second chapter."
                },
                "media": [],
                "created_at": "2025-12-18T03:20:29.000000Z",
                "updated_at": "2025-12-18T03:20:29.000000Z",
                "outgoing_edges_count": 1,
                "incoming_edges_count": 1,
                "is_locked": false,
                "locked_by": null,
                "locked_at": null
            },
            {
                "node_id": "ARXTM2EZ77E67QWXDWPH3WAEVE",
                "project_id": "01KHFBZSS300011X6EQ7H267R2",
                "type": "chapter",
                "label": "Chapter 3",
                "content": {
                    "title": "Chapter 3",
                    "summary": "The third chapter starts here"
                },
                "media": [],
                "created_at": "2025-12-18T03:23:05.000000Z",
                "updated_at": "2025-12-18T03:23:05.000000Z",
                "outgoing_edges_count": 1,
                "incoming_edges_count": 1,
                "is_locked": false,
                "locked_by": null,
                "locked_at": null
            },
            {
                "node_id": "XKJ2CFDBTCZ8KND6CKB8D4YABX",
                "project_id": "01KHFBZSS300011X6EQ7H267R2",
                "type": "chapter",
                "label": "Chapter 4",
                "content": {
                    "title": "Chapter 4",
                    "summary": "The fourth chapter is here"
                },
                "media": [],
                "created_at": "2025-12-18T03:24:45.000000Z",
                "updated_at": "2025-12-18T03:24:45.000000Z",
                "outgoing_edges_count": 0,
                "incoming_edges_count": 1,
                "is_locked": false,
                "locked_by": null,
                "locked_at": null
            },
            {
                "node_id": "F9H3JTDHC3HNEE6MV8BJ4ATFMV",
                "project_id": "01KHFBZSS300011X6EQ7H267R2",
                "type": "dialog-entry",
                "label": "Stay calm!",
                "content": {
                    "speaker": "JVRMME1XQVKFZT5W4KHGNFHQ17",
                    "message": "Stay calm!",
                    "speaker_int_backup": "3"
                },
                "media": [],
                "created_at": "2026-02-12T16:44:43.000000Z",
                "updated_at": "2026-02-12T16:44:43.000000Z",
                "outgoing_edges_count": 0,
                "incoming_edges_count": 1,
                "is_locked": false,
                "locked_by": null,
                "locked_at": null
            },
            {
                "node_id": "KBJA1EX8G1J2S18QW8X1932K7V",
                "project_id": "01KHFBZSS300011X6EQ7H267R2",
                "type": "dialog-entry",
                "label": "Run!",
                "content": {
                    "speaker": "JVRMME1XQVKFZT5W4KHGNFHQ17",
                    "message": "Run!"
                },
                "media": [],
                "created_at": "2026-02-15T02:34:02.000000Z",
                "updated_at": "2026-02-19T14:34:36.000000Z",
                "outgoing_edges_count": 1,
                "incoming_edges_count": 1,
                "is_locked": false,
                "locked_by": null,
                "locked_at": null
            },
            {
                "node_id": "D1J0J8C1WQK3673W9YQR9ZSGMQ",
                "project_id": "01KHFBZSS300011X6EQ7H267R2",
                "type": "dialog-entry",
                "label": "A little left!",
                "content": {
                    "speaker": "JVRMME1XQVKFZT5W4KHGNFHQ17",
                    "message": "A little left!"
                },
                "media": [],
                "created_at": "2026-02-15T02:54:05.000000Z",
                "updated_at": "2026-02-19T14:03:59.000000Z",
                "outgoing_edges_count": 1,
                "incoming_edges_count": 1,
                "is_locked": false,
                "locked_by": null,
                "locked_at": null
            },
            {
                "node_id": "V4TE0HWAB311WD64HBFDASKC3G",
                "project_id": "01KHFBZSS300011X6EQ7H267R2",
                "type": "dialog-entry",
                "label": "Yes!",
                "content": {
                    "speaker": "YM17E03PC6FY6FKGKV9V5QH792",
                    "message": "Yes!"
                },
                "media": [],
                "created_at": "2026-02-18T03:08:23.000000Z",
                "updated_at": "2026-02-19T14:34:45.000000Z",
                "outgoing_edges_count": 0,
                "incoming_edges_count": 1,
                "is_locked": false,
                "locked_by": null,
                "locked_at": null
            },
            {
                "node_id": "FVX1ECBDPZCWG3ZG6BFDY7PN3C",
                "project_id": "01KHFBZSS300011X6EQ7H267R2",
                "type": "dialog-entry",
                "label": "E2E: lokaler Pruefknoten (Thea 13.09.2026)",
                "content": {
                    "speaker": "JVRMME1XQVKFZT5W4KHGNFHQ17",
                    "message": "E2E: lokaler Pruefknoten (Thea 13.09.2026)"
                },
                "media": [],
                "created_at": "2026-09-13T03:48:15.000000Z",
                "updated_at": "2026-09-13T03:48:15.000000Z",
                "outgoing_edges_count": 0,
                "incoming_edges_count": 0,
                "is_locked": false,
                "locked_by": null,
                "locked_at": null
            }
        ],
        "pagination": {
            "current_page": 1,
            "total_pages": 1,
            "per_page": 20,
            "total_items": 20,
            "page": 1
        }
    }
}

{
    "method": "GET",
    "url": "http://localhost:8000/api/nodes",
    "headers": {
        "Authorization": [
            "***REDACTED***"
        ],
        "Accept": "application/json",
        "Content-Type": "application/json"
    },
    "payload": {
        "query": {
            "project_id": "01KHFBZSS300011X6EQ7H267R2"
        }
    },
    "recorded_at": "2026-09-13T19:37:58+00:00"
}

// TellsTree SDK - Nodes API (JavaScript)
// List all nodes in a project

const API_BASE_URL = 'https://tellstree.com/api';
const API_TOKEN = 'your_jwt_token_here';

/**
 * Get all nodes for a specific project
 * @param {number} projectId - The ID of the project
 * @param {number} page - Page number (default: 1)
 * @param {number} perPage - Items per page (default: 20)
 * @returns {Promise<Object>} API response with nodes data
 */
async function listProjectNodes(projectId, page = 1, perPage = 20) {
    try {
        const params = new URLSearchParams({
            'query[project_id]': projectId,
            'query[page]': page,
            'query[per_page]': perPage
        });
        const url = `${API_BASE_URL}/nodes?${params}`;

        const response = await fetch(url, {
            method: 'GET',
            headers: {
                'Accept': 'application/json',
                'Content-Type': 'application/json',
                'Authorization': `Bearer ${API_TOKEN}`
            }
        });

        if (!response.ok) {
            throw new Error(`HTTP ${response.status}: ${response.statusText}`);
        }

        const data = await response.json();
        return data;
    } catch (error) {
        console.error('Error fetching project nodes:', error);
        throw error;
    }
}

// Example usage (only runs when executed directly)
if (typeof require !== 'undefined' && require.main === module) {
    // Example: Get nodes for project ID 1
    listProjectNodes(1, 1, 10)
        .then(result => {
            console.log('Project Nodes:');
            console.log(JSON.stringify(result, null, 2));
        })
        .catch(error => {
            console.error('Failed to fetch project nodes:', error.message);
        });
}

// Export for use in other modules
if (typeof module !== 'undefined' && module.exports) {
    module.exports = { listProjectNodes };
}

"""
TellsTree SDK - Nodes API (Python)
List all nodes in a project
"""

import requests
import json
from typing import Dict, Any, Optional

API_BASE_URL = "https://tellstree.com/api"
API_TOKEN = "your_jwt_token_here"

def list_project_nodes(project_id: int, page: int = 1, per_page: int = 20) -> Dict[str, Any]:
    """
    Get all nodes for a specific project
    
    Args:
        project_id (int): The ID of the project
        page (int): Page number (default: 1)
        per_page (int): Items per page (default: 10)
        
    Returns:
        Dict[str, Any]: API response with nodes data
        
    Raises:
        requests.RequestException: If the API request fails
        ValueError: If the response cannot be parsed as JSON
    """
    try:
        url = f"{API_BASE_URL}/nodes"
        params = {
            'query[project_id]': project_id,
            'query[page]': page,
            'query[per_page]': per_page
        }
        
        headers = {
            'Accept': 'application/json',
            'Content-Type': 'application/json',
            'Authorization': f'Bearer {API_TOKEN}'
        }
        
        response = requests.get(url, params=params, headers=headers)
        response.raise_for_status()
        
        return response.json()
        
    except requests.RequestException as e:
        print(f"Error fetching project nodes: {e}")
        raise
    except json.JSONDecodeError as e:
        print(f"Error parsing JSON response: {e}")
        raise ValueError("Invalid JSON response from API")

def main():
    """Example usage of the nodes API"""
    try:
        # Get nodes for project ID 1
        result = list_project_nodes(1, 1, 10)
        print("Project Nodes:")
        print(json.dumps(result, indent=2))
        
    except Exception as e:
        print(f"Failed to fetch project nodes: {e}")

if __name__ == "__main__":
    main()

<?php
/**
 * TellsTree SDK - Nodes API (PHP)
 * List all nodes in a project
 */

const API_BASE_URL = 'https://tellstree.com/api';
const API_TOKEN = 'your_jwt_token_here';

/**
 * Get all nodes for a specific project
 * 
 * @param int $projectId The ID of the project
 * @param int $page Page number (default: 1)
 * @param int $perPage Items per page (default: 10)
 * @return array API response with nodes data
 * @throws Exception If the API request fails
 */
function listProjectNodes($projectId, $page = 1, $perPage = 20) {
    $url = API_BASE_URL . "/nodes?" . http_build_query([
        'query' => [
            'project_id' => $projectId,
            'page' => $page,
            'per_page' => $perPage
        ]
    ]);
    
    $context = stream_context_create([
        'http' => [
            'method' => 'GET',
            'header' => [
                'Accept: application/json',
                'Content-Type: application/json',
                'Authorization: Bearer ' . API_TOKEN
            ],
            'ignore_errors' => true
        ]
    ]);
    
    $response = file_get_contents($url, false, $context);
    
    if ($response === false) {
        throw new Exception('Failed to make API request');
    }
    
    // Get HTTP status code
    $statusLine = $http_response_header[0] ?? '';
    preg_match('/\d{3}/', $statusLine, $matches);
    $statusCode = $matches[0] ?? 0;
    
    if ($statusCode >= 400) {
        $errorData = json_decode($response, true);
        $message = $errorData['message'] ?? 'HTTP Error ' . $statusCode;
        throw new Exception($message, (int)$statusCode);
    }
    
    $data = json_decode($response, true);
    
    if (json_last_error() !== JSON_ERROR_NONE) {
        throw new Exception('Invalid JSON response: ' . json_last_error_msg());
    }
    
    return $data;
}

// Example usage (only runs when executed directly)
if (basename(__FILE__) === basename($_SERVER['SCRIPT_FILENAME'])) {
    try {
        // Get nodes for project ID 1
        $result = listProjectNodes(1, 1, 10);
        echo "Project Nodes:\n";
        echo json_encode($result, JSON_PRETTY_PRINT) . "\n";
        
    } catch (Exception $e) {
        echo "Failed to fetch project nodes: " . $e->getMessage() . "\n";
        exit(1);
    }
}
?>

curl -X GET "https://tellstree.com/api/projects/1/nodes?page=1&per_page=10" \
     -H "Authorization: Bearer your-jwt-token" \
     -H "Accept: application/json"

Load Specific Nodes

Get specific nodes by IDs for lazy loading in the TellsTreeGraph editor. Used for performance optimization when working with large projects.

Query Parameters

query[project_id] - Required project ID
query[include] - Comma-separated node IDs
• Returns canvas-ready node data
• Optimized for editor performance

Response

200 Success / Nodes loaded

400 Missing project_id

GEThttps://tellstree.com/api/nodes

{
    "data": {
        "nodes": [
            {
                "node_id": "PKDJSHNTAAACVDPR22JAV4F7P6",
                "type": "start",
                "label": "Start",
                "content": [],
                "media": [],
                "compactView": null,
                "detailView": null,
                "resolvedProps": []
            },
            {
                "node_id": "G1EA86336NCVQSX6K7SQPR2V0G",
                "type": "end",
                "label": "End",
                "content": [],
                "media": [],
                "compactView": null,
                "detailView": null,
                "resolvedProps": []
            },
            {
                "node_id": "JVRMME1XQVKFZT5W4KHGNFHQ17",
                "type": "character",
                "label": "Wilhelm Tell",
                "content": {
                    "name": "Wilhelm Tell",
                    "description": "A silent hero of justice - a man of few words, but unshakable principles. He values freedom over obedience, and would rather risk death than bow to a tyrant."
                },
                "media": [],
                "compactView": null,
                "detailView": null,
                "resolvedProps": {
                    "header": "Wilhelm Tell",
                    "content": "A silent hero of justice - a man of few words, but unshakable principles. He values freedom over obedience, and would rather risk death than bow to a tyrant.",
                    "image": "",
                    "imageAlign": "top"
                }
            }
        ]
    }
}

{
    "method": "GET",
    "url": "http://localhost:8000/api/nodes",
    "headers": {
        "Authorization": [
            "***REDACTED***"
        ],
        "Accept": "application/json",
        "Content-Type": "application/json"
    },
    "payload": {
        "query": {
            "project_id": "01KHFBZSS300011X6EQ7H267R2",
            "include": "PKDJSHNTAAACVDPR22JAV4F7P6,G1EA86336NCVQSX6K7SQPR2V0G,JVRMME1XQVKFZT5W4KHGNFHQ17"
        }
    },
    "recorded_at": "2026-09-13T19:37:58+00:00"
}

// TellsTree SDK - Nodes API (JavaScript)
// Load specific nodes for lazy loading

const API_BASE_URL = 'https://tellstree.com/api';
const API_TOKEN = 'your_jwt_token_here';

/**
 * Load specific nodes by IDs for lazy loading
 * @param {number} projectId - The ID of the project
 * @param {Array<number|string>} nodeIds - Array of node IDs to load
 * @returns {Promise<Array>} Array of canvas-ready node objects
 */
async function loadSpecificNodes(projectId, nodeIds) {
    try {
        const params = new URLSearchParams({
            'query[project_id]': projectId,
            'query[include]': nodeIds.join(',')
        });
        const url = `${API_BASE_URL}/nodes?${params}`;

        const response = await fetch(url, {
            method: 'GET',
            headers: {
                'Accept': 'application/json',
                'Authorization': `Bearer ${API_TOKEN}`
            }
        });

        if (!response.ok) {
            throw new Error(`HTTP ${response.status}: ${response.statusText}`);
        }

        const data = await response.json();
        return data.data.nodes; // Extract nodes from wrapper structure
    } catch (error) {
        console.error('Failed to load nodes:', error);
        throw error;
    }
}

// Example usage (only runs when executed directly)
if (typeof require !== 'undefined' && require.main === module) {
    // Example: Load specific nodes for project 42
    const projectId = 42;
    const nodeIds = [1, 2, 3, 15, 28];
    
    loadSpecificNodes(projectId, nodeIds)
        .then(nodes => {
            console.log(`Loaded ${nodes.length} nodes:`);
            nodes.forEach(node => {
                console.log(`- ${node.title} (ID: ${node.node_id})`);
            });
        })
        .catch(error => {
            console.error('Failed to load nodes:', error.message);
        });
}

export { loadSpecificNodes };

"""
TellsTree SDK - Nodes API (Python)
Load specific nodes for lazy loading
"""

import requests
from typing import List, Dict, Any, Union

API_BASE_URL = "https://tellstree.com/api"
API_TOKEN = "your_jwt_token_here"

def load_specific_nodes(project_id: int, node_ids: List[Union[int, str]]) -> List[Dict[str, Any]]:
    """
    Load specific nodes by IDs for lazy loading
    
    Args:
        project_id: The ID of the project
        node_ids: Array of node IDs to load
        
    Returns:
        List of canvas-ready node objects
        
    Raises:
        requests.RequestException: If the API request fails
    """
    headers = {
        "Authorization": f"Bearer {API_TOKEN}",
        "Accept": "application/json"
    }
    
    params = {
        "query[project_id]": project_id,
        "query[include]": ",".join(map(str, node_ids))
    }
    
    response = requests.get(
        f"{API_BASE_URL}/nodes",
        headers=headers,
        params=params
    )
    
    response.raise_for_status()
    data = response.json()
    return data["data"]["nodes"]  # Extract nodes from wrapper structure

def main():
    """Example usage of the load specific nodes API"""
    try:
        # Example: Load specific nodes for project 42
        project_id = 42
        node_ids = [1, 2, 3, 15, 28]
        
        nodes = load_specific_nodes(project_id, node_ids)
        
        print(f"Loaded {len(nodes)} nodes:")
        for node in nodes:
            print(f"- {node['title']} (ID: {node['node_id']})")
            
    except requests.RequestException as e:
        print(f"Error: {e}")

if __name__ == "__main__":
    main()

<?php
/**
 * TellsTree SDK - Nodes API (PHP)
 * Load specific nodes for lazy loading
 */

const API_BASE_URL = 'https://tellstree.com/api';
const API_TOKEN = 'your_jwt_token_here';

/**
 * Load specific nodes by IDs for lazy loading
 * 
 * @param int $projectId The ID of the project
 * @param array $nodeIds Array of node IDs to load
 * @return array Array of canvas-ready node data
 * @throws Exception If the API request fails
 */
function loadSpecificNodes($projectId, $nodeIds) {
    $url = API_BASE_URL . "/nodes?" . http_build_query([
        'query' => [
            'project_id' => $projectId,
            'include' => implode(',', $nodeIds)
        ]
    ]);
    
    $context = stream_context_create([
        'http' => [
            'method' => 'GET',
            'header' => [
                'Accept: application/json',
                'Authorization: Bearer ' . API_TOKEN
            ]
        ]
    ]);
    
    $response = @file_get_contents($url, false, $context);
    
    if ($response === false) {
        $error = error_get_last();
        throw new Exception("API request failed: " . $error['message']);
    }
    
    $httpStatus = null;
    if (isset($http_response_header)) {
        foreach ($http_response_header as $header) {
            if (strpos($header, 'HTTP/') === 0) {
                preg_match('/HTTP\/\d\.\d (\d+)/', $header, $matches);
                if ($matches) {
                    $httpStatus = (int)$matches[1];
                    break;
                }
            }
        }
    }
    
    if ($httpStatus && $httpStatus >= 400) {
        throw new Exception("API request failed with HTTP $httpStatus");
    }
    
    $data = json_decode($response, true);
    
    if ($data === null) {
        throw new Exception("Invalid JSON response from API");
    }
    
    return $data['data']['nodes']; // Extract nodes from wrapper structure
}

// Example usage
if (__FILE__ == $_SERVER['SCRIPT_FILENAME']) {
    try {
        // Example: Load specific nodes for project 42
        $projectId = 42;
        $nodeIds = [1, 2, 3, 15, 28];
        
        $nodes = loadSpecificNodes($projectId, $nodeIds);
        
        echo "Loaded " . count($nodes) . " nodes:\n";
        foreach ($nodes as $node) {
            echo "- {$node['title']} (ID: {$node['node_id']})\n";
        }
    } catch (Exception $e) {
        echo "Error: " . $e->getMessage() . "\n";
    }
}
?>

# TellsTree Nodes API - Load Specific Nodes (cURL)
# 
# This example demonstrates how to load specific nodes by IDs
# for lazy loading in the TellsTreeGraph editor.

# Load specific nodes by IDs with query parameters
curl -X GET "https://tellstree.com/api/nodes?query%5Bproject_id%5D=42&query%5Binclude%5D=1,2,3,15,28" \
     -H "Authorization: Bearer your-jwt-token" \
     -H "Accept: application/json"

# Alternative: Using -G and -d for more readable format
curl -G \
     -H "Authorization: Bearer your-jwt-token" \
     -H "Accept: application/json" \
     -d "query[project_id]=42" \
     -d "query[include]=1,2,3,15,28" \
     "https://tellstree.com/api/nodes"

# Expected response: Array of canvas-ready node objects
# [
#   {
#     "node_id": 1,
#     "title": "Main Character",
#     "x_position": 100,
#     "y_position": 200,
#     "type": "character",
#     "resolved": {
#       "content": "...",
#       "media": []
#     }
#   }
# ]

Create Node

Create a new node. Nodes can exist independently or be associated with a project via project_id.

Required Fields

title - Node title

Optional Fields

project_id - Associate with project
content - Node content/text
type - Node type
position_x - X coordinate
position_y - Y coordinate
properties - Custom properties

Response

201 Created / Node created

422 Invalid data / Validation failed

401 Unauthorized / Invalid token

POSThttps://tellstree.com/api/nodes

{
    "data": {
        "node": {
            "node_id": "XTA5WRKZ83SPYBV358ZM3W8DWN",
            "project_id": "64EVPGQQB6G9GNA954F6SECPN6",
            "type": "character",
            "label": "API Test Character 1789328277",
            "content": {
                "name": "API Test Character 1789328277",
                "description": "Node created by automated API test"
            },
            "media": [],
            "created_at": "2026-09-13T19:37:57.000000Z",
            "updated_at": "2026-09-13T19:37:57.000000Z",
            "outgoing_edges_count": 0,
            "incoming_edges_count": 0,
            "is_locked": false,
            "locked_by": null,
            "locked_at": null
        }
    }
}

{
    "method": "POST",
    "url": "http://localhost:8000/api/nodes",
    "headers": {
        "Authorization": [
            "***REDACTED***"
        ],
        "Accept": "application/json",
        "Content-Type": "application/json"
    },
    "payload": {
        "type": "character",
        "label": "API Test Character 1789328277",
        "content": {
            "name": "API Test Character 1789328277",
            "description": "Node created by automated API test"
        },
        "media": [],
        "project_id": "64EVPGQQB6G9GNA954F6SECPN6"
    },
    "recorded_at": "2026-09-13T19:37:58+00:00"
}

// TellsTree SDK - Nodes API (JavaScript)
// Create a new node

const API_BASE_URL = 'https://tellstree.com/api';
const API_TOKEN = 'your_jwt_token_here';

/**
 * Create a new node
 * @param {Object} nodeData - The node data
 * @param {string} nodeData.type - Node type (e.g., 'character', 'scene', 'chapter')
 * @param {string} nodeData.label - Node label/title
 * @param {Object} nodeData.content - Node content object
 * @param {number} [nodeData.project_id] - Optional project ID to associate with
 * @param {Array} [nodeData.media] - Optional media array
 * @returns {Promise<Object>} API response with created node data
 */
async function createNode(nodeData) {
    try {
        const response = await fetch(`${API_BASE_URL}/nodes`, {
            method: 'POST',
            headers: {
                'Accept': 'application/json',
                'Content-Type': 'application/json',
                'Authorization': `Bearer ${API_TOKEN}`
            },
            body: JSON.stringify(nodeData)
        });

        if (!response.ok) {
            throw new Error(`HTTP ${response.status}: ${response.statusText}`);
        }

        const data = await response.json();
        return data;

    } catch (error) {
        console.error('Error creating node:', error);
        throw error;
    }
}

// Example usage
const newNodeData = {
    type: 'character',
    label: 'My New Character',
    content: {
        name: 'Hero Character',
        description: 'The main protagonist of our story'
    },
    media: [],
    project_id: 1 // Optional - associate with a project
};

createNode(newNodeData)
    .then(result => {
        console.log('Node created successfully:', result.data.node);
    })
    .catch(error => {
        console.error('Failed to create node:', error);
    });

# TellsTree SDK - Nodes API (Python)
# Create a new node

import requests
import json

API_BASE_URL = 'https://tellstree.com/api'
API_TOKEN = 'your_jwt_token_here'

def create_node(node_data):
    """
    Create a new node
    
    Args:
        node_data (dict): The node data
            - type (str): Node type (e.g., 'character', 'scene', 'chapter')
            - label (str): Node label/title
            - content (dict): Node content object
            - project_id (int, optional): Optional project ID to associate with
            - media (list, optional): Optional media array
    
    Returns:
        dict: API response with created node data
    """
    try:
        headers = {
            'Accept': 'application/json',
            'Content-Type': 'application/json',
            'Authorization': f'Bearer {API_TOKEN}'
        }
        
        response = requests.post(
            f'{API_BASE_URL}/nodes',
            headers=headers,
            json=node_data,
            timeout=30
        )
        
        response.raise_for_status()
        return response.json()
        
    except requests.exceptions.RequestException as e:
        print(f'Error creating node: {e}')
        raise e

# Example usage
if __name__ == '__main__':
    new_node_data = {
        'type': 'character',
        'label': 'My New Character',
        'content': {
            'name': 'Hero Character',
            'description': 'The main protagonist of our story'
        },
        'media': [],
        'project_id': 1  # Optional - associate with a project
    }
    
    try:
        result = create_node(new_node_data)
        print('Node created successfully:', result['data']['node'])
    except Exception as error:
        print('Failed to create node:', error)

<?php
/**
 * TellsTree SDK - Nodes API (PHP)
 * Create a new node
 */

const API_BASE_URL = 'https://tellstree.com/api';
const API_TOKEN = 'your_jwt_token_here';

/**
 * Create a new node
 * 
 * @param array $nodeData The node data
 *                        - type (string): Node type (e.g., 'character', 'scene', 'chapter')
 *                        - label (string): Node label/title
 *                        - content (array): Node content object
 *                        - project_id (int, optional): Optional project ID to associate with
 *                        - media (array, optional): Optional media array
 * @return array API response with created node data
 * @throws Exception If the request fails
 */
function createNode($nodeData) {
    $url = API_BASE_URL . '/nodes';
    
    $headers = [
        'Accept: application/json',
        'Content-Type: application/json',
        'Authorization: Bearer ' . API_TOKEN
    ];
    
    $context = stream_context_create([
        'http' => [
            'method' => 'POST',
            'header' => implode("\r\n", $headers),
            'content' => json_encode($nodeData)
        ]
    ]);
    
    $response = file_get_contents($url, false, $context);
    
    if ($response === false) {
        throw new Exception('Failed to create node: Unable to connect to API');
    }
    
    $data = json_decode($response, true);
    
    if (json_last_error() !== JSON_ERROR_NONE) {
        throw new Exception('Failed to decode JSON response: ' . json_last_error_msg());
    }
    
    return $data;
}

// Example usage
try {
    $newNodeData = [
        'type' => 'character',
        'label' => 'My New Character',
        'content' => [
            'name' => 'Hero Character',
            'description' => 'The main protagonist of our story'
        ],
        'media' => [],
        'project_id' => 1 // Optional - associate with a project
    ];
    
    $result = createNode($newNodeData);
    echo "Node created successfully:\n";
    print_r($result['data']['node']);
    
} catch (Exception $error) {
    echo "Failed to create node: " . $error->getMessage() . "\n";
}
?>

#!/bin/bash

# TellsTree SDK - Nodes API (cURL)
# Create a new node

API_BASE_URL="https://tellstree.com/api"
API_TOKEN="your_jwt_token_here"

# Create a new node
curl -X POST "${API_BASE_URL}/nodes" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ${API_TOKEN}" \
  -d '{
    "type": "character",
    "label": "My New Character",
    "content": {
      "name": "Hero Character", 
      "description": "The main protagonist of our story"
    },
    "media": [],
    "project_id": 1
  }'

Get Node

Retrieve detailed information about a specific node, including all its properties and metadata.

URL Parameters

project - Project ID
node - Node ID

Response

200 Success / Node details

404 Node not found

403 Forbidden / No access

GEThttps://tellstree.com/api/nodes/{node}

{
    "data": {
        "nodes": [
            {
                "node_id": "PKDJSHNTAAACVDPR22JAV4F7P6",
                "project_id": "01KHFBZSS300011X6EQ7H267R2",
                "type": "start",
                "label": "Start",
                "content": [],
                "media": [],
                "created_at": "2025-12-17T15:11:39.000000Z",
                "updated_at": "2026-02-18T03:06:52.000000Z",
                "outgoing_edges_count": 4,
                "incoming_edges_count": 0,
                "is_locked": false,
                "locked_by": null,
                "locked_at": null
            },
            {
                "node_id": "G1EA86336NCVQSX6K7SQPR2V0G",
                "project_id": "01KHFBZSS300011X6EQ7H267R2",
                "type": "end",
                "label": "End",
                "content": [],
                "media": [],
                "created_at": "2025-12-17T15:11:39.000000Z",
                "updated_at": "2026-02-15T01:10:44.000000Z",
                "outgoing_edges_count": 0,
                "incoming_edges_count": 4,
                "is_locked": false,
                "locked_by": null,
                "locked_at": null
            },
            {
                "node_id": "JVRMME1XQVKFZT5W4KHGNFHQ17",
                "project_id": "01KHFBZSS300011X6EQ7H267R2",
                "type": "character",
                "label": "Wilhelm Tell",
                "content": {
                    "name": "Wilhelm Tell",
                    "description": "A silent hero of justice - a man of few words, but unshakable principles. He values freedom over obedience, and would rather risk death than bow to a tyrant."
                },
                "media": [],
                "created_at": "2025-12-17T15:11:39.000000Z",
                "updated_at": "2025-12-17T15:11:39.000000Z",
                "outgoing_edges_count": 0,
                "incoming_edges_count": 0,
                "is_locked": false,
                "locked_by": null,
                "locked_at": null
            },
            {
                "node_id": "YM17E03PC6FY6FKGKV9V5QH792",
                "project_id": "01KHFBZSS300011X6EQ7H267R2",
                "type": "character",
                "label": "Walter Tell",
                "content": {
                    "name": "Walter Tell",
                    "description": "Wilhelm Tells son."
                },
                "media": [],
                "created_at": "2025-12-17T15:11:39.000000Z",
                "updated_at": "2025-12-17T15:11:39.000000Z",
                "outgoing_edges_count": 0,
                "incoming_edges_count": 0,
                "is_locked": false,
                "locked_by": null,
                "locked_at": null
            },
            {
                "node_id": "QNKW04Z1ET7HTCGC4A3CA8PGW0",
                "project_id": "01KHFBZSS300011X6EQ7H267R2",
                "type": "dialog-entry",
                "label": "Trust me!",
                "content": {
                    "message": "Trust me!",
                    "speaker": "JVRMME1XQVKFZT5W4KHGNFHQ17"
                },
                "media": [],
                "created_at": "2025-12-17T15:11:39.000000Z",
                "updated_at": "2026-02-19T14:34:59.000000Z",
                "outgoing_edges_count": 1,
                "incoming_edges_count": 1,
                "is_locked": false,
                "locked_by": null,
                "locked_at": null
            },
            {
                "node_id": "122Q411CBPB1VSFWYJ3VS8AB4F",
                "project_id": "01KHFBZSS300011X6EQ7H267R2",
                "type": "dialog-entry",
                "label": "Are you sure you won\u00b4t kill me?",
                "content": {
                    "message": "Are you sure you won\u00b4t kill me?",
                    "speaker": "YM17E03PC6FY6FKGKV9V5QH792",
                    "speaker_int_backup": 4
                },
                "media": [],
                "created_at": "2025-12-17T15:11:39.000000Z",
                "updated_at": "2026-02-19T14:03:06.000000Z",
                "outgoing_edges_count": 4,
                "incoming_edges_count": 1,
                "is_locked": false,
                "locked_by": null,
                "locked_at": null
            },
            {
                "node_id": "8FJW80RHSQE75PMD4CCKYMJ5RN",
                "project_id": "01KHFBZSS300011X6EQ7H267R2",
                "type": "dialog-entry",
                "label": "You are right. I can't do that.",
                "content": {
                    "message": "You are right. I can't do that.",
                    "speaker": "JVRMME1XQVKFZT5W4KHGNFHQ17",
                    "speaker_int_backup": 3
                },
                "media": [],
                "created_at": "2025-12-17T15:11:39.000000Z",
                "updated_at": "2026-02-15T01:11:13.000000Z",
                "outgoing_edges_count": 1,
                "incoming_edges_count": 1,
                "is_locked": false,
                "locked_by": null,
                "locked_at": null
            },
            {
                "node_id": "NKZKBJBHZQ7WKHH8P9FJ2MMSD4",
                "project_id": "01KHFBZSS300011X6EQ7H267R2",
                "type": "dialog-entry",
                "label": "Trust me son!",
                "content": {
                    "message": "Trust me son!",
                    "speaker": "JVRMME1XQVKFZT5W4KHGNFHQ17",
                    "speaker_int_backup": 3
                },
                "media": [],
                "created_at": "2025-12-17T15:11:39.000000Z",
                "updated_at": "2025-12-17T15:11:39.000000Z",
                "outgoing_edges_count": 1,
                "incoming_edges_count": 1,
                "is_locked": false,
                "locked_by": null,
                "locked_at": null
            },
            {
                "node_id": "SMAQ85Q79CYZZVCGXCP61B971X",
                "project_id": "01KHFBZSS300011X6EQ7H267R2",
                "type": "dialog-entry",
                "label": "Son just stop shaking!",
                "content": {
                    "message": "Son just stop shaking!",
                    "speaker": "JVRMME1XQVKFZT5W4KHGNFHQ17",
                    "speaker_int_backup": 3
                },
                "media": [],
                "created_at": "2025-12-17T15:11:39.000000Z",
                "updated_at": "2025-12-17T15:11:39.000000Z",
                "outgoing_edges_count": 1,
                "incoming_edges_count": 1,
                "is_locked": false,
                "locked_by": null,
                "locked_at": null
            },
            {
                "node_id": "GG4Q99Q64Q1W7753R9R0M03HGS",
                "project_id": "01KHFBZSS300011X6EQ7H267R2",
                "type": "dialog",
                "label": "Apple Shot Talk",
                "content": {
                    "title": "Apple Shot Talk",
                    "description": "Wilhelm wants his son to calm down."
                },
                "media": [],
                "created_at": "2025-12-18T03:10:33.000000Z",
                "updated_at": "2025-12-18T03:10:33.000000Z",
                "outgoing_edges_count": 0,
                "incoming_edges_count": 0,
                "is_locked": false,
                "locked_by": null,
                "locked_at": null
            },
            {
                "node_id": "Z1GQ4GPM30V2JHJ3V841KWP01Z",
                "project_id": "01KHFBZSS300011X6EQ7H267R2",
                "type": "scene",
                "label": "The Apple Shot",
                "content": {
                    "title": "The Apple Shot",
                    "description": "The famous apple shot scene."
                },
                "media": [],
                "created_at": "2025-12-18T03:15:59.000000Z",
                "updated_at": "2025-12-18T03:15:59.000000Z",
                "outgoing_edges_count": 0,
                "incoming_edges_count": 0,
                "is_locked": false,
                "locked_by": null,
                "locked_at": null
            },
            {
                "node_id": "BCSVNRRE72XMV9QDBNASZTH00T",
                "project_id": "01KHFBZSS300011X6EQ7H267R2",
                "type": "chapter",
                "label": "Chapter 1",
                "content": {
                    "title": "Chapter 1",
                    "summary": "This is the very first chapter."
                },
                "media": [],
                "created_at": "2025-12-18T03:17:30.000000Z",
                "updated_at": "2025-12-18T03:17:30.000000Z",
                "outgoing_edges_count": 1,
                "incoming_edges_count": 1,
                "is_locked": false,
                "locked_by": null,
                "locked_at": null
            },
            {
                "node_id": "PE2051MQEYT7ER5HSDBTQZ56MB",
                "project_id": "01KHFBZSS300011X6EQ7H267R2",
                "type": "chapter",
                "label": "Chapter 2",
                "content": {
                    "title": "Chapter 2",
                    "summary": "This is the second chapter."
                },
                "media": [],
                "created_at": "2025-12-18T03:20:29.000000Z",
                "updated_at": "2025-12-18T03:20:29.000000Z",
                "outgoing_edges_count": 1,
                "incoming_edges_count": 1,
                "is_locked": false,
                "locked_by": null,
                "locked_at": null
            },
            {
                "node_id": "ARXTM2EZ77E67QWXDWPH3WAEVE",
                "project_id": "01KHFBZSS300011X6EQ7H267R2",
                "type": "chapter",
                "label": "Chapter 3",
                "content": {
                    "title": "Chapter 3",
                    "summary": "The third chapter starts here"
                },
                "media": [],
                "created_at": "2025-12-18T03:23:05.000000Z",
                "updated_at": "2025-12-18T03:23:05.000000Z",
                "outgoing_edges_count": 1,
                "incoming_edges_count": 1,
                "is_locked": false,
                "locked_by": null,
                "locked_at": null
            },
            {
                "node_id": "XKJ2CFDBTCZ8KND6CKB8D4YABX",
                "project_id": "01KHFBZSS300011X6EQ7H267R2",
                "type": "chapter",
                "label": "Chapter 4",
                "content": {
                    "title": "Chapter 4",
                    "summary": "The fourth chapter is here"
                },
                "media": [],
                "created_at": "2025-12-18T03:24:45.000000Z",
                "updated_at": "2025-12-18T03:24:45.000000Z",
                "outgoing_edges_count": 0,
                "incoming_edges_count": 1,
                "is_locked": false,
                "locked_by": null,
                "locked_at": null
            },
            {
                "node_id": "F9H3JTDHC3HNEE6MV8BJ4ATFMV",
                "project_id": "01KHFBZSS300011X6EQ7H267R2",
                "type": "dialog-entry",
                "label": "Stay calm!",
                "content": {
                    "speaker": "JVRMME1XQVKFZT5W4KHGNFHQ17",
                    "message": "Stay calm!",
                    "speaker_int_backup": "3"
                },
                "media": [],
                "created_at": "2026-02-12T16:44:43.000000Z",
                "updated_at": "2026-02-12T16:44:43.000000Z",
                "outgoing_edges_count": 0,
                "incoming_edges_count": 1,
                "is_locked": false,
                "locked_by": null,
                "locked_at": null
            },
            {
                "node_id": "KBJA1EX8G1J2S18QW8X1932K7V",
                "project_id": "01KHFBZSS300011X6EQ7H267R2",
                "type": "dialog-entry",
                "label": "Run!",
                "content": {
                    "speaker": "JVRMME1XQVKFZT5W4KHGNFHQ17",
                    "message": "Run!"
                },
                "media": [],
                "created_at": "2026-02-15T02:34:02.000000Z",
                "updated_at": "2026-02-19T14:34:36.000000Z",
                "outgoing_edges_count": 1,
                "incoming_edges_count": 1,
                "is_locked": false,
                "locked_by": null,
                "locked_at": null
            },
            {
                "node_id": "D1J0J8C1WQK3673W9YQR9ZSGMQ",
                "project_id": "01KHFBZSS300011X6EQ7H267R2",
                "type": "dialog-entry",
                "label": "A little left!",
                "content": {
                    "speaker": "JVRMME1XQVKFZT5W4KHGNFHQ17",
                    "message": "A little left!"
                },
                "media": [],
                "created_at": "2026-02-15T02:54:05.000000Z",
                "updated_at": "2026-02-19T14:03:59.000000Z",
                "outgoing_edges_count": 1,
                "incoming_edges_count": 1,
                "is_locked": false,
                "locked_by": null,
                "locked_at": null
            },
            {
                "node_id": "V4TE0HWAB311WD64HBFDASKC3G",
                "project_id": "01KHFBZSS300011X6EQ7H267R2",
                "type": "dialog-entry",
                "label": "Yes!",
                "content": {
                    "speaker": "YM17E03PC6FY6FKGKV9V5QH792",
                    "message": "Yes!"
                },
                "media": [],
                "created_at": "2026-02-18T03:08:23.000000Z",
                "updated_at": "2026-02-19T14:34:45.000000Z",
                "outgoing_edges_count": 0,
                "incoming_edges_count": 1,
                "is_locked": false,
                "locked_by": null,
                "locked_at": null
            },
            {
                "node_id": "FVX1ECBDPZCWG3ZG6BFDY7PN3C",
                "project_id": "01KHFBZSS300011X6EQ7H267R2",
                "type": "dialog-entry",
                "label": "E2E: lokaler Pruefknoten (Thea 13.09.2026)",
                "content": {
                    "speaker": "JVRMME1XQVKFZT5W4KHGNFHQ17",
                    "message": "E2E: lokaler Pruefknoten (Thea 13.09.2026)"
                },
                "media": [],
                "created_at": "2026-09-13T03:48:15.000000Z",
                "updated_at": "2026-09-13T03:48:15.000000Z",
                "outgoing_edges_count": 0,
                "incoming_edges_count": 0,
                "is_locked": false,
                "locked_by": null,
                "locked_at": null
            }
        ],
        "pagination": {
            "current_page": 1,
            "total_pages": 1,
            "per_page": 20,
            "total_items": 20,
            "page": 1
        }
    }
}

{
    "method": "GET",
    "url": "http://localhost:8000/api/nodes",
    "headers": {
        "Authorization": [
            "***REDACTED***"
        ],
        "Accept": "application/json",
        "Content-Type": "application/json"
    },
    "payload": {
        "query": {
            "project_id": "01KHFBZSS300011X6EQ7H267R2"
        }
    },
    "recorded_at": "2026-09-13T19:37:58+00:00"
}

// TellsTree SDK - Nodes API (JavaScript)  
// Get specific node details

const API_BASE_URL = 'https://tellstree.com/api';
const API_TOKEN = 'your_jwt_token_here';

/**
 * Get a specific node by ID
 * @param {number} nodeId - The ID of the node to retrieve
 * @returns {Promise<Object>} API response with node data
 */
async function getNode(nodeId) {
    try {
        const response = await fetch(`${API_BASE_URL}/nodes/${nodeId}`, {
            method: 'GET',
            headers: {
                'Accept': 'application/json',
                'Content-Type': 'application/json',
                'Authorization': `Bearer ${API_TOKEN}`
            }
        });

        if (!response.ok) {
            throw new Error(`HTTP ${response.status}: ${response.statusText}`);
        }

        const data = await response.json();
        return data;
    } catch (error) {
        console.error('Error fetching node:', error);
        throw error;
    }
}

/**
 * Create a new node in a project
 * @param {Object} nodeData - The node data to create
 * @returns {Promise<Object>} API response with created node
 */
async function createNode(nodeData) {
    try {
        const response = await fetch(`${API_BASE_URL}/nodes`, {
            method: 'POST',
            headers: {
                'Accept': 'application/json',
                'Content-Type': 'application/json',
                'Authorization': `Bearer ${API_TOKEN}`
            },
            body: JSON.stringify(nodeData)
        });

        if (!response.ok) {
            throw new Error(`HTTP ${response.status}: ${response.statusText}`);
        }

        const data = await response.json();
        return data;
    } catch (error) {
        console.error('Error creating node:', error);
        throw error;
    }
}

// Example usage (only runs when executed directly)
if (typeof require !== 'undefined' && require.main === module) {
    // Example: Get node with ID 1
    getNode(1)
        .then(result => {
            console.log('Node Details:');
            console.log(JSON.stringify(result, null, 2));
        })
        .catch(error => {
            console.error('Failed to fetch node:', error.message);
        });

    // Example: Create a new node
    const newNode = {
        project_id: 1,
        title: "New Story Node",
        content: "This is the content of the new node.",
        type: "dialogue",
        position_x: 100,
        position_y: 200
    };

    createNode(newNode)
        .then(result => {
            console.log('Created Node:');
            console.log(JSON.stringify(result, null, 2));
        })
        .catch(error => {
            console.error('Failed to create node:', error.message);
        });
}

// Export for use in other modules
if (typeof module !== 'undefined' && module.exports) {
    module.exports = { getNode, createNode };
}

"""
TellsTree SDK - Nodes API (Python)
Get specific node details and create new nodes
"""

import requests
import json
from typing import Dict, Any, Optional

API_BASE_URL = "https://tellstree.com/api"
API_TOKEN = "your_jwt_token_here"

def get_node(node_id: int) -> Dict[str, Any]:
    """
    Get a specific node by ID
    
    Args:
        node_id (int): The ID of the node to retrieve
        
    Returns:
        Dict[str, Any]: API response with node data
        
    Raises:
        requests.RequestException: If the API request fails
        ValueError: If the response cannot be parsed as JSON
    """
    try:
        url = f"{API_BASE_URL}/nodes/{node_id}"
        
        headers = {
            'Accept': 'application/json',
            'Content-Type': 'application/json',
            'Authorization': f'Bearer {API_TOKEN}'
        }
        
        response = requests.get(url, headers=headers)
        response.raise_for_status()
        
        return response.json()
        
    except requests.RequestException as e:
        print(f"Error fetching node: {e}")
        raise
    except json.JSONDecodeError as e:
        print(f"Error parsing JSON response: {e}")
        raise ValueError("Invalid JSON response from API")

def create_node(node_data: Dict[str, Any]) -> Dict[str, Any]:
    """
    Create a new node in a project
    
    Args:
        node_data (Dict[str, Any]): The node data to create
        
    Returns:
        Dict[str, Any]: API response with created node
        
    Raises:
        requests.RequestException: If the API request fails
        ValueError: If the response cannot be parsed as JSON
    """
    try:
        url = f"{API_BASE_URL}/nodes"
        
        headers = {
            'Accept': 'application/json',
            'Content-Type': 'application/json',
            'Authorization': f'Bearer {API_TOKEN}'
        }
        
        response = requests.post(url, headers=headers, json=node_data)
        response.raise_for_status()
        
        return response.json()
        
    except requests.RequestException as e:
        print(f"Error creating node: {e}")
        raise
    except json.JSONDecodeError as e:
        print(f"Error parsing JSON response: {e}")
        raise ValueError("Invalid JSON response from API")

def main():
    """Example usage of the nodes API"""
    try:
        # Get node with ID 1
        result = get_node(1)
        print("Node Details:")
        print(json.dumps(result, indent=2))
        
        # Create a new node
        new_node = {
            "project_id": 1,
            "title": "New Story Node",
            "content": "This is the content of the new node.",
            "type": "dialogue",
            "position_x": 100,
            "position_y": 200
        }
        
        created_node = create_node(new_node)
        print("\nCreated Node:")
        print(json.dumps(created_node, indent=2))
        
    except Exception as e:
        print(f"Failed to process nodes: {e}")

if __name__ == "__main__":
    main()

<?php
/**
 * TellsTree SDK - Nodes API (PHP)
 * Get specific node details and create new nodes
 */

const API_BASE_URL = 'https://tellstree.com/api';
const API_TOKEN = 'your_jwt_token_here';

/**
 * Get a specific node by ID
 * 
 * @param int $nodeId The ID of the node to retrieve
 * @return array API response with node data
 * @throws Exception If the API request fails
 */
function getNode($nodeId) {
    $url = API_BASE_URL . "/nodes/{$nodeId}";
    
    $context = stream_context_create([
        'http' => [
            'method' => 'GET',
            'header' => [
                'Accept: application/json',
                'Content-Type: application/json',
                'Authorization: Bearer ' . API_TOKEN
            ],
            'ignore_errors' => true
        ]
    ]);
    
    $response = file_get_contents($url, false, $context);
    
    if ($response === false) {
        throw new Exception('Failed to make API request');
    }
    
    // Get HTTP status code
    $statusLine = $http_response_header[0] ?? '';
    preg_match('/\d{3}/', $statusLine, $matches);
    $statusCode = $matches[0] ?? 0;
    
    if ($statusCode >= 400) {
        $errorData = json_decode($response, true);
        $message = $errorData['message'] ?? 'HTTP Error ' . $statusCode;
        throw new Exception($message, (int)$statusCode);
    }
    
    $data = json_decode($response, true);
    
    if (json_last_error() !== JSON_ERROR_NONE) {
        throw new Exception('Invalid JSON response: ' . json_last_error_msg());
    }
    
    return $data;
}

/**
 * Create a new node in a project
 * 
 * @param array $nodeData The node data to create
 * @return array API response with created node
 * @throws Exception If the API request fails
 */
function createNode($nodeData) {
    $url = API_BASE_URL . "/nodes";
    $jsonData = json_encode($nodeData);
    
    $context = stream_context_create([
        'http' => [
            'method' => 'POST',
            'header' => [
                'Accept: application/json',
                'Content-Type: application/json',
                'Authorization: Bearer ' . API_TOKEN,
                'Content-Length: ' . strlen($jsonData)
            ],
            'content' => $jsonData,
            'ignore_errors' => true
        ]
    ]);
    
    $response = file_get_contents($url, false, $context);
    
    if ($response === false) {
        throw new Exception('Failed to make API request');
    }
    
    // Get HTTP status code
    $statusLine = $http_response_header[0] ?? '';
    preg_match('/\d{3}/', $statusLine, $matches);
    $statusCode = $matches[0] ?? 0;
    
    if ($statusCode >= 400) {
        $errorData = json_decode($response, true);
        $message = $errorData['message'] ?? 'HTTP Error ' . $statusCode;
        throw new Exception($message, (int)$statusCode);
    }
    
    $data = json_decode($response, true);
    
    if (json_last_error() !== JSON_ERROR_NONE) {
        throw new Exception('Invalid JSON response: ' . json_last_error_msg());
    }
    
    return $data;
}

// Example usage (only runs when executed directly)
if (basename(__FILE__) === basename($_SERVER['SCRIPT_FILENAME'])) {
    try {
        // Get node with ID 1
        $result = getNode(1);
        echo "Node Details:\n";
        echo json_encode($result, JSON_PRETTY_PRINT) . "\n";
        
        // Create a new node
        $newNode = [
            'project_id' => 1,
            'title' => 'New Story Node',
            'content' => 'This is the content of the new node.',
            'type' => 'dialogue',
            'position_x' => 100,
            'position_y' => 200
        ];
        
        $createdNode = createNode($newNode);
        echo "\nCreated Node:\n";
        echo json_encode($createdNode, JSON_PRETTY_PRINT) . "\n";
        
    } catch (Exception $e) {
        echo "Failed to process nodes: " . $e->getMessage() . "\n";
        exit(1);
    }
}
?>

curl -X GET "https://tellstree.com/api/nodes/1" \
     -H "Authorization: Bearer your-jwt-token" \
     -H "Accept: application/json"

Update Node

Update an existing node's content, position, properties, or other attributes.

🔒 Lock Management

Lock/unlock functionality is integrated into the update endpoint:

• is_locked: true - Lock node for current user
• is_locked: false - Unlock node (only by lock owner)
• Response includes is_locked: true/false
• Auto-unlock: Locks expire automatically after 300 seconds when node is accessed

Updatable Fields

title - Node title
content - Node content
type - Node type
position_x - X coordinate
position_y - Y coordinate
properties - Custom properties
locked_by - Lock status (user_id or null)

Response

200 Success / Node updated

422 Invalid data / Validation failed

404 Node not found

403 Forbidden / No permission

PUThttps://tellstree.com/api/nodes/{node}

{
    "data": {
        "node": {
            "node_id": "XTA5WRKZ83SPYBV358ZM3W8DWN",
            "project_id": "64EVPGQQB6G9GNA954F6SECPN6",
            "type": "character",
            "label": "Updated API Test Character",
            "content": {
                "name": "Updated API Test Character",
                "description": "Node created by automated API test"
            },
            "media": [],
            "created_at": "2026-09-13T19:37:57.000000Z",
            "updated_at": "2026-09-13T19:37:58.000000Z",
            "outgoing_edges_count": 0,
            "incoming_edges_count": 0,
            "is_locked": true,
            "locked_by": "01KHF8MP96QY9KMPXF67Z5ZE3R",
            "locked_at": "2026-09-13 19:37:58"
        }
    }
}

{
    "method": "PUT",
    "url": "http://localhost:8000/api/nodes/XTA5WRKZ83SPYBV358ZM3W8DWN",
    "headers": {
        "Authorization": [
            "***REDACTED***"
        ],
        "Accept": "application/json",
        "Content-Type": "application/json"
    },
    "payload": {
        "type": "character",
        "content": {
            "name": "Updated API Test Character"
        },
        "is_locked": true,
        "project_id": "64EVPGQQB6G9GNA954F6SECPN6"
    },
    "recorded_at": "2026-09-13T19:37:58+00:00"
}

// TellsTree SDK - Nodes API (JavaScript)
// Update an existing node

const API_BASE_URL = 'https://tellstree.com/api';
const API_TOKEN = 'your_jwt_token_here';

/**
 * Update an existing node
 * @param {number} nodeId - The ID of the node to update
 * @param {Object} updateData - The update data
 * @param {string} updateData.type - Node type (required)
 * @param {Object} [updateData.content] - Updated content object
 * @param {string} [updateData.label] - Updated label/title
 * @param {Array} [updateData.media] - Updated media array
 * @param {boolean} [updateData.is_locked] - Lock state (true to lock, false to unlock)
 * @returns {Promise<Object>} API response with updated node data
 */
async function updateNode(nodeId, updateData) {
    try {
        const response = await fetch(`${API_BASE_URL}/nodes/${nodeId}`, {
            method: 'PUT',
            headers: {
                'Accept': 'application/json',
                'Content-Type': 'application/json',
                'Authorization': `Bearer ${API_TOKEN}`
            },
            body: JSON.stringify(updateData)
        });

        if (!response.ok) {
            throw new Error(`HTTP ${response.status}: ${response.statusText}`);
        }

        const data = await response.json();
        return data;

    } catch (error) {
        console.error('Error updating node:', error);
        throw error;
    }
}

// Example usage
const nodeId = 1; // Replace with actual node ID
const updateData = {
    type: 'character', // Required field
    content: {
        name: 'Updated Character Name',
        description: 'Updated character description'
    },
    is_locked: true // Optional: Lock for current user, or false to unlock
};

updateNode(nodeId, updateData)
    .then(result => {
        console.log('Node updated successfully:', result.data.node);
    })
    .catch(error => {
        console.error('Failed to update node:', error);
    });

# TellsTree SDK - Nodes API (Python)
# Update an existing node

import requests
import json

API_BASE_URL = 'https://tellstree.com/api'
API_TOKEN = 'your_jwt_token_here'

def update_node(node_id, update_data):
    """
    Update an existing node
    
    Args:
        node_id (int): The ID of the node to update
        update_data (dict): The update data
            - type (str): Node type (required)
            - content (dict, optional): Updated content object
            - label (str, optional): Updated label/title
            - media (list, optional): Updated media array
    
    Returns:
        dict: API response with updated node data
    """
    try:
        headers = {
            'Accept': 'application/json',
            'Content-Type': 'application/json',
            'Authorization': f'Bearer {API_TOKEN}'
        }
        
        response = requests.put(
            f'{API_BASE_URL}/nodes/{node_id}',
            headers=headers,
            json=update_data,
            timeout=30
        )
        
        response.raise_for_status()
        return response.json()
        
    except requests.exceptions.RequestException as e:
        print(f'Error updating node: {e}')
        raise e

# Example usage
if __name__ == '__main__':
    node_id = 1  # Replace with actual node ID
    update_data = {
        'type': 'character',  # Required field
        'content': {
            'name': 'Updated Character Name',
            'description': 'Updated character description'
        }
    }
    
    try:
        result = update_node(node_id, update_data)
        print('Node updated successfully:', result['data']['node'])
    except Exception as error:
        print('Failed to update node:', error)

<?php
/**
 * TellsTree SDK - Nodes API (PHP)
 * Update an existing node
 */

const API_BASE_URL = 'https://tellstree.com/api';
const API_TOKEN = 'your_jwt_token_here';

/**
 * Update an existing node
 * 
 * @param int $nodeId The ID of the node to update
 * @param array $updateData The update data
 *                          - type (string): Node type (required)
 *                          - content (array, optional): Updated content object
 *                          - label (string, optional): Updated label/title
 *                          - media (array, optional): Updated media array
 *                          - is_locked (bool, optional): Lock state (true to lock, false to unlock)
 * @return array API response with updated node data
 * @throws Exception If the request fails
 */
function updateNode($nodeId, $updateData) {
    $url = API_BASE_URL . '/nodes/' . $nodeId;
    
    $headers = [
        'Accept: application/json',
        'Content-Type: application/json',
        'Authorization: Bearer ' . API_TOKEN
    ];
    
    $context = stream_context_create([
        'http' => [
            'method' => 'PUT',
            'header' => implode("\r\n", $headers),
            'content' => json_encode($updateData)
        ]
    ]);
    
    $response = file_get_contents($url, false, $context);
    
    if ($response === false) {
        throw new Exception('Failed to update node: Unable to connect to API');
    }
    
    $data = json_decode($response, true);
    
    if (json_last_error() !== JSON_ERROR_NONE) {
        throw new Exception('Failed to decode JSON response: ' . json_last_error_msg());
    }
    
    return $data;
}

// Example usage
try {
    $nodeId = 1; // Replace with actual node ID
    $updateData = [
        'type' => 'character', // Required field
        'content' => [
            'name' => 'Updated Character Name',
            'description' => 'Updated character description'
        ],
        'is_locked' => true // Optional: Lock for current user, or false to unlock
    ];
    
    $result = updateNode($nodeId, $updateData);
    echo "Node updated successfully:\n";
    print_r($result['data']['node']);
    
} catch (Exception $error) {
    echo "Failed to update node: " . $error->getMessage() . "\n";
}
?>

#!/bin/bash

# TellsTree SDK - Nodes API (cURL)
# Update an existing node

API_BASE_URL="https://tellstree.com/api"
API_TOKEN="your_jwt_token_here"
NODE_ID="1" # Replace with actual node ID

# Update an existing node
curl -X PUT "${API_BASE_URL}/nodes/${NODE_ID}" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ${API_TOKEN}" \
  -d '{
    "type": "character",
    "content": {
      "name": "Updated Character Name",
      "description": "Updated character description"
    }
  }'

Delete Node

Permanently delete a node from the project. This will also remove all connected edges.

Response

204 Success / No Content

404 Node not found

403 Forbidden / No permission

DELETEhttps://tellstree.com/api/nodes/{node}

{
    "method": "DELETE",
    "url": "http://localhost:8000/api/nodes/XTA5WRKZ83SPYBV358ZM3W8DWN",
    "headers": {
        "Authorization": [
            "***REDACTED***"
        ],
        "Accept": "application/json",
        "Content-Type": "application/json"
    },
    "payload": null,
    "recorded_at": "2026-09-13T19:37:58+00:00"
}

// TellsTree SDK - Nodes API (JavaScript)
// Delete a node

const API_BASE_URL = 'https://tellstree.com/api';
const API_TOKEN = 'your_jwt_token_here';

/**
 * Delete a node permanently
 * @param {number} nodeId - The ID of the node to delete
 * @returns {Promise<boolean>} True if deletion was successful
 */
async function deleteNode(nodeId) {
    try {
        const response = await fetch(`${API_BASE_URL}/nodes/${nodeId}`, {
            method: 'DELETE',
            headers: {
                'Accept': 'application/json',
                'Content-Type': 'application/json',
                'Authorization': `Bearer ${API_TOKEN}`
            }
        });

        if (response.status === 204) {
            return true; // Successfully deleted (No Content)
        } else if (!response.ok) {
            throw new Error(`HTTP ${response.status}: ${response.statusText}`);
        }

        return true;

    } catch (error) {
        console.error('Error deleting node:', error);
        throw error;
    }
}

// Example usage
const nodeId = 1; // Replace with actual node ID

deleteNode(nodeId)
    .then(success => {
        if (success) {
            console.log('Node deleted successfully');
        }
    })
    .catch(error => {
        console.error('Failed to delete node:', error);
    });

# TellsTree SDK - Nodes API (Python)
# Delete a node

import requests

API_BASE_URL = 'https://tellstree.com/api'
API_TOKEN = 'your_jwt_token_here'

def delete_node(node_id):
    """
    Delete a node permanently
    
    Args:
        node_id (int): The ID of the node to delete
    
    Returns:
        bool: True if deletion was successful
    """
    try:
        headers = {
            'Accept': 'application/json',
            'Content-Type': 'application/json',
            'Authorization': f'Bearer {API_TOKEN}'
        }
        
        response = requests.delete(
            f'{API_BASE_URL}/nodes/{node_id}',
            headers=headers,
            timeout=30
        )
        
        if response.status_code == 204:
            return True  # Successfully deleted (No Content)
        else:
            response.raise_for_status()
            return True
        
    except requests.exceptions.RequestException as e:
        print(f'Error deleting node: {e}')
        raise e

# Example usage
if __name__ == '__main__':
    node_id = 1  # Replace with actual node ID
    
    try:
        success = delete_node(node_id)
        if success:
            print('Node deleted successfully')
    except Exception as error:
        print('Failed to delete node:', error)

<?php
$projectId = 42;
$nodeId = 123;
$token = "your-auth-token";

$context = stream_context_create([
    "http" => [
        "method" => "DELETE",
        "header" => [
            "Authorization: Bearer $token",
            "Accept: application/json"
        ]
    ]
]);

$response = file_get_contents(
    "https://tellstree.com/api/projects/$projectId/nodes/$nodeId",
    false,
    $context
);

$result = json_decode($response);
var_dump($result);
?>

curl -X DELETE "https://tellstree.com/api/projects/42/nodes/123" \
     -H "Authorization: Bearer your-auth-token" \
     -H "Accept: application/json"

?? Edges

Edges create connections between nodes, defining the flow and relationships in your interactive stories. They represent transitions, choices, and narrative pathways.

GET /api/edges List all edges

POST /api/edges Create new edge

GET /api/edges/{edge} Get edge details

PUT /api/edges/{edge} Update edge

DELETE /api/edges/{edge} Delete edge

Create Edge

Create a new edge connection between two nodes in a project.

Required Fields

source_node_id - ID of source node
target_node_id - ID of target node

Optional Fields

label - Display text for edge
condition - Edge activation condition

Response

201 Created / Edge created

422 Invalid data / Validation failed

404 Source/target node not found

POSThttps://tellstree.com/api/edges

{
    "data": {
        "edge": {
            "edge_id": "6EKQKTMPWTDECFB5T85THMZHRK",
            "project_id": "3VXKJBDTYV0GDB8GN1WXTQV73X",
            "from_node_id": "YQZJ5HYCH15WZVGYJC636QA14S",
            "to_node_id": "J69H73NPTMDC8N9P9XMSRQQWGF",
            "type": "connection",
            "label": null,
            "description": null,
            "condition": null,
            "created_at": "2026-09-13T19:37:53.000000Z",
            "updated_at": "2026-09-13T19:37:53.000000Z",
            "from_node": {
                "node_id": "YQZJ5HYCH15WZVGYJC636QA14S",
                "type": "character",
                "label": "Edge API Node 1789328273"
            },
            "to_node": {
                "node_id": "J69H73NPTMDC8N9P9XMSRQQWGF",
                "type": "character",
                "label": "Edge API Node 2 1789328273"
            },
            "is_locked": false
        }
    }
}

{
    "method": "POST",
    "url": "http://localhost:8000/api/edges",
    "headers": {
        "Authorization": [
            "***REDACTED***"
        ],
        "Accept": "application/json",
        "Content-Type": "application/json"
    },
    "payload": {
        "from_node_id": "YQZJ5HYCH15WZVGYJC636QA14S",
        "to_node_id": "J69H73NPTMDC8N9P9XMSRQQWGF",
        "type": "connection",
        "condition": null,
        "project_id": "3VXKJBDTYV0GDB8GN1WXTQV73X"
    },
    "recorded_at": "2026-09-13T19:37:53+00:00"
}

// TellsTree SDK - Edges API (JavaScript)
// Create a new edge connection between nodes

const API_BASE_URL = 'https://tellstree.com/api';
const API_TOKEN = 'your_jwt_token_here';

/**
 * Create a new edge connection between two nodes
 * @param {Object} edgeData - The edge data
 * @param {number} edgeData.from_node_id - ID of the source node
 * @param {number} edgeData.to_node_id - ID of the target node
 * @param {string} [edgeData.type] - Edge type (e.g., 'connection')
 * @param {string} [edgeData.condition] - Edge activation condition
 * @param {number} [edgeData.project_id] - Optional project ID to associate with
 * @returns {Promise<Object>} API response with created edge data
 */
async function createEdge(edgeData) {
    try {
        const response = await fetch(`${API_BASE_URL}/edges`, {
            method: 'POST',
            headers: {
                'Accept': 'application/json',
                'Content-Type': 'application/json',
                'Authorization': `Bearer ${API_TOKEN}`
            },
            body: JSON.stringify(edgeData)
        });

        if (!response.ok) {
            throw new Error(`HTTP ${response.status}: ${response.statusText}`);
        }

        const data = await response.json();
        return data;

    } catch (error) {
        console.error('Error creating edge:', error);
        throw error;
    }
}

// Example usage
const newEdgeData = {
    from_node_id: 1,
    to_node_id: 2,
    type: 'connection',
    condition: null,
    project_id: 1 // Optional
};

createEdge(newEdgeData)
    .then(result => {
        console.log('Edge created successfully:', result.data.edge);
    })
    .catch(error => {
        console.error('Failed to create edge:', error);
    });

# TellsTree SDK - Edges API (Python)
# Create a new edge connection between nodes

import requests
import json

API_BASE_URL = 'https://tellstree.com/api'
API_TOKEN = 'your_jwt_token_here'

def create_edge(edge_data):
    """
    Create a new edge connection between two nodes
    
    Args:
        edge_data (dict): The edge data
            - from_node_id (int): ID of the source node
            - to_node_id (int): ID of the target node
            - type (str, optional): Edge type (e.g., 'connection')
            - condition (str, optional): Edge activation condition
            - project_id (int, optional): Optional project ID to associate with
    
    Returns:
        dict: API response with created edge data
    """
    try:
        headers = {
            'Accept': 'application/json',
            'Content-Type': 'application/json',
            'Authorization': f'Bearer {API_TOKEN}'
        }
        
        response = requests.post(
            f'{API_BASE_URL}/edges',
            headers=headers,
            json=edge_data,
            timeout=30
        )
        
        response.raise_for_status()
        return response.json()
        
    except requests.exceptions.RequestException as e:
        print(f'Error creating edge: {e}')
        raise e

# Example usage
if __name__ == '__main__':
    new_edge_data = {
        'from_node_id': 1,
        'to_node_id': 2,
        'type': 'connection',
        'condition': None,
        'project_id': 1  # Optional
    }
    
    try:
        result = create_edge(new_edge_data)
        print('Edge created successfully:', result['data']['edge'])
    except Exception as error:
        print('Failed to create edge:', error)

<?php
/**
 * TellsTree SDK - Edges API (PHP)
 * Create a new edge connection between nodes
 */

const API_BASE_URL = 'https://tellstree.com/api';
const API_TOKEN = 'your_jwt_token_here';

/**
 * Create a new edge connection between two nodes
 * 
 * @param array $edgeData The edge data
 *                        - from_node_id (int): ID of the source node
 *                        - to_node_id (int): ID of the target node
 *                        - type (string, optional): Edge type (e.g., 'connection')
 *                        - condition (string, optional): Edge activation condition
 *                        - project_id (int, optional): Optional project ID to associate with
 * @return array API response with created edge data
 * @throws Exception If the request fails
 */
function createEdge($edgeData) {
    $url = API_BASE_URL . '/edges';
    
    $headers = [
        'Accept: application/json',
        'Content-Type: application/json',
        'Authorization: Bearer ' . API_TOKEN
    ];
    
    $context = stream_context_create([
        'http' => [
            'method' => 'POST',
            'header' => implode("\r\n", $headers),
            'content' => json_encode($edgeData)
        ]
    ]);
    
    $response = file_get_contents($url, false, $context);
    
    if ($response === false) {
        throw new Exception('Failed to create edge: Unable to connect to API');
    }
    
    $data = json_decode($response, true);
    
    if (json_last_error() !== JSON_ERROR_NONE) {
        throw new Exception('Failed to decode JSON response: ' . json_last_error_msg());
    }
    
    return $data;
}

// Example usage
try {
    $newEdgeData = [
        'from_node_id' => 1,
        'to_node_id' => 2,
        'type' => 'connection',
        'condition' => null,
        'project_id' => 1 // Optional
    ];
    
    $result = createEdge($newEdgeData);
    echo "Edge created successfully:\n";
    print_r($result['data']['edge']);
    
} catch (Exception $error) {
    echo "Failed to create edge: " . $error->getMessage() . "\n";
}
?>

#!/bin/bash

# TellsTree SDK - Edges API (cURL)
# Create a new edge connection between nodes

API_BASE_URL="https://tellstree.com/api"
API_TOKEN="your_jwt_token_here"

# Create a new edge
curl -X POST "${API_BASE_URL}/edges" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ${API_TOKEN}" \
  -d '{
    "from_node_id": 1,
    "to_node_id": 2,
    "type": "connection",
    "condition": null,
    "project_id": 1
  }'

Get Edge

Retrieve detailed information about a specific edge, including source and target node details.

URL Parameters

project - Project ID
edge - Edge ID

Response

200 Success / Edge details

404 Edge not found

403 Forbidden / No access

GEThttps://tellstree.com/api/edges/{edge}

{
    "data": {
        "edge": {
            "edge_id": "6EKQKTMPWTDECFB5T85THMZHRK",
            "project_id": "3VXKJBDTYV0GDB8GN1WXTQV73X",
            "from_node_id": "YQZJ5HYCH15WZVGYJC636QA14S",
            "to_node_id": "J69H73NPTMDC8N9P9XMSRQQWGF",
            "type": "connection",
            "label": null,
            "description": null,
            "condition": null,
            "created_at": "2026-09-13T19:37:53.000000Z",
            "updated_at": "2026-09-13T19:37:53.000000Z",
            "from_node": {
                "node_id": "YQZJ5HYCH15WZVGYJC636QA14S",
                "type": "character",
                "label": "Edge API Node 1789328273"
            },
            "to_node": {
                "node_id": "J69H73NPTMDC8N9P9XMSRQQWGF",
                "type": "character",
                "label": "Edge API Node 2 1789328273"
            },
            "is_locked": false
        }
    }
}

{
    "method": "GET",
    "url": "http://localhost:8000/api/edges/6EKQKTMPWTDECFB5T85THMZHRK",
    "headers": {
        "Authorization": [
            "***REDACTED***"
        ],
        "Accept": "application/json",
        "Content-Type": "application/json"
    },
    "payload": null,
    "recorded_at": "2026-09-13T19:37:53+00:00"
}

// TellsTree SDK - Edges API (JavaScript)
// Read/Get an edge

const API_BASE_URL = 'https://tellstree.com/api';
const API_TOKEN = 'your_jwt_token_here';

/**
 * Get detailed information about a specific edge
 * @param {number} edgeId - The ID of the edge to retrieve
 * @returns {Promise<Object>} API response with edge data
 */
async function getEdge(edgeId) {
    try {
        const response = await fetch(`${API_BASE_URL}/edges/${edgeId}`, {
            method: 'GET',
            headers: {
                'Accept': 'application/json',
                'Authorization': `Bearer ${API_TOKEN}`
            }
        });

        if (!response.ok) {
            throw new Error(`HTTP ${response.status}: ${response.statusText}`);
        }

        const data = await response.json();
        return data;

    } catch (error) {
        console.error('Error fetching edge:', error);
        throw error;
    }
}

// Example usage
const edgeId = 1; // Replace with actual edge ID

getEdge(edgeId)
    .then(result => {
        console.log('Edge details:', result.data.edge);
    })
    .catch(error => {
        console.error('Failed to fetch edge:', error);
    });

# TellsTree SDK - Edges API (Python)
# Read/Get an edge

import requests

API_BASE_URL = 'https://tellstree.com/api'
API_TOKEN = 'your_jwt_token_here'

def get_edge(edge_id):
    """
    Get detailed information about a specific edge
    
    Args:
        edge_id (int): The ID of the edge to retrieve
    
    Returns:
        dict: API response with edge data
    """
    try:
        headers = {
            'Accept': 'application/json',
            'Authorization': f'Bearer {API_TOKEN}'
        }
        
        response = requests.get(
            f'{API_BASE_URL}/edges/{edge_id}',
            headers=headers,
            timeout=30
        )
        
        response.raise_for_status()
        return response.json()
        
    except requests.exceptions.RequestException as e:
        print(f'Error fetching edge: {e}')
        raise e

# Example usage
if __name__ == '__main__':
    edge_id = 1  # Replace with actual edge ID
    
    try:
        result = get_edge(edge_id)
        print('Edge details:', result['data']['edge'])
    except Exception as error:
        print('Failed to fetch edge:', error)

<?php
/**
 * TellsTree SDK - Edges API (PHP)
 * Read/Get an edge
 */

const API_BASE_URL = 'https://tellstree.com/api';
const API_TOKEN = 'your_jwt_token_here';

/**
 * Get detailed information about a specific edge
 * 
 * @param int $edgeId The ID of the edge to retrieve
 * @return array API response with edge data
 * @throws Exception If the request fails
 */
function getEdge($edgeId) {
    $url = API_BASE_URL . '/edges/' . $edgeId;
    
    $headers = [
        'Accept: application/json',
        'Authorization: Bearer ' . API_TOKEN
    ];
    
    $context = stream_context_create([
        'http' => [
            'method' => 'GET',
            'header' => implode("\r\n", $headers)
        ]
    ]);
    
    $response = file_get_contents($url, false, $context);
    
    if ($response === false) {
        throw new Exception('Failed to fetch edge: Unable to connect to API');
    }
    
    $data = json_decode($response, true);
    
    if (json_last_error() !== JSON_ERROR_NONE) {
        throw new Exception('Failed to decode JSON response: ' . json_last_error_msg());
    }
    
    return $data;
}

// Example usage
try {
    $edgeId = 1; // Replace with actual edge ID
    
    $result = getEdge($edgeId);
    echo "Edge details:\n";
    print_r($result['data']['edge']);
    
} catch (Exception $error) {
    echo "Failed to fetch edge: " . $error->getMessage() . "\n";
}
?>

#!/bin/bash

# TellsTree SDK - Edges API (cURL)
# Read/Get an edge

API_BASE_URL="https://tellstree.com/api"
API_TOKEN="your_jwt_token_here"
EDGE_ID="1" # Replace with actual edge ID

# Get edge details
curl -X GET "${API_BASE_URL}/edges/${EDGE_ID}" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer ${API_TOKEN}"

Update Edge

Update properties of an existing edge. You can modify the label, condition, and connection endpoints.

🔒 Lock Management

Lock/unlock functionality is integrated into the update endpoint:

• is_locked: true - Lock edge for current user
• is_locked: false - Unlock edge (only by lock owner)
• Response includes is_locked: true/false
• Auto-unlock: Locks expire automatically after 300 seconds when edge is accessed

Request Body

source_node_id - Source node ID
target_node_id - Target node ID
label - Edge display label
condition - Edge condition
locked_by - Lock status (internal use only)

Response

200 Success / Edge updated

422 Invalid data / Validation failed

404 Edge not found

403 Forbidden / No permission

PUThttps://tellstree.com/api/edges/{edge}

{
    "data": {
        "edge": {
            "edge_id": "6EKQKTMPWTDECFB5T85THMZHRK",
            "project_id": "3VXKJBDTYV0GDB8GN1WXTQV73X",
            "from_node_id": "YQZJ5HYCH15WZVGYJC636QA14S",
            "to_node_id": "J69H73NPTMDC8N9P9XMSRQQWGF",
            "type": "connection",
            "label": null,
            "description": null,
            "condition": "updated condition",
            "created_at": "2026-09-13T19:37:53.000000Z",
            "updated_at": "2026-09-13T19:37:53.000000Z",
            "from_node": {
                "node_id": "YQZJ5HYCH15WZVGYJC636QA14S",
                "type": "character",
                "label": "Edge API Node 1789328273"
            },
            "to_node": {
                "node_id": "J69H73NPTMDC8N9P9XMSRQQWGF",
                "type": "character",
                "label": "Edge API Node 2 1789328273"
            },
            "is_locked": true
        }
    }
}

{
    "method": "PUT",
    "url": "http://localhost:8000/api/edges/6EKQKTMPWTDECFB5T85THMZHRK",
    "headers": {
        "Authorization": [
            "***REDACTED***"
        ],
        "Accept": "application/json",
        "Content-Type": "application/json"
    },
    "payload": {
        "from_node_id": "YQZJ5HYCH15WZVGYJC636QA14S",
        "to_node_id": "J69H73NPTMDC8N9P9XMSRQQWGF",
        "type": "connection",
        "condition": "updated condition",
        "is_locked": true
    },
    "recorded_at": "2026-09-13T19:37:53+00:00"
}

// TellsTree SDK - Edges API (JavaScript)
// Update an existing edge

const API_BASE_URL = 'https://tellstree.com/api';
const API_TOKEN = 'your_jwt_token_here';

/**
 * Update an existing edge
 * @param {number} edgeId - The ID of the edge to update
 * @param {Object} updateData - The update data
 * @param {number} updateData.from_node_id - ID of the source node
 * @param {number} updateData.to_node_id - ID of the target node
 * @param {string} [updateData.type] - Edge type
 * @param {string} [updateData.condition] - Edge activation condition
 * @param {boolean} [updateData.is_locked] - Lock state (true to lock, false to unlock)
 * @returns {Promise<Object>} API response with updated edge data
 */
async function updateEdge(edgeId, updateData) {
    try {
        const response = await fetch(`${API_BASE_URL}/edges/${edgeId}`, {
            method: 'PUT',
            headers: {
                'Accept': 'application/json',
                'Content-Type': 'application/json',
                'Authorization': `Bearer ${API_TOKEN}`
            },
            body: JSON.stringify(updateData)
        });

        if (!response.ok) {
            throw new Error(`HTTP ${response.status}: ${response.statusText}`);
        }

        const data = await response.json();
        return data;

    } catch (error) {
        console.error('Error updating edge:', error);
        throw error;
    }
}

// Example usage
const edgeId = 1; // Replace with actual edge ID
const updateData = {
    from_node_id: 1,
    to_node_id: 2,
    type: 'connection',
    condition: 'updated condition',
    is_locked: true // Optional: Lock for current user, or false to unlock
};

updateEdge(edgeId, updateData)
    .then(result => {
        console.log('Edge updated successfully:', result.data.edge);
    })
    .catch(error => {
        console.error('Failed to update edge:', error);
    });

# TellsTree SDK - Edges API (Python)
# Update an existing edge

import requests

API_BASE_URL = 'https://tellstree.com/api'
API_TOKEN = 'your_jwt_token_here'

def update_edge(edge_id, update_data):
    """
    Update an existing edge
    
    Args:
        edge_id (int): The ID of the edge to update
        update_data (dict): The update data
            - from_node_id (int): ID of the source node
            - to_node_id (int): ID of the target node
            - type (str, optional): Edge type
            - condition (str, optional): Edge activation condition
    
    Returns:
        dict: API response with updated edge data
    """
    try:
        headers = {
            'Accept': 'application/json',
            'Content-Type': 'application/json',
            'Authorization': f'Bearer {API_TOKEN}'
        }
        
        response = requests.put(
            f'{API_BASE_URL}/edges/{edge_id}',
            headers=headers,
            json=update_data,
            timeout=30
        )
        
        response.raise_for_status()
        return response.json()
        
    except requests.exceptions.RequestException as e:
        print(f'Error updating edge: {e}')
        raise e

# Example usage
if __name__ == '__main__':
    edge_id = 1  # Replace with actual edge ID
    update_data = {
        'from_node_id': 1,
        'to_node_id': 2,
        'type': 'connection',
        'condition': 'updated condition'
    }
    
    try:
        result = update_edge(edge_id, update_data)
        print('Edge updated successfully:', result['data']['edge'])
    except Exception as error:
        print('Failed to update edge:', error)

<?php
/**
 * TellsTree SDK - Edges API (PHP)
 * Update an existing edge
 */

const API_BASE_URL = 'https://tellstree.com/api';
const API_TOKEN = 'your_jwt_token_here';

/**
 * Update an existing edge
 * 
 * @param int $edgeId The ID of the edge to update
 * @param array $updateData The update data
 *                          - from_node_id (int): ID of the source node
 *                          - to_node_id (int): ID of the target node
 *                          - type (string, optional): Edge type
 *                          - condition (string, optional): Edge activation condition
 *                          - is_locked (bool, optional): Lock state (true to lock, false to unlock)
 * @return array API response with updated edge data
 * @throws Exception If the request fails
 */
function updateEdge($edgeId, $updateData) {
    $url = API_BASE_URL . '/edges/' . $edgeId;
    
    $headers = [
        'Accept: application/json',
        'Content-Type: application/json',
        'Authorization: Bearer ' . API_TOKEN
    ];
    
    $context = stream_context_create([
        'http' => [
            'method' => 'PUT',
            'header' => implode("\r\n", $headers),
            'content' => json_encode($updateData)
        ]
    ]);
    
    $response = file_get_contents($url, false, $context);
    
    if ($response === false) {
        throw new Exception('Failed to update edge: Unable to connect to API');
    }
    
    $data = json_decode($response, true);
    
    if (json_last_error() !== JSON_ERROR_NONE) {
        throw new Exception('Failed to decode JSON response: ' . json_last_error_msg());
    }
    
    return $data;
}

// Example usage
try {
    $edgeId = 1; // Replace with actual edge ID
    $updateData = [
        'from_node_id' => 1,
        'to_node_id' => 2,
        'type' => 'connection',
        'condition' => 'updated condition',
        'is_locked' => true // Optional: Lock for current user, or false to unlock
    ];
    
    $result = updateEdge($edgeId, $updateData);
    echo "Edge updated successfully:\n";
    print_r($result['data']['edge']);
    
} catch (Exception $error) {
    echo "Failed to update edge: " . $error->getMessage() . "\n";
}
?>

#!/bin/bash

# TellsTree SDK - Edges API (cURL)
# Update an existing edge

API_BASE_URL="https://tellstree.com/api"
API_TOKEN="your_jwt_token_here"
EDGE_ID="1" # Replace with actual edge ID

# Update an existing edge
curl -X PUT "${API_BASE_URL}/edges/${EDGE_ID}" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ${API_TOKEN}" \
  -d '{
    "from_node_id": 1,
    "to_node_id": 2,
    "type": "connection",
    "condition": "updated condition"
  }'

Delete Edge

Permanently delete an edge connection. This action cannot be undone and will break the connection between nodes.

Response

204 Success / No Content

404 Edge not found

403 Forbidden / No permission

DELETEhttps://tellstree.com/api/edges/{edge}

{
    "method": "DELETE",
    "url": "http://localhost:8000/api/edges/6EKQKTMPWTDECFB5T85THMZHRK",
    "headers": {
        "Authorization": [
            "***REDACTED***"
        ],
        "Accept": "application/json",
        "Content-Type": "application/json"
    },
    "payload": null,
    "recorded_at": "2026-09-13T19:37:53+00:00"
}

// TellsTree SDK - Edges API (JavaScript)
// Delete an edge

const API_BASE_URL = 'https://tellstree.com/api';
const API_TOKEN = 'your_jwt_token_here';

/**
 * Delete an edge permanently
 * @param {number} edgeId - The ID of the edge to delete
 * @returns {Promise<boolean>} True if deletion was successful
 */
async function deleteEdge(edgeId) {
    try {
        const response = await fetch(`${API_BASE_URL}/edges/${edgeId}`, {
            method: 'DELETE',
            headers: {
                'Accept': 'application/json',
                'Authorization': `Bearer ${API_TOKEN}`
            }
        });

        if (response.status === 204) {
            return true; // Successfully deleted (No Content)
        } else if (!response.ok) {
            throw new Error(`HTTP ${response.status}: ${response.statusText}`);
        }

        return true;

    } catch (error) {
        console.error('Error deleting edge:', error);
        throw error;
    }
}

// Example usage
const edgeId = 1; // Replace with actual edge ID

deleteEdge(edgeId)
    .then(success => {
        if (success) {
            console.log('Edge deleted successfully');
        }
    })
    .catch(error => {
        console.error('Failed to delete edge:', error);
    });

# TellsTree SDK - Edges API (Python)
# Delete an edge

import requests

API_BASE_URL = 'https://tellstree.com/api'
API_TOKEN = 'your_jwt_token_here'

def delete_edge(edge_id):
    """
    Delete an edge permanently
    
    Args:
        edge_id (int): The ID of the edge to delete
    
    Returns:
        bool: True if deletion was successful
    """
    try:
        headers = {
            'Accept': 'application/json',
            'Authorization': f'Bearer {API_TOKEN}'
        }
        
        response = requests.delete(
            f'{API_BASE_URL}/edges/{edge_id}',
            headers=headers,
            timeout=30
        )
        
        if response.status_code == 204:
            return True  # Successfully deleted (No Content)
        else:
            response.raise_for_status()
            return True
        
    except requests.exceptions.RequestException as e:
        print(f'Error deleting edge: {e}')
        raise e

# Example usage
if __name__ == '__main__':
    edge_id = 1  # Replace with actual edge ID
    
    try:
        success = delete_edge(edge_id)
        if success:
            print('Edge deleted successfully')
    except Exception as error:
        print('Failed to delete edge:', error)

<?php
/**
 * TellsTree SDK - Edges API (PHP)
 * Delete an edge
 */

const API_BASE_URL = 'https://tellstree.com/api';
const API_TOKEN = 'your_jwt_token_here';

/**
 * Delete an edge permanently
 * 
 * @param int $edgeId The ID of the edge to delete
 * @return bool True if deletion was successful
 * @throws Exception If the request fails
 */
function deleteEdge($edgeId) {
    $url = API_BASE_URL . '/edges/' . $edgeId;
    
    $headers = [
        'Accept: application/json',
        'Authorization: Bearer ' . API_TOKEN
    ];
    
    $context = stream_context_create([
        'http' => [
            'method' => 'DELETE',
            'header' => implode("\r\n", $headers)
        ]
    ]);
    
    $response = file_get_contents($url, false, $context);
    
    // Check if the request was successful
    // For DELETE requests, a 204 No Content response is expected
    $responseHeaders = $http_response_header ?? [];
    
    foreach ($responseHeaders as $header) {
        if (strpos($header, 'HTTP/') === 0) {
            if (strpos($header, '204') !== false) {
                return true; // Successfully deleted
            }
        }
    }
    
    if ($response === false) {
        throw new Exception('Failed to delete edge: Unable to connect to API');
    }
    
    return true;
}

// Example usage
try {
    $edgeId = 1; // Replace with actual edge ID
    
    $success = deleteEdge($edgeId);
    if ($success) {
        echo "Edge deleted successfully\n";
    }
    
} catch (Exception $error) {
    echo "Failed to delete edge: " . $error->getMessage() . "\n";
}
?>

#!/bin/bash

# TellsTree SDK - Edges API (cURL)
# Delete an edge

API_BASE_URL="https://tellstree.com/api"
API_TOKEN="your_jwt_token_here"
EDGE_ID="1" # Replace with actual edge ID

# Delete an edge permanently
curl -X DELETE "${API_BASE_URL}/edges/${EDGE_ID}" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer ${API_TOKEN}"

🎬 Media

Media files can be attached to projects, nodes, or edges. Support for images, videos, audio, and documents to enrich your interactive stories with multimedia content.

GET /api/media List all media

POST /api/media Upload new media

GET /api/media/{media} Get media details

PUT /api/media/{media} Update media metadata

PATCH /api/media/{media}/visibility Update visibility

DELETE /api/media/{media} Delete media

List Media

Retrieve all media files or filter by project, node, or edge.

Query Parameters

project_id - Filter by project ID (optional)
node_id - Filter by node ID (optional)
edge_id - Filter by edge ID (optional)
type - Filter by media type (optional)
page - Page number (optional)
per_page - Items per page (optional)

Response

200 Success / Media list

401 Unauthorized / Invalid token

403 Forbidden / No access

GEThttps://tellstree.com/api/media

{
    "data": {
        "media": [
            {
                "media_id": 1,
                "filename": "hero-image.jpg",
                "original_name": "Hero Image.jpg",
                "mime_type": "image/jpeg",
                "size": 1048576,
                "path": "/storage/media/hero-image.jpg",
                "url": "https://tellstree.com/storage/media/hero-image.jpg",
                "project_id": 42,
                "node_id": null,
                "edge_id": null,
                "visibility": "public",
                "alt_text": "Hero image for opening scene",
                "description": "Main visual for the story introduction",
                "metadata": {
                    "width": 1920,
                    "height": 1080,
                    "aspect_ratio": "16:9"
                },
                "created_at": "2024-01-15T10:00:00.000000Z",
                "updated_at": "2024-01-15T10:00:00.000000Z"
            }
        ],
        "pagination": {
            "current_page": 1,
            "total_pages": 3,
            "per_page": 10,
            "total_items": 25
        }
    },
    "meta": {
        "request_id": "req_67890",
        "timestamp": "2024-01-15T10:00:00.000000Z"
    }
}

curl -X GET "https://tellstree.com/api/media?project_id=42&type=image" \
  -H "Authorization: Bearer your_jwt_token" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json"

const response = await fetch('https://tellstree.com/api/media?project_id=42', {
    method: 'GET',
    headers: {
        'Authorization': 'Bearer your_jwt_token',
        'Accept': 'application/json',
        'Content-Type': 'application/json'
    }
});

const data = await response.json();
console.log(data.data.media);

$response = Http::withHeaders([
    'Authorization' => 'Bearer ' . $token,
    'Accept' => 'application/json',
])->get('https://tellstree.com/api/media', [
    'project_id' => 42,
    'type' => 'image'
]);

$media = $response->json()['data']['media'];

import requests

headers = {
    'Authorization': 'Bearer your_jwt_token',
    'Accept': 'application/json',
    'Content-Type': 'application/json'
}

params = {
    'project_id': 42,
    'type': 'image'
}

response = requests.get(
    'https://tellstree.com/api/media',
    headers=headers,
    params=params
)

media = response.json()['data']['media']

GET /api/media?project_id=42&type=image HTTP/1.1
Host: tellstree.com
Authorization: Bearer your_jwt_token
Accept: application/json
Content-Type: application/json

Upload Media

Upload a new media file and attach it to a project, node, or edge.

Required Fields

file - Media file to upload

Optional Fields

project_id - Attach to project
node_id - Attach to node
edge_id - Attach to edge
alt_text - Alternative text
description - Media description
visibility - public/private

Response

201 Created / Media uploaded

422 Invalid file / Validation failed

413 Payload Too Large / File too big

415 Unsupported Media Type

POSThttps://tellstree.com/api/media

{
    "data": {
        "media_id": 123,
        "filename": "uploaded-image.jpg",
        "original_name": "My Image.jpg",
        "mime_type": "image/jpeg",
        "size": 2097152,
        "path": "/storage/media/uploaded-image.jpg",
        "url": "https://tellstree.com/storage/media/uploaded-image.jpg",
        "project_id": 42,
        "node_id": null,
        "edge_id": null,
        "visibility": "public",
        "alt_text": "Uploaded image",
        "description": "User uploaded media file",
        "metadata": {
            "width": 1600,
            "height": 900,
            "aspect_ratio": "16:9"
        },
        "created_at": "2024-01-15T10:30:00.000000Z",
        "updated_at": "2024-01-15T10:30:00.000000Z"
    },
    "meta": {
        "request_id": "req_12345",
        "timestamp": "2024-01-15T10:30:00.000000Z"
    }
}

curl -X POST "https://tellstree.com/api/media" \
  -H "Authorization: Bearer your_jwt_token" \
  -H "Accept: application/json" \
  -F "file=@/path/to/image.jpg" \
  -F "project_id=42" \
  -F "alt_text=Uploaded image" \
  -F "description=User uploaded media"

const formData = new FormData();
formData.append('file', fileInput.files[0]);
formData.append('project_id', '42');
formData.append('alt_text', 'Uploaded image');
formData.append('description', 'User uploaded media');

const response = await fetch('https://tellstree.com/api/media', {
    method: 'POST',
    headers: {
        'Authorization': 'Bearer your_jwt_token',
        'Accept': 'application/json'
    },
    body: formData
});

const data = await response.json();
console.log(data.data);

$response = Http::withHeaders([
    'Authorization' => 'Bearer ' . $token,
    'Accept' => 'application/json',
])->attach(
    'file', file_get_contents($filePath), $fileName
)->post('https://tellstree.com/api/media', [
    'project_id' => 42,
    'alt_text' => 'Uploaded image',
    'description' => 'User uploaded media'
]);

$media = $response->json()['data'];

import requests

headers = {
    'Authorization': 'Bearer your_jwt_token',
    'Accept': 'application/json'
}

files = {
    'file': open('image.jpg', 'rb')
}

data = {
    'project_id': 42,
    'alt_text': 'Uploaded image',
    'description': 'User uploaded media'
}

response = requests.post(
    'https://tellstree.com/api/media',
    headers=headers,
    files=files,
    data=data
)

media = response.json()['data']

POST /api/media HTTP/1.1
Host: tellstree.com
Authorization: Bearer your_jwt_token
Accept: application/json
Content-Type: multipart/form-data; boundary=----boundary

------boundary
Content-Disposition: form-data; name="file"; filename="image.jpg"
Content-Type: image/jpeg

[binary file data]
------boundary
Content-Disposition: form-data; name="project_id"

42
------boundary--

💬 Comments

Comments enable collaborative feedback and discussion within projects. Team members can leave notes, suggestions, and feedback to improve the narrative experience.

GET /api/comments List all comments

POST /api/comments Create new comment

GET /api/comments/{comment} Get comment details

PUT /api/comments/{comment} Update comment

DELETE /api/comments/{comment} Delete comment

List Comments

Retrieve all comments or filter by project to see discussions and feedback.

Query Parameters

project_id - Filter by project ID (optional)
user_id - Filter by author (optional)
status - Filter by status (optional)
page - Page number (optional)
per_page - Items per page (optional)

Response

200 Success / Comments list

401 Unauthorized / Invalid token

403 Forbidden / No access

GEThttps://tellstree.com/api/comments

{
    "data": {
        "comments": [
            {
                "id": "0FH7VYX9QCVS4RXKGW09QJPG9V",
                "project_id": "691NAT4PP8N5Q4357QFWM6HKB9",
                "user_id": "01KHF8MP96QY9KMPXF67Z5ZE3R",
                "content": "{\"content\":\"API Test Comment content with enough length\",\"rating\":4,\"project_id\":\"691NAT4PP8N5Q4357QFWM6HKB9\"}",
                "rating": 4,
                "created_at": "2026-09-13T19:37:52.000000Z"
            }
        ]
    }
}

{
    "method": "GET",
    "url": "http://localhost:8000/api/comments?project_id=691NAT4PP8N5Q4357QFWM6HKB9",
    "headers": {
        "Authorization": [
            "***REDACTED***"
        ],
        "Accept": "application/json",
        "Content-Type": "application/json"
    },
    "payload": null,
    "recorded_at": "2026-09-13T19:37:53+00:00"
}

/**
 * TellsTree Comments API - List Comments
 * 
 * This example demonstrates how to fetch comments for a project using JavaScript.
 * Replace 'your_jwt_token' with your actual authentication token.
 */

const response = await fetch('https://tellstree.com/api/comments?project_id=42', {
    method: 'GET',
    headers: {
        'Authorization': 'Bearer your_jwt_token',
        'Accept': 'application/json',
        'Content-Type': 'application/json'
    }
});

const data = await response.json();
console.log(data.data.comments);

<?php
/**
 * TellsTree Comments API - List Comments
 * 
 * This example demonstrates how to fetch comments for a project using PHP.
 * Replace 'your_jwt_token' with your actual authentication token.
 */

use Illuminate\Support\Facades\Http;

$token = 'your_jwt_token';

$response = Http::withHeaders([
    'Authorization' => 'Bearer ' . $token,
    'Accept' => 'application/json',
])->get('https://tellstree.com/api/comments', [
    'project_id' => 42,
    'status' => 'open'
]);

$comments = $response->json()['data']['comments'];
var_dump($comments);

"""
TellsTree Comments API - List Comments

This example demonstrates how to fetch comments for a project using Python.
Replace 'your_jwt_token' with your actual authentication token.

Requirements:
pip install requests
"""

import requests

headers = {
    'Authorization': 'Bearer your_jwt_token',
    'Accept': 'application/json',
    'Content-Type': 'application/json'
}

params = {
    'project_id': 42,
    'status': 'open'
}

response = requests.get(
    'https://tellstree.com/api/comments',
    headers=headers,
    params=params
)

comments = response.json()['data']['comments']
print(comments)

# TellsTree Comments API - List Comments
# 
# This example demonstrates how to fetch comments for a project using cURL.
# Replace 'your_jwt_token' with your actual authentication token.

curl -X GET "https://tellstree.com/api/comments?project_id=42&status=open" \
  -H "Authorization: Bearer your_jwt_token" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json"

Create Comment

Add a new comment or feedback to a project for collaborative discussion.

Required Fields

content - Comment text
project_id - Project to attach comment to

Optional Fields

priority - low/medium/high
node_id - Related node ID
position - UI position data
tags - Array of tags

Response

201 Created / Comment created

422 Invalid data / Validation failed

404 Project not found

403 Forbidden / No access

POSThttps://tellstree.com/api/comments

{
    "data": {
        "comment": {
            "id": "0FH7VYX9QCVS4RXKGW09QJPG9V",
            "project_id": "691NAT4PP8N5Q4357QFWM6HKB9",
            "user_id": "01KHF8MP96QY9KMPXF67Z5ZE3R",
            "content": "{\"content\":\"API Test Comment content with enough length\",\"rating\":4,\"project_id\":\"691NAT4PP8N5Q4357QFWM6HKB9\"}",
            "rating": 4,
            "created_at": "2026-09-13T19:37:52.000000Z"
        }
    }
}

{
    "method": "POST",
    "url": "http://localhost:8000/api/comments",
    "headers": {
        "Authorization": [
            "***REDACTED***"
        ],
        "Accept": "application/json",
        "Content-Type": "application/json"
    },
    "payload": {
        "content": "API Test Comment content with enough length",
        "rating": 4,
        "project_id": "691NAT4PP8N5Q4357QFWM6HKB9"
    },
    "recorded_at": "2026-09-13T19:37:53+00:00"
}

/**
 * TellsTree Comments API - Create Comment
 * 
 * This example demonstrates how to create a new comment using JavaScript.
 * Replace 'your_jwt_token' with your actual authentication token.
 */

const response = await fetch('https://tellstree.com/api/comments', {
    method: 'POST',
    headers: {
        'Authorization': 'Bearer your_jwt_token',
        'Accept': 'application/json',
        'Content-Type': 'application/json'
    },
    body: JSON.stringify({
        content: 'API Test Comment content with enough length',
        rating: 4,
        project_id: 40
    })
});

const data = await response.json();
console.log(data.data);

<?php
/**
 * TellsTree Comments API - Create Comment
 * 
 * This example demonstrates how to create a new comment using PHP.
 * Replace 'your_jwt_token' with your actual authentication token.
 */

use Illuminate\Support\Facades\Http;

$token = 'your_jwt_token';

$response = Http::withHeaders([
    'Authorization' => 'Bearer ' . $token,
    'Accept' => 'application/json',
])->post('https://tellstree.com/api/comments', [
    'content' => 'API Test Comment content with enough length',
    'rating' => 4,
    'project_id' => 40
]);

$comment = $response->json()['data'];
var_dump($comment);

"""
TellsTree Comments API - Create Comment

This example demonstrates how to create a new comment using Python.
Replace 'your_jwt_token' with your actual authentication token.

Requirements:
pip install requests
"""

import requests

headers = {
    'Authorization': 'Bearer your_jwt_token',
    'Accept': 'application/json',
    'Content-Type': 'application/json'
}

data = {
    'content': 'API Test Comment content with enough length',
    'rating': 4,
    'project_id': 40
}

response = requests.post(
    'https://tellstree.com/api/comments',
    headers=headers,
    json=data
)

comment = response.json()['data']
print(comment)

# TellsTree Comments API - Create Comment
# 
# This example demonstrates how to create a new comment using cURL.
# Replace 'your_jwt_token' with your actual authentication token.

curl -X POST "https://tellstree.com/api/comments" \
  -H "Authorization: Bearer your_jwt_token" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "API Test Comment content with enough length",
    "rating": 4,
    "project_id": 40
  }'

Themes

Themes define the visual styling and appearance of your storytelling projects. Each theme contains color schemes, fonts, and layout configurations.

GET /api/themes List all themes

GET /api/themes/{theme} Get theme by domain

List All Themes

Retrieve a paginated list of all available themes. This is a public endpoint and does not require authentication.

Query Parameters

page - Page number (optional, default: 1)
per_page - Items per page (optional, default: 15)

Response

200 Success / Themes list

GEThttps://tellstree.com/api/themes

{
    "data": {
        "themes": [
            {
                "theme_id": "1MV932GAHRKYAF20PMV8M3F11H",
                "name": "Dialog Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T17:21:14.000000Z",
                "updated_at": "2026-09-13T17:21:14.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "4VWMRXCMK22BBW6BQWCZB0WR7D",
                "name": "Dialog Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T17:21:16.000000Z",
                "updated_at": "2026-09-13T17:21:16.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "12AZWPS6DXWMTR2QG1GVRXSZCR",
                "name": "Dialog Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T17:23:50.000000Z",
                "updated_at": "2026-09-13T17:23:50.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "NAWR695ZCW1FRDJJHVBN3F5Y37",
                "name": "Dialog Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T17:23:52.000000Z",
                "updated_at": "2026-09-13T17:23:52.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "84H0WFMSV6QY8AX8HNY1M3674R",
                "name": "Dialog Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T17:24:58.000000Z",
                "updated_at": "2026-09-13T17:24:58.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "QMVDDGQ99PXXJCC1DQGCG0ZG4Z",
                "name": "Dialog Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T17:25:00.000000Z",
                "updated_at": "2026-09-13T17:25:00.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "8Q33V4QXNT7E9EY1J1X12RP46F",
                "name": "Dialog Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T17:25:32.000000Z",
                "updated_at": "2026-09-13T17:25:32.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "Z86HTV6GGFAJMVK10CCWGJCYHA",
                "name": "Dialog Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T17:25:37.000000Z",
                "updated_at": "2026-09-13T17:25:37.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "24YXZY4XF45782B28QHCT91VTV",
                "name": "Dialog Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T17:26:11.000000Z",
                "updated_at": "2026-09-13T17:26:11.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "XDYCY4WYSDCXVJ3A7FP30SK9N2",
                "name": "Dialog Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T17:26:13.000000Z",
                "updated_at": "2026-09-13T17:26:13.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "FXYHBPD7FGGWJX0ESS88B904QB",
                "name": "Dialog Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T17:27:04.000000Z",
                "updated_at": "2026-09-13T17:27:04.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "B389DHZ2XHK08R9XEW54QFS4PQ",
                "name": "Dialog Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T17:27:06.000000Z",
                "updated_at": "2026-09-13T17:27:06.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "97A4VNGM58K65F0R26AE7CK2A4",
                "name": "Dialog Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T17:29:01.000000Z",
                "updated_at": "2026-09-13T17:29:01.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "4JC01RC8CHA3Q48Y6FC9355VB6",
                "name": "Dialog Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T17:29:07.000000Z",
                "updated_at": "2026-09-13T17:29:07.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "PS7WF9Z9BDQ7JACGBMSBEEB773",
                "name": "Dialog Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T17:30:26.000000Z",
                "updated_at": "2026-09-13T17:30:26.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "9WYJ35D3P4BB8QZ97V8CFECWD5",
                "name": "Dialog Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T17:30:29.000000Z",
                "updated_at": "2026-09-13T17:30:29.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "0910RMD4R4AHWX7YGSGRB6ZAQ2",
                "name": "Dialog Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T17:30:48.000000Z",
                "updated_at": "2026-09-13T17:30:48.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "S5EME4BF0QGGMYX6NSZYJNHGFS",
                "name": "Dialog Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T17:30:51.000000Z",
                "updated_at": "2026-09-13T17:30:51.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "8XV65RXXZQ5W01YRFFTRTWQ766",
                "name": "Dialog Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T17:41:33.000000Z",
                "updated_at": "2026-09-13T17:41:33.000000Z",
                "statistics": {
                    "projects_count": 1,
                    "is_default": true
                }
            },
            {
                "theme_id": "DK8XRYC6MN3KNT8CQZJT5C80RN",
                "name": "Dialog Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T17:41:39.000000Z",
                "updated_at": "2026-09-13T17:41:39.000000Z",
                "statistics": {
                    "projects_count": 1,
                    "is_default": true
                }
            },
            {
                "theme_id": "119V96P3780B9XMRRG9GGSFAYV",
                "name": "Dialog Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T18:05:43.000000Z",
                "updated_at": "2026-09-13T18:05:43.000000Z",
                "statistics": {
                    "projects_count": 1,
                    "is_default": true
                }
            },
            {
                "theme_id": "5YHZSKSMPGBD6JDESPA0C1V691",
                "name": "Dialog Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T18:06:05.000000Z",
                "updated_at": "2026-09-13T18:06:05.000000Z",
                "statistics": {
                    "projects_count": 1,
                    "is_default": true
                }
            },
            {
                "theme_id": "ZXTKHK2RQ91041JV6Z4VZ21TJ7",
                "name": "Dialog Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T18:25:57.000000Z",
                "updated_at": "2026-09-13T18:25:57.000000Z",
                "statistics": {
                    "projects_count": 1,
                    "is_default": true
                }
            },
            {
                "theme_id": "FHC3A463XQ2AS4Z57QRRQBP2TH",
                "name": "Dialog Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T18:25:58.000000Z",
                "updated_at": "2026-09-13T18:25:58.000000Z",
                "statistics": {
                    "projects_count": 1,
                    "is_default": true
                }
            },
            {
                "theme_id": "6NGAQGB5NKN05R3HB46HVDXDAK",
                "name": "Dialog Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T19:25:19.000000Z",
                "updated_at": "2026-09-13T19:25:19.000000Z",
                "statistics": {
                    "projects_count": 1,
                    "is_default": true
                }
            },
            {
                "theme_id": "81Q88DPZNCCE75E64678ZXZ69Z",
                "name": "Dialog Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T19:26:26.000000Z",
                "updated_at": "2026-09-13T19:26:26.000000Z",
                "statistics": {
                    "projects_count": 1,
                    "is_default": true
                }
            },
            {
                "theme_id": "Q857837AYHA7TABCW963J2SH4F",
                "name": "Dialog Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T19:27:58.000000Z",
                "updated_at": "2026-09-13T19:27:58.000000Z",
                "statistics": {
                    "projects_count": 1,
                    "is_default": true
                }
            },
            {
                "theme_id": "ARF71XVC5S1C8FVP96JM1DR2MD",
                "name": "Dialog Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T19:28:01.000000Z",
                "updated_at": "2026-09-13T19:28:01.000000Z",
                "statistics": {
                    "projects_count": 1,
                    "is_default": true
                }
            },
            {
                "theme_id": "2D7C5RTBQ5R3529PHHBPE4AXAM",
                "name": "Dialog Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T19:30:42.000000Z",
                "updated_at": "2026-09-13T19:30:42.000000Z",
                "statistics": {
                    "projects_count": 1,
                    "is_default": true
                }
            },
            {
                "theme_id": "QDZBJK68MGV9V79C7F4R7WHGEX",
                "name": "Dialog Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T19:30:46.000000Z",
                "updated_at": "2026-09-13T19:30:46.000000Z",
                "statistics": {
                    "projects_count": 1,
                    "is_default": true
                }
            },
            {
                "theme_id": "V8HW2S3DK1GPBD85P1C0DKHAVK",
                "name": "Dialog-Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T17:21:09.000000Z",
                "updated_at": "2026-09-13T17:21:09.000000Z",
                "statistics": {
                    "projects_count": 500,
                    "is_default": true
                }
            },
            {
                "theme_id": "6TKYBX9TGJE21Q25C9RFFZMR6M",
                "name": "Dialog-Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T17:24:23.000000Z",
                "updated_at": "2026-09-13T17:24:23.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "PF40S0ACPV7X21KH7Q1ZCJ9NBN",
                "name": "Dialog-Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T17:24:23.000000Z",
                "updated_at": "2026-09-13T17:24:23.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "B50FYQXS4D81P5WTPFWV33GVAW",
                "name": "Dialog-Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T17:24:23.000000Z",
                "updated_at": "2026-09-13T17:24:23.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "YS4NWN1W1HKBD4V28XXHQ8SKR4",
                "name": "Dialog-Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T17:24:23.000000Z",
                "updated_at": "2026-09-13T17:24:23.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "XFJBYJAYZN9C0QXGMPW8H8Q714",
                "name": "Dialog-Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T17:24:23.000000Z",
                "updated_at": "2026-09-13T17:24:23.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "91E92S99JSK3TZECT141BQTD07",
                "name": "Dialog-Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T17:24:23.000000Z",
                "updated_at": "2026-09-13T17:24:23.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "Q08FS8P0T55KB3XAJ3PXSRNY1E",
                "name": "Dialog-Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T17:24:23.000000Z",
                "updated_at": "2026-09-13T17:24:23.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "HB010ENB9TJBAGR5MTSB7N46Q4",
                "name": "Dialog-Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T17:24:23.000000Z",
                "updated_at": "2026-09-13T17:24:23.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "64FV462D4GXMQ0YER60KM895NG",
                "name": "Dialog-Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T17:24:23.000000Z",
                "updated_at": "2026-09-13T17:24:23.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "26EX4XEHXTCBP7THBK7TQ1SGE1",
                "name": "Dialog-Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T17:24:23.000000Z",
                "updated_at": "2026-09-13T17:24:23.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "FM4E652SW3C5ZFAETF4SATTHZS",
                "name": "Dialog-Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T17:25:03.000000Z",
                "updated_at": "2026-09-13T17:25:03.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "T698QB4J950D41MXAZQF0Z9KZJ",
                "name": "Dialog-Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T17:25:03.000000Z",
                "updated_at": "2026-09-13T17:25:03.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "CABWGSP6PZGV35VN2JQD1WQ8S9",
                "name": "Dialog-Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T17:25:03.000000Z",
                "updated_at": "2026-09-13T17:25:03.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "Z9CKHVC906AXBDVCJ9YQ4398XN",
                "name": "Dialog-Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T17:25:04.000000Z",
                "updated_at": "2026-09-13T17:25:04.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "RYNKA1D7BKH18SP5Q45TT9QG84",
                "name": "Dialog-Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T17:25:04.000000Z",
                "updated_at": "2026-09-13T17:25:04.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "77NWE0JGDKRJ1GR5CKRWK5GHCM",
                "name": "Dialog-Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T17:25:04.000000Z",
                "updated_at": "2026-09-13T17:25:04.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "79CKW5VCYED48K3V31HQ5M7PR8",
                "name": "Dialog-Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T17:25:04.000000Z",
                "updated_at": "2026-09-13T17:25:04.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "ZQ5AWY53G3TB52K6JPRN4GMBE3",
                "name": "Dialog-Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T17:25:04.000000Z",
                "updated_at": "2026-09-13T17:25:04.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "K5ZJSK5CWVRYQSPZ1QPK6SDZGD",
                "name": "Dialog-Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T17:25:04.000000Z",
                "updated_at": "2026-09-13T17:25:04.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "YQA0J7BZT4WJE37V0W8Q6G3ZQ1",
                "name": "Dialog-Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T17:25:04.000000Z",
                "updated_at": "2026-09-13T17:25:04.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "H8EF20YSFS8C1A3G8T47ZXPNPX",
                "name": "Dialog-Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T17:25:04.000000Z",
                "updated_at": "2026-09-13T17:25:04.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "DMNN807742Z4NE39EXXW5EV2ZH",
                "name": "Dialog-Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T17:25:04.000000Z",
                "updated_at": "2026-09-13T17:25:04.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "EX6A918BHSJJQC8F8ZX1JSE0C3",
                "name": "Dialog-Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T17:25:04.000000Z",
                "updated_at": "2026-09-13T17:25:04.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "GWRZJYRWDVYP3V67MPJNYNSGTF",
                "name": "Dialog-Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T17:25:04.000000Z",
                "updated_at": "2026-09-13T17:25:04.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "TKDB7QRA07Y6341DQ5AE9ZSR2R",
                "name": "Dialog-Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T17:41:43.000000Z",
                "updated_at": "2026-09-13T17:41:43.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "CS0JKRHXFP774KT4YWZM9PA4EF",
                "name": "Dialog-Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T17:41:43.000000Z",
                "updated_at": "2026-09-13T17:41:43.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "GF9FJ4D050NT8X24Q5R9DC246W",
                "name": "Dialog-Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T17:41:44.000000Z",
                "updated_at": "2026-09-13T17:41:44.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "4VHJYJZB5YVRKYYCNFXQE45H1F",
                "name": "Dialog-Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T17:41:44.000000Z",
                "updated_at": "2026-09-13T17:41:44.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "2NF19K99D33G5RXKZRVBB7ACGD",
                "name": "Dialog-Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T17:41:44.000000Z",
                "updated_at": "2026-09-13T17:41:44.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "HV75J8A2H6W340DJ4SAN29BS1V",
                "name": "Dialog-Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T17:41:44.000000Z",
                "updated_at": "2026-09-13T17:41:44.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "VXYHVY01R6MR2116B59JVQW2S7",
                "name": "Dialog-Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T17:41:44.000000Z",
                "updated_at": "2026-09-13T17:41:44.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "PZNW9CETB19SDAWJJ52TDPA328",
                "name": "Dialog-Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T17:41:44.000000Z",
                "updated_at": "2026-09-13T17:41:44.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "WM1RC4VXJZ9KTNEX1C7B9J3E99",
                "name": "Dialog-Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T17:41:44.000000Z",
                "updated_at": "2026-09-13T17:41:44.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "4GXNXXP7YZKW0TV32SR0QWA5PE",
                "name": "Dialog-Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T17:41:45.000000Z",
                "updated_at": "2026-09-13T17:41:45.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "40GVQWVTEMPSM7WK4R1FWGZQRD",
                "name": "Dialog-Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T17:41:45.000000Z",
                "updated_at": "2026-09-13T17:41:45.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "DQE58N3WX25ZRPHWYCW56VP36A",
                "name": "Dialog-Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T17:41:45.000000Z",
                "updated_at": "2026-09-13T17:41:45.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "ZWQPHWJ4X8PGH19MZYYME6YFEG",
                "name": "Dialog-Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T17:41:45.000000Z",
                "updated_at": "2026-09-13T17:41:45.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "PQDQZ3M2ZVSATBV13BGED3QGKA",
                "name": "Dialog-Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T18:05:38.000000Z",
                "updated_at": "2026-09-13T18:05:38.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "H3GQWV2CQT096ZF8AZAA0BRNFW",
                "name": "Dialog-Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T18:05:38.000000Z",
                "updated_at": "2026-09-13T18:05:38.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "DF0V8HF9RGGBN9TT6XQYD8EJ2D",
                "name": "Dialog-Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T18:05:38.000000Z",
                "updated_at": "2026-09-13T18:05:38.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "E4NY6N2TNW8ZXG9JJKW9T0ZDPK",
                "name": "Dialog-Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T18:05:38.000000Z",
                "updated_at": "2026-09-13T18:05:38.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "EZVJE7DV0N1XDFNX3B0QTTR6XH",
                "name": "Dialog-Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T18:05:38.000000Z",
                "updated_at": "2026-09-13T18:05:38.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "KD5198R8QHBSQWZRDZZQV43X5G",
                "name": "Dialog-Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T18:05:39.000000Z",
                "updated_at": "2026-09-13T18:05:39.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "9V6YMM1Y94V0JJQFGSVMHCJWHZ",
                "name": "Dialog-Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T18:05:39.000000Z",
                "updated_at": "2026-09-13T18:05:39.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "VTYY7WM80SJRRD6DBPWBAWJ1V9",
                "name": "Dialog-Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T18:05:40.000000Z",
                "updated_at": "2026-09-13T18:05:40.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "TZ9B4MCZW5V8NJTNWRPKPW4635",
                "name": "Dialog-Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T18:05:40.000000Z",
                "updated_at": "2026-09-13T18:05:40.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "YA0MPVN0S5KJ4PB2WD96APDP7J",
                "name": "Dialog-Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T18:05:41.000000Z",
                "updated_at": "2026-09-13T18:05:41.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "AJTZF7SXQ2G7Z8NH6EZD51HQ43",
                "name": "Dialog-Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T18:05:41.000000Z",
                "updated_at": "2026-09-13T18:05:41.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "QV05YQA7D6S4KH4R3CHMBQNVD9",
                "name": "Dialog-Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T18:05:42.000000Z",
                "updated_at": "2026-09-13T18:05:42.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "GJVTKX574WG44CCR70591Q2T8K",
                "name": "Dialog-Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T18:05:43.000000Z",
                "updated_at": "2026-09-13T18:05:43.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "4VYEBDFJP47XS3EJ31MBGQQB36",
                "name": "Dialog-Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T18:06:01.000000Z",
                "updated_at": "2026-09-13T18:06:01.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "WHF9D96XWCQ74HGRNMYKRS41MG",
                "name": "Dialog-Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T18:06:02.000000Z",
                "updated_at": "2026-09-13T18:06:02.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "S6DER5NTH418BEFCC4Q64ACMXP",
                "name": "Dialog-Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T18:06:02.000000Z",
                "updated_at": "2026-09-13T18:06:02.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "RBVWVX2NGF492MT6KY214E9VAF",
                "name": "Dialog-Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T18:06:02.000000Z",
                "updated_at": "2026-09-13T18:06:02.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "ZX2E6PBR5A7PPM74MYAT7H83WH",
                "name": "Dialog-Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T18:06:02.000000Z",
                "updated_at": "2026-09-13T18:06:02.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "TKNJ38710PZ2CAH4R00X09QQM6",
                "name": "Dialog-Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T18:06:03.000000Z",
                "updated_at": "2026-09-13T18:06:03.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "HK8GTZAAV5FCQQX4XZB2F3C998",
                "name": "Dialog-Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T18:06:03.000000Z",
                "updated_at": "2026-09-13T18:06:03.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "NAK07DS43EJMX4P3HAEJV9AYXG",
                "name": "Dialog-Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T18:06:03.000000Z",
                "updated_at": "2026-09-13T18:06:03.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "XVQ9KGYQ601R132D1C1A0RPE26",
                "name": "Dialog-Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T18:06:03.000000Z",
                "updated_at": "2026-09-13T18:06:03.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "CQ0HZTS4N0T4BEWZNFGWPDRCQE",
                "name": "Dialog-Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T18:06:04.000000Z",
                "updated_at": "2026-09-13T18:06:04.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "QQZ14JXGSQ3BGA31EADKTDVMZS",
                "name": "Dialog-Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T18:06:04.000000Z",
                "updated_at": "2026-09-13T18:06:04.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "G3NP50VNC5JC4MFN3DJJ6PF8T9",
                "name": "Dialog-Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T18:06:04.000000Z",
                "updated_at": "2026-09-13T18:06:04.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "CWB50S6XRSK0N492QHAZMF897R",
                "name": "Dialog-Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T18:06:05.000000Z",
                "updated_at": "2026-09-13T18:06:05.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "AJFS0DQETSSEG2WFHGXAMNYDTN",
                "name": "Dialog-Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T18:06:05.000000Z",
                "updated_at": "2026-09-13T18:06:05.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "SPBHX7C39CNPT6MDGF850A8EJ3",
                "name": "Dialog-Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T18:25:56.000000Z",
                "updated_at": "2026-09-13T18:25:56.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "4DW33BT36S5SCKDPY62G3RYT3F",
                "name": "Dialog-Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T18:25:56.000000Z",
                "updated_at": "2026-09-13T18:25:56.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "YMJWDB3WM4PD76NR5SCC1ZSG5Q",
                "name": "Dialog-Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T18:25:56.000000Z",
                "updated_at": "2026-09-13T18:25:56.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "BYKB6J0D41H06FACVFYM84S87K",
                "name": "Dialog-Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T18:25:56.000000Z",
                "updated_at": "2026-09-13T18:25:56.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "R3HZWW638JFXV1BDP5YYRD4D5X",
                "name": "Dialog-Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T18:25:56.000000Z",
                "updated_at": "2026-09-13T18:25:56.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "CHQWW8NN9R3X410RK5ZV0PXC7H",
                "name": "Dialog-Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T18:25:56.000000Z",
                "updated_at": "2026-09-13T18:25:56.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "2H816YNYQ25MEFPMB1VTZ2WSJP",
                "name": "Dialog-Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T18:25:57.000000Z",
                "updated_at": "2026-09-13T18:25:57.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "YXX0P8M1B5SS8B2Q51ZGCV2Z37",
                "name": "Dialog-Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T18:25:57.000000Z",
                "updated_at": "2026-09-13T18:25:57.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "T91F5H9VNS7NFPQ9PEP1GTB2PD",
                "name": "Dialog-Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T18:25:57.000000Z",
                "updated_at": "2026-09-13T18:25:57.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "AWY2XKCG2FMX20P40NWN2VH132",
                "name": "Dialog-Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T18:25:57.000000Z",
                "updated_at": "2026-09-13T18:25:57.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "DFDA5MZH5VXJ0028V9RX2YDCRW",
                "name": "Dialog-Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T18:25:57.000000Z",
                "updated_at": "2026-09-13T18:25:57.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "2MR3P1QSK8ENYGZWYFSEPF84DY",
                "name": "Dialog-Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T18:25:57.000000Z",
                "updated_at": "2026-09-13T18:25:57.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "JGVG0M1C543C2E04VWA993FESK",
                "name": "Dialog-Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T18:25:57.000000Z",
                "updated_at": "2026-09-13T18:25:57.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "8PJ3MH5J5G24NN73Q17KDNER5Q",
                "name": "Dialog-Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T18:25:57.000000Z",
                "updated_at": "2026-09-13T18:25:57.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "WV5SV6ZRCNBGFP892EZDX12J9M",
                "name": "Game Theme",
                "domain": "game",
                "created_at": "2025-12-17T15:11:38.000000Z",
                "updated_at": "2025-12-17T15:11:38.000000Z",
                "statistics": {
                    "projects_count": 4,
                    "is_default": false
                },
                "badge": [
                    "Game",
                    "Adventure",
                    "Interactive"
                ],
                "version": "1.0.0",
                "description": "Create an immersive game with scenes, characters, items and dialog.",
                "nodes": {
                    "start": {
                        "name": "Start",
                        "description": "The origin of the narrative - the beginning of all paths",
                        "forms": {
                            "label": {
                                "form": "input",
                                "label": "Label",
                                "placeholder": "Start",
                                "required": false,
                                "isLabel": true
                            }
                        },
                        "graph": {
                            "component": "StartNode",
                            "props": []
                        }
                    },
                    "end": {
                        "name": "End",
                        "description": "The conclusion of the narrative - where all paths converge",
                        "forms": {
                            "label": {
                                "form": "input",
                                "label": "Label",
                                "placeholder": "End",
                                "required": false,
                                "isLabel": true
                            }
                        },
                        "graph": {
                            "component": "EndNode",
                            "props": []
                        }
                    },
                    "audio-segment": {
                        "name": "Audio Segment",
                        "description": "Background music or sound effect segment",
                        "forms": {
                            "title": {
                                "form": "input",
                                "type": "string",
                                "required": true,
                                "label": "Title",
                                "isLabel": true,
                                "placeholder": "Audio segment title"
                            },
                            "description": {
                                "form": "textarea",
                                "type": "string",
                                "required": false,
                                "label": "Description",
                                "rows": 2,
                                "placeholder": "Describe the audio mood..."
                            }
                        },
                        "media": {
                            "audio": {
                                "form": "upload",
                                "type": "file",
                                "label": "Audio File",
                                "formats": [
                                    "mp3",
                                    "wav",
                                    "ogg"
                                ],
                                "maxSize": "5MB"
                            }
                        },
                        "graph": {
                            "component": "Card",
                            "props": {
                                "header": "Audio: {{self.content.title}}",
                                "content": "{{self.content.description}}"
                            }
                        }
                    },
                    "chapter": {
                        "name": "Chapter",
                        "description": "A chapter of the game",
                        "forms": {
                            "title": {
                                "label": "Title",
                                "form": "input",
                                "type": "string",
                                "required": true,
                                "isLabel": true,
                                "placeholder": "The title of the chapter."
                            },
                            "summary": {
                                "label": "Summary",
                                "form": "textarea",
                                "type": "string",
                                "required": false,
                                "rows": 4,
                                "placeholder": "Brief summary of the chapter."
                            }
                        },
                        "graph": {
                            "component": "Card",
                            "props": {
                                "header": "Chapter: {{self.content.title}}",
                                "content": "{{self.content.summary}}"
                            }
                        }
                    },
                    "character": {
                        "name": "Character",
                        "description": "Character with properties and profile",
                        "forms": {
                            "name": {
                                "form": "input",
                                "type": "string",
                                "required": true,
                                "label": "Character Name",
                                "isLabel": true,
                                "placeholder": "The name of the character."
                            },
                            "description": {
                                "form": "textarea",
                                "type": "string",
                                "required": false,
                                "label": "Description",
                                "rows": 4,
                                "placeholder": "The description of the character."
                            },
                            "traits": {
                                "form": "textarea",
                                "type": "string",
                                "required": false,
                                "label": "Traits",
                                "rows": 3,
                                "placeholder": "Character traits (e.g. brave, shy...)"
                            }
                        },
                        "media": {
                            "image": {
                                "form": "upload",
                                "type": "file",
                                "label": "Character Image",
                                "formats": [
                                    "jpg",
                                    "jpeg",
                                    "png",
                                    "gif"
                                ],
                                "maxSize": "2MB"
                            },
                            "avatar": {
                                "form": "upload",
                                "type": "file",
                                "label": "Avatar/Portrait",
                                "formats": [
                                    "jpg",
                                    "jpeg",
                                    "png",
                                    "gif"
                                ],
                                "maxSize": "1MB"
                            }
                        },
                        "graph": {
                            "component": "MediaCard",
                            "props": {
                                "header": "{{self.content.name}}",
                                "content": "{{self.content.description}}",
                                "image": "{{self.media.image}}",
                                "imageAlign": "top"
                            }
                        }
                    },
                    "checkpoint": {
                        "name": "Checkpoint",
                        "description": "A save point or checkpoint in the game",
                        "forms": {
                            "name": {
                                "form": "input",
                                "type": "string",
                                "required": true,
                                "label": "Checkpoint Name",
                                "isLabel": true,
                                "placeholder": "Name of the checkpoint"
                            },
                            "note": {
                                "form": "textarea",
                                "type": "string",
                                "required": false,
                                "label": "Note",
                                "rows": 2,
                                "placeholder": "Optional note about this checkpoint"
                            }
                        },
                        "graph": {
                            "component": "Card",
                            "props": {
                                "header": "Checkpoint: {{self.content.name}}",
                                "content": "{{self.content.note}}"
                            }
                        }
                    },
                    "dialog": {
                        "name": "Dialog",
                        "description": "Start of a conversation between characters",
                        "forms": {
                            "title": {
                                "form": "input",
                                "type": "string",
                                "required": true,
                                "label": "Dialog Title",
                                "isLabel": true,
                                "placeholder": "What is the dialog about?"
                            },
                            "description": {
                                "form": "textarea",
                                "type": "string",
                                "required": false,
                                "label": "Description",
                                "rows": 4,
                                "placeholder": "Dialog description..."
                            }
                        },
                        "graph": {
                            "component": "Card",
                            "props": {
                                "header": "Dialog Start",
                                "content": "{{self.content.title}}: {{self.content.description}}"
                            }
                        }
                    },
                    "dialog-entry": {
                        "name": "Dialog Entry",
                        "description": "Individual speech contribution of a character",
                        "forms": {
                            "speaker": {
                                "form": "select",
                                "type": "string",
                                "required": true,
                                "label": "Speaker",
                                "options": [
                                    {
                                        "label": "{{node[{{character}}].content.name}}",
                                        "value": "{{node[{{character}}].public_id}}"
                                    }
                                ],
                                "placeholder": "Select character..."
                            },
                            "message": {
                                "form": "contentarea",
                                "type": "string",
                                "required": true,
                                "label": "Message",
                                "isLabel": true,
                                "rows": 4,
                                "placeholder": "What does the character say?"
                            }
                        },
                        "graph": {
                            "component": "MediaCard",
                            "props": {
                                "header": "{{node[id=(self.content.speaker)].content.name}}:",
                                "content": "\"{{self.content.message}}\"",
                                "image": "{{node[id=(self.content.speaker)].media.image}}",
                                "imageAlign": "left"
                            }
                        }
                    },
                    "effect": {
                        "name": "Effect",
                        "description": "A visual or gameplay effect",
                        "forms": {
                            "name": {
                                "form": "input",
                                "type": "string",
                                "required": true,
                                "label": "Effect Name",
                                "isLabel": true,
                                "placeholder": "Name of the effect"
                            },
                            "type": {
                                "form": "select",
                                "type": "string",
                                "required": true,
                                "label": "Effect Type",
                                "options": [
                                    {
                                        "label": "Visual",
                                        "value": "visual"
                                    },
                                    {
                                        "label": "Audio",
                                        "value": "audio"
                                    },
                                    {
                                        "label": "Gameplay",
                                        "value": "gameplay"
                                    },
                                    {
                                        "label": "Status",
                                        "value": "status"
                                    }
                                ]
                            },
                            "description": {
                                "form": "textarea",
                                "type": "string",
                                "required": true,
                                "label": "Description",
                                "rows": 3,
                                "placeholder": "Describe the effect..."
                            },
                            "duration": {
                                "form": "input",
                                "type": "string",
                                "required": false,
                                "label": "Duration",
                                "placeholder": "Effect duration (optional)"
                            }
                        },
                        "graph": {
                            "component": "Card",
                            "props": {
                                "header": "Effect: {{self.content.name}}",
                                "content": "{{self.content.description}}"
                            }
                        }
                    },
                    "environment-segment": {
                        "name": "Environment Segment",
                        "description": "Environmental narrative or atmosphere description",
                        "forms": {
                            "title": {
                                "form": "input",
                                "type": "string",
                                "required": true,
                                "label": "Title",
                                "isLabel": true,
                                "placeholder": "Environment segment title"
                            },
                            "content": {
                                "form": "textarea",
                                "type": "string",
                                "required": true,
                                "label": "Content",
                                "rows": 6,
                                "placeholder": "Describe the environment, atmosphere, sounds..."
                            }
                        },
                        "graph": {
                            "component": "Card",
                            "props": {
                                "header": "Environment",
                                "content": "{{self.content.content}}"
                            }
                        }
                    },
                    "event": {
                        "name": "Event",
                        "description": "A triggered event in the game",
                        "forms": {
                            "name": {
                                "form": "input",
                                "type": "string",
                                "required": true,
                                "label": "Event Name",
                                "isLabel": true,
                                "placeholder": "Name of the event"
                            },
                            "trigger": {
                                "form": "textarea",
                                "type": "string",
                                "required": false,
                                "label": "Trigger Condition",
                                "rows": 2,
                                "placeholder": "What triggers this event?"
                            },
                            "description": {
                                "form": "textarea",
                                "type": "string",
                                "required": true,
                                "label": "Description",
                                "rows": 4,
                                "placeholder": "What happens when this event is triggered?"
                            }
                        },
                        "graph": {
                            "component": "Card",
                            "props": {
                                "header": "Event: {{self.content.name}}",
                                "content": "{{self.content.description}}"
                            }
                        }
                    },
                    "gameplay-segment": {
                        "name": "Gameplay Segment",
                        "description": "A segment of gameplay mechanics or instructions",
                        "forms": {
                            "title": {
                                "form": "input",
                                "type": "string",
                                "required": true,
                                "label": "Title",
                                "isLabel": true,
                                "placeholder": "Gameplay segment title"
                            },
                            "mechanics": {
                                "form": "textarea",
                                "type": "string",
                                "required": true,
                                "label": "Mechanics",
                                "rows": 5,
                                "placeholder": "Describe the gameplay mechanics..."
                            }
                        },
                        "graph": {
                            "component": "Card",
                            "props": {
                                "header": "Gameplay",
                                "content": "{{self.content.mechanics}}"
                            }
                        }
                    },
                    "inventory": {
                        "name": "Inventory",
                        "description": "An inventory container or system",
                        "forms": {
                            "name": {
                                "form": "input",
                                "type": "string",
                                "required": true,
                                "label": "Inventory Name",
                                "isLabel": true,
                                "placeholder": "Name of the inventory"
                            },
                            "capacity": {
                                "form": "input",
                                "type": "string",
                                "required": false,
                                "label": "Capacity",
                                "placeholder": "Maximum capacity (optional)"
                            },
                            "note": {
                                "form": "textarea",
                                "type": "string",
                                "required": false,
                                "label": "Note",
                                "rows": 2,
                                "placeholder": "Additional notes..."
                            }
                        },
                        "graph": {
                            "component": "Card",
                            "props": {
                                "header": "Inventory: {{self.content.name}}",
                                "content": "Capacity: {{self.content.capacity}}"
                            }
                        }
                    },
                    "item": {
                        "name": "Item",
                        "description": "An item that can be collected or used",
                        "forms": {
                            "name": {
                                "form": "input",
                                "type": "string",
                                "required": true,
                                "label": "Item Name",
                                "isLabel": true,
                                "placeholder": "Name of the item"
                            },
                            "description": {
                                "form": "textarea",
                                "type": "string",
                                "required": false,
                                "label": "Description",
                                "rows": 3,
                                "placeholder": "What is this item?"
                            },
                            "usage": {
                                "form": "textarea",
                                "type": "string",
                                "required": false,
                                "label": "Usage",
                                "rows": 2,
                                "placeholder": "How can it be used?"
                            }
                        },
                        "media": {
                            "image": {
                                "form": "upload",
                                "type": "file",
                                "label": "Item Image",
                                "formats": [
                                    "jpg",
                                    "jpeg",
                                    "png",
                                    "gif"
                                ],
                                "maxSize": "1MB"
                            }
                        },
                        "graph": {
                            "component": "MediaCard",
                            "props": {
                                "header": "{{self.content.name}}",
                                "content": "{{self.content.description}}",
                                "image": "{{self.media.image}}"
                            }
                        }
                    },
                    "location": {
                        "name": "Location",
                        "description": "A physical location in the game world",
                        "forms": {
                            "name": {
                                "form": "input",
                                "type": "string",
                                "required": true,
                                "label": "Location Name",
                                "isLabel": true,
                                "placeholder": "Name of the location"
                            },
                            "description": {
                                "form": "textarea",
                                "type": "string",
                                "required": false,
                                "label": "Description",
                                "rows": 4,
                                "placeholder": "Describe the location..."
                            }
                        },
                        "media": {
                            "image": {
                                "form": "upload",
                                "type": "file",
                                "label": "Location Image",
                                "formats": [
                                    "jpg",
                                    "jpeg",
                                    "png",
                                    "gif"
                                ],
                                "maxSize": "2MB"
                            }
                        },
                        "graph": {
                            "component": "MediaCard",
                            "props": {
                                "header": "{{self.content.name}}",
                                "content": "{{self.content.description}}",
                                "image": "{{self.media.image}}"
                            }
                        }
                    },
                    "object": {
                        "name": "Object",
                        "description": "An interactive object in the game",
                        "forms": {
                            "name": {
                                "form": "input",
                                "type": "string",
                                "required": true,
                                "label": "Object Name",
                                "isLabel": true,
                                "placeholder": "Name of the object"
                            },
                            "description": {
                                "form": "textarea",
                                "type": "string",
                                "required": false,
                                "label": "Description",
                                "rows": 3,
                                "placeholder": "What does it look like?"
                            },
                            "interaction": {
                                "form": "textarea",
                                "type": "string",
                                "required": false,
                                "label": "Interaction",
                                "rows": 3,
                                "placeholder": "What happens when interacting with it?"
                            }
                        },
                        "media": {
                            "image": {
                                "form": "upload",
                                "type": "file",
                                "label": "Object Image",
                                "formats": [
                                    "jpg",
                                    "jpeg",
                                    "png",
                                    "gif"
                                ],
                                "maxSize": "1MB"
                            }
                        },
                        "graph": {
                            "component": "MediaCard",
                            "props": {
                                "header": "{{self.content.name}}",
                                "content": "{{self.content.description}}",
                                "image": "{{self.media.image}}"
                            }
                        }
                    },
                    "quest": {
                        "name": "Quest",
                        "description": "A quest or mission for the player",
                        "forms": {
                            "title": {
                                "form": "input",
                                "type": "string",
                                "required": true,
                                "label": "Quest Title",
                                "isLabel": true,
                                "placeholder": "Name of the quest"
                            },
                            "description": {
                                "form": "textarea",
                                "type": "string",
                                "required": false,
                                "label": "Description",
                                "rows": 4,
                                "placeholder": "What is the quest about?"
                            },
                            "objective": {
                                "form": "textarea",
                                "type": "string",
                                "required": true,
                                "label": "Objective",
                                "rows": 3,
                                "placeholder": "What must be accomplished?"
                            },
                            "reward": {
                                "form": "textarea",
                                "type": "string",
                                "required": false,
                                "label": "Reward",
                                "rows": 2,
                                "placeholder": "What reward does the player receive?"
                            }
                        },
                        "graph": {
                            "component": "Card",
                            "props": {
                                "header": "Quest: {{self.content.title}}",
                                "content": "{{self.content.objective}}"
                            }
                        }
                    },
                    "scene": {
                        "name": "Scene",
                        "description": "A scene within a chapter",
                        "forms": {
                            "title": {
                                "form": "input",
                                "type": "string",
                                "required": true,
                                "label": "Scene Title",
                                "isLabel": true,
                                "placeholder": "Name of the scene"
                            },
                            "description": {
                                "form": "textarea",
                                "type": "string",
                                "required": false,
                                "label": "Description",
                                "rows": 4,
                                "placeholder": "What happens in this scene?"
                            }
                        },
                        "graph": {
                            "component": "Card",
                            "props": {
                                "header": "Scene: {{self.content.title}}",
                                "content": "{{self.content.description}}"
                            }
                        }
                    },
                    "stage": {
                        "name": "Stage",
                        "description": "A stage or phase within gameplay",
                        "forms": {
                            "name": {
                                "form": "input",
                                "type": "string",
                                "required": true,
                                "label": "Stage Name",
                                "isLabel": true,
                                "placeholder": "Name of the stage"
                            },
                            "objective": {
                                "form": "textarea",
                                "type": "string",
                                "required": false,
                                "label": "Objective",
                                "rows": 3,
                                "placeholder": "What must the player accomplish?"
                            }
                        },
                        "graph": {
                            "component": "Card",
                            "props": {
                                "header": "Stage: {{self.content.name}}",
                                "content": "{{self.content.objective}}"
                            }
                        }
                    },
                    "story-segment": {
                        "name": "Story Segment",
                        "description": "A segment of a story",
                        "forms": {
                            "title": {
                                "form": "input",
                                "type": "string",
                                "required": true,
                                "label": "Segment Title",
                                "isLabel": true,
                                "placeholder": "What is the segment about?"
                            },
                            "content": {
                                "form": "textarea",
                                "type": "string",
                                "required": false,
                                "label": "Content",
                                "rows": 4,
                                "placeholder": "Content of the story segment."
                            }
                        },
                        "graph": {
                            "component": "Card",
                            "props": {
                                "header": "Story Segment",
                                "content": "{{self.content.title}}: {{self.content.content}}"
                            }
                        }
                    },
                    "task": {
                        "name": "Task",
                        "description": "A specific task within a quest or objective",
                        "forms": {
                            "name": {
                                "form": "input",
                                "type": "string",
                                "required": true,
                                "label": "Task Name",
                                "isLabel": true,
                                "placeholder": "Name of the task"
                            },
                            "description": {
                                "form": "textarea",
                                "type": "string",
                                "required": true,
                                "label": "Description",
                                "rows": 3,
                                "placeholder": "What needs to be done?"
                            },
                            "optional": {
                                "form": "select",
                                "type": "string",
                                "required": false,
                                "label": "Optional",
                                "options": [
                                    {
                                        "label": "Required",
                                        "value": "false"
                                    },
                                    {
                                        "label": "Optional",
                                        "value": "true"
                                    }
                                ]
                            }
                        },
                        "graph": {
                            "component": "Card",
                            "props": {
                                "header": "Task: {{self.content.name}}",
                                "content": "{{self.content.description}}"
                            }
                        }
                    },
                    "trait": {
                        "name": "Trait",
                        "description": "A character trait or attribute",
                        "forms": {
                            "name": {
                                "form": "input",
                                "type": "string",
                                "required": true,
                                "label": "Trait Name",
                                "isLabel": true,
                                "placeholder": "Name of the trait"
                            },
                            "description": {
                                "form": "textarea",
                                "type": "string",
                                "required": false,
                                "label": "Description",
                                "rows": 3,
                                "placeholder": "Describe the trait..."
                            },
                            "effect": {
                                "form": "textarea",
                                "type": "string",
                                "required": false,
                                "label": "Effect",
                                "rows": 2,
                                "placeholder": "What effect does this trait have?"
                            }
                        },
                        "graph": {
                            "component": "Card",
                            "props": {
                                "header": "Trait: {{self.content.name}}",
                                "content": "{{self.content.description}}"
                            }
                        }
                    }
                },
                "node_types": [
                    "start",
                    "end",
                    "audio-segment",
                    "chapter",
                    "character",
                    "checkpoint",
                    "dialog",
                    "dialog-entry",
                    "effect",
                    "environment-segment",
                    "event",
                    "gameplay-segment",
                    "inventory",
                    "item",
                    "location",
                    "object",
                    "quest",
                    "scene",
                    "stage",
                    "story-segment",
                    "task",
                    "trait"
                ],
                "edges": [
                    "flow",
                    "contains",
                    "link"
                ],
                "startNode": "start",
                "endNode": "end",
                "graph": {
                    "nodes": [
                        "start",
                        "end",
                        "audio-segment",
                        "chapter",
                        "checkpoint",
                        "dialog",
                        "dialog-entry",
                        "effect",
                        "environment-segment",
                        "event",
                        "gameplay-segment",
                        "inventory",
                        "item",
                        "location",
                        "object",
                        "quest",
                        "scene",
                        "stage",
                        "story-segment",
                        "task",
                        "trait"
                    ],
                    "edges": [
                        "flow",
                        "contains",
                        "link"
                    ]
                }
            },
            {
                "theme_id": "612GBK8WMPTZ73X5D8DV3W4N89",
                "name": "Non-existent Theme",
                "domain": "non-existent",
                "created_at": "2026-09-13T17:21:17.000000Z",
                "updated_at": "2026-09-13T17:21:17.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": false
                }
            },
            {
                "theme_id": "RG4G081HZZHWXV0E1G9P6XNW5W",
                "name": "Non-existent Theme",
                "domain": "non-existent",
                "created_at": "2026-09-13T17:23:53.000000Z",
                "updated_at": "2026-09-13T17:23:53.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": false
                }
            },
            {
                "theme_id": "74C2HYDXF4YRKD5WEFG606S0G7",
                "name": "Non-existent Theme",
                "domain": "non-existent",
                "created_at": "2026-09-13T17:25:01.000000Z",
                "updated_at": "2026-09-13T17:25:01.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": false
                }
            },
            {
                "theme_id": "KD6FQWQDCZHTWRX4P9NATPEQ7Q",
                "name": "Non-existent Theme",
                "domain": "non-existent",
                "created_at": "2026-09-13T17:25:39.000000Z",
                "updated_at": "2026-09-13T17:25:39.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": false
                }
            },
            {
                "theme_id": "VWQ71WMNJG5EPKTDYFZ6PG21EP",
                "name": "Non-existent Theme",
                "domain": "non-existent",
                "created_at": "2026-09-13T17:26:14.000000Z",
                "updated_at": "2026-09-13T17:26:14.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": false
                }
            },
            {
                "theme_id": "XSW2XX5DJ073GG4QQDWEY6BY3T",
                "name": "Non-existent Theme",
                "domain": "non-existent",
                "created_at": "2026-09-13T17:27:07.000000Z",
                "updated_at": "2026-09-13T17:27:07.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": false
                }
            },
            {
                "theme_id": "W0M13EPZ1A3084W0C704MFJXFE",
                "name": "Non-existent Theme",
                "domain": "non-existent",
                "created_at": "2026-09-13T17:29:08.000000Z",
                "updated_at": "2026-09-13T17:29:08.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": false
                }
            },
            {
                "theme_id": "B7PXHYJ8MZ1CATV7M771H9VFTY",
                "name": "Non-existent Theme",
                "domain": "non-existent",
                "created_at": "2026-09-13T17:30:31.000000Z",
                "updated_at": "2026-09-13T17:30:31.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": false
                }
            },
            {
                "theme_id": "0CRN69ABD2F2MEHKPGQY7XSQBC",
                "name": "Non-existent Theme",
                "domain": "non-existent",
                "created_at": "2026-09-13T17:30:53.000000Z",
                "updated_at": "2026-09-13T17:30:53.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": false
                }
            },
            {
                "theme_id": "SMH6FR2FC3NPPNCDHEKXAKY3PA",
                "name": "Non-existent Theme",
                "domain": "non-existent",
                "created_at": "2026-09-13T17:41:41.000000Z",
                "updated_at": "2026-09-13T17:41:41.000000Z",
                "statistics": {
                    "projects_count": 1,
                    "is_default": false
                }
            },
            {
                "theme_id": "4V8X9A6XR6P0DJJTJHKX603YBT",
                "name": "Non-existent Theme",
                "domain": "non-existent",
                "created_at": "2026-09-13T18:05:37.000000Z",
                "updated_at": "2026-09-13T18:05:37.000000Z",
                "statistics": {
                    "projects_count": 1,
                    "is_default": false
                }
            },
            {
                "theme_id": "3GNCPJ3ARY64VS9KX576C43JK5",
                "name": "Non-existent Theme",
                "domain": "non-existent",
                "created_at": "2026-09-13T18:06:01.000000Z",
                "updated_at": "2026-09-13T18:06:01.000000Z",
                "statistics": {
                    "projects_count": 1,
                    "is_default": false
                }
            },
            {
                "theme_id": "5Q6HGV832WEXZ6A78V3P21ZNCM",
                "name": "Non-existent Theme",
                "domain": "non-existent",
                "created_at": "2026-09-13T18:25:57.000000Z",
                "updated_at": "2026-09-13T18:25:57.000000Z",
                "statistics": {
                    "projects_count": 1,
                    "is_default": false
                }
            },
            {
                "theme_id": "6WP63B566EP9JE1YT3QAHBY9CN",
                "name": "Non-existent Theme",
                "domain": "non-existent",
                "created_at": "2026-09-13T19:28:02.000000Z",
                "updated_at": "2026-09-13T19:28:02.000000Z",
                "statistics": {
                    "projects_count": 1,
                    "is_default": false
                }
            },
            {
                "theme_id": "Q8HE5ZM1HK18V44VR5WQGC1NM3",
                "name": "Non-existent Theme",
                "domain": "non-existent",
                "created_at": "2026-09-13T19:28:46.000000Z",
                "updated_at": "2026-09-13T19:28:46.000000Z",
                "statistics": {
                    "projects_count": 1,
                    "is_default": false
                }
            },
            {
                "theme_id": "8SBQFDCW0W30HG9RJWB5JW0ZJN",
                "name": "Non-existent Theme",
                "domain": "non-existent",
                "created_at": "2026-09-13T19:29:04.000000Z",
                "updated_at": "2026-09-13T19:29:04.000000Z",
                "statistics": {
                    "projects_count": 1,
                    "is_default": false
                }
            },
            {
                "theme_id": "4TN9E6AMT7ZVJ8Z43GN5YDTEQ4",
                "name": "Non-existent Theme",
                "domain": "non-existent",
                "created_at": "2026-09-13T19:30:47.000000Z",
                "updated_at": "2026-09-13T19:30:47.000000Z",
                "statistics": {
                    "projects_count": 1,
                    "is_default": false
                }
            },
            {
                "theme_id": "7KAYSSA4749C3HCJ66GWYN0HKE",
                "name": "Simple Theme",
                "domain": "simple",
                "created_at": "2026-09-13T17:21:17.000000Z",
                "updated_at": "2026-09-13T17:21:17.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": false
                }
            },
            {
                "theme_id": "3TZARPNM20D971TZD7W37BRTNS",
                "name": "Simple Theme",
                "domain": "simple",
                "created_at": "2026-09-13T17:23:53.000000Z",
                "updated_at": "2026-09-13T17:23:53.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": false
                }
            },
            {
                "theme_id": "EXZEG5FP1MANXQAZ17W8D6TQJP",
                "name": "Simple Theme",
                "domain": "simple",
                "created_at": "2026-09-13T17:25:02.000000Z",
                "updated_at": "2026-09-13T17:25:02.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": false
                }
            },
            {
                "theme_id": "ND0F20NWXGPWYCWNCXJS6XC8N6",
                "name": "Simple Theme",
                "domain": "simple",
                "created_at": "2026-09-13T17:25:39.000000Z",
                "updated_at": "2026-09-13T17:25:39.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": false
                }
            },
            {
                "theme_id": "5RSW1H16ZW09QA5KKT2C9DDN21",
                "name": "Simple Theme",
                "domain": "simple",
                "created_at": "2026-09-13T17:26:14.000000Z",
                "updated_at": "2026-09-13T17:26:14.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": false
                }
            },
            {
                "theme_id": "K365CWZERE3PC85W8YK4F643WS",
                "name": "Simple Theme",
                "domain": "simple",
                "created_at": "2026-09-13T17:27:07.000000Z",
                "updated_at": "2026-09-13T17:27:07.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": false
                }
            },
            {
                "theme_id": "R2JEKQSH1EH7JZM2CNTJZ5ERHH",
                "name": "Simple Theme",
                "domain": "simple",
                "created_at": "2026-09-13T17:29:08.000000Z",
                "updated_at": "2026-09-13T17:29:08.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": false
                }
            },
            {
                "theme_id": "SD4B3P4AY04GK1ETHQC4CNVYJ6",
                "name": "Simple Theme",
                "domain": "simple",
                "created_at": "2026-09-13T17:30:31.000000Z",
                "updated_at": "2026-09-13T17:30:31.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": false
                }
            },
            {
                "theme_id": "D8NTV312QKEC8806M9E8JNSYM1",
                "name": "Simple Theme",
                "domain": "simple",
                "created_at": "2026-09-13T17:30:53.000000Z",
                "updated_at": "2026-09-13T17:30:53.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": false
                }
            },
            {
                "theme_id": "J8351MBMQ9JGVT7T3B36GB61PK",
                "name": "Simple Theme",
                "domain": "simple",
                "created_at": "2026-09-13T17:41:41.000000Z",
                "updated_at": "2026-09-13T17:41:41.000000Z",
                "statistics": {
                    "projects_count": 1,
                    "is_default": false
                }
            },
            {
                "theme_id": "6M8GQJCET2YHF567W8Y4ZM9WN2",
                "name": "Simple Theme",
                "domain": "simple",
                "created_at": "2026-09-13T18:05:37.000000Z",
                "updated_at": "2026-09-13T18:05:37.000000Z",
                "statistics": {
                    "projects_count": 1,
                    "is_default": false
                }
            },
            {
                "theme_id": "XJTEDWE0H5N661R315Z0PTNZG2",
                "name": "Simple Theme",
                "domain": "simple",
                "created_at": "2026-09-13T18:06:01.000000Z",
                "updated_at": "2026-09-13T18:06:01.000000Z",
                "statistics": {
                    "projects_count": 1,
                    "is_default": false
                }
            },
            {
                "theme_id": "6NY24NGHTD4BHGEDXT5TXJ8BW1",
                "name": "Simple Theme",
                "domain": "simple",
                "created_at": "2026-09-13T18:25:57.000000Z",
                "updated_at": "2026-09-13T18:25:57.000000Z",
                "statistics": {
                    "projects_count": 1,
                    "is_default": false
                }
            },
            {
                "theme_id": "K8EFV3MZH3K2NH35D3ZAJXPWFM",
                "name": "Simple Theme",
                "domain": "simple",
                "created_at": "2026-09-13T19:28:03.000000Z",
                "updated_at": "2026-09-13T19:28:03.000000Z",
                "statistics": {
                    "projects_count": 1,
                    "is_default": false
                }
            },
            {
                "theme_id": "2J6F0NYA2ARJ18VTE1S9HGM4KG",
                "name": "Simple Theme",
                "domain": "simple",
                "created_at": "2026-09-13T19:28:46.000000Z",
                "updated_at": "2026-09-13T19:28:46.000000Z",
                "statistics": {
                    "projects_count": 1,
                    "is_default": false
                }
            },
            {
                "theme_id": "MQS83KSY0WPJXDN0KYWZK8227Q",
                "name": "Simple Theme",
                "domain": "simple",
                "created_at": "2026-09-13T19:29:04.000000Z",
                "updated_at": "2026-09-13T19:29:04.000000Z",
                "statistics": {
                    "projects_count": 1,
                    "is_default": false
                }
            },
            {
                "theme_id": "C6GDH7FGYAW7JE32KA5ES5EHHN",
                "name": "Simple Theme",
                "domain": "simple",
                "created_at": "2026-09-13T19:30:47.000000Z",
                "updated_at": "2026-09-13T19:30:47.000000Z",
                "statistics": {
                    "projects_count": 1,
                    "is_default": false
                }
            },
            {
                "theme_id": "QDEET0HVSC5CRJPJ5BJJAA3TRQ",
                "name": "Story Theme",
                "domain": "story",
                "created_at": "2025-12-17T15:11:38.000000Z",
                "updated_at": "2025-12-17T15:11:38.000000Z",
                "statistics": {
                    "projects_count": 5170,
                    "is_default": false
                },
                "badge": "Story",
                "version": "1.0.0",
                "description": "Interactive stories with characters, dialogs, chapters and scenes",
                "nodes": {
                    "start": {
                        "name": "Start",
                        "description": "The origin of the narrative - the beginning of all paths",
                        "forms": {
                            "label": {
                                "form": "input",
                                "label": "Label",
                                "placeholder": "Start",
                                "required": false,
                                "isLabel": true
                            }
                        },
                        "graph": {
                            "component": "StartNode",
                            "props": []
                        }
                    },
                    "end": {
                        "name": "End",
                        "description": "The conclusion of the narrative - where all paths converge",
                        "forms": {
                            "label": {
                                "form": "input",
                                "label": "Label",
                                "placeholder": "End",
                                "required": false,
                                "isLabel": true
                            }
                        },
                        "graph": {
                            "component": "EndNode",
                            "props": []
                        }
                    },
                    "character": {
                        "name": "Character",
                        "description": "Character with properties and profile",
                        "forms": {
                            "name": {
                                "form": "input",
                                "type": "string",
                                "required": true,
                                "label": "Character Name",
                                "isLabel": true,
                                "placeholder": "Enter character name..."
                            },
                            "description": {
                                "form": "textarea",
                                "type": "string",
                                "required": false,
                                "label": "Description",
                                "rows": 4,
                                "placeholder": "Character description..."
                            },
                            "traits": {
                                "form": "textarea",
                                "type": "string",
                                "required": false,
                                "label": "Traits",
                                "rows": 3,
                                "placeholder": "Character traits (e.g. brave, shy...)"
                            }
                        },
                        "media": {
                            "image": {
                                "form": "upload",
                                "type": "file",
                                "label": "Character Image",
                                "formats": [
                                    "jpg",
                                    "jpeg",
                                    "png",
                                    "gif"
                                ],
                                "maxSize": "2MB"
                            },
                            "avatar": {
                                "form": "upload",
                                "type": "file",
                                "label": "Avatar/Portrait",
                                "formats": [
                                    "jpg",
                                    "jpeg",
                                    "png",
                                    "gif"
                                ],
                                "maxSize": "1MB"
                            }
                        },
                        "graph": {
                            "component": "MediaCard",
                            "props": {
                                "header": "{{self.content.name}}",
                                "content": "{{self.content.description}}",
                                "image": "{{self.media.image}}",
                                "imageAlign": "top"
                            }
                        }
                    },
                    "dialog": {
                        "name": "Dialog",
                        "description": "Start of a conversation between characters",
                        "forms": {
                            "title": {
                                "form": "input",
                                "type": "string",
                                "required": true,
                                "label": "Dialog Title",
                                "isLabel": true,
                                "placeholder": "What is the dialog about?"
                            },
                            "description": {
                                "form": "textarea",
                                "type": "string",
                                "required": false,
                                "label": "Description",
                                "rows": 4,
                                "placeholder": "Dialog description..."
                            }
                        },
                        "graph": {
                            "component": "Card",
                            "props": {
                                "header": "Dialog Start",
                                "content": "{{self.content.title}}: {{self.content.description}}"
                            }
                        }
                    },
                    "dialog-entry": {
                        "name": "Dialog Entry",
                        "description": "Individual speech contribution of a character",
                        "forms": {
                            "speaker": {
                                "form": "select",
                                "type": "string",
                                "required": true,
                                "label": "Speaker",
                                "options": [
                                    {
                                        "label": "{{node[{{character}}].content.name}}",
                                        "value": "{{node[{{character}}].public_id}}"
                                    }
                                ],
                                "placeholder": "Select character..."
                            },
                            "message": {
                                "form": "contentarea",
                                "type": "string",
                                "required": true,
                                "label": "Message",
                                "isLabel": true,
                                "rows": 4,
                                "placeholder": "What does the character say?"
                            }
                        },
                        "graph": {
                            "component": "MediaCard",
                            "props": {
                                "header": "{{node[id=(self.content.speaker)].content.name}}:",
                                "content": "\"{{self.content.message}}\"",
                                "image": "{{node[id=(self.content.speaker)].media.image}}",
                                "imageAlign": "left"
                            }
                        }
                    },
                    "chapter": {
                        "name": "Chapter",
                        "description": "A chapter of the game",
                        "forms": {
                            "title": {
                                "label": "Title",
                                "form": "input",
                                "type": "string",
                                "required": true,
                                "isLabel": true,
                                "placeholder": "The title of the chapter."
                            },
                            "summary": {
                                "label": "Summary",
                                "form": "textarea",
                                "type": "string",
                                "required": false,
                                "rows": 4,
                                "placeholder": "Brief summary of the chapter."
                            }
                        },
                        "graph": {
                            "component": "Card",
                            "props": {
                                "header": "Chapter: {{self.content.title}}",
                                "content": "{{self.content.summary}}"
                            }
                        }
                    },
                    "scene": {
                        "name": "Scene",
                        "description": "A scene within a chapter",
                        "forms": {
                            "title": {
                                "form": "input",
                                "type": "string",
                                "required": true,
                                "label": "Scene Title",
                                "isLabel": true,
                                "placeholder": "Name of the scene"
                            },
                            "description": {
                                "form": "textarea",
                                "type": "string",
                                "required": false,
                                "label": "Description",
                                "rows": 4,
                                "placeholder": "What happens in this scene?"
                            }
                        },
                        "graph": {
                            "component": "Card",
                            "props": {
                                "header": "Scene: {{self.content.title}}",
                                "content": "{{self.content.description}}"
                            }
                        }
                    },
                    "story-segment": {
                        "name": "Story Segment",
                        "description": "A segment of a story",
                        "forms": {
                            "title": {
                                "form": "input",
                                "type": "string",
                                "required": true,
                                "label": "Segment Title",
                                "isLabel": true,
                                "placeholder": "What is the segment about?"
                            },
                            "content": {
                                "form": "textarea",
                                "type": "string",
                                "required": false,
                                "label": "Content",
                                "rows": 4,
                                "placeholder": "Content of the story segment."
                            }
                        },
                        "graph": {
                            "component": "Card",
                            "props": {
                                "header": "Story Segment",
                                "content": "{{self.content.title}}: {{self.content.content}}"
                            }
                        }
                    }
                },
                "node_types": [
                    "start",
                    "end",
                    "character",
                    "dialog",
                    "dialog-entry",
                    "chapter",
                    "scene",
                    "story-segment"
                ],
                "edges": [
                    "flow",
                    "contains",
                    "link"
                ],
                "startNode": "start",
                "endNode": "end",
                "graph": {
                    "nodes": [
                        "start",
                        "end",
                        "character",
                        "dialog",
                        "dialog-entry",
                        "chapter",
                        "scene",
                        "story-segment"
                    ],
                    "edges": [
                        "flow",
                        "contains",
                        "link"
                    ]
                }
            },
            {
                "theme_id": "2XJVMN1E10E2733VFSQ3Q5E9FA",
                "name": "Test Dialog Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T17:21:17.000000Z",
                "updated_at": "2026-09-13T17:21:17.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "8ADCE40WDRQMC5H5BK377QK4WZ",
                "name": "Test Dialog Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T17:21:17.000000Z",
                "updated_at": "2026-09-13T17:21:17.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "8W3X8C5G1JY0KAKY6P3V4KM211",
                "name": "Test Dialog Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T17:21:17.000000Z",
                "updated_at": "2026-09-13T17:21:17.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "D4GM8N66GX0GTPJZPHXJHCSNS6",
                "name": "Test Dialog Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T17:23:53.000000Z",
                "updated_at": "2026-09-13T17:23:53.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "J85EYZFFA60GXYS1T4RWB993S8",
                "name": "Test Dialog Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T17:23:53.000000Z",
                "updated_at": "2026-09-13T17:23:53.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "F795APTET0BRVB4KDDD838AASP",
                "name": "Test Dialog Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T17:23:53.000000Z",
                "updated_at": "2026-09-13T17:23:53.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "HEJP8DMHNEJQZ3T1N1ZA8BKSF4",
                "name": "Test Dialog Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T17:25:01.000000Z",
                "updated_at": "2026-09-13T17:25:01.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "DTPSY73ZWZ7TPBFZX4ZGJQDPNR",
                "name": "Test Dialog Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T17:25:01.000000Z",
                "updated_at": "2026-09-13T17:25:01.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "4AYJS9EGPB0W9G1XJ01WB7T1T4",
                "name": "Test Dialog Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T17:25:01.000000Z",
                "updated_at": "2026-09-13T17:25:01.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "7T1HA2AT4001PQSAXJCW15G9VF",
                "name": "Test Dialog Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T17:25:38.000000Z",
                "updated_at": "2026-09-13T17:25:38.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "B23PPT1PX1J9AMM4RTZPGBZKX8",
                "name": "Test Dialog Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T17:25:38.000000Z",
                "updated_at": "2026-09-13T17:25:38.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "85W6KDDAWVNX1TM385KXQ6SH7P",
                "name": "Test Dialog Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T17:25:38.000000Z",
                "updated_at": "2026-09-13T17:25:38.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "JZVZA7N7J37XRM5TYWMBRYGCVX",
                "name": "Test Dialog Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T17:26:14.000000Z",
                "updated_at": "2026-09-13T17:26:14.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "RHVTPZHTGCPVAF6A9STAATWE6A",
                "name": "Test Dialog Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T17:26:14.000000Z",
                "updated_at": "2026-09-13T17:26:14.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "JV314N3RVMD3N843VBQFYN1WM0",
                "name": "Test Dialog Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T17:26:14.000000Z",
                "updated_at": "2026-09-13T17:26:14.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "AG0XW54NN6NNV3JSZS75VF4898",
                "name": "Test Dialog Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T17:27:07.000000Z",
                "updated_at": "2026-09-13T17:27:07.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "NK69FYN6PSF16KKWYRP4AFQNBP",
                "name": "Test Dialog Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T17:27:07.000000Z",
                "updated_at": "2026-09-13T17:27:07.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "DR9QHT5MYMG72NSDY3CV1P74PR",
                "name": "Test Dialog Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T17:27:07.000000Z",
                "updated_at": "2026-09-13T17:27:07.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "8DZDST0SC267YGJX12VWAY6E3Y",
                "name": "Test Dialog Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T17:29:07.000000Z",
                "updated_at": "2026-09-13T17:29:07.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "N1EPFRDM3HKWCBBA5E6R5CTGZY",
                "name": "Test Dialog Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T17:29:08.000000Z",
                "updated_at": "2026-09-13T17:29:08.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "SQ35MHEM8V662ZNJ4BR3EDFETB",
                "name": "Test Dialog Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T17:29:08.000000Z",
                "updated_at": "2026-09-13T17:29:08.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "8MFZ4WFHYEWQQSP0X8BH6W0PTD",
                "name": "Test Dialog Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T17:30:30.000000Z",
                "updated_at": "2026-09-13T17:30:30.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "691C9P0GYTPKDAD6PST0N9VXXJ",
                "name": "Test Dialog Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T17:30:30.000000Z",
                "updated_at": "2026-09-13T17:30:30.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "0QRRSXYBQCH7RGR3QJQAN4X6HH",
                "name": "Test Dialog Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T17:30:30.000000Z",
                "updated_at": "2026-09-13T17:30:30.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "27E1Z2NTJS9PF1226XHXDCTVX7",
                "name": "Test Dialog Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T17:30:52.000000Z",
                "updated_at": "2026-09-13T17:30:52.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "9AN36D1TNS4KWAW9FPGZRJJAPB",
                "name": "Test Dialog Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T17:30:53.000000Z",
                "updated_at": "2026-09-13T17:30:53.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "3AJFAARNDK10STV0EMRVCKZ1MP",
                "name": "Test Dialog Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T17:30:53.000000Z",
                "updated_at": "2026-09-13T17:30:53.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "2KP7W0PZR2DQ3YQVYEGKXD09KK",
                "name": "Test Dialog Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T17:41:40.000000Z",
                "updated_at": "2026-09-13T17:41:40.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "10118RYKZXZ5J5V0GREZ7YB5Q6",
                "name": "Test Dialog Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T17:41:40.000000Z",
                "updated_at": "2026-09-13T17:41:40.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "R55XN78VAVNS2WFB9CFCB8AVB2",
                "name": "Test Dialog Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T18:05:37.000000Z",
                "updated_at": "2026-09-13T18:05:37.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "D9E10S9XDJV1H82BQPAMRC8J7T",
                "name": "Test Dialog Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T18:05:37.000000Z",
                "updated_at": "2026-09-13T18:05:37.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "9DVQ352VG1ZNWW6S141TY43YQK",
                "name": "Test Dialog Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T18:05:37.000000Z",
                "updated_at": "2026-09-13T18:05:37.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "GD66HZ24RH2SQM2N638H9GC843",
                "name": "Test Dialog Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T18:06:01.000000Z",
                "updated_at": "2026-09-13T18:06:01.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "4C47MQYMY7YPJJ7J03T5G3BJMF",
                "name": "Test Dialog Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T18:06:01.000000Z",
                "updated_at": "2026-09-13T18:06:01.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "25HMK9MJ4B4HW5TE5YAX24NEQD",
                "name": "Test Dialog Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T18:06:01.000000Z",
                "updated_at": "2026-09-13T18:06:01.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "K7TK1Z3GMMECJB8X8XG686KX7P",
                "name": "Test Dialog Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T18:25:58.000000Z",
                "updated_at": "2026-09-13T18:25:58.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "1YND3QP4ASWPSG68JY8N8YX4QE",
                "name": "Test Dialog Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T18:25:58.000000Z",
                "updated_at": "2026-09-13T18:25:58.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "0SGDA1T84GGMM300E1416AX9HM",
                "name": "Test Dialog Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T18:25:58.000000Z",
                "updated_at": "2026-09-13T18:25:58.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "MFA1EECYY8Q8MCFPZG6Z74VH5W",
                "name": "Test Dialog Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T19:28:02.000000Z",
                "updated_at": "2026-09-13T19:28:02.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "Q1ZJCSWVGG87NX1HCYSNV4WEFC",
                "name": "Test Dialog Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T19:28:02.000000Z",
                "updated_at": "2026-09-13T19:28:02.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "DYNC59CAYWKG7AR9J9HSDEC7DY",
                "name": "Test Dialog Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T19:28:02.000000Z",
                "updated_at": "2026-09-13T19:28:02.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "DSDMGJY50TSYMY1ZEQ2C3DRHW2",
                "name": "Test Dialog Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T19:28:46.000000Z",
                "updated_at": "2026-09-13T19:28:46.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "CMKBFFE8M99NVSAKPZJRR13G93",
                "name": "Test Dialog Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T19:28:46.000000Z",
                "updated_at": "2026-09-13T19:28:46.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "YAR6NY30SGK51FR1E6TWCPK76E",
                "name": "Test Dialog Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T19:28:46.000000Z",
                "updated_at": "2026-09-13T19:28:46.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "RRJ50M3WNEPMTF8NQDVMYFX2PF",
                "name": "Test Dialog Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T19:29:04.000000Z",
                "updated_at": "2026-09-13T19:29:04.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "JN68XT2SWBVT52GG9GABVX098B",
                "name": "Test Dialog Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T19:29:04.000000Z",
                "updated_at": "2026-09-13T19:29:04.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "700G4MAJ1EV5W0P3HC2QCAD1SF",
                "name": "Test Dialog Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T19:29:05.000000Z",
                "updated_at": "2026-09-13T19:29:05.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "BP5M7VVQNKFQ67SXA1FSQRW92X",
                "name": "Test Dialog Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T19:30:46.000000Z",
                "updated_at": "2026-09-13T19:30:46.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "VQY38TEZP95MVXCZPJQKAPDNV7",
                "name": "Test Dialog Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T19:30:46.000000Z",
                "updated_at": "2026-09-13T19:30:46.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "509Z7JX31RYE97N0KVQ8RV9SN8",
                "name": "Test Dialog Theme",
                "domain": "dialog",
                "created_at": "2026-09-13T19:30:46.000000Z",
                "updated_at": "2026-09-13T19:30:46.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": true
                }
            },
            {
                "theme_id": "B9HWW9DPM4FSC8QSYF1H9TS5Q2",
                "name": "unique_name_1",
                "domain": "unique_domain_1",
                "created_at": "2026-09-13T17:21:57.000000Z",
                "updated_at": "2026-09-13T17:21:57.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": false
                }
            },
            {
                "theme_id": "B7PEPSEHRWKREXZYP68T0FCMBC",
                "name": "unique_name_1",
                "domain": "unique_domain_1",
                "created_at": "2026-09-13T17:24:46.000000Z",
                "updated_at": "2026-09-13T17:24:46.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": false
                }
            },
            {
                "theme_id": "GACXDQADHJGC5ZPYYRCV1EVNVP",
                "name": "unique_name_1",
                "domain": "unique_domain_1",
                "created_at": "2026-09-13T17:25:25.000000Z",
                "updated_at": "2026-09-13T17:25:25.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": false
                }
            },
            {
                "theme_id": "55C3PX6PSH5MPW3SEYGK8VPW8D",
                "name": "unique_name_1",
                "domain": "unique_domain_1",
                "created_at": "2026-09-13T17:26:25.000000Z",
                "updated_at": "2026-09-13T17:26:25.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": false
                }
            },
            {
                "theme_id": "JRX2Q525XCRS4E5ZEESRZ0TZV7",
                "name": "unique_name_1",
                "domain": "unique_domain_1",
                "created_at": "2026-09-13T17:28:11.000000Z",
                "updated_at": "2026-09-13T17:28:11.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": false
                }
            },
            {
                "theme_id": "6KR4S8ARD8X13KCVD4H8YGV8C9",
                "name": "unique_name_1",
                "domain": "unique_domain_1",
                "created_at": "2026-09-13T17:29:19.000000Z",
                "updated_at": "2026-09-13T17:29:19.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": false
                }
            },
            {
                "theme_id": "CPDZMS526HXGFDK8YBTJ5J6XPB",
                "name": "unique_name_1",
                "domain": "unique_domain_1",
                "created_at": "2026-09-13T17:29:43.000000Z",
                "updated_at": "2026-09-13T17:29:43.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": false
                }
            },
            {
                "theme_id": "ZZKNJX1GJ8TBQ5RVQ91KKYZNTP",
                "name": "unique_name_1",
                "domain": "unique_domain_1",
                "created_at": "2026-09-13T17:31:13.000000Z",
                "updated_at": "2026-09-13T17:31:13.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": false
                }
            },
            {
                "theme_id": "FCY50X2T68FBVKE260WX104932",
                "name": "unique_name_1",
                "domain": "unique_domain_1",
                "created_at": "2026-09-13T17:36:24.000000Z",
                "updated_at": "2026-09-13T17:36:24.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": false
                }
            },
            {
                "theme_id": "7G4KDQKBBSVK8HF0K2X7BYKP7B",
                "name": "unique_name_1",
                "domain": "unique_domain_1",
                "created_at": "2026-09-13T17:51:34.000000Z",
                "updated_at": "2026-09-13T17:51:34.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": false
                }
            },
            {
                "theme_id": "EHT5WB31SARWBY35J74WQ374TX",
                "name": "unique_name_1",
                "domain": "unique_domain_1",
                "created_at": "2026-09-13T17:55:29.000000Z",
                "updated_at": "2026-09-13T17:55:29.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": false
                }
            },
            {
                "theme_id": "AMG9ZQSJQ8KS5CMN59SMJ4ECE2",
                "name": "unique_name_1",
                "domain": "unique_domain_1",
                "created_at": "2026-09-13T19:24:27.000000Z",
                "updated_at": "2026-09-13T19:24:27.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": false
                }
            },
            {
                "theme_id": "66DF6P6GPJ0690WVTW9RPJ6MPM",
                "name": "unique_name_1",
                "domain": "unique_domain_1",
                "created_at": "2026-09-13T19:25:32.000000Z",
                "updated_at": "2026-09-13T19:25:32.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": false
                }
            },
            {
                "theme_id": "ZAYXH05AFSCJVH5C6NKPYG83GS",
                "name": "unique_name_1",
                "domain": "unique_domain_1",
                "created_at": "2026-09-13T19:26:50.000000Z",
                "updated_at": "2026-09-13T19:26:50.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": false
                }
            },
            {
                "theme_id": "DMG89J6FFRT96K7T5QQ6M40MQF",
                "name": "unique_name_1",
                "domain": "unique_domain_1",
                "created_at": "2026-09-13T19:29:25.000000Z",
                "updated_at": "2026-09-13T19:29:25.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": false
                }
            },
            {
                "theme_id": "2SGPG8P3C1TCHXQBXJX6TR7VFS",
                "name": "unique_name_1",
                "domain": "unique_domain_1",
                "created_at": "2026-09-13T19:31:11.000000Z",
                "updated_at": "2026-09-13T19:31:11.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": false
                }
            },
            {
                "theme_id": "3WJKDNHZBW5H1521A9V1VW9XD4",
                "name": "unique_name_1",
                "domain": "unique_domain_1",
                "created_at": "2026-09-13T19:31:49.000000Z",
                "updated_at": "2026-09-13T19:31:49.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": false
                }
            },
            {
                "theme_id": "BVY28VSYCKDW3NNK9J76D7W80J",
                "name": "unique_name_1",
                "domain": "unique_domain_1",
                "created_at": "2026-09-13T19:36:38.000000Z",
                "updated_at": "2026-09-13T19:36:38.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": false
                }
            },
            {
                "theme_id": "THSYG59DCT11KT7QPRP44REZCD",
                "name": "unique_name_2",
                "domain": "unique_domain_2",
                "created_at": "2026-09-13T17:21:57.000000Z",
                "updated_at": "2026-09-13T17:21:57.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": false
                }
            },
            {
                "theme_id": "B5BD49XSCZQM3PRWN6RE0SYA16",
                "name": "unique_name_2",
                "domain": "unique_domain_2",
                "created_at": "2026-09-13T17:24:46.000000Z",
                "updated_at": "2026-09-13T17:24:46.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": false
                }
            },
            {
                "theme_id": "FR7Y4ATJE2FFWMKJ46DHAQDX9H",
                "name": "unique_name_2",
                "domain": "unique_domain_2",
                "created_at": "2026-09-13T17:25:25.000000Z",
                "updated_at": "2026-09-13T17:25:25.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": false
                }
            },
            {
                "theme_id": "FE0SRMC539JYQ87349THG94BJS",
                "name": "unique_name_2",
                "domain": "unique_domain_2",
                "created_at": "2026-09-13T17:26:25.000000Z",
                "updated_at": "2026-09-13T17:26:25.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": false
                }
            },
            {
                "theme_id": "NZF1F4T559J77AWTK2G8MJQZZ0",
                "name": "unique_name_2",
                "domain": "unique_domain_2",
                "created_at": "2026-09-13T17:28:11.000000Z",
                "updated_at": "2026-09-13T17:28:11.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": false
                }
            },
            {
                "theme_id": "SBXQYRF4JCT4WJ58RP9PMPP15K",
                "name": "unique_name_2",
                "domain": "unique_domain_2",
                "created_at": "2026-09-13T17:29:19.000000Z",
                "updated_at": "2026-09-13T17:29:19.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": false
                }
            },
            {
                "theme_id": "JEWXK18C5WQCE7AP8YR8REQBWR",
                "name": "unique_name_2",
                "domain": "unique_domain_2",
                "created_at": "2026-09-13T17:29:43.000000Z",
                "updated_at": "2026-09-13T17:29:43.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": false
                }
            },
            {
                "theme_id": "V3E2VWM83P48V215P18E6WXRWF",
                "name": "unique_name_2",
                "domain": "unique_domain_2",
                "created_at": "2026-09-13T17:31:13.000000Z",
                "updated_at": "2026-09-13T17:31:13.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": false
                }
            },
            {
                "theme_id": "AZE9EJ55SJN1F5BYNFZ7XNKCBW",
                "name": "unique_name_2",
                "domain": "unique_domain_2",
                "created_at": "2026-09-13T17:36:24.000000Z",
                "updated_at": "2026-09-13T17:36:24.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": false
                }
            },
            {
                "theme_id": "TGYZPT7YD34R04WK0BVZHQ1V56",
                "name": "unique_name_2",
                "domain": "unique_domain_2",
                "created_at": "2026-09-13T17:51:34.000000Z",
                "updated_at": "2026-09-13T17:51:34.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": false
                }
            },
            {
                "theme_id": "AW03NC85JPQ15MJ4QE8BSE95BB",
                "name": "unique_name_2",
                "domain": "unique_domain_2",
                "created_at": "2026-09-13T17:55:29.000000Z",
                "updated_at": "2026-09-13T17:55:29.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": false
                }
            },
            {
                "theme_id": "JN6VM1242J9WBF84V2W84E716S",
                "name": "unique_name_2",
                "domain": "unique_domain_2",
                "created_at": "2026-09-13T19:24:27.000000Z",
                "updated_at": "2026-09-13T19:24:27.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": false
                }
            },
            {
                "theme_id": "MBAKBVFB6ED9Q6DCRJYWYFG0PW",
                "name": "unique_name_2",
                "domain": "unique_domain_2",
                "created_at": "2026-09-13T19:25:32.000000Z",
                "updated_at": "2026-09-13T19:25:32.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": false
                }
            },
            {
                "theme_id": "KB91SS0D3ZE39M0EB4G8MJZD9E",
                "name": "unique_name_2",
                "domain": "unique_domain_2",
                "created_at": "2026-09-13T19:26:50.000000Z",
                "updated_at": "2026-09-13T19:26:50.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": false
                }
            },
            {
                "theme_id": "WXATS5BMB8VE060P16V1KQZDK6",
                "name": "unique_name_2",
                "domain": "unique_domain_2",
                "created_at": "2026-09-13T19:29:25.000000Z",
                "updated_at": "2026-09-13T19:29:25.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": false
                }
            },
            {
                "theme_id": "XJTHNWN9GQ5VZ6N64HNG7ZM1KW",
                "name": "unique_name_2",
                "domain": "unique_domain_2",
                "created_at": "2026-09-13T19:31:11.000000Z",
                "updated_at": "2026-09-13T19:31:11.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": false
                }
            },
            {
                "theme_id": "VF8S9Y68X06Y39DMMGAJMQEN32",
                "name": "unique_name_2",
                "domain": "unique_domain_2",
                "created_at": "2026-09-13T19:31:49.000000Z",
                "updated_at": "2026-09-13T19:31:49.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": false
                }
            },
            {
                "theme_id": "E5Y4YNBKCTHC77QC0WHSZ8PNYE",
                "name": "unique_name_2",
                "domain": "unique_domain_2",
                "created_at": "2026-09-13T19:36:38.000000Z",
                "updated_at": "2026-09-13T19:36:38.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": false
                }
            }
        ]
    },
    "meta": {
        "total_count": 231,
        "timestamp": "2026-09-13T19:38:09.220549Z"
    }
}

{
    "method": "GET",
    "url": "https://tellstree.com/api/themes",
    "headers": {
        "Accept": "application/json"
    },
    "query_parameters": {
        "page": "1",
        "per_page": "15"
    }
}

// TellsTree API - List All Themes
// This example demonstrates how to fetch all available themes from the TellsTree API

const API_BASE_URL = 'https://tellstree.com/api';

/**
 * Fetch all themes from TellsTree API
 * @param {Object} options - Configuration options
 * @param {number} options.page - Page number (default: 1)
 * @param {number} options.per_page - Items per page (default: 15)
 * @returns {Promise<Object>} Themes data
 */
async function listAllThemes(options = {}) {
    const { page = 1, per_page = 15 } = options;
    
    // Build query parameters
    const params = new URLSearchParams({
        page: page.toString(),
        per_page: per_page.toString()
    });
    
    const url = `${API_BASE_URL}/themes?${params}`;
    
    try {
        const response = await fetch(url, {
            method: 'GET',
            headers: {
                'Accept': 'application/json',
                'Content-Type': 'application/json'
            }
        });
        
        if (!response.ok) {
            throw new Error(`HTTP error! status: ${response.status}`);
        }
        
        const data = await response.json();
        return data;
        
    } catch (error) {
        console.error('Error fetching themes:', error);
        throw error;
    }
}

/**
 * Example usage
 */
async function example() {
    try {
        console.log('Fetching themes...');
        
        // Get first page of themes
        const themes = await listAllThemes();
        console.log('Themes received:', themes);
        
        // Get specific page with custom page size
        const customPageThemes = await listAllThemes({ page: 1, per_page: 10 });
        console.log('Custom page themes:', customPageThemes);
        
    } catch (error) {
        console.error('Example failed:', error);
    }
}

// Export for module usage
if (typeof module !== 'undefined' && module.exports) {
    module.exports = { listAllThemes };
}

// Run example if called directly
if (require.main === module) {
    example();
}

#!/usr/bin/env python3
"""
TellsTree API - List All Themes
This example demonstrates how to fetch all available themes from the TellsTree API
"""

import requests
import json
from typing import Optional, Dict, Any

API_BASE_URL = 'https://tellstree.com/api'

def list_all_themes(page: int = 1, per_page: int = 15) -> Dict[str, Any]:
    """
    Fetch all themes from TellsTree API
    
    Args:
        page (int): Page number (default: 1)
        per_page (int): Items per page (default: 15)
        
    Returns:
        Dict[str, Any]: Themes data
        
    Raises:
        requests.RequestException: If the API request fails
    """
    url = f"{API_BASE_URL}/themes"
    
    params = {
        'page': page,
        'per_page': per_page
    }
    
    headers = {
        'Accept': 'application/json',
        'Content-Type': 'application/json'
    }
    
    try:
        response = requests.get(url, params=params, headers=headers)
        response.raise_for_status()
        
        return response.json()
        
    except requests.RequestException as e:
        print(f"Error fetching themes: {e}")
        raise

def main():
    """Example usage"""
    try:
        print("Fetching themes...")
        
        # Get first page of themes
        themes = list_all_themes()
        print(f"Themes received: {json.dumps(themes, indent=2)}")
        
        # Get specific page with custom page size
        custom_page_themes = list_all_themes(page=1, per_page=10)
        print(f"Custom page themes: {json.dumps(custom_page_themes, indent=2)}")
        
    except Exception as e:
        print(f"Example failed: {e}")

if __name__ == '__main__':
    main()

<?php
/**
 * TellsTree API - List All Themes
 * This example demonstrates how to fetch all available themes from the TellsTree API
 */

const API_BASE_URL = 'https://tellstree.com/api';

/**
 * Fetch all themes from TellsTree API
 * 
 * @param int $page Page number (default: 1)
 * @param int $per_page Items per page (default: 15)
 * @return array Themes data
 * @throws Exception If the API request fails
 */
function listAllThemes($page = 1, $per_page = 15) {
    $url = API_BASE_URL . '/themes';
    
    // Build query parameters
    $queryParams = http_build_query([
        'page' => $page,
        'per_page' => $per_page
    ]);
    
    $fullUrl = $url . '?' . $queryParams;
    
    // Setup request headers
    $headers = [
        'Accept: application/json',
        'Content-Type: application/json'
    ];
    
    // Create context for the request
    $context = stream_context_create([
        'http' => [
            'method' => 'GET',
            'header' => implode("\r\n", $headers),
            'timeout' => 30
        ]
    ]);
    
    // Make the request
    $response = @file_get_contents($fullUrl, false, $context);
    
    if ($response === false) {
        $error = error_get_last();
        throw new Exception("Error fetching themes: " . ($error['message'] ?? 'Unknown error'));
    }
    
    // Parse the response
    $data = json_decode($response, true);
    
    if (json_last_error() !== JSON_ERROR_NONE) {
        throw new Exception("Error parsing JSON response: " . json_last_error_msg());
    }
    
    return $data;
}

/**
 * Example usage
 */
function example() {
    try {
        echo "Fetching themes...\n";
        
        // Get first page of themes
        $themes = listAllThemes();
        echo "Themes received:\n" . json_encode($themes, JSON_PRETTY_PRINT) . "\n";
        
        // Get specific page with custom page size
        $customPageThemes = listAllThemes(1, 10);
        echo "Custom page themes:\n" . json_encode($customPageThemes, JSON_PRETTY_PRINT) . "\n";
        
    } catch (Exception $e) {
        echo "Example failed: " . $e->getMessage() . "\n";
    }
}

// Run example if called directly
if (basename(__FILE__) === basename($_SERVER['SCRIPT_NAME'] ?? '')) {
    example();
}
?>

curl -X GET "https://tellstree.com/api/themes?page=1&per_page=10" \
     -H "Authorization: Bearer your-jwt-token" \
     -H "Accept: application/json"

Get Specific Theme

Retrieve detailed information about a specific theme by its domain. This is a public endpoint and does not require authentication.

URL Parameters

theme - The unique domain identifier of the theme (e.g., "dialog")

Response

200 Success / Theme details

404 Theme not found

GEThttps://tellstree.com/api/themes/{slug}

{
    "data": {
        "theme": {
            "theme_id": "QDEET0HVSC5CRJPJ5BJJAA3TRQ",
            "name": "Story Theme",
            "domain": "story",
            "created_at": "2025-12-17T15:11:38.000000Z",
            "updated_at": "2025-12-17T15:11:38.000000Z",
            "statistics": {
                "projects_count": 5170,
                "is_default": false
            },
            "badge": "Story",
            "version": "1.0.0",
            "description": "Interactive stories with characters, dialogs, chapters and scenes",
            "nodes": {
                "start": {
                    "name": "Start",
                    "description": "The origin of the narrative - the beginning of all paths",
                    "forms": {
                        "label": {
                            "form": "input",
                            "label": "Label",
                            "placeholder": "Start",
                            "required": false,
                            "isLabel": true
                        }
                    },
                    "graph": {
                        "component": "StartNode",
                        "props": []
                    }
                },
                "end": {
                    "name": "End",
                    "description": "The conclusion of the narrative - where all paths converge",
                    "forms": {
                        "label": {
                            "form": "input",
                            "label": "Label",
                            "placeholder": "End",
                            "required": false,
                            "isLabel": true
                        }
                    },
                    "graph": {
                        "component": "EndNode",
                        "props": []
                    }
                },
                "character": {
                    "name": "Character",
                    "description": "Character with properties and profile",
                    "forms": {
                        "name": {
                            "form": "input",
                            "type": "string",
                            "required": true,
                            "label": "Character Name",
                            "isLabel": true,
                            "placeholder": "Enter character name..."
                        },
                        "description": {
                            "form": "textarea",
                            "type": "string",
                            "required": false,
                            "label": "Description",
                            "rows": 4,
                            "placeholder": "Character description..."
                        },
                        "traits": {
                            "form": "textarea",
                            "type": "string",
                            "required": false,
                            "label": "Traits",
                            "rows": 3,
                            "placeholder": "Character traits (e.g. brave, shy...)"
                        }
                    },
                    "media": {
                        "image": {
                            "form": "upload",
                            "type": "file",
                            "label": "Character Image",
                            "formats": [
                                "jpg",
                                "jpeg",
                                "png",
                                "gif"
                            ],
                            "maxSize": "2MB"
                        },
                        "avatar": {
                            "form": "upload",
                            "type": "file",
                            "label": "Avatar/Portrait",
                            "formats": [
                                "jpg",
                                "jpeg",
                                "png",
                                "gif"
                            ],
                            "maxSize": "1MB"
                        }
                    },
                    "graph": {
                        "component": "MediaCard",
                        "props": {
                            "header": "{{self.content.name}}",
                            "content": "{{self.content.description}}",
                            "image": "{{self.media.image}}",
                            "imageAlign": "top"
                        }
                    }
                },
                "dialog": {
                    "name": "Dialog",
                    "description": "Start of a conversation between characters",
                    "forms": {
                        "title": {
                            "form": "input",
                            "type": "string",
                            "required": true,
                            "label": "Dialog Title",
                            "isLabel": true,
                            "placeholder": "What is the dialog about?"
                        },
                        "description": {
                            "form": "textarea",
                            "type": "string",
                            "required": false,
                            "label": "Description",
                            "rows": 4,
                            "placeholder": "Dialog description..."
                        }
                    },
                    "graph": {
                        "component": "Card",
                        "props": {
                            "header": "Dialog Start",
                            "content": "{{self.content.title}}: {{self.content.description}}"
                        }
                    }
                },
                "dialog-entry": {
                    "name": "Dialog Entry",
                    "description": "Individual speech contribution of a character",
                    "forms": {
                        "speaker": {
                            "form": "select",
                            "type": "string",
                            "required": true,
                            "label": "Speaker",
                            "options": [
                                {
                                    "label": "{{node[{{character}}].content.name}}",
                                    "value": "{{node[{{character}}].public_id}}"
                                }
                            ],
                            "placeholder": "Select character..."
                        },
                        "message": {
                            "form": "contentarea",
                            "type": "string",
                            "required": true,
                            "label": "Message",
                            "isLabel": true,
                            "rows": 4,
                            "placeholder": "What does the character say?"
                        }
                    },
                    "graph": {
                        "component": "MediaCard",
                        "props": {
                            "header": "{{node[id=(self.content.speaker)].content.name}}:",
                            "content": "\"{{self.content.message}}\"",
                            "image": "{{node[id=(self.content.speaker)].media.image}}",
                            "imageAlign": "left"
                        }
                    }
                },
                "chapter": {
                    "name": "Chapter",
                    "description": "A chapter of the game",
                    "forms": {
                        "title": {
                            "label": "Title",
                            "form": "input",
                            "type": "string",
                            "required": true,
                            "isLabel": true,
                            "placeholder": "The title of the chapter."
                        },
                        "summary": {
                            "label": "Summary",
                            "form": "textarea",
                            "type": "string",
                            "required": false,
                            "rows": 4,
                            "placeholder": "Brief summary of the chapter."
                        }
                    },
                    "graph": {
                        "component": "Card",
                        "props": {
                            "header": "Chapter: {{self.content.title}}",
                            "content": "{{self.content.summary}}"
                        }
                    }
                },
                "scene": {
                    "name": "Scene",
                    "description": "A scene within a chapter",
                    "forms": {
                        "title": {
                            "form": "input",
                            "type": "string",
                            "required": true,
                            "label": "Scene Title",
                            "isLabel": true,
                            "placeholder": "Name of the scene"
                        },
                        "description": {
                            "form": "textarea",
                            "type": "string",
                            "required": false,
                            "label": "Description",
                            "rows": 4,
                            "placeholder": "What happens in this scene?"
                        }
                    },
                    "graph": {
                        "component": "Card",
                        "props": {
                            "header": "Scene: {{self.content.title}}",
                            "content": "{{self.content.description}}"
                        }
                    }
                },
                "story-segment": {
                    "name": "Story Segment",
                    "description": "A segment of a story",
                    "forms": {
                        "title": {
                            "form": "input",
                            "type": "string",
                            "required": true,
                            "label": "Segment Title",
                            "isLabel": true,
                            "placeholder": "What is the segment about?"
                        },
                        "content": {
                            "form": "textarea",
                            "type": "string",
                            "required": false,
                            "label": "Content",
                            "rows": 4,
                            "placeholder": "Content of the story segment."
                        }
                    },
                    "graph": {
                        "component": "Card",
                        "props": {
                            "header": "Story Segment",
                            "content": "{{self.content.title}}: {{self.content.content}}"
                        }
                    }
                }
            },
            "node_types": [
                "start",
                "end",
                "character",
                "dialog",
                "dialog-entry",
                "chapter",
                "scene",
                "story-segment"
            ],
            "edges": [
                "flow",
                "contains",
                "link"
            ],
            "startNode": "start",
            "endNode": "end",
            "graph": {
                "nodes": [
                    "start",
                    "end",
                    "character",
                    "dialog",
                    "dialog-entry",
                    "chapter",
                    "scene",
                    "story-segment"
                ],
                "edges": [
                    "flow",
                    "contains",
                    "link"
                ]
            }
        }
    },
    "meta": {
        "timestamp": "2026-09-13T19:38:09.323832Z"
    }
}

{
    "method": "GET",
    "url": "https://tellstree.com/api/themes/{theme}",
    "headers": {
        "Accept": "application/json"
    },
    "url_parameters": {
        "theme": "dialog"
    }
}

// TellsTree API - Get Specific Theme
// This example demonstrates how to fetch a specific theme by domain

const API_BASE_URL = 'https://tellstree.com/api';

/**
 * Fetch a specific theme by domain
 * @param {string} themeDomain - The domain identifier of the theme (e.g., 'dialog')
 * @returns {Promise<Object>} Theme data
 */
async function getTheme(themeDomain) {
    if (!themeDomain) {
        throw new Error('Theme domain is required');
    }
    
    const url = `${API_BASE_URL}/themes/${encodeURIComponent(themeDomain)}`;
    
    try {
        const response = await fetch(url, {
            method: 'GET',
            headers: {
                'Accept': 'application/json',
                'Content-Type': 'application/json'
            }
        });
        
        if (!response.ok) {
            if (response.status === 404) {
                throw new Error(`Theme '${themeDomain}' not found`);
            }
            throw new Error(`HTTP error! status: ${response.status}`);
        }
        
        const data = await response.json();
        return data;
        
    } catch (error) {
        console.error(`Error fetching theme '${themeDomain}':`, error);
        throw error;
    }
}

/**
 * Example usage
 */
async function example() {
    try {
        console.log('Fetching dialog theme...');
        
        // Get the dialog theme
        const dialogTheme = await getTheme('dialog');
        console.log('Dialog theme received:', dialogTheme);
        
        // Extract useful information
        console.log('Theme details:');
        console.log(`- Name: ${dialogTheme.data.theme.name}`);
        console.log(`- Domain: ${dialogTheme.data.theme.domain}`);
        console.log(`- Projects using this theme: ${dialogTheme.data.theme.statistics.projects_count}`);
        console.log(`- Available node types: ${dialogTheme.data.theme.node_types.join(', ')}`);
        
    } catch (error) {
        console.error('Example failed:', error);
    }
}

// Export for module usage
if (typeof module !== 'undefined' && module.exports) {
    module.exports = { getTheme };
}

// Run example if called directly
if (require.main === module) {
    example();
}

#!/usr/bin/env python3
"""
TellsTree API - Get Specific Theme
This example demonstrates how to fetch a specific theme by domain
"""

import requests
import json
from typing import Dict, Any

API_BASE_URL = 'https://tellstree.com/api'

def get_theme(theme_domain: str) -> Dict[str, Any]:
    """
    Fetch a specific theme by domain
    
    Args:
        theme_domain (str): The domain identifier of the theme (e.g., 'dialog')
        
    Returns:
        Dict[str, Any]: Theme data
        
    Raises:
        ValueError: If theme_domain is empty
        requests.RequestException: If the API request fails
    """
    if not theme_domain:
        raise ValueError('Theme domain is required')
    
    url = f"{API_BASE_URL}/themes/{theme_domain}"
    
    headers = {
        'Accept': 'application/json',
        'Content-Type': 'application/json'
    }
    
    try:
        response = requests.get(url, headers=headers)
        
        if response.status_code == 404:
            raise requests.RequestException(f"Theme '{theme_domain}' not found")
        
        response.raise_for_status()
        return response.json()
        
    except requests.RequestException as e:
        print(f"Error fetching theme '{theme_domain}': {e}")
        raise

def main():
    """Example usage"""
    try:
        print("Fetching dialog theme...")
        
        # Get the dialog theme
        dialog_theme = get_theme('dialog')
        print(f"Dialog theme received: {json.dumps(dialog_theme, indent=2)}")
        
        # Extract useful information
        theme_data = dialog_theme['data']['theme']
        print("\nTheme details:")
        print(f"- Name: {theme_data['name']}")
        print(f"- Domain: {theme_data['domain']}")
        print(f"- Projects using this theme: {theme_data['statistics']['projects_count']}")
        print(f"- Available node types: {', '.join(theme_data['node_types'])}")
        
    except Exception as e:
        print(f"Example failed: {e}")

if __name__ == '__main__':
    main()

<?php
/**
 * TellsTree API - Get Specific Theme
 * This example demonstrates how to fetch a specific theme by domain
 */

const API_BASE_URL = 'https://tellstree.com/api';

/**
 * Fetch a specific theme by domain
 * 
 * @param string $themeDomain The domain identifier of the theme (e.g., 'dialog')
 * @return array Theme data
 * @throws Exception If the API request fails or theme domain is empty
 */
function getTheme($themeDomain) {
    if (empty($themeDomain)) {
        throw new Exception('Theme domain is required');
    }
    
    $url = API_BASE_URL . '/themes/' . urlencode($themeDomain);
    
    // Setup request headers
    $headers = [
        'Accept: application/json',
        'Content-Type: application/json'
    ];
    
    // Create context for the request
    $context = stream_context_create([
        'http' => [
            'method' => 'GET',
            'header' => implode("\r\n", $headers),
            'timeout' => 30
        ]
    ]);
    
    // Make the request
    $response = @file_get_contents($url, false, $context);
    
    if ($response === false) {
        // Check if it's a 404 error
        if (isset($http_response_header)) {
            foreach ($http_response_header as $header) {
                if (strpos($header, '404') !== false) {
                    throw new Exception("Theme '$themeDomain' not found");
                }
            }
        }
        
        $error = error_get_last();
        throw new Exception("Error fetching theme '$themeDomain': " . ($error['message'] ?? 'Unknown error'));
    }
    
    // Parse the response
    $data = json_decode($response, true);
    
    if (json_last_error() !== JSON_ERROR_NONE) {
        throw new Exception("Error parsing JSON response: " . json_last_error_msg());
    }
    
    return $data;
}

/**
 * Example usage
 */
function example() {
    try {
        echo "Fetching dialog theme...\n";
        
        // Get the dialog theme
        $dialogTheme = getTheme('dialog');
        echo "Dialog theme received:\n" . json_encode($dialogTheme, JSON_PRETTY_PRINT) . "\n";
        
        // Extract useful information
        $themeData = $dialogTheme['data']['theme'];
        echo "\nTheme details:\n";
        echo "- Name: " . $themeData['name'] . "\n";
        echo "- Domain: " . $themeData['domain'] . "\n";
        echo "- Projects using this theme: " . $themeData['statistics']['projects_count'] . "\n";
        echo "- Available node types: " . implode(', ', $themeData['node_types']) . "\n";
        
    } catch (Exception $e) {
        echo "Example failed: " . $e->getMessage() . "\n";
    }
}

// Run example if called directly
if (basename(__FILE__) === basename($_SERVER['SCRIPT_NAME'] ?? '')) {
    example();
}
?>

curl -X GET "https://tellstree.com/api/themes/dialog" \
     -H "Authorization: Bearer your-jwt-token" \
     -H "Accept: application/json"

✨ Designs

Designs provide specific styling configurations within themes, allowing fine-grained control over the visual presentation of story elements.

GET /api/designs List all designs

GET /api/designs/{design} Get design by domain

List All Designs

Retrieve a list of all available designs. This is a public endpoint and does not require authentication.

Response

200 Success / Designs list

GEThttps://tellstree.com/api/designs

{
    "data": {
        "designs": [
            {
                "design_id": "1YMJCVSPEM79S5N7DM5XY54D4T",
                "name": "Original",
                "domain": "original",
                "created_at": "2025-12-17T15:11:38.000000Z",
                "updated_at": "2025-12-17T15:11:38.000000Z",
                "statistics": {
                    "projects_count": 5258,
                    "is_default": false
                },
                "version": "1.0.0",
                "description": "The original design recipe for TellsTree - timeless, refined, and expertly crafted.",
                "author": "TellsTree Team",
                "category": "classic",
                "preview": "foundation-preview.jpg",
                "colors": {
                    "primary": "#3B82F6",
                    "secondary": "#8B5CF6",
                    "accent": "#10B981",
                    "background": "#F8FAFC",
                    "surface": "#FFFFFF",
                    "text": {
                        "primary": "#1F2937",
                        "secondary": "#6B7280",
                        "muted": "#9CA3AF"
                    },
                    "border": "#E5E7EB",
                    "shadow": "rgba(0, 0, 0, 0.1)"
                },
                "typography": {
                    "fontFamily": {
                        "primary": "Inter, sans-serif",
                        "heading": "Inter, sans-serif",
                        "code": "JetBrains Mono, monospace"
                    },
                    "fontSize": {
                        "xs": "0.75rem",
                        "sm": "0.875rem",
                        "base": "1rem",
                        "lg": "1.125rem",
                        "xl": "1.25rem",
                        "2xl": "1.5rem",
                        "3xl": "1.875rem"
                    },
                    "fontWeight": {
                        "normal": "400",
                        "medium": "500",
                        "semibold": "600",
                        "bold": "700"
                    },
                    "lineHeight": {
                        "tight": "1.25",
                        "normal": "1.5",
                        "relaxed": "1.75"
                    }
                },
                "spacing": {
                    "xs": "0.25rem",
                    "sm": "0.5rem",
                    "md": "1rem",
                    "lg": "1.5rem",
                    "xl": "2rem",
                    "2xl": "3rem"
                },
                "borderRadius": {
                    "sm": "0.25rem",
                    "md": "0.375rem",
                    "lg": "0.5rem",
                    "xl": "0.75rem",
                    "full": "9999px"
                },
                "shadows": {
                    "sm": "0 1px 2px 0 rgba(0, 0, 0, 0.05)",
                    "md": "0 4px 6px -1px rgba(0, 0, 0, 0.1)",
                    "lg": "0 10px 15px -3px rgba(0, 0, 0, 0.1)",
                    "xl": "0 20px 25px -5px rgba(0, 0, 0, 0.1)"
                },
                "components": [
                    "Card",
                    "Circle",
                    "SpeechBubble",
                    "CharacterBadge",
                    "MediaCard",
                    "StartNode",
                    "EndNode",
                    "EdgeLabel"
                ]
            },
            {
                "design_id": "MSW92SWMCSMK1W3E5WX5TNKBRG",
                "name": "Original",
                "domain": "universal",
                "created_at": "2026-09-13T17:21:09.000000Z",
                "updated_at": "2026-09-13T17:21:09.000000Z",
                "statistics": {
                    "projects_count": 452,
                    "is_default": true
                },
                "version": "1.0.0",
                "description": "The original design recipe for TellsTree - timeless, refined, and expertly crafted.",
                "author": "TellsTree Team",
                "category": "classic",
                "preview": "foundation-preview.jpg",
                "colors": {
                    "primary": "#3B82F6",
                    "secondary": "#8B5CF6",
                    "accent": "#10B981",
                    "background": "#F8FAFC",
                    "surface": "#FFFFFF",
                    "text": {
                        "primary": "#1F2937",
                        "secondary": "#6B7280",
                        "muted": "#9CA3AF"
                    },
                    "border": "#E5E7EB",
                    "shadow": "rgba(0, 0, 0, 0.1)"
                },
                "typography": {
                    "fontFamily": {
                        "primary": "Inter, sans-serif",
                        "heading": "Inter, sans-serif",
                        "code": "JetBrains Mono, monospace"
                    },
                    "fontSize": {
                        "xs": "0.75rem",
                        "sm": "0.875rem",
                        "base": "1rem",
                        "lg": "1.125rem",
                        "xl": "1.25rem",
                        "2xl": "1.5rem",
                        "3xl": "1.875rem"
                    },
                    "fontWeight": {
                        "normal": "400",
                        "medium": "500",
                        "semibold": "600",
                        "bold": "700"
                    },
                    "lineHeight": {
                        "tight": "1.25",
                        "normal": "1.5",
                        "relaxed": "1.75"
                    }
                },
                "spacing": {
                    "xs": "0.25rem",
                    "sm": "0.5rem",
                    "md": "1rem",
                    "lg": "1.5rem",
                    "xl": "2rem",
                    "2xl": "3rem"
                },
                "borderRadius": {
                    "sm": "0.25rem",
                    "md": "0.375rem",
                    "lg": "0.5rem",
                    "xl": "0.75rem",
                    "full": "9999px"
                },
                "shadows": {
                    "sm": "0 1px 2px 0 rgba(0, 0, 0, 0.05)",
                    "md": "0 4px 6px -1px rgba(0, 0, 0, 0.1)",
                    "lg": "0 10px 15px -3px rgba(0, 0, 0, 0.1)",
                    "xl": "0 20px 25px -5px rgba(0, 0, 0, 0.1)"
                },
                "components": [
                    "Card",
                    "Circle",
                    "SpeechBubble",
                    "CharacterBadge",
                    "MediaCard",
                    "StartNode",
                    "EndNode",
                    "EdgeLabel"
                ]
            },
            {
                "design_id": "FR7RM1CHXRFE0YSX0T0MXYJ2WY",
                "name": "unique_test_1",
                "domain": "test_domain_1",
                "created_at": "2026-09-13T17:20:26.000000Z",
                "updated_at": "2026-09-13T17:20:26.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": false
                }
            },
            {
                "design_id": "5FN8QQS4PPQ5G0F9SKQNEVRK7N",
                "name": "unique_test_2",
                "domain": "test_domain_2",
                "created_at": "2026-09-13T17:20:26.000000Z",
                "updated_at": "2026-09-13T17:20:26.000000Z",
                "statistics": {
                    "projects_count": 0,
                    "is_default": false
                }
            }
        ]
    },
    "meta": {
        "total_count": 4,
        "timestamp": "2026-09-13T19:37:53.117634Z"
    }
}

{
    "method": "GET",
    "url": "/api/designs",
    "headers": [],
    "payload": null,
    "recorded_at": "2026-09-13T19:37:53+00:00"
}

// TellsTree SDK - Designs API (JavaScript)
// List all designs (public endpoint)

const API_BASE_URL = 'https://tellstree.com/api';

/**
 * Get all available designs (public endpoint - no authentication required)
 * @returns {Promise<Object>} API response with designs data
 */
async function listAllDesigns() {
    try {
        const response = await fetch(`${API_BASE_URL}/designs`, {
            method: 'GET',
            headers: {
                'Accept': 'application/json'
            }
        });

        if (!response.ok) {
            throw new Error(`HTTP ${response.status}: ${response.statusText}`);
        }

        const data = await response.json();
        return data;
    } catch (error) {
        console.error('Error fetching designs:', error);
        throw error;
    }
}

// Example usage (only runs when executed directly)
if (typeof require !== 'undefined' && require.main === module) {
    // Example: Get all designs
    listAllDesigns()
        .then(result => {
            console.log('All Designs:');
            console.log(JSON.stringify(result, null, 2));
        })
        .catch(error => {
            console.error('Failed to fetch designs:', error.message);
        });
}

// Export for use in other modules
if (typeof module !== 'undefined' && module.exports) {
    module.exports = { listAllDesigns };
}

"""
TellsTree SDK - Designs API (Python)
List all designs (public endpoint)
"""

import requests
import json
from typing import Dict, Any

API_BASE_URL = "https://tellstree.com/api"

def list_all_designs() -> Dict[str, Any]:
    """
    Get all available designs (public endpoint - no authentication required)
    
    Returns:
        Dict[str, Any]: API response with designs data
        
    Raises:
        requests.RequestException: If the API request fails
        ValueError: If the response cannot be parsed as JSON
    """
    try:
        headers = {
            'Accept': 'application/json'
        }
        
        response = requests.get(f"{API_BASE_URL}/designs", headers=headers)
        response.raise_for_status()
        
        return response.json()
        
    except requests.RequestException as e:
        print(f"Error fetching designs: {e}")
        raise
    except json.JSONDecodeError as e:
        print(f"Error parsing JSON response: {e}")
        raise ValueError("Invalid JSON response from API")

def main():
    """Example usage of the designs API"""
    try:
        # Get all designs
        result = list_all_designs()
        print("All Designs:")
        print(json.dumps(result, indent=2))
        
    except Exception as e:
        print(f"Failed to fetch designs: {e}")

if __name__ == "__main__":
    main()

<?php
/**
 * TellsTree SDK - Designs API (PHP)
 * List all designs (public endpoint)
 */

const API_BASE_URL = 'https://tellstree.com/api';

/**
 * Get all available designs (public endpoint - no authentication required)
 * 
 * @return array API response with designs data
 * @throws Exception If the API request fails
 */
function listAllDesigns() {
    $url = API_BASE_URL . "/designs";
    
    $context = stream_context_create([
        'http' => [
            'method' => 'GET',
            'header' => [
                'Accept: application/json'
            ],
            'ignore_errors' => true
        ]
    ]);
    
    $response = file_get_contents($url, false, $context);
    
    if ($response === false) {
        throw new Exception('Failed to make API request');
    }
    
    // Get HTTP status code
    $statusLine = $http_response_header[0] ?? '';
    preg_match('/\d{3}/', $statusLine, $matches);
    $statusCode = $matches[0] ?? 0;
    
    if ($statusCode >= 400) {
        $errorData = json_decode($response, true);
        $message = $errorData['message'] ?? 'HTTP Error ' . $statusCode;
        throw new Exception($message, (int)$statusCode);
    }
    
    $data = json_decode($response, true);
    
    if (json_last_error() !== JSON_ERROR_NONE) {
        throw new Exception('Invalid JSON response: ' . json_last_error_msg());
    }
    
    return $data;
}

// Example usage (only runs when executed directly)
if (basename(__FILE__) === basename($_SERVER['SCRIPT_FILENAME'])) {
    try {
        // Get all designs
        $result = listAllDesigns();
        echo "All Designs:\n";
        echo json_encode($result, JSON_PRETTY_PRINT) . "\n";
        
    } catch (Exception $e) {
        echo "Failed to fetch designs: " . $e->getMessage() . "\n";
        exit(1);
    }
}
?>

curl -H "Accept: application/json" \
     "https://tellstree.com/api/designs"

Get Specific Design

Retrieve detailed configuration for a specific design by its domain identifier.

URL Parameters

design - The domain identifier of the design

Response

200 Success / Design details

404 Design not found

GEThttps://tellstree.com/api/designs/{design}

{
    "data": {
        "design": {
            "design_id": "1YMJCVSPEM79S5N7DM5XY54D4T",
            "name": "Original",
            "domain": "original",
            "created_at": "2025-12-17T15:11:38.000000Z",
            "updated_at": "2025-12-17T15:11:38.000000Z",
            "statistics": {
                "projects_count": 5258,
                "is_default": false
            },
            "version": "1.0.0",
            "description": "The original design recipe for TellsTree - timeless, refined, and expertly crafted.",
            "author": "TellsTree Team",
            "category": "classic",
            "preview": "foundation-preview.jpg",
            "colors": {
                "primary": "#3B82F6",
                "secondary": "#8B5CF6",
                "accent": "#10B981",
                "background": "#F8FAFC",
                "surface": "#FFFFFF",
                "text": {
                    "primary": "#1F2937",
                    "secondary": "#6B7280",
                    "muted": "#9CA3AF"
                },
                "border": "#E5E7EB",
                "shadow": "rgba(0, 0, 0, 0.1)"
            },
            "typography": {
                "fontFamily": {
                    "primary": "Inter, sans-serif",
                    "heading": "Inter, sans-serif",
                    "code": "JetBrains Mono, monospace"
                },
                "fontSize": {
                    "xs": "0.75rem",
                    "sm": "0.875rem",
                    "base": "1rem",
                    "lg": "1.125rem",
                    "xl": "1.25rem",
                    "2xl": "1.5rem",
                    "3xl": "1.875rem"
                },
                "fontWeight": {
                    "normal": "400",
                    "medium": "500",
                    "semibold": "600",
                    "bold": "700"
                },
                "lineHeight": {
                    "tight": "1.25",
                    "normal": "1.5",
                    "relaxed": "1.75"
                }
            },
            "spacing": {
                "xs": "0.25rem",
                "sm": "0.5rem",
                "md": "1rem",
                "lg": "1.5rem",
                "xl": "2rem",
                "2xl": "3rem"
            },
            "borderRadius": {
                "sm": "0.25rem",
                "md": "0.375rem",
                "lg": "0.5rem",
                "xl": "0.75rem",
                "full": "9999px"
            },
            "shadows": {
                "sm": "0 1px 2px 0 rgba(0, 0, 0, 0.05)",
                "md": "0 4px 6px -1px rgba(0, 0, 0, 0.1)",
                "lg": "0 10px 15px -3px rgba(0, 0, 0, 0.1)",
                "xl": "0 20px 25px -5px rgba(0, 0, 0, 0.1)"
            },
            "components": [
                "Card",
                "Circle",
                "SpeechBubble",
                "CharacterBadge",
                "MediaCard",
                "StartNode",
                "EndNode",
                "EdgeLabel"
            ]
        }
    },
    "meta": {
        "timestamp": "2026-09-13T19:37:53.142567Z"
    }
}

{
    "method": "GET",
    "url": "/api/designs/original",
    "headers": [],
    "payload": null,
    "recorded_at": "2026-09-13T19:37:53+00:00"
}

// TellsTree SDK - Designs API (JavaScript)
// Get specific design by domain (public endpoint)

const API_BASE_URL = 'https://tellstree.com/api';

/**
 * Get a specific design by domain (public endpoint - no authentication required)
 * @param {string} designDomain - The domain identifier of the design (e.g., 'original', 'modern')
 * @returns {Promise<Object>} API response with design data
 */
async function getDesign(designDomain) {
    try {
        const response = await fetch(`${API_BASE_URL}/designs/${designDomain}`, {
            method: 'GET',
            headers: {
                'Accept': 'application/json'
            }
        });

        if (!response.ok) {
            throw new Error(`HTTP ${response.status}: ${response.statusText}`);
        }

        const data = await response.json();
        return data;
    } catch (error) {
        console.error('Error fetching design:', error);
        throw error;
    }
}

// Example usage (only runs when executed directly)
if (typeof require !== 'undefined' && require.main === module) {
    // Example: Get the 'original' design
    getDesign('original')
        .then(result => {
            console.log('Original Design:');
            console.log(JSON.stringify(result, null, 2));
        })
        .catch(error => {
            console.error('Failed to fetch design:', error.message);
        });
}

// Export for use in other modules
if (typeof module !== 'undefined' && module.exports) {
    module.exports = { getDesign };
}

"""
TellsTree SDK - Designs API (Python)
Get specific design by domain (public endpoint)
"""

import requests
import json
from typing import Dict, Any

API_BASE_URL = "https://tellstree.com/api"

def get_design(design_domain: str) -> Dict[str, Any]:
    """
    Get a specific design by domain (public endpoint - no authentication required)
    
    Args:
        design_domain (str): The domain identifier of the design (e.g., 'original', 'modern')
        
    Returns:
        Dict[str, Any]: API response with design data
        
    Raises:
        requests.RequestException: If the API request fails
        ValueError: If the response cannot be parsed as JSON
    """
    try:
        headers = {
            'Accept': 'application/json'
        }
        
        response = requests.get(f"{API_BASE_URL}/designs/{design_domain}", headers=headers)
        response.raise_for_status()
        
        return response.json()
        
    except requests.RequestException as e:
        print(f"Error fetching design: {e}")
        raise
    except json.JSONDecodeError as e:
        print(f"Error parsing JSON response: {e}")
        raise ValueError("Invalid JSON response from API")

def main():
    """Example usage of the designs API"""
    try:
        # Get the 'original' design
        result = get_design('original')
        print("Original Design:")
        print(json.dumps(result, indent=2))
        
    except Exception as e:
        print(f"Failed to fetch design: {e}")

if __name__ == "__main__":
    main()

<?php
/**
 * TellsTree SDK - Designs API (PHP)
 * Get specific design by domain (public endpoint)
 */

const API_BASE_URL = 'https://tellstree.com/api';

/**
 * Get a specific design by domain (public endpoint - no authentication required)
 * 
 * @param string $designDomain The domain identifier of the design (e.g., 'original', 'modern')
 * @return array API response with design data
 * @throws Exception If the API request fails
 */
function getDesign($designDomain) {
    $url = API_BASE_URL . "/designs/{$designDomain}";
    
    $context = stream_context_create([
        'http' => [
            'method' => 'GET',
            'header' => [
                'Accept: application/json'
            ],
            'ignore_errors' => true
        ]
    ]);
    
    $response = file_get_contents($url, false, $context);
    
    if ($response === false) {
        throw new Exception('Failed to make API request');
    }
    
    // Get HTTP status code
    $statusLine = $http_response_header[0] ?? '';
    preg_match('/\d{3}/', $statusLine, $matches);
    $statusCode = $matches[0] ?? 0;
    
    if ($statusCode >= 400) {
        $errorData = json_decode($response, true);
        $message = $errorData['message'] ?? 'HTTP Error ' . $statusCode;
        throw new Exception($message, (int)$statusCode);
    }
    
    $data = json_decode($response, true);
    
    if (json_last_error() !== JSON_ERROR_NONE) {
        throw new Exception('Invalid JSON response: ' . json_last_error_msg());
    }
    
    return $data;
}

// Example usage (only runs when executed directly)
if (basename(__FILE__) === basename($_SERVER['SCRIPT_FILENAME'])) {
    try {
        // Get the 'original' design
        $result = getDesign('original');
        echo "Original Design:\n";
        echo json_encode($result, JSON_PRETTY_PRINT) . "\n";
        
    } catch (Exception $e) {
        echo "Failed to fetch design: " . $e->getMessage() . "\n";
        exit(1);
    }
}
?>

curl -H "Accept: application/json" \
     "https://tellstree.com/api/designs/original"