---
title: "Create Share"
method: POST
path: "/api/shares"
tags: ["shares"]
---

# Create Share

`POST /api/shares`

## Request

- Base URL: `https://api.retirementlab.app` (the document declares no server; this is the origin it was published from)
- URL: `https://api.retirementlab.app/api/shares`
- Auth: HTTP bearer

## Request body

- ShareCreateRequest
  - `config_name` string
  - `run_id` integer

## Response `201`

Successful Response

- ShareCreateResponse
  - `token` string, required
  - `share_url` string, required
  - `config_name` string, required
  - `created_at` string, required
  - `source_run_id` integer
  - `assumptions_version` string
  - `assumptions_version_state` 'declared' | 'legacy_unverified'

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/retirementlab/apis/income-simulator-api.md) · [All operations](https://skmtc.dev/retirementlab/apis/income-simulator-api/llms.txt) · [OpenAPI document](https://skmtc.dev/retirementlab/apis/income-simulator-api/revisions/b0f00a0333fd?raw)