Comments
Current runtime: accounts, favorites and community are unavailable. Provider discovery reports disabled; other identity APIs return the existing private, no-store 503 response. The Rust HTTP implementation is archived. This page preserves its contract for a future JavaScript implementation; configuration alone does not enable it. See the runtime/recovery guide.
Comments attach a signed-in author’s Markdown text to a canonical model. Text is limited to 1024 Unicode scalar values, not UTF-8 bytes. GitHub-flavored Markdown rendering is separate from reference resolution.
Resolved @username mentions, #topic hashtags, $ticker references and %publisher/model references link to their corresponding destinations. Unknown users or models remain plain text. The preview resolver returns reference information; it does not publish a comment.
The comments list supports model, author and topic scopes and an opaque cursor, with at most 40 rows per page. Public profiles and the world timeline use the same comment objects. A user can delete only their own comments. Identity and community APIs can be disabled by deployment configuration.
On this page
- World/model/user/topic timeline; 40 rows with stable cursor pagination ·
GET /community/comments - Publish a model comment with resolved mentions/topics/tickers/model references ·
POST /community/comments - Delete your own comment ·
DELETE /community/comments/{id} - Resolve references for a Markdown preview; unknown users/models remain plain text ·
POST /community/references
World/model/user/topic timeline; 40 rows with stable cursor pagination
GET /api/v1/community/comments
Availability: account/community configuration must be enabled (except /auth/providers).
Access: public read; no TensorTrace API key.
Parameters
| Name | Location | Required | Type / limits | Meaning |
|---|---|---|---|---|
model_id | query | No | string | Canonical model ID, or an unambiguous model alias resolved by the server. |
username | query | No | string | Case-insensitive public username. Usernames are globally unique. |
topic | query | No | string | Case-insensitive comment hashtag, without the # prefix. |
cursor | query | No | string | Opaque next_cursor from a preceding comments page. Do not construct or decode it; pages contain at most 40 comments. |
Request example
curl 'https://tensortrace.net/api/v1/community/comments'
Responses
| Status | Meaning | Body type |
|---|---|---|
200 | Private, no-store response. | CommentPage |
400 | Invalid input, expired or consumed token | No declared JSON body |
401 | Sign-in required or incorrect credentials | No declared JSON body |
403 | Origin/CSRF failure or username confirmation required | No declared JSON body |
404 | Resource not found | No declared JSON body |
409 | Username or identity conflict | No declared JSON body |
429 | Rate limited; retry later | No declared JSON body |
503 | Account feature or provider/mail configuration unavailable | No declared JSON body |
Response example · 200
Illustrative values; schema-valid and not a live catalog measurement.
{
"data": [
{
"id": "00000000-0000-4000-8000-000000000001",
"author": {
"id": "00000000-0000-4000-8000-000000000001",
"username": "model_reviewer",
"display_name": "Model Reviewer",
"avatar_url": "example",
"avatar_fallback": "example",
"created_at": "2026-10-05T00:00:00Z"
},
"model_id": "google/gemini-2.5-flash",
"body": "Exploring %google/gemini-2.5-flash with @model_reviewer. #multimodal",
"references": [
{
"text": "example",
"kind": "user",
"href": "example",
"model_id": "google/gemini-2.5-flash"
}
],
"created_at": "2026-10-05T00:00:00Z"
}
],
"next_cursor": "example"
}
| Field | Type | Required | Meaning / constraints |
|---|---|---|---|
data | array of CommunityComment | Yes | |
next_cursor | string,null | Yes |
Publish a model comment with resolved mentions/topics/tickers/model references
POST /api/v1/community/comments
Availability: account/community configuration must be enabled (except /auth/providers).
Access: browser session, session-bound CSRF token and exact Origin. See Authentication.
Parameters
This operation has no path or query parameters.
Request body
Content type: application/json. Required.
| Field | Type | Required | Meaning / constraints |
|---|---|---|---|
model_id | string | Yes | Canonical model ID, or an unambiguous model alias resolved by the server. Max. length: 512 |
body | string | Yes | Unicode scalar values, not UTF-8 bytes. GFM and resolved references. Min. length: 1; Max. length: 1024 |
Request example
curl -X POST 'https://tensortrace.net/api/v1/community/comments' \
--cookie 'cookies.txt' \
-H 'Origin: https://tensortrace.net' \
-H 'X-CSRF-Token: SESSION_CSRF_TOKEN' \
-H 'Content-Type: application/json' \
--data '{"model_id":"google/gemini-2.5-flash","body":"Exploring %google/gemini-2.5-flash with @model_reviewer. #multimodal"}'
Responses
| Status | Meaning | Body type |
|---|---|---|
200 | Private, no-store response. | object |
400 | Invalid input, expired or consumed token | No declared JSON body |
401 | Sign-in required or incorrect credentials | No declared JSON body |
403 | Origin/CSRF failure or username confirmation required | No declared JSON body |
404 | Resource not found | No declared JSON body |
409 | Username or identity conflict | No declared JSON body |
429 | Rate limited; retry later | No declared JSON body |
503 | Account feature or provider/mail configuration unavailable | No declared JSON body |
Response example · 200
Illustrative values; schema-valid and not a live catalog measurement.
{
"id": "00000000-0000-4000-8000-000000000001"
}
| Field | Type | Required | Meaning / constraints |
|---|---|---|---|
id | string · uuid | No |
Delete your own comment
DELETE /api/v1/community/comments/{id}
Availability: account/community configuration must be enabled (except /auth/providers).
Access: browser session, session-bound CSRF token and exact Origin. See Authentication.
Parameters
| Name | Location | Required | Type / limits | Meaning |
|---|---|---|---|---|
id | path | Yes | string · uuid | UUID of the comment to delete. Only its author can delete it. |
Request example
curl -X DELETE 'https://tensortrace.net/api/v1/community/comments/00000000-0000-4000-8000-000000000001' \
--cookie 'cookies.txt' \
-H 'Origin: https://tensortrace.net' \
-H 'X-CSRF-Token: SESSION_CSRF_TOKEN'
Responses
| Status | Meaning | Body type |
|---|---|---|
200 | Private, no-store response. | object |
400 | Invalid input, expired or consumed token | No declared JSON body |
401 | Sign-in required or incorrect credentials | No declared JSON body |
403 | Origin/CSRF failure or username confirmation required | No declared JSON body |
404 | Resource not found | No declared JSON body |
409 | Username or identity conflict | No declared JSON body |
429 | Rate limited; retry later | No declared JSON body |
503 | Account feature or provider/mail configuration unavailable | No declared JSON body |
Response example · 200
Illustrative values; schema-valid and not a live catalog measurement.
{
"deleted": false
}
| Field | Type | Required | Meaning / constraints |
|---|---|---|---|
deleted | boolean | No |
Resolve references for a Markdown preview; unknown users/models remain plain text
POST /api/v1/community/references
Availability: account/community configuration must be enabled (except /auth/providers).
Access: browser session, session-bound CSRF token and exact Origin. See Authentication.
Parameters
This operation has no path or query parameters.
Request body
Content type: application/json. Required.
| Field | Type | Required | Meaning / constraints |
|---|---|---|---|
body | string | Yes | Comment or preview text in GitHub-flavored Markdown, up to 1024 Unicode scalar values. Resolved @users, #topics, $tickers and %model IDs link to their destinations. Min. length: 1; Max. length: 1024 |
Request example
curl -X POST 'https://tensortrace.net/api/v1/community/references' \
--cookie 'cookies.txt' \
-H 'Origin: https://tensortrace.net' \
-H 'X-CSRF-Token: SESSION_CSRF_TOKEN' \
-H 'Content-Type: application/json' \
--data '{"body":"Exploring %google/gemini-2.5-flash with @model_reviewer. #multimodal"}'
Responses
| Status | Meaning | Body type |
|---|---|---|
200 | Private, no-store response. | object |
400 | Invalid input, expired or consumed token | No declared JSON body |
401 | Sign-in required or incorrect credentials | No declared JSON body |
403 | Origin/CSRF failure or username confirmation required | No declared JSON body |
404 | Resource not found | No declared JSON body |
409 | Username or identity conflict | No declared JSON body |
429 | Rate limited; retry later | No declared JSON body |
503 | Account feature or provider/mail configuration unavailable | No declared JSON body |
Response example · 200
Illustrative values; schema-valid and not a live catalog measurement.
{
"references": [
{
"text": "example",
"kind": "user",
"href": "example",
"model_id": "google/gemini-2.5-flash"
}
]
}
| Field | Type | Required | Meaning / constraints |
|---|---|---|---|
references | array of CommentReference | No |