---
title: "POST: /recipe/{recipeId}/image?lat=42&lng=21&caption=this%20is%20my%20caption Note that caption, lng and lat are all optional, but must go on the request URI as params because this endpoint needs a multipart/mime content header and will not parse JSON in the body along with it. Testing with Postman (validated 11/20/2015): 1) Remove the Content-Type header; add authentication information 2) On the request, click Body and choose \"form-data\", then add a line item with \"key\" column set to \"file\" and on the right, change the type of the input from Text to File. Browse and choose a JPG."
method: POST
path: "/recipe/{recipeId}/image"
tags: ["Images"]
---

# POST: /recipe/{recipeId}/image?lat=42&lng=21&caption=this%20is%20my%20caption Note that caption, lng and lat are all optional, but must go on the request URI as params because this endpoint needs a multipart/mime content header and will not parse JSON in the body along with it. Testing with Postman (validated 11/20/2015): 1) Remove the Content-Type header; add authentication information 2) On the request, click Body and choose "form-data", then add a line item with "key" column set to "file" and on the right, change the type of the input from Text to File. Browse and choose a JPG.

`POST /recipe/{recipeId}/image`

## Request

- Base URL: `https://api2.bigoven.com`
- URL: `https://api2.bigoven.com/recipe/{recipeId}/image`
- Auth: none declared

## Path parameters

- `recipeId` string, required

## Query parameters

- `caption` string
- `lat` number, double
- `lng` number, double

## Response `200`

Success

- SystemObject

## Other responses

- `400`: if bad request (e.g., missing parameters)
- `401`: if the user is unknown
- `415`: if unsupported media type (e.g., bad JPG)

---

[API](https://skmtc.dev/bigoven/apis/1-000-000-recipe-and-grocery-list-api-v2.md) - [All operations](https://skmtc.dev/bigoven/apis/1-000-000-recipe-and-grocery-list-api-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/bigoven/apis/1-000-000-recipe-and-grocery-list-api-v2/revisions/213a69be0728?raw)