world.treeline.actor.preferences Documentation (EN)

main record

Athlete display units, default sports, and privacy preferences for Treeline.

Record Key literal:self Fixed literal value

Properties

allowReuse string Optional

Who may save this athlete's public activities as their own: 'coAthletes' (tagged co-athletes and confirmed group matches, the default), 'everyone' (co-athletes save as an activity; anyone else saves as a route), or 'nobody'. Unset means 'coAthletes'.

Known values: everyone, coAthletes, nobody

Default: coAthletes

defaultGear array of ref #sportGearDefault Optional

Per-sport default gear. Preselected in the upload and edit pickers and used as the default for the gear backfill. One entry per sport; gear that is retired or deleted is ignored.

maxLength: 32 items

defaultHideStartEndMeters integer Optional

Default distance in meters trimmed from start and end for privacy.

minimum: 0maximum: 100000

Default: 0

defaultPrivacy string Optional

Default visibility setting for new activities ('public' or 'unlisted'). Restricted/private training logs and groups/circles belong to ATProto Permissioned Spaces (Proposal 0016). Historical values ('followers', 'private', 'permissioned') are retained for schema compatibility.

Known values: public, unlisted, followers, private, permissioned

Default: public

defaultSport string Optional

Default sport category selected when recording or uploading activities.

distanceUnits string Optional

Preferred unit of measurement for distance.

Known values: km, mi

Default: km

elevationUnits string Optional

Preferred unit of measurement for elevation.

Known values: m, ft

Default: m

temperatureUnits string Optional

Preferred unit of measurement for temperature.

Known values: c, f

Default: c

unitSystem string Optional

[Deprecated in v0.10: Use distanceUnits, elevationUnits, temperatureUnits] Legacy unit system.

Known values: metric, imperial

updatedAt string datetime Optional

Timestamp when preferences were last updated.

View raw schema

{
  "description": "Athlete display units, default sports, and privacy preferences for Treeline.",
  "key": "literal:self",
  "record": {
    "properties": {
      "allowReuse": {
        "default": "coAthletes",
        "description": "Who may save this athlete's public activities as their own: 'coAthletes' (tagged co-athletes and confirmed group matches, the default), 'everyone' (co-athletes save as an activity; anyone else saves as a route), or 'nobody'. Unset means 'coAthletes'.",
        "knownValues": [
          "everyone",
          "coAthletes",
          "nobody"
        ],
        "type": "string"
      },
      "defaultGear": {
        "description": "Per-sport default gear. Preselected in the upload and edit pickers and used as the default for the gear backfill. One entry per sport; gear that is retired or deleted is ignored.",
        "items": {
          "ref": "#sportGearDefault",
          "type": "ref"
        },
        "maxLength": 32,
        "type": "array"
      },
      "defaultHideStartEndMeters": {
        "default": 0,
        "description": "Default distance in meters trimmed from start and end for privacy.",
        "maximum": 100000,
        "minimum": 0,
        "type": "integer"
      },
      "defaultPrivacy": {
        "default": "public",
        "description": "Default visibility setting for new activities ('public' or 'unlisted'). Restricted/private training logs and groups/circles belong to ATProto Permissioned Spaces (Proposal 0016). Historical values ('followers', 'private', 'permissioned') are retained for schema compatibility.",
        "knownValues": [
          "public",
          "unlisted",
          "followers",
          "private",
          "permissioned"
        ],
        "type": "string"
      },
      "defaultSport": {
        "description": "Default sport category selected when recording or uploading activities.",
        "type": "string"
      },
      "distanceUnits": {
        "default": "km",
        "description": "Preferred unit of measurement for distance.",
        "knownValues": [
          "km",
          "mi"
        ],
        "type": "string"
      },
      "elevationUnits": {
        "default": "m",
        "description": "Preferred unit of measurement for elevation.",
        "knownValues": [
          "m",
          "ft"
        ],
        "type": "string"
      },
      "temperatureUnits": {
        "default": "c",
        "description": "Preferred unit of measurement for temperature.",
        "knownValues": [
          "c",
          "f"
        ],
        "type": "string"
      },
      "unitSystem": {
        "description": "[Deprecated in v0.10: Use distanceUnits, elevationUnits, temperatureUnits] Legacy unit system.",
        "knownValues": [
          "metric",
          "imperial"
        ],
        "type": "string"
      },
      "updatedAt": {
        "description": "Timestamp when preferences were last updated.",
        "format": "datetime",
        "type": "string"
      }
    },
    "type": "object"
  },
  "type": "record"
}

sportGearDefault object

No description available.

Properties

gearUri string at-uri Required

AT-URI of the world.treeline.gear.item to use by default for this sport.

maxLength: 512 bytes

sport string Required

Sport identifier, as used in activity.sport.

maxLength: 64 bytesmaxGraphemes: 64 graphemes

View raw schema

{
  "properties": {
    "gearUri": {
      "description": "AT-URI of the world.treeline.gear.item to use by default for this sport.",
      "format": "at-uri",
      "maxLength": 512,
      "type": "string"
    },
    "sport": {
      "description": "Sport identifier, as used in activity.sport.",
      "maxGraphemes": 64,
      "maxLength": 64,
      "type": "string"
    }
  },
  "required": [
    "sport",
    "gearUri"
  ],
  "type": "object"
}