Documentation

Quickstart

Get a working Nimblesite agent in under 5 minutes using the hosted API.

Quickstart

Get from zero to a working agent in under 5 minutes. Nimblesite is a hosted API — there is nothing to install, clone, or run.

Prerequisites

  • A Nimblesite account and API key — sign up to get one
  • curl (or any HTTP client you like)

1. Export your API key

Every request authenticates with X-API-Key. Save yours to an env var so the rest of the commands stay short.

export NIMBLE_KEY="nbl_live_..."

You received this key when your tenant was provisioned. If you've lost it, rotate it from your account dashboard.

2. Create an agent config

A config is the declarative definition of an agent — its prompt, model, and tools. POST it once and you get back a stable config_id.

curl -X POST https://api.nimblesite.dev/api/v1/configs \
  -H "X-API-Key: $NIMBLE_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Hello Agent",
    "system_prompt": "You are a helpful assistant for {tenant_name}.",
    "model_config": {
      "provider": "anthropic",
      "model": "claude-sonnet-4-6"
    },
    "tools_config": []
  }'

The response includes a config_id. Save it.

export CONFIG_ID="<the config id from above>"

3. Talk to your agent

curl -X POST https://api.nimblesite.dev/api/v1/chat/$CONFIG_ID \
  -H "X-API-Key: $NIMBLE_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "Hello! Who are you?"
  }'

You'll get back a response and a conversation_id.

4. Talk to it again

This is the magic. Send a follow-up with the returned conversation_id:

curl -X POST https://api.nimblesite.dev/api/v1/chat/$CONFIG_ID \
  -H "X-API-Key: $NIMBLE_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "What did I just ask you?",
    "conversation_id": "11111111-1111-1111-1111-111111111111"
  }'

The agent remembers. You didn't store anything. You didn't build a messages table. You didn't run a loop.

What just happened

You've now built a stateful AI assistant with:

  • A system prompt
  • Conversation memory
  • Multi-tenant isolation
  • A stable HTTP contract

…in two curl commands.

Next