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 /account - Change/confirm globally unique username and profile ·
PATCH /account - Decode, crop and re-encode PNG/JPEG/WebP avatar (512 KiB maximum; 2048 px input bound) ·
PUT /account/avatar - Remove uploaded avatar and use account fallback ·
DELETE /account/avatar - Read public profile (no email or identity subjects) ·
GET /community/users/{username} - Read re-encoded uploaded avatar ·
GET /community/users/{id}/avatar
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
| Status | Meaning | Body type |
|---|---|---|
200 | Private, no-store response. | Account |
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",
"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"
}
| Field | Type | Required | Meaning / constraints |
|---|---|---|---|
id | string · uuid | Yes | |
username | string | Yes | Max. length: 15 |
display_name | string | Yes | Max. length: 100 |
avatar_url | string | Yes | |
avatar_fallback | string | Yes | |
created_at | string · date-time | Yes | |
email | string,null | Yes | |
first_name | string | No | |
last_name | string | No | |
username_confirmed | boolean | Yes | |
identities | array of string | Yes |
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.
| Field | Type | Required | Meaning / constraints |
|---|---|---|---|
username | string | Yes | Globally 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_name | string | No | Optional public display name; does not need to be globally unique. Max. length: 100 |
first_name | string | No | Optional first name from the account profile. Max. length: 100 |
last_name | string | No | Optional 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
| Status | Meaning | Body type |
|---|---|---|
200 | Private, no-store response. | Account |
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",
"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"
}
| Field | Type | Required | Meaning / constraints |
|---|---|---|---|
id | string · uuid | Yes | |
username | string | Yes | Max. length: 15 |
display_name | string | Yes | Max. length: 100 |
avatar_url | string | Yes | |
avatar_fallback | string | Yes | |
created_at | string · date-time | Yes | |
email | string,null | Yes | |
first_name | string | No | |
last_name | string | No | |
username_confirmed | boolean | Yes | |
identities | array of string | Yes |
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
| Status | Meaning | Body type |
|---|---|---|
200 | Private, no-store response. | Account |
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",
"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"
}
| Field | Type | Required | Meaning / constraints |
|---|---|---|---|
id | string · uuid | Yes | |
username | string | Yes | Max. length: 15 |
display_name | string | Yes | Max. length: 100 |
avatar_url | string | Yes | |
avatar_fallback | string | Yes | |
created_at | string · date-time | Yes | |
email | string,null | Yes | |
first_name | string | No | |
last_name | string | No | |
username_confirmed | boolean | Yes | |
identities | array of string | Yes |
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
| Status | Meaning | Body type |
|---|---|---|
200 | Private, no-store response. | Account |
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",
"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"
}
| Field | Type | Required | Meaning / constraints |
|---|---|---|---|
id | string · uuid | Yes | |
username | string | Yes | Max. length: 15 |
display_name | string | Yes | Max. length: 100 |
avatar_url | string | Yes | |
avatar_fallback | string | Yes | |
created_at | string · date-time | Yes | |
email | string,null | Yes | |
first_name | string | No | |
last_name | string | No | |
username_confirmed | boolean | Yes | |
identities | array of string | Yes |
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
| Name | Location | Required | Type / limits | Meaning |
|---|---|---|---|---|
username | path | Yes | string | Case-insensitive public username. Usernames are globally unique. |
Request example
curl 'https://tensortrace.net/api/v1/community/users/model_reviewer'
Responses
| Status | Meaning | Body type |
|---|---|---|
200 | Private, no-store response. | PublicUser |
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",
"username": "model_reviewer",
"display_name": "Model Reviewer",
"avatar_url": "example",
"avatar_fallback": "example",
"created_at": "2026-10-05T00:00:00Z"
}
| Field | Type | Required | Meaning / constraints |
|---|---|---|---|
id | string · uuid | Yes | |
username | string | Yes | Max. length: 15 |
display_name | string | Yes | Max. length: 100 |
avatar_url | string | Yes | |
avatar_fallback | string | Yes | |
created_at | string · date-time | Yes |
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
| Name | Location | Required | Type / limits | Meaning |
|---|---|---|---|---|
id | path | Yes | string · uuid | UUID 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
| Status | Meaning | Body type |
|---|---|---|
200 | Private, no-store response. | string · binary |
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
The response contains original bytes or an image. Content types: image/png. Preserve the declared encoding and checksum; do not parse it as JSON.