From 4e135235152cb2afd52d4ca1eb833d1a64375954 Mon Sep 17 00:00:00 2001
From: connermanuel <manuel.conner.g@gmail.com>
Date: Mon, 27 Apr 2026 14:34:01 -0700
Subject: [PATCH] Add RL.PayloadUploadURLResponse

---
 openapi.yaml | 41 +++++++++++++++++++++++++++++++++++++++++
 1 file changed, 41 insertions(+)

diff --git a/openapi.yaml b/openapi.yaml
index f58c85d..f1021fc 100644
--- a/openapi.yaml
+++ b/openapi.yaml
@@ -7707,6 +7707,32 @@ paths:
           schema:
             description: Operation ID
             type: string
+  /rl/training-sessions/{session_id}/payloads/upload-url:
+    post:
+      summary: Create payload upload URL
+      description: Returns a pre-signed URL for uploading a large operation payload to object storage.
+      operationId: createPayloadUploadURL
+      tags: [RL]
+      responses:
+        "200":
+          description: Pre-signed upload URL and payload ID
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/RL.PayloadUploadURLResponse'
+        default:
+          description: An unexpected error response.
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorData'
+      parameters:
+        - name: session_id
+          in: path
+          required: true
+          schema:
+            description: ID of the training session
+            type: string
   /rl/checkpoints/{id}/download:
     get:
       summary: Download checkpoint
@@ -8574,6 +8600,21 @@ components:
             - type: integer
           example: 123456789
           description: File size in bytes
+    RL.PayloadUploadURLResponse:
+      type: object
+      description: Pre-signed upload URL and payload identifier for large operation payloads
+      required:
+        - upload_url
+        - payload_id
+      properties:
+        upload_url:
+          type: string
+          example: "https://r2.cloudflarestorage.com/..."
+          description: Pre-signed URL for uploading the payload via HTTP PUT
+        payload_id:
+          type: string
+          example: "550e8400-e29b-41d4-a716-446655440000"
+          description: Unique ID for this payload, to be referenced in subsequent operation request
     RL.CheckpointDownloadResponse:
       type: object
       description: Presigned download URLs for a checkpoint's files