Skip to main content
Last updated on
Advanced — 0.0.x primitives

You don't need this page for a normal integration. Use the quickstarts and createMythos() instead. These low-level functions remain exported for custom setups.

listingCallbackRoute

Express handler for the Mythos listing registration callback.

Signature​

typescript
function listingCallbackRoute(
  onRegistered: (listingId: string) => Promise<void>,
): RequestHandler

Route​

text
GET|POST /.well-known/mythos-listing-registered?lt=<listing-registered-jwt>

Parameters​

ParamTypeRequiredDescription
onRegistered(listingId: string) => Promise<void>YesCalled with validated listing ID — persist it
lt (query)stringYesJWT with purpose: "listing_registered"

Returns​

RequestHandler — mount at the well-known path.

Responses​

StatusBody
200{ "ok": true }
401{ "error": "Missing listing callback token" }
401{ "error": "Invalid listing callback token" }
503{ "error": "Service unavailable" }

Example​

typescript
import { listingCallbackRoute, requireLaunchToken } from '@mythos-work/sdk';

const listingIds: string[] = [];

app.use(
  '/.well-known/mythos-listing-registered',
  listingCallbackRoute(async (id) => {
    if (!listingIds.includes(id)) listingIds.push(id);
  }),
);

app.get(
  '/api/mythos/session',
  requireLaunchToken({ resolveListingIds: async () => listingIds }),
  (req, res) => res.json({ ok: true, session: req.mythos }),
);

See also​