# Sess

> Sess lets AI agents ask people through a private Sess link. Whatever a person decides, Sess signs the receipt.

## Ask a person now, no signup

No account or API key: one API call creates a trial Session, and you get back a link to share and a credential your agent uses to read the answer.

1. Create the trial Session. No `Authorization` header: this API call starts a new trial.

```http
POST https://api.sess.si/v1/trial/sessions
Content-Type: application/json

{
  "interaction": {
    "mode": "interactive",
    "title": "Which time works for a call?",
    "source": {
      "kind": "sess_surface",
      "components": [
        {
          "type": "field",
          "name": "time",
          "label": "Time",
          "required": true,
          "schema": { "type": "string", "enum": ["10:00", "14:00", "16:00"] },
          "option_labels": { "10:00": "10 am", "14:00": "2 pm", "16:00": "4 pm" }
        }
      ]
    },
    "actions": [{ "id": "submit", "label": "Send", "intent": "submit" }]
  }
}
```

The `201` response holds `id`, `human_url`, `management_credential` and `action_expires_at`. The management credential is never shown again; keep it secret.

2. Show `human_url` to the person. They open it on any device and answer. Send it only to them.

3. Read the Session every few seconds until `status` is `"responded"`. Reading never changes the Session, so polling is safe. Keep polling until the person answers or `action_expires_at` passes; do not stop early.

```http
GET https://api.sess.si/v1/trial/sessions/{id}
Authorization: Bearer <management_credential>
```

4. Read the answer back to the person. Their typed answer is `responses[0].data`, for example `{"time": "14:00"}`.

Check any bundle at `POST https://api.sess.si/v1/receipts/verify`, no key.

Limits: 3 trials per network per day; the link can be answered for 1 hour.

For your own question, change the title, the field and the action: see Writing a Surface in the [docs llms.txt](https://docs.sess.si/llms.txt). More as Markdown: [Quickstart](https://docs.sess.si/quickstart/index.html.md), [How Sess works](https://docs.sess.si/concepts/index.html.md), [Limits](https://docs.sess.si/limits/index.html.md), [API reference](https://docs.sess.si/reference/index.html.md).

## Docs

- [Sess documentation](https://docs.sess.si/): the documentation index
- [Quickstart](https://docs.sess.si/quickstart/): create a Session with curl, get the person's typed answer, then verify its signed receipt

## Build with Sess

- [SDK quickstart](https://docs.sess.si/sdk/): the same from Node.js with the Sess SDK
- [Add Sess to your agent](https://docs.sess.si/add-to-your-agent/): connect Sess's MCP server to each agent host (hosted or on your machine), and where each host stands today
- [Register your agent](https://docs.sess.si/targets/): give Sess your agent's HTTPS address, prove the address is yours, and let the websites you choose start it

The full index, pricing and how to write a page: [docs.sess.si/llms.txt](https://docs.sess.si/llms.txt).
