---
title: "Update an observation photo"
method: PUT
path: "/observation_photos/{uuid}"
tags: ["ObservationPhotos"]
---

# Update an observation photo

`PUT /observation_photos/{uuid}`

## Path parameters

- `uuid` string, uuid, required

## Request body

- ObservationPhotosUpdate
  - `fields` unknown
  - `observation_photo` object
    - `observation_id` string, uuid, required
    - `position` integer

## Response `200`

A list of observation photos

- ResultsObservationPhotos
  - `total_results` integer, required
  - `page` integer, required
  - `per_page` integer, required
  - `results` ObservationPhoto[], required
    - `id` integer, required — Unique auto-increment integer identifier.
    - `photo` Photo, nullable
      - `id` integer, required — Unique auto-increment integer identifier.
      - `attribution` string
      - `attribution_name` string, nullable
      - `flags` Flag[]
        - `id` integer, required — Unique auto-increment integer identifier.
        - `comment` string, nullable
        - `created_at` string, date-time
        - `created_at_utc` string, date-time, nullable
        - `flag` string
        - `flaggable_content` string, nullable
        - `flaggable_id` integer, nullable
        - `flaggable_type` string, nullable
        - `flaggable_user_id` integer, nullable
        - `resolved` boolean
        - `resolver_id` integer, nullable
        - `resolved_at` string, date-time, nullable
        - `updated_at` string, date-time, nullable
        - `updated_at_utc` string, date-time, nullable
        - `user` User, nullable
          - `id` integer, required — Unique auto-increment integer identifier.
          - `uuid` string, uuid
          - `created_at` string, date-time
          - `description` string, nullable
          - `faved_project_ids` number[] — Ordered list of IDs of projects the user has faved
          - `icon` string, nullable
          - `icon_url` string, nullable
          - `identifications_count` integer
          - `journal_posts_count` integer
          - `annotated_observations_count` integer
          - `last_active` string, date-time
          - `login` string
          - `monthly_supporter` boolean, nullable
          - `name` string, nullable
          - `observations_count` integer
          - `orcid` string, nullable
          - `preferences` object
            - `prefers_community_taxa` boolean — Whether the user allows the Community Taxon to be the taxon their observation is associated with
            - `prefers_observation_fields_by` 'anyone' | 'curators' | 'observer'
            - `prefers_project_addition_by` 'any' | 'joined' | 'none'
          - `roles` string[]
          - `site` Site, nullable
            - `id` integer, required — Unique auto-increment integer identifier.
            - `icon_url` string — URL of an icon image for the site
            - `locale` string, nullable — Default language code for users of this site
            - `name` string — Full name of the site
            - `place_id` integer, nullable — Integer ID of the default search place for this site
            - `site_name_short` string, nullable — Short name for this site
            - `url` string
          - `site_id` integer, nullable
          - `spam` boolean
          - `species_count` integer
          - `suspended` boolean
          - `updated_at` string, date-time
        - `user_id` integer
        - `uuid` string, uuid, nullable
      - `hidden` boolean
      - `large_url` string, nullable
      - `license_code` string, nullable
      - `medium_url` string, nullable
      - `moderator_actions` ModeratorAction[]
        - `id` integer, required — Unique auto-increment integer identifier.
        - `created_at` string
        - `created_at_details` DateDetails, nullable
          - `date` string, required
          - `day` integer, required
          - `hour` integer, required
          - `month` integer, required
          - `week` integer, required
          - `year` integer, required
        - `user` User, nullable
          - `id` integer, required — Unique auto-increment integer identifier.
          - `uuid` string, uuid
          - `created_at` string, date-time
          - `description` string, nullable
          - `faved_project_ids` number[] — Ordered list of IDs of projects the user has faved
          - `icon` string, nullable
          - `icon_url` string, nullable
          - `identifications_count` integer
          - `journal_posts_count` integer
          - `annotated_observations_count` integer
          - `last_active` string, date-time
          - `login` string
          - `monthly_supporter` boolean, nullable
          - `name` string, nullable
          - `observations_count` integer
          - `orcid` string, nullable
          - `preferences` object
            - `prefers_community_taxa` boolean — Whether the user allows the Community Taxon to be the taxon their observation is associated with
            - `prefers_observation_fields_by` 'anyone' | 'curators' | 'observer'
            - `prefers_project_addition_by` 'any' | 'joined' | 'none'
          - `roles` string[]
          - `site` Site, nullable
            - `id` integer, required — Unique auto-increment integer identifier.
            - `icon_url` string — URL of an icon image for the site
            - `locale` string, nullable — Default language code for users of this site
            - `name` string — Full name of the site
            - `place_id` integer, nullable — Integer ID of the default search place for this site
            - `site_name_short` string, nullable — Short name for this site
            - `url` string
          - `site_id` integer, nullable
          - `spam` boolean
          - `species_count` integer
          - `suspended` boolean
          - `updated_at` string, date-time
        - `action` string
        - `reason` string
        - `private` boolean
      - `native_page_url` string, nullable
      - `native_photo_id` string, nullable
      - `original_dimensions` object, nullable
        - `height` integer, nullable
        - `width` integer, nullable
      - `original_url` string, nullable
      - `small_url` string, nullable
      - `square_url` string, nullable
      - `type` string
      - `url` string, nullable
      - `original_filename` string, nullable
    - `position` integer, nullable
    - `uuid` string, uuid

---

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