---
title: "Share a saved request revision as a link, without its results or permission to spend"
method: POST
path: "/v1/specs/{id}/links"
---

# Share a saved request revision as a link, without its results or permission to spend

`POST /v1/specs/{id}/links`

## Request

- Base URL: `https://api.specstream.ai`
- URL: `https://api.specstream.ai/v1/specs/{id}/links`
- Auth: API key in header `Authorization`

## Path parameters

- `id` string, required

## Request body

- SpecLinkRequest
  - `revision_id` string, required
  - `expected_ast_hash` string, required
  - `include_context` boolean
  - `expires_seconds` integer

## Response `201`

Share a saved request revision as a link, without its results or permission to spend

- object
  - `data` SpecLinkData, required
    - `link_id` string, required
    - `public_url` string, required
    - `expires_at` string, date-time, required
    - `snapshot_hash` string, required

## Other responses

- `default`: Error envelope

---

[API](https://skmtc.dev/specstream/apis/specstream-api.md) · [All operations](https://skmtc.dev/specstream/apis/specstream-api/llms.txt) · [OpenAPI document](https://skmtc.dev/specstream/apis/specstream-api/revisions/5a9f51143a13?raw)