Users

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.

Public users have a globally unique username, display name and avatar. The public profile never exposes email, linked identity subjects or private account fields. The current-account endpoint is private and requires an authenticated browser session.

Usernames contain 1–15 ASCII letters, digits, underscores or hyphens; reserved names and case-insensitive collisions are rejected. Updating a username also confirms a generated candidate. Optional names allow at most 100 printable characters. Omitting optional names in an update sends their empty-string defaults, so send names you want to retain.

Avatar uploads accept PNG, JPEG or WebP bytes up to 512 KiB and an input dimension bound of 2048 px; the server crops and re-encodes the image. Deleting an upload returns to the account’s provider, Gravatar or generated fallback. The public avatar endpoint serves an uploaded image; use the profile’s avatar URL for the full fallback behavior.

On this page

Read private profile and linked provider names

GET /api/v1/account

Availability: account/community configuration must be enabled (except /auth/providers).

Access: browser session. See Authentication.

Parameters

This operation has no path or query parameters.

Request example

curl 'https://tensortrace.net/api/v1/account' \
    --cookie 'cookies.txt'

Responses

StatusMeaningBody type
200Private, no-store response.Account
400Invalid input, expired or consumed tokenNo declared JSON body
401Sign-in required or incorrect credentialsNo declared JSON body
403Origin/CSRF failure or username confirmation requiredNo declared JSON body
404Resource not foundNo declared JSON body
409Username or identity conflictNo declared JSON body
429Rate limited; retry laterNo declared JSON body
503Account feature or provider/mail configuration unavailableNo declared JSON body

Response example · 200

Illustrative values; schema-valid and not a live catalog measurement.

{
    "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",
    "email": "reviewer@example.com",
    "username_confirmed": false,
    "identities": [
        "example"
    ],
    "first_name": "Model",
    "last_name": "Reviewer"
}
FieldTypeRequiredMeaning / constraints
idstring · uuidYes
usernamestringYesMax. length: 15
display_namestringYesMax. length: 100
avatar_urlstringYes
avatar_fallbackstringYes
created_atstring · date-timeYes
emailstring,nullYes
first_namestringNo
last_namestringNo
username_confirmedbooleanYes
identitiesarray of stringYes

Change/confirm globally unique username and profile

PATCH /api/v1/account

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.

FieldTypeRequiredMeaning / constraints
usernamestringYesGlobally unique username: 1–15 ASCII letters, digits, underscores or hyphens. Case-insensitive collisions and reserved names are rejected. Updating also confirms a generated candidate. Pattern: ^[A-Za-z0-9_][A-Za-z0-9_-]{0,14}$
display_namestringNoOptional public display name; does not need to be globally unique. Max. length: 100
first_namestringNoOptional first name from the account profile. Max. length: 100
last_namestringNoOptional last name from the account profile. Max. length: 100

Request example

curl -X PATCH 'https://tensortrace.net/api/v1/account' \
    --cookie 'cookies.txt' \
    -H 'Origin: https://tensortrace.net' \
    -H 'X-CSRF-Token: SESSION_CSRF_TOKEN' \
    -H 'Content-Type: application/json' \
    --data '{"username":"model_reviewer","display_name":"Model Reviewer","first_name":"Model","last_name":"Reviewer"}'

Responses

StatusMeaningBody type
200Private, no-store response.Account
400Invalid input, expired or consumed tokenNo declared JSON body
401Sign-in required or incorrect credentialsNo declared JSON body
403Origin/CSRF failure or username confirmation requiredNo declared JSON body
404Resource not foundNo declared JSON body
409Username or identity conflictNo declared JSON body
429Rate limited; retry laterNo declared JSON body
503Account feature or provider/mail configuration unavailableNo declared JSON body

Response example · 200

Illustrative values; schema-valid and not a live catalog measurement.

{
    "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",
    "email": "reviewer@example.com",
    "username_confirmed": false,
    "identities": [
        "example"
    ],
    "first_name": "Model",
    "last_name": "Reviewer"
}
FieldTypeRequiredMeaning / constraints
idstring · uuidYes
usernamestringYesMax. length: 15
display_namestringYesMax. length: 100
avatar_urlstringYes
avatar_fallbackstringYes
created_atstring · date-timeYes
emailstring,nullYes
first_namestringNo
last_namestringNo
username_confirmedbooleanYes
identitiesarray of stringYes

Decode, crop and re-encode PNG/JPEG/WebP avatar (512 KiB maximum; 2048 px input bound)

PUT /api/v1/account/avatar

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/octet-stream. Required.

Type: string · binary.

Request example

curl -X PUT 'https://tensortrace.net/api/v1/account/avatar' \
    --cookie 'cookies.txt' \
    -H 'Origin: https://tensortrace.net' \
    -H 'X-CSRF-Token: SESSION_CSRF_TOKEN' \
    -H 'Content-Type: application/octet-stream' \
    --data-binary '@avatar.png'

Responses

StatusMeaningBody type
200Private, no-store response.Account
400Invalid input, expired or consumed tokenNo declared JSON body
401Sign-in required or incorrect credentialsNo declared JSON body
403Origin/CSRF failure or username confirmation requiredNo declared JSON body
404Resource not foundNo declared JSON body
409Username or identity conflictNo declared JSON body
429Rate limited; retry laterNo declared JSON body
503Account feature or provider/mail configuration unavailableNo declared JSON body

Response example · 200

Illustrative values; schema-valid and not a live catalog measurement.

{
    "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",
    "email": "reviewer@example.com",
    "username_confirmed": false,
    "identities": [
        "example"
    ],
    "first_name": "Model",
    "last_name": "Reviewer"
}
FieldTypeRequiredMeaning / constraints
idstring · uuidYes
usernamestringYesMax. length: 15
display_namestringYesMax. length: 100
avatar_urlstringYes
avatar_fallbackstringYes
created_atstring · date-timeYes
emailstring,nullYes
first_namestringNo
last_namestringNo
username_confirmedbooleanYes
identitiesarray of stringYes

Remove uploaded avatar and use account fallback

DELETE /api/v1/account/avatar

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 example

curl -X DELETE 'https://tensortrace.net/api/v1/account/avatar' \
    --cookie 'cookies.txt' \
    -H 'Origin: https://tensortrace.net' \
    -H 'X-CSRF-Token: SESSION_CSRF_TOKEN'

Responses

StatusMeaningBody type
200Private, no-store response.Account
400Invalid input, expired or consumed tokenNo declared JSON body
401Sign-in required or incorrect credentialsNo declared JSON body
403Origin/CSRF failure or username confirmation requiredNo declared JSON body
404Resource not foundNo declared JSON body
409Username or identity conflictNo declared JSON body
429Rate limited; retry laterNo declared JSON body
503Account feature or provider/mail configuration unavailableNo declared JSON body

Response example · 200

Illustrative values; schema-valid and not a live catalog measurement.

{
    "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",
    "email": "reviewer@example.com",
    "username_confirmed": false,
    "identities": [
        "example"
    ],
    "first_name": "Model",
    "last_name": "Reviewer"
}
FieldTypeRequiredMeaning / constraints
idstring · uuidYes
usernamestringYesMax. length: 15
display_namestringYesMax. length: 100
avatar_urlstringYes
avatar_fallbackstringYes
created_atstring · date-timeYes
emailstring,nullYes
first_namestringNo
last_namestringNo
username_confirmedbooleanYes
identitiesarray of stringYes

Read public profile (no email or identity subjects)

GET /api/v1/community/users/{username}

Availability: account/community configuration must be enabled (except /auth/providers).

Access: public read; no TensorTrace API key.

Parameters

NameLocationRequiredType / limitsMeaning
usernamepathYesstringCase-insensitive public username. Usernames are globally unique.

Request example

curl 'https://tensortrace.net/api/v1/community/users/model_reviewer'

Responses

StatusMeaningBody type
200Private, no-store response.PublicUser
400Invalid input, expired or consumed tokenNo declared JSON body
401Sign-in required or incorrect credentialsNo declared JSON body
403Origin/CSRF failure or username confirmation requiredNo declared JSON body
404Resource not foundNo declared JSON body
409Username or identity conflictNo declared JSON body
429Rate limited; retry laterNo declared JSON body
503Account feature or provider/mail configuration unavailableNo declared JSON body

Response example · 200

Illustrative values; schema-valid and not a live catalog measurement.

{
    "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"
}
FieldTypeRequiredMeaning / constraints
idstring · uuidYes
usernamestringYesMax. length: 15
display_namestringYesMax. length: 100
avatar_urlstringYes
avatar_fallbackstringYes
created_atstring · date-timeYes

Read re-encoded uploaded avatar

GET /api/v1/community/users/{id}/avatar

Availability: account/community configuration must be enabled (except /auth/providers).

Access: public read; no TensorTrace API key.

Parameters

NameLocationRequiredType / limitsMeaning
idpathYesstring · uuidUUID of the public user whose uploaded avatar is requested.

Request example

curl 'https://tensortrace.net/api/v1/community/users/00000000-0000-4000-8000-000000000001/avatar'

Responses

StatusMeaningBody type
200Private, no-store response.string · binary
400Invalid input, expired or consumed tokenNo declared JSON body
401Sign-in required or incorrect credentialsNo declared JSON body
403Origin/CSRF failure or username confirmation requiredNo declared JSON body
404Resource not foundNo declared JSON body
409Username or identity conflictNo declared JSON body
429Rate limited; retry laterNo declared JSON body
503Account feature or provider/mail configuration unavailableNo declared JSON body

Response example · 200

The response contains original bytes or an image. Content types: image/png. Preserve the declared encoding and checksum; do not parse it as JSON.

Models

Loading
EVIDENCE / COMPARISON

Benchmarks

Explore every benchmark

Loading

These charts contain model-linked results. The charts above also include unlinked source profiles. Compare scores within each evaluation. Model quality, usage, transparency and system performance measure different things.

Install TensorTrace