# POST /v1/images - Upload an image

Source: <https://everruns.com/docs/api/operations/upload_image/>

POST

/v1/images

Select code samplecURL (shell:curl)

```js
const url = 'https://app.everruns.com/api/v1/images';
const options = {method: 'POST', headers: {'Content-Type': 'multipart/form-data'}};


try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```sh
curl --request POST \
  --url https://app.everruns.com/api/v1/images \
  --header 'Content-Type: multipart/form-data'
```

* Production APIapp.everruns.com/api/v1/images

## Parameters

### Query Parameters

**session\_id**

string

Optional: session ID stored as metadata for tracking (not required for upload)

## Request Bodyrequired

Multipart form data with ‘file’ field

Media typemultipart/form-data

string

## Responses

### 201

Image uploaded successfully

Media typeapplication/json

Image upload response

object

**content\_type**

required

string

**created\_at**

required

Timestamp when this resource was created (RFC 3339).

string format: date-time

**filename**

required

string

**id**

required

Prefixed public identifier. See [ID Schema](https://everruns.com/docs/advanced/id-schema/).

string

**size\_bytes**

required

integer format: int64

##### Example

```json
{
  "id": "img_01933b5a00007000800000000000001"
}
```

### 400

Invalid request (bad format, size exceeded, etc.)

### 500

Internal server error