latestOpenAPI 3.0.02026-08-10135177718.4 KB

f739db716aaf

ObservationPhotos

Create observation photos

Use multipart/form-data to upload a new photo to an existing observation and application/json to create a connetion between an existing observation and an existing photo. Both accept a client-specified UUID and have upsert behavior to prevent creating duplicate ObservationPhoto records if requests succeed but fail to receive a response under poor network conditions.

post/observation_photos

Request body

{"stackTrail":"components:schemas:ObservationPhotosCreate:properties:fields","oasType":"schema","type":"unknown"}

Response

A list of observation photos

total_resultsinteger required

pageinteger required

per_pageinteger required

Example response

{
  "results": [
    {
      "photo": {
        "flags": [
          {
            "user": {
              "site": {
                "id": 1,
                "icon_url": "https://static.inaturalist.org/sites/1-logo_square.png",
                "locale": "en",
                "name": "iNaturalist",
                "site_name_short": "iNat",
                "url": "https://www.inaturalist.org"
              }
            }
          }
        ],
        "moderator_actions": [
          {
            "user": {
              "site": {
                "id": 1,
                "icon_url": "https://static.inaturalist.org/sites/1-logo_square.png",
                "locale": "en",
                "name": "iNaturalist",
                "site_name_short": "iNat",
                "url": "https://www.inaturalist.org"
              }
            }
          }
        ]
      }
    }
  ]
}