跳到主要内容

aiThreadsTouch

AiSuccessResponse aiThreadsTouch(AiThreadsTouchRequest)

POST /api/2.0/ai/threads/touch

Bump a thread's activity

Bumps a thread's last-edit date without adding a message, which resurfaces it in the list. Passing profileId also rebinds the thread to another model, so this is the operation to call when a model switch alone should count as activity. Nothing else about the thread changes and the answer only confirms the write. It is idempotent: repeating it simply moves the date forward again.

Parameters​

NameInTypeDescriptionNotes
AiThreadsTouchRequestbodyAiThreadsTouchRequest[required]

Responses​

Status codeDescriptionTypeResponse headers
200Confirms the thread's activity date moved forward.AiSuccessResponse-
401Missing asc_auth_key cookie or Authorization header.AiErrorResponse-
403AI is disabled for this portal, the caller is a guest, or the room named by entityId is one the caller cannot open. Relayed from the DocSpace AI service or the Files API.AiErrorResponse-
413The request body is larger than 100 KB, the JSON parser's limit on this route.AiErrorResponse-
500Unhandled failure. The reason is logged server-side and never echoed back.AiErrorResponse-

Return type​

AiSuccessResponse

Authorization​

cookieAuth, bearerAuth

HTTP request headers​

  • Content-Type: application/json
  • Accept: application/json