GET /api/threads

GET

api

threads

curl -X GET 'http://localhost:5079/api/threads?limit=50' \
  -H 'Authorization: Bearer YOUR_JWT_TOKEN'

const response = await fetch('http://localhost:5079/api/threads?limit=50', {
  method: 'GET',
  headers: {
    'Authorization': `Bearer ${jwt}`
  }
});

const result = await response.json();

import requests

response = requests.get(
    'http://localhost:5079/api/threads',
    headers={'Authorization': f'Bearer {jwt}'},
    params={'limit': 50}
)

threads = response.json()

{
  "items": [
    {
      "thread_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
      "user_id": "user-uuid-here",
      "title": "Chat about AI",
      "visibility": "private",
      "created_at": "2024-01-15T10:30:00.000Z",
      "updated_at": "2024-01-15T11:45:00.000Z"
    }
  ]
}

{
  "error": "User ID claim missing"
}

{
  "success": false,
  "error": "Database connection failed",
  "code": "THREADS_ERROR"
}

Authentication

Required: JWT Bearer token JWT Claims Extraction (Lines 39-43):

sub | ClaimTypes.NameIdentifier → User UUID (required)

Query Parameters

integer

default:"20"

Maximum threads to returnValidation: None (controller accepts any integer)Default: 20 (Line 34)Range: Not enforced by API contract (database-dependent)

Response

array

Array of thread objects

Show Thread object

string

UUID identifier

string

Owner UUID (matches authenticated user)

string

Thread title

string

"private", "public", or "unlisted"

string

ISO8601 UTC timestamp

string

ISO8601 UTC timestamp

curl -X GET 'http://localhost:5079/api/threads?limit=50' \
  -H 'Authorization: Bearer YOUR_JWT_TOKEN'

const response = await fetch('http://localhost:5079/api/threads?limit=50', {
  method: 'GET',
  headers: {
    'Authorization': `Bearer ${jwt}`
  }
});

const result = await response.json();

import requests

response = requests.get(
    'http://localhost:5079/api/threads',
    headers={'Authorization': f'Bearer {jwt}'},
    params={'limit': 50}
)

threads = response.json()

{
  "items": [
    {
      "thread_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
      "user_id": "user-uuid-here",
      "title": "Chat about AI",
      "visibility": "private",
      "created_at": "2024-01-15T10:30:00.000Z",
      "updated_at": "2024-01-15T11:45:00.000Z"
    }
  ]
}

{
  "error": "User ID claim missing"
}

{
  "success": false,
  "error": "Database connection failed",
  "code": "THREADS_ERROR"
}

Authorization

Ownership Filter (Line 50):

await _threadsService.GetThreadsAsync(userId, limit);

Guaranteed Behavior:

Returns ONLY threads owned by authenticated user
userId extracted from JWT claims
No visibility filtering (returns all user’s threads regardless of visibility)

Visibility Rules:

User sees all their own threads (private, public, unlisted)
User NEVER sees threads owned by others

Side Effects

Database Reads (Line 50):

SELECT from threads table WHERE user_id = userId
Ordered by creation date (descending, assumed from service)

No Database Writes: Read-only endpoint

Permissions

Who Can Read:

Authenticated user (their own threads only)

Who Cannot Read:

Unauthenticated users
Other authenticated users (cross-user access forbidden)

Edge Cases

Missing user ID claim: 401 error (Lines 45-48)
Zero threads: Returns {"items": []} (empty array)
Limit = 0: Behavior not enforced by server contract (service-dependent)
Limit < 0: Behavior not enforced by server contract (service-dependent)
Limit > database max: Service may cap internally (not documented)

Error Conditions

Code	HTTP	Cause	Controller Line
N/A	401	JWT missing or invalid	Middleware
N/A	401	User ID claim missing/invalid GUID	45-48
`THREADS_ERROR`	500	Service exception	54-62

Exception Handling (Lines 54-62):

catch (Exception ex) {
    return StatusCode(500, new { error = ex.Message, code = "THREADS_ERROR" });
}

All service exceptions return 500
Error message exposed to client

Pagination Behavior

Current Implementation: Simple limit-based No Cursor/Offset: Controller does not support pagination beyond limit Ordering: Not specified by API contract (service-defined) Server Contract: Returns first limit threads (ordering implementation-defined)

Performance Characteristics

Database Query: Single SELECT with WHERE clause Index Requirements: threads.user_id should be indexed for performance Response Size: Proportional to limit value (uncapped by controller)

curl -X GET 'http://localhost:5079/api/threads?limit=50' \
  -H 'Authorization: Bearer YOUR_JWT_TOKEN'

const response = await fetch('http://localhost:5079/api/threads?limit=50', {
  method: 'GET',
  headers: {
    'Authorization': `Bearer ${jwt}`
  }
});

const result = await response.json();

import requests

response = requests.get(
    'http://localhost:5079/api/threads',
    headers={'Authorization': f'Bearer {jwt}'},
    params={'limit': 50}
)

threads = response.json()

{
  "items": [
    {
      "thread_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
      "user_id": "user-uuid-here",
      "title": "Chat about AI",
      "visibility": "private",
      "created_at": "2024-01-15T10:30:00.000Z",
      "updated_at": "2024-01-15T11:45:00.000Z"
    }
  ]
}

{
  "error": "User ID claim missing"
}

{
  "success": false,
  "error": "Database connection failed",
  "code": "THREADS_ERROR"
}

Overview

Chat & Arena

Threads

Voting & Stats

Models & Users

Utilities

Admin API

Authentication

Query Parameters

Response

Authorization

Side Effects

Permissions

Edge Cases

Error Conditions

Performance Characteristics

​Authentication

​Query Parameters

​Response

​Authorization

​Side Effects

​Permissions

​Edge Cases

​Error Conditions

​Pagination Behavior

​Performance Characteristics

Authentication

Query Parameters

Response

Authorization

Side Effects

Permissions

Edge Cases

Error Conditions

Pagination Behavior

Performance Characteristics