---
title: "Read the files on SaveHQ saves"
method: POST
path: "/api/v1/actions/look_at_file"
tags: ["Change the board"]
---

# Read the files on SaveHQ saves

`POST /api/v1/actions/look_at_file`

## Request

- Base URL: `https://savehq.app`
- URL: `https://savehq.app/api/v1/actions/look_at_file`
- Auth: HTTP bearer

Watch a video, listen to a voice note or look at a photo attached to the user's saves, or watch a public YouTube video the user saved or read an X post they saved (its video and photos) (itemId, or several as itemIds), and return what each shows and says, as text. With no ids, it reads the newest videos, voice notes and YouTube links that haven't been read yet, up to 5. Anything already read returns what was stored, free — videos, voice notes and YouTube links are read within minutes of being saved, so most are; reading a new one uses the user's SaveHQ AI credits. Changes nothing on the board, except that a save still wearing the name SaveHQ gave it ("Video: IMG_0042") is renamed to what its file shows. A link to an Instagram or TikTok post is not a file and can't be opened.

Needs the person's OK: never.

## Request body

- object
  - `itemId` string: One save's id exactly as given to you.
  - `itemIds` string[]: Several saves' ids exactly as given to you.
  - `confirmToken` string: The confirmToken returned with this change's preview, once the user has agreed to it.

## Response `200`

Done (status "done", with summary and changeId), or nothing to change

- ChangeDone
  - `status` 'done' | 'no_change'
  - `summary` string
  - `changeId` string
  - `message` string

## Other responses

- `202`: Not done yet: needs the person's OK. Send the same request again with confirmToken.
- `400`: Something to fix in the request
- `401`: Missing, expired or revoked API key or token
- `429`: Over 60 requests a minute for this person; retry after 60 seconds

---

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