---
title: "Save Markup"
method: PUT
path: "/api/field-app/jobs/{job_id}/photos/{media_id}/markup"
tags: ["fieldApp"]
---

# Save Markup

`PUT /api/field-app/jobs/{job_id}/photos/{media_id}/markup`

## Request

- Base URL: `https://api.electricair.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.electricair.io/api/field-app/jobs/{job_id}/photos/{media_id}/markup`
- Auth: HTTP bearer

## Path parameters

- `job_id` integer, required
- `media_id` integer, required

## Request body

- MarkupRequest
  - `document` object, required

## Response `200`

OK

- PhotoReviewSchema
  - `id` integer, required
  - `url` string, required
  - `ready` boolean, required
  - `caption` string, required
  - `uploaded_by` PersonRefSchema
    - `kind` string, required
    - `id` integer, required
    - `name` string, required
  - `taken_at` string, date-time, nullable
  - `uploaded_at` string, date-time, nullable
  - `markup` object, required
  - `markup_by` PersonRefSchema
    - `kind` string, required
    - `id` integer, required
    - `name` string, required
  - `markup_at` string, date-time, nullable
  - `comments` CommentSchema[], required
    - `id` integer, required
    - `body` string, required
    - `author` PersonRefSchema
      - `kind` string, required
      - `id` integer, required
      - `name` string, required
    - `created_at` string, date-time, required
    - `photo_id` integer, nullable
    - `punch_item_id` integer, nullable
    - `note_id` integer, nullable
  - `punch_items` PunchItemSchema[], required
    - `id` integer, required
    - `number` integer, required
    - `title` string, required
    - `details` string, required
    - `category` string, required
    - `category_label` string, required
    - `status` string, required
    - `status_label` string, required
    - `photo_id` integer, nullable
    - `photo_url` string, nullable
    - `x` number, nullable
    - `y` number, nullable
    - `assignees` PersonRefSchema[], required
      - `kind` string, required
      - `id` integer, required
      - `name` string, required
    - `created_by` PersonRefSchema
      - `kind` string, required
      - `id` integer, required
      - `name` string, required
    - `created_at` string, date-time, required
    - `done_by` PersonRefSchema
      - `kind` string, required
      - `id` integer, required
      - `name` string, required
    - `done_at` string, date-time, nullable
    - `done_note` string, required
    - `done_photo_url` string, nullable
    - `verified_by` PersonRefSchema
      - `kind` string, required
      - `id` integer, required
      - `name` string, required
    - `verified_at` string, date-time, nullable
    - `comment_count` integer, required

## Changes

> 22 revisions in range; 1 not diffed.

- **2026-10-28** `558d42db3b2e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/electricair/apis/electric-air-autoquote-api/changes/api/field-app/jobs/:job_id/photos/:media_id/markup/put.md)

---

[API](https://skmtc.dev/electricair/apis/electric-air-autoquote-api.md) - [All operations](https://skmtc.dev/electricair/apis/electric-air-autoquote-api/llms.txt) - [OpenAPI document](https://skmtc.dev/electricair/apis/electric-air-autoquote-api/revisions/a13d832a5676?raw)