HTTP Basics

Use HTTP steps when an agentic flow needs a direct, deterministic call to an API. They run without a model and can be mixed with agents, tools, SQL, scripts, and assertions inside the same .norn sequence.

Your First Request

Create a file called hello.norn and add:

GET https://jsonplaceholder.typicode.com/posts/1

Click the Send Request CodeLens above the request, or run Norn: Send Request from the Command Palette. The response appears in the response panel.

Headers and a Request Body

Add headers directly below the request line and leave a blank line before the body:

POST https://jsonplaceholder.typicode.com/posts
Content-Type: application/json

{
    "title": "Hello World",
    "body": "This is my first post",
    "userId": 1
}

Variables

Define a value with var and reference it with {{name}}:

var baseUrl = https://jsonplaceholder.typicode.com

GET {{baseUrl}}/posts/1

Put Requests in a Flow

test sequence FetchAndCheckPost
    GET https://jsonplaceholder.typicode.com/posts/1

    assert $1.status == 200
    assert $1.body.title exists
end sequence

A sequence gives related steps an execution order and lets later steps use earlier results. See Sequences for composition, parameters, returns, agent calls, and control flow.

Next Steps

• HTTP & API Definitions - Reuse endpoints, header groups, and OpenAPI imports.
• Assertions - Validate status, data, schemas, headers, and timings.
• Environments - Keep URLs, credentials, and deployment values outside the workflow.
• Getting Started - Build and run your first AI agent.