Connekt Script Writer

Connekt is an HTTP client driven by Kotlin scripts. Scripts use the .connekt.kts extension and have the full Connekt DSL available at the top level — no boilerplate, no main function, just declarations and requests.

When generating scripts, always read from connekt.env.json for base URLs and secrets using val x: String by env rather than hardcoding values. Save scripts with the .connekt.kts extension.

Execution Model

A script only registers requests — the runner decides which request to execute. The script is NOT run top-to-bottom like a regular program. This means:

• No imperative code between requests. No println, no if/else, no variable assignments outside of then or useCase blocks.
• Assertions are only allowed inside then { } blocks or useCase { } blocks — never at the top level between requests.
• Never interpolate results from other requests directly into a URL. Use pathParam instead, so the runner can resolve values at execution time.
• Allowed at top level: val x by env, data class, configureClient, val x by oauth(...), extension functions (e.g. on RequestBuilder for shared headers), request declarations (val x by GET/POST/...), and useCase blocks.