> ## Documentation Index
> Fetch the complete documentation index at: https://secndai.manicule.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> For every page in one file, fetch https://secndai.manicule.dev/llms-full.txt (large).
> To search and read these docs as tools, connect the MCP server at https://secndai.manicule.dev/api/mcp.
> Every agent surface: https://secndai.manicule.dev/.well-known/llms-manifest.json

# Quickstart (/quickstart)

<!-- agent-signals: reading_time_min: 2 · est_tokens: 702 · updated: 2026-11-12 -->
Related: [Introduction](/index.md), [Authentication](/authentication.md), [Models](/models.md), [Changelog](/changelog.md), [Confidence and the gate](/confidence.md), [Request limits](/limits.md)

> Make one request with curl, Python, or TypeScript.

Use an invited account and create a server-side API key. Set `SECND_API_KEY` through your secret manager. Check `GET /v1/models` and substitute the dated model your account returns; the examples use `ren-zero-2026-11-12`.

## curl

```bash
curl --fail-with-body https://api.secndai.com/v1/decide \
  -H "Authorization: Bearer $SECND_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{
    "model": "ren-zero-2026-11-12",
    "type": "choice",
    "situation": "A customer says the same order was charged twice.",
    "question": "Which queue should handle this ticket?",
    "options": [
      {"id": "billing", "description": "Payment and invoice problems"},
      {"id": "delivery", "description": "Shipping and parcel problems"}
    ],
    "threshold": 0.9
  }'
```

## Python

Install the local SDK from the repository root with `uv pip install ./packages/sdk-python` in your environment. The import is `secnd`.

```python
import os
from secnd import Secnd

client = Secnd(api_key=os.environ["SECND_API_KEY"])
result = client.decide({
    "model": "ren-zero-2026-11-12",
    "type": "choice",
    "situation": "A customer says the same order was charged twice.",
    "question": "Which queue should handle this ticket?",
    "options": [
        {"id": "billing", "description": "Payment and invoice problems"},
        {"id": "delivery", "description": "Shipping and parcel problems"},
    ],
    "threshold": 0.9,
})
print(result["choice"], result["confidence"], result["action"])
```

## TypeScript

Build and install the local `@secnd/sdk` package as described in the [SDK overview](/sdk/index).

```typescript
import { Secnd } from "@secnd/sdk";

const apiKey = process.env.SECND_API_KEY;
if (!apiKey) throw new Error("Set SECND_API_KEY");
const client = new Secnd({ apiKey });
const result = await client.decide({
  model: "ren-zero-2026-11-12",
  type: "choice",
  situation: "A customer says the same order was charged twice.",
  question: "Which queue should handle this ticket?",
  options: [
    { id: "billing", description: "Payment and invoice problems" },
    { id: "delivery", description: "Shipping and parcel problems" },
  ],
  threshold: 0.9,
});
console.log(result.choice, result.confidence, result.action);
```

## Handle the answer

Check `action` before running any downstream operation. On `ask_human`, enqueue the situation and candidate answer for review. On `act`, your code still enforces permissions and business rules. The API itself does not move a ticket or issue a refund.

The response also includes the full probability map, resolved model ID, effective threshold, and usage. See [confidence and the gate](/confidence), [errors](/errors), and [request limits](/limits) before adding production traffic.