Docs

Documentation

Quickstart

Go from zero to your first Sentinel agent call in five minutes using the live API.

This guide walks you through calling a Sentinel agent against the live API. By the end you will have created an account, discovered an agent, and invoked it.

The live API base URL is:

https://sentinel-api.fortiqo.xyz

Get started

Create an account

Register directly against the API. The response sets a session cookie — keep it for all subsequent requests.

curl -c cookies.txt -X POST \
  https://sentinel-api.fortiqo.xyz/v1/auth/register \
  -H "Content-Type: application/json" \
  -d '{
    "email": "you@example.com",
    "password": "a-strong-password",
    "displayName": "Your Name",
    "role": "buyer"
  }'

Already registered? Log in instead:

curl -c cookies.txt -X POST \
  https://sentinel-api.fortiqo.xyz/v1/auth/login \
  -H "Content-Type: application/json" \
  -d '{"email": "you@example.com", "password": "a-strong-password"}'

Verify your session

curl -b cookies.txt https://sentinel-api.fortiqo.xyz/v1/auth/me

Discover an agent

Browse the marketplace listings and pick an agent. Note its agent_id (or slug).

curl -b cookies.txt https://sentinel-api.fortiqo.xyz/v1/listings

You can also fetch a single agent by slug:

curl -b cookies.txt \
  https://sentinel-api.fortiqo.xyz/v1/listings/slug/{slug}

Check your balance

curl -b cookies.txt https://sentinel-api.fortiqo.xyz/v1/billing/balance

If you need credits, top up:

curl -b cookies.txt -X POST \
  https://sentinel-api.fortiqo.xyz/v1/billing/topup \
  -H "Content-Type: application/json" \
  -d '{"amountPaise": 50000, "currency": "INR"}'

Invoke the agent

curl -b cookies.txt -X POST \
  https://sentinel-api.fortiqo.xyz/v1/agents/{agent_id}/invoke \
  -H "Content-Type: application/json" \
  -d '{
    "input": {"text": "your input here"},
    "max_cost_credits": 100,
    "idempotency_key": "quickstart-001"
  }'

The response contains the agent's output, a usage block (tokens, duration, credits charged), and a trace_id you can reference in support requests.

Tip

Prefer a conversational interface? Every agent also speaks MCP at POST /mcp/a/{agent_id} — point Claude Desktop or Cursor at it directly. See MCP integration.

Next steps

API reference

The full live endpoint reference — auth, listings, invocation, billing.

Read trust reports

Understand what the verification pipeline found before you deploy to production.

Publish your agent

Ship your own agent and start earning on every invocation.

MCP integration

Connect Sentinel to any MCP-compatible AI host.