---
title: "Pin a finding"
method: POST
path: "/api/v1/datasets/{id}/findings"
---

# Pin a finding

`POST /api/v1/datasets/{id}/findings`

## Request

- Base URL: `https://rows.page`
- URL: `https://rows.page/api/v1/datasets/{id}/findings`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-Rows-Token`

## Path parameters

- `id` string, required

## Request body

- FindingInput
  - `title` string, required
  - `note` string, nullable
  - `q` string: rows.page query language, e.g. country:NL price:>20
  - `sort` string: e.g. -price,name
  - `cols` string: e.g. id,price
  - `sql` string: SQL against the table data
  - `version` integer, nullable
  - `row_count` integer, nullable

## Response `201`

Created

- Finding
  - `id` string
  - `version` integer, nullable
  - `title` string
  - `note` string, nullable
  - `view` object
    - `q` string
    - `sort` string
    - `cols` string
    - `sql` string
  - `row_count` integer, nullable
  - `position` integer
  - `created_via` string
  - `created_at` string

## Other responses

- `400`: Error
- `401`: Error
- `403`: Error
- `404`: Error

---

[API](https://skmtc.dev/rows/apis/rows-page-api.md) · [All operations](https://skmtc.dev/rows/apis/rows-page-api/llms.txt) · [OpenAPI document](https://skmtc.dev/rows/apis/rows-page-api/revisions/98dacb9eeca7?raw)