---
title: "Create a revocable guest link"
method: POST
path: "/api/agent/fiches/{id}/share"
---

# Create a revocable guest link

`POST /api/agent/fiches/{id}/share`

## Request

- Base URL: `https://sesapp.fr`
- URL: `https://sesapp.fr/api/agent/fiches/{id}/share`
- Auth: HTTP bearer

## Path parameters

- `id` string, required

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `expiresAt` string, date-time: Optional ISO datetime. Omit for no expiry.

## Response `200`

{ token, url, expiresAt, viewCount, createdAt }

## Other responses

- `400`: INVALID_PARAMS
- `401`: UNAUTHORIZED — missing or invalid Bearer
- `402`: x402 payment required (expired plan or overage). Body is not ApiError.
- `404`: SHEET_NOT_FOUND, SHARE_NOT_FOUND or WEBHOOK_NOT_FOUND

---

[API](https://skmtc.dev/sesapp/apis/sesapp-agent-api.md) · [All operations](https://skmtc.dev/sesapp/apis/sesapp-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sesapp/apis/sesapp-agent-api/revisions/8d819a96c5bf?raw)