Skip to main content

Generate the Connection Link

A Veyra runtime connection begins with a temporary, one-time bootstrap link generated by the runtime owner.

Format:

veyra-connect://<public-host>/connect/<one-time-token>?protocol=1

Example structure only:

veyra-connect://agent.example.com/connect/REDACTED_ONE_TIME_TOKEN?protocol=1

Never publish a real live connection link.

The link contains:

  • the runtime's public host and optional port;
  • a one-time bootstrap token;
  • Runtime Protocol version.

It does not contain:

  • model-provider API key;
  • runtime private signing key;
  • post-pairing runtime credential;
  • GitHub repository token.

Token lifetime​

The official starter currently gives a bootstrap token a 24-hour lifetime.

A token stops being usable when:

  • it expires;
  • it is successfully claimed;
  • the owner rotates to a newer unused token.

The official starter's owner page can request a new link through:

POST /veyra/connect/rotate

A successful response contains the new connection_link and expiration metadata.

Rotation is owner administration and should not be exposed anonymously on a public host.

Paste into Veyra​

Paste the complete veyra-connect://... value into the Connect Agent step or the retry panel for the intended worker.

After Veyra successfully claims the runtime, normal communication moves to the scoped runtime credential and authenticated heartbeat transport.

The one-time link is not the long-lived runtime credential.