---
title: "Create Record View Link With Service"
method: POST
path: "/api/record-view-links"
tags: ["Record View Links"]
---

# Create Record View Link With Service

`POST /api/record-view-links`

Creates a short-lived capability link for viewing one stored record snapshot.

## Headers

- `X-Polytomic-Version` string

## Request body

- CreateRecordViewLinkRequest
  - `connection_id` string, uuid, required — Connection containing the record.
  - `expires_at` string, date-time, nullable — Optional expiry timestamp. Defaults to 72 hours and cannot exceed 7 days.
  - `fields` string[] — Optional field IDs to include. If omitted, all eligible readable fields are included.
  - `lookup_key_field` string, required — The schema lookup-key field used to identify the record. V1 only accepts the schema's single effective primary key.
  - `lookup_key_value` string, required — The lookup-key value for the record.
  - `schema_id` string, required — Schema containing the record.
  - `source` string — Optional creator/source label.

## Response `200`

OK

- CreateRecordViewLinkEnvelope
  - `data` CreateRecordViewLinkResponse
    - `created_at` string, date-time — Link creation timestamp.
    - `expires_at` string, date-time — Link expiry timestamp.
    - `id` string, uuid — Record-view link identifier.
    - `url` string — One-time returned viewer URL containing the raw bearer token.

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Not Found
- `500` — Internal Server Error

---

[API](https://skmtc.net/polytomic/apis/polytomic-api.md) · [All operations](https://skmtc.net/polytomic/apis/polytomic-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/polytomic/polytomic-api/revisions/b509e00e80aa/schema)