SesApp Access Sheets

Subscribe or renew. plan=agent (15 USDC, 20 sheets), fleet (79 USDC, 200), platform (250 USDC, fair-use). Send PAYMENT-SIGNATURE (x402 v2). Returns a Bearer JWT.

{
  "type": "object",
  "properties": {
    "plan": {
      "type": "string",
      "enum": [
        "agent",
        "fleet",
        "platform"
      ],
      "description": "SKU to purchase. Default agent."
    }
  }
}

Current agent plan, expiry, fichesCount, maxFiches, overageUsdc. Requires Authorization: Bearer.

{
  "type": "object",
  "properties": {}
}

Resolve a postal address to formattedAddress + lat/lon for create_fiche (cover map and 150 m WiFi geofence). Optional country ISO2. Requires Bearer.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Address search, min 3 characters"
    },
    "country": {
      "type": "string",
      "description": "Optional ISO 3166-1 alpha-2, e.g. fr"
    }
  },
  "required": [
    "query"
  ]
}

List access sheets owned by the authenticated agent. Requires Authorization: Bearer.

{
  "type": "object",
  "properties": {}
}

Create an access sheet. Write the guest flip-book in `instructions` (Markdown; guest language, usually French). Cover (map/name/address/accessCode) is auto. Pages: --- . Photos: . Intents: [Add WiFi](sesapp:wifi) or [Ajouter le WiFi](sesapp:wifi) + wifiName/wifiPassword; [Add contact](sesapp:contact) or [Ajouter le contact](sesapp:contact) + phoneNumber. Never put wifiPassword in Markdown (150 m GPS). Optional `locale` fr|en for guest chrome. Playbook: GET /llms.txt. Requires Bearer. Beyond quota, retry with PAYMENT-SIGNATURE (0.50 USDC on Agent, 0.25 on Fleet).

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string"
    },
    "formattedAddress": {
      "type": "string"
    },
    "instructions": {
      "type": "string",
      "description": "Markdown flip-book shown to the guest (this field).\nCover (map, name, formattedAddress, accessCode) is generated — do not repeat it here.\nSplit pages with a line containing only --- .\nSupported: # ## ### headings, paragraphs, **bold**, *italic*, - / 1. lists, [label](https://...), ![alt](https://...).\nPhotos: https URLs (GCS via the host app, or your own CDN). Agents send URLs, no file upload.\nNever put wifiPassword in Markdown; it is unlocked only within 150 m via GPS.\nIntent hrefs: sesapp:wifi (needs wifiName + wifiPassword) and sesapp:contact (needs phoneNumber). Guest-facing labels: [Ajouter le WiFi] / [Ajouter le contact].\nIf you omit those links but set the fields, SesApp appends WiFi/contact pages.\nExample:\n# Bienvenue\nParking au fond à gauche.\n\n![Façade](https://example.com/facade.jpg)\n\n---\n\n## Arrivée\nSonnette à gauche.\n\n[Itinéraire](https://maps.google.com/?q=48.8566,2.3522)\n\n---\n\n[Ajouter le WiFi](sesapp:wifi)\n\n---\n\n[Ajouter le contact](sesapp:contact)"
    },
    "lat": {
      "type": "number",
      "description": "Cover map + WiFi geofence (150 m)."
    },
    "lon": {
      "type": "number",
      "description": "Cover map + WiFi geofence (150 m)."
    },
    "wifiName": {
      "type": "string",
      "description": "SSID for sesapp:wifi. Hidden until 150 m if wifiPassword is set."
    },
    "wifiPassword": {
      "type": "string",
      "description": "Do not put in instructions. Unlocked within 150 m."
    },
    "accessCode": {
      "type": "string",
      "description": "Shown on the generated cover."
    },
    "phoneNumber": {
      "type": "string",
      "description": "Required for sesapp:contact. E.164 preferred."
    },
    "locale": {
      "type": "string",
      "enum": [
        "fr",
        "en"
      ],
      "description": "Guest chrome language. Markdown stays as written. Omit to follow Accept-Language / ?lang=."
    }
  },
  "required": [
    "name",
    "formattedAddress"
  ]
}

Get one owned access sheet by id (same fields as list_fiches). Requires Bearer.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    }
  },
  "required": [
    "id"
  ]
}

Update an owned access sheet. Same fields as create_fiche. Typical: update instructions with photos/links. Requires Bearer.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "formattedAddress": {
      "type": "string"
    },
    "instructions": {
      "type": "string",
      "description": "Markdown flip-book shown to the guest (this field).\nCover (map, name, formattedAddress, accessCode) is generated — do not repeat it here.\nSplit pages with a line containing only --- .\nSupported: # ## ### headings, paragraphs, **bold**, *italic*, - / 1. lists, [label](https://...), ![alt](https://...).\nPhotos: https URLs (GCS via the host app, or your own CDN). Agents send URLs, no file upload.\nNever put wifiPassword in Markdown; it is unlocked only within 150 m via GPS.\nIntent hrefs: sesapp:wifi (needs wifiName + wifiPassword) and sesapp:contact (needs phoneNumber). Guest-facing labels: [Ajouter le WiFi] / [Ajouter le contact].\nIf you omit those links but set the fields, SesApp appends WiFi/contact pages.\nExample:\n# Bienvenue\nParking au fond à gauche.\n\n![Façade](https://example.com/facade.jpg)\n\n---\n\n## Arrivée\nSonnette à gauche.\n\n[Itinéraire](https://maps.google.com/?q=48.8566,2.3522)\n\n---\n\n[Ajouter le WiFi](sesapp:wifi)\n\n---\n\n[Ajouter le contact](sesapp:contact)"
    },
    "lat": {
      "type": "number",
      "description": "Cover map + WiFi geofence (150 m)."
    },
    "lon": {
      "type": "number",
      "description": "Cover map + WiFi geofence (150 m)."
    },
    "wifiName": {
      "type": "string",
      "description": "SSID for sesapp:wifi. Hidden until 150 m if wifiPassword is set."
    },
    "wifiPassword": {
      "type": "string",
      "description": "Do not put in instructions. Unlocked within 150 m."
    },
    "accessCode": {
      "type": "string",
      "description": "Shown on the generated cover."
    },
    "phoneNumber": {
      "type": "string",
      "description": "Required for sesapp:contact. E.164 preferred."
    },
    "locale": {
      "type": "string",
      "enum": [
        "fr",
        "en"
      ],
      "description": "Guest chrome language. Markdown stays as written. Omit to follow Accept-Language / ?lang=."
    }
  },
  "required": [
    "id"
  ]
}

Delete an owned access sheet and its share links. Requires Bearer.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    }
  },
  "required": [
    "id"
  ]
}

Create a revocable guest link. Optional expiresAt (ISO). WiFi password is never in Markdown: guests unlock it within 150 m of lat/lon. Requires Bearer.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    },
    "expiresAt": {
      "type": "string",
      "description": "ISO datetime, optional. Omit for no expiry."
    }
  },
  "required": [
    "id"
  ]
}

List guest links for a fiche (token, url, expiresAt, viewCount, createdAt). Requires Bearer.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    }
  },
  "required": [
    "id"
  ]
}

Revoke a guest share token. Optional delayDays (1–365) keeps the link until then (soft revoke). Requires Bearer.

{
  "type": "object",
  "properties": {
    "token": {
      "type": "string"
    },
    "delayDays": {
      "type": "number",
      "description": "If set, the link expires after N days instead of being deleted now."
    }
  },
  "required": [
    "token"
  ]
}

Fleet/Platform only. Register an HTTPS endpoint. Events: fiche.viewed, share.created, share.revoked, wifi.unlocked, quota.warning. HMAC SHA-256 in X-SesApp-Signature (t=unix,v1=hex of timestamp.body). Secret returned once. Max 5 endpoints. Requires Bearer.

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "HTTPS URL (http://127.0.0.1 allowed in DEV)"
    },
    "events": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Subset of events. Default: all."
    }
  },
  "required": [
    "url"
  ]
}

List webhook endpoints (secret is never returned). Fleet/Platform. Requires Bearer.

{
  "type": "object",
  "properties": {}
}

Update url, events, or active. Fleet/Platform. Requires Bearer.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    },
    "url": {
      "type": "string"
    },
    "events": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "active": {
      "type": "boolean"
    }
  },
  "required": [
    "id"
  ]
}

Delete a webhook endpoint. Fleet/Platform. Requires Bearer.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    }
  },
  "required": [
    "id"
  ]
}