---
title: "Create a response link from an accessible source-backed form."
method: POST
path: "/api/v1/forms/fillout-links"
tags: ["Forms"]
---

# Create a response link from an accessible source-backed form.

`POST /api/v1/forms/fillout-links`

## Request

- Base URL: `https://commentary.dev`
- URL: `https://commentary.dev/api/v1/forms/fillout-links`
- Auth: HTTP bearer

The caller becomes the dedicated result-set owner. The source review remains the edit location, and source review owners do not automatically see response-link replies.

## Headers

- `X-Commentary-Workspace-Id` string
- `X-Correlation-Id` string

## Request body

- object
  - `formId` string, required
  - `sourceContext` object
  - `sourceReviewHref` string
  - `renderer` object
    - `mode` 'default' | 'review_file'
    - `path` string
    - `kind` 'markdown' | 'html'
  - `shareMode` 'specific_user' | 'authenticated' | 'anonymous'
  - `replyMode` 'identified' | 'anonymous'
  - `repeatSubmissions` boolean
  - `recipient` object

## Response `201`

Successful response.

- object
  - `ok` unknown
  - `filloutLink` object

## Other responses

- `400`: The request was invalid.
- `401`: Authentication is required.
- `403`: The token or session does not have permission for this resource.
- `404`: The resource was not found.
- `429`: The request was rate limited.

---

[API](https://skmtc.dev/commentary/apis/commentary-public-api.md) · [All operations](https://skmtc.dev/commentary/apis/commentary-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/commentary/apis/commentary-public-api/revisions/7aaafc198c52?raw)