Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
121 changes: 121 additions & 0 deletions .speakeasy/in.openapi.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -29388,6 +29388,127 @@ paths:
tags:
- 'Containers'
x-hidden: true
/containers/{container_id}/files/{file_id}/promote:
post:
description: 'Copies a file from the container''s sandbox prefix into the workspace''s durable document storage, so it outlives the container. Returns the new document in the Files API shape, with a durable file id in the documents namespace. The copy counts against the workspace''s storage quota exactly like an upload.'
operationId: 'promoteContainerFile'
parameters:
- description: 'The canonical container id, exactly as returned in a bash/shell tool result — a restarted session has its own `-r<nonce>`-suffixed id. A session-derived id is always `sess_` + the sanitized session key, which is not necessarily the raw session id that was sent.'
in: 'path'
name: 'container_id'
required: true
schema:
description: 'The canonical container id, exactly as returned in a bash/shell tool result — a restarted session has its own `-r<nonce>`-suffixed id. A session-derived id is always `sess_` + the sanitized session key, which is not necessarily the raw session id that was sent.'
example: 'sess_abc123'
type: 'string'
- description: 'Container file id (`cfile_` + base64url of the file path).'
in: 'path'
name: 'file_id'
required: true
schema:
description: 'Container file id (`cfile_` + base64url of the file path).'
example: 'cfile_b3V0L3JlcG9ydC5jc3Y'
type: 'string'
responses:
'200':
content:
application/json:
example:
_shape: 'openrouter'
created_at: '2026-08-23T00:00:00Z'
downloadable: false
filename: 'out/report.csv'
id: 'or_file_011CNha8iCJcU1wXNR6q4V8w'
mime_type: 'text/csv'
size_bytes: 123
type: 'file'
schema:
$ref: '#/components/schemas/FileResponse'
description: 'The promoted file, as a workspace document.'
'400':
content:
application/json:
example:
error:
code: 400
message: 'Invalid request parameters'
schema:
$ref: '#/components/schemas/BadRequestResponse'
description: 'Bad Request - Invalid request parameters or malformed input'
'401':
content:
application/json:
example:
error:
code: 401
message: 'Missing Authentication header'
schema:
$ref: '#/components/schemas/UnauthorizedResponse'
description: 'Unauthorized - Authentication required or invalid credentials'
'403':
content:
application/json:
example:
error:
code: 403
message: 'Only management keys can perform this operation'
schema:
$ref: '#/components/schemas/ForbiddenResponse'
description: 'Forbidden - Authentication successful but insufficient permissions'
'404':
content:
application/json:
example:
error:
code: 404
message: 'Resource not found'
schema:
$ref: '#/components/schemas/NotFoundResponse'
description: 'Not Found - Resource does not exist'
'413':
content:
application/json:
example:
error:
code: 413
message: 'Request payload too large'
schema:
$ref: '#/components/schemas/PayloadTooLargeResponse'
description: 'Payload Too Large - Request payload exceeds size limits'
'429':
content:
application/json:
example:
error:
code: 429
message: 'Rate limit exceeded'
schema:
$ref: '#/components/schemas/TooManyRequestsResponse'
description: 'Too Many Requests - Rate limit exceeded'
'500':
content:
application/json:
example:
error:
code: 500
message: 'Internal Server Error'
schema:
$ref: '#/components/schemas/InternalServerResponse'
description: 'Internal Server Error - Unexpected server error'
'503':
content:
application/json:
example:
error:
code: 503
message: 'Service temporarily unavailable'
schema:
$ref: '#/components/schemas/ServiceUnavailableResponse'
description: 'Service Unavailable - Service temporarily unavailable'
summary: 'Promote a container file into workspace documents'
tags:
- 'Containers'
x-hidden: true
/credits:
get:
description: 'Get total credits purchased and used for the authenticated user. [Management key](/docs/guides/overview/auth/management-api-keys) required.'
Expand Down
Loading