Struct PreauthKeyRecord 

pub struct PreauthKeyRecord {
    pub id: String,
    pub user: String,
    pub key: String,
    pub reusable: bool,
    pub ephemeral: bool,
    pub used: bool,
    pub expiration: Option<DateTime<Utc>>,
    pub acl_tags: Vec<String>,
}

One pre-auth key as the coordinator reports it (GET /api/v1/preauthkey).

Field names are the protojson camelCase spelling headscale’s grpc-gateway emits; the shape was read off the live v0.23.0 coordinator on 2026-09-04: {"preAuthKeys":[{user,id,key,reusable,ephemeral,used,expiration,createdAt,aclTags}]}. expiration is RFC3339 and may be absent for a never-expiring key.

Fields

id: String

user: String

key: String

reusable: bool

ephemeral: bool

used: bool

expiration: Option<DateTime<Utc>>

acl_tags: Vec<String>

Implementations

impl PreauthKeyRecord

pub fn is_usable_at(&self, now: DateTime<Utc>) -> bool

Whether this key can still onboard a node at now: not past its expiry, and either reusable or not yet spent.

Trait Implementations

impl Clone for PreauthKeyRecord

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for PreauthKeyRecord

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for PreauthKeyRecord

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for PreauthKeyRecord

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.