useToken

import { useToken } from "@aiql.io/react";

const { token, status, error, reload, expiresAt } = useToken();

const { token, status } = useToken("/api/custom-aiql-token");

function EmbedShell({ children }: { children: React.ReactNode }) {
  const { token, status, error, reload } = useToken();

  if (status === "loading" || status === "idle") {
    return <p>Loading…</p>;
  }

  if (status === "error" || !token) {
    return (
      <div>
        <p>{error ?? "Could not load embed token"}</p>
        <button type="button" onClick={reload}>
          Retry
        </button>
      </div>
    );
  }

  return <AiqlProvider token={token}>{children}</AiqlProvider>;
}

{
  "ok": true,
  "token": "<jwt>",
  "expiresIn": 1800,
  "expiresAt": "2026-07-21T12:00:00.000Z"
}