---
title: "Prepare Run Payload Upload"
method: POST
path: "/functions/{function_id}/runs/{run_id}/payloads/{field}/upload"
tags: ["functions"]
---

# Prepare Run Payload Upload

`POST /functions/{function_id}/runs/{run_id}/payloads/{field}/upload`

## Request

- Base URL: `https://api.notte.cc` (the document declares no server; this is the origin it was published from)
- URL: `https://api.notte.cc/functions/{function_id}/runs/{run_id}/payloads/{field}/upload`
- Auth: OAuth 2
  - Password
  - Token URL: `token`

## Path parameters

- `run_id` string, required
- `function_id` string, required
- `field` 'result' | 'logs' | 'variables', required

## Headers

- `x-notte-request-origin` string, nullable
- `x-notte-sdk-version` string, nullable

## Request body

- RunPayloadUploadRequest
  - `size_bytes` integer, required
  - `sha256` string, required

## Response `200`

Successful Response

- RunPayloadUploadResponse
  - `reference` RunPayloadReference, required
    - `size_bytes` integer, required
    - `sha256` string, required
    - `upload_id` string, uuid, required
  - `url` string, required
  - `headers` object, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-07** `cbde3a371e0a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/notte/apis/notte-api/changes/functions/:function_id/runs/:run_id/payloads/:field/upload/post.md)

---

[API](https://skmtc.dev/notte/apis/notte-api.md) - [All operations](https://skmtc.dev/notte/apis/notte-api/llms.txt) - [OpenAPI document](https://skmtc.dev/notte/apis/notte-api/revisions/d56fcbf39bc9?raw)