Examplary
    • Start for free
    Developer docs/Guides

    Import intent URL

    To offer users an option to import a test from your application into Examplary, you can use the import intent URL.

    The import intent URL has the following format:

    https://app.examplary.ai/intent/import?url={url}&name={name}

    Where:

    • url: The URL where the test file can be downloaded from
      • This file should be in a supported format (e.g., Moodle XML, QTI)
      • The file's content type isn't inspected for this flow, so a Moodle XML or bare QTI XML file is only recognized as such if .xml appears somewhere in the URL's path or filename (a query string like ?token=... after it is fine) — otherwise it falls back to a slower, AI-based import. QTI packages (.zip) are unaffected by this.
      • The URL must be HTTPS with no custom port and no basic auth credentials, and it can't resolve to a private, loopback, or link-local address. It's fetched server-side with a plain request, so cookies or a browser session aren't forwarded; if the file needs authentication, put a token in the URL itself (e.g. ?token=...).
    • name: Optional parameter to specify the name of the exam in Examplary

    When a user clicks on this URL, they will be redirected to Examplary, where they can import the test from the provided URL. The underlying import endpoint is rate limited to 5 requests per minute per user — this is only a concern if you're triggering the import programmatically rather than through a single user click.