rendobar-com Upload Sessions API
Tokenized upload sessions for clients without filesystem access
Tokenized upload sessions for clients without filesystem access
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/rendobar-com:rendobar-com-upload-sessions-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Rendobar Upload Sessions API
version: 1.0.0
summary: Serverless media processing API
description: Serverless media processing API. Watermark, transcode, caption, redact, and render videos with one API call. Credit-based billing. MCP-native for AI agents.
termsOfService: https://rendobar.com/terms/
contact:
name: Rendobar Support
url: https://rendobar.com/
email: hello@rendobar.com
license:
name: Proprietary
url: https://rendobar.com/terms/
servers:
- url: https://api.rendobar.com
description: Current environment
security:
- bearerAuth: []
- oauth2: []
tags:
- name: Upload Sessions
description: Tokenized upload sessions for clients without filesystem access
paths:
/upload-sessions/{token}:
get:
x-scope-exempt: 'the single-use token in the path IS the credential: this is how someone with no account uploads to a shared session'
operationId: getUploadSession
tags:
- Upload Sessions
summary: Get upload session state
description: Returns the session's status, expiry, and the assets uploaded through it so far. A 'done' session stays viewable here (only 'expired' 410s). The token is the sole credential — no API key required.
parameters:
- schema:
type: string
description: Upload session bearer token
required: true
description: Upload session bearer token
name: token
in: path
responses:
'200':
description: Session state (active or done)
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
status:
type: string
description: active | done | expired
expiresAt:
type: integer
description: Session expiry (Unix ms)
expectedFiles:
type: array
items:
type: object
properties:
filename:
type: string
size:
type: number
required:
- filename
description: Files the creator told the page to expect (advisory, not enforced)
maxFiles:
type: integer
description: Max files this session may upload
assets:
type: array
items:
type: object
properties:
id:
type: string
description: Asset ID
filename:
type:
- string
- 'null'
description: Display filename
status:
type: string
description: pending | uploading | ready | failed | expired
url:
type: string
description: Stable content URL — present only once the asset is ready
required:
- id
- filename
- status
required:
- status
- expiresAt
- expectedFiles
- maxFiles
- assets
required:
- data
'404':
description: Unknown token
content:
application/json:
schema:
type: object
properties:
error:
type: object
properties:
code:
type: string
description: Machine-readable error code
message:
type: string
description: Human-readable error message
details:
description: More about the error when there is more to say. A refusal lists its problems here as `{ path, message, upgradeTo? }`, where `upgradeTo` names the cheapest plan that runs it (null when only an enterprise plan does).
required:
- code
- message
required:
- error
'410':
description: Session expired
content:
application/json:
schema:
type: object
properties:
error:
type: object
properties:
code:
type: string
description: Machine-readable error code
message:
type: string
description: Human-readable error message
details:
description: More about the error when there is more to say. A refusal lists its problems here as `{ path, message, upgradeTo? }`, where `upgradeTo` names the cheapest plan that runs it (null when only an enterprise plan does).
required:
- code
- message
required:
- error
/upload-sessions/{token}/files:
post:
x-scope-exempt: 'the single-use token in the path IS the credential: this is how someone with no account uploads to a shared session'
operationId: addUploadSessionFile
tags:
- Upload Sessions
summary: Initialize a file upload against a session
description: Creates a pending asset and returns presigned upload URL(s), gated by the session's remaining file count and the org's plan size limit.
parameters:
- schema:
type: string
description: Upload session bearer token
required: true
description: Upload session bearer token
name: token
in: path
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
filename:
type: string
minLength: 1
maxLength: 255
description: Original filename
size:
type: integer
exclusiveMinimum: 0
description: File size in bytes
contentType:
type: string
description: MIME content type
required:
- filename
- size
responses:
'200':
description: Deduplicated — a ready asset with this checksum already exists
content:
application/json:
schema:
type: object
properties:
status:
type: string
description: presigned | multipart | deduplicated
data:
type: object
properties:
id:
type: string
description: Asset ID
filename:
type:
- string
- 'null'
description: Display filename
status:
type: string
description: pending | uploading | ready | failed | expired
url:
type: string
description: Stable content URL — present only once the asset is ready
required:
- id
- filename
- status
upload:
description: Presigned PUT URL or multipart part URLs
required:
- status
- data
'201':
description: Pending asset created with presigned upload URL(s)
content:
application/json:
schema:
type: object
properties:
status:
type: string
description: presigned | multipart | deduplicated
data:
type: object
properties:
id:
type: string
description: Asset ID
filename:
type:
- string
- 'null'
description: Display filename
status:
type: string
description: pending | uploading | ready | failed | expired
url:
type: string
description: Stable content URL — present only once the asset is ready
required:
- id
- filename
- status
upload:
description: Presigned PUT URL or multipart part URLs
required:
- status
- data
'403':
description: Session has reached its file cap
content:
application/json:
schema:
type: object
properties:
error:
type: object
properties:
code:
type: string
description: Machine-readable error code
message:
type: string
description: Human-readable error message
details:
description: More about the error when there is more to say. A refusal lists its problems here as `{ path, message, upgradeTo? }`, where `upgradeTo` names the cheapest plan that runs it (null when only an enterprise plan does).
required:
- code
- message
required:
- error
'404':
description: Unknown token
content:
application/json:
schema:
type: object
properties:
error:
type: object
properties:
code:
type: string
description: Machine-readable error code
message:
type: string
description: Human-readable error message
details:
description: More about the error when there is more to say. A refusal lists its problems here as `{ path, message, upgradeTo? }`, where `upgradeTo` names the cheapest plan that runs it (null when only an enterprise plan does).
required:
- code
- message
required:
- error
'410':
description: Session expired or no longer active
content:
application/json:
schema:
type: object
properties:
error:
type: object
properties:
code:
type: string
description: Machine-readable error code
message:
type: string
description: Human-readable error message
details:
description: More about the error when there is more to say. A refusal lists its problems here as `{ path, message, upgradeTo? }`, where `upgradeTo` names the cheapest plan that runs it (null when only an enterprise plan does).
required:
- code
- message
required:
- error
'413':
description: File exceeds the org's plan upload size limit
content:
application/json:
schema:
type: object
properties:
error:
type: object
properties:
code:
type: string
description: Machine-readable error code
message:
type: string
description: Human-readable error message
details:
description: More about the error when there is more to say. A refusal lists its problems here as `{ path, message, upgradeTo? }`, where `upgradeTo` names the cheapest plan that runs it (null when only an enterprise plan does).
required:
- code
- message
required:
- error
/upload-sessions/{token}/files/{assetId}/complete:
post:
x-scope-exempt: 'the single-use token in the path IS the credential: this is how someone with no account uploads to a shared session'
operationId: completeUploadSessionFile
tags:
- Upload Sessions
summary: Finalize a file upload against a session
description: Verifies the uploaded object landed in storage and marks the asset ready. assetId must have been returned by a prior POST to this same session.
parameters:
- schema:
type: string
description: Upload session bearer token
required: true
description: Upload session bearer token
name: token
in: path
- schema:
type: string
description: Asset ID returned by POST /files
required: true
description: Asset ID returned by POST /files
name: assetId
in: path
requestBody:
required: false
content:
application/json:
schema:
type: object
properties:
parts:
type: array
items:
type: object
properties:
partNumber:
type: integer
exclusiveMinimum: 0
etag:
type: string
maxLength: 256
required:
- partNumber
- etag
description: Multipart part etags (required for multipart uploads)
responses:
'200':
description: Asset finalized and ready
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
id:
type: string
description: Asset ID
filename:
type:
- string
- 'null'
description: Display filename
status:
type: string
description: pending | uploading | ready | failed | expired
url:
type: string
description: Stable content URL — present only once the asset is ready
required:
- id
- filename
- status
required:
- data
'400':
description: Multipart completion is missing part etags
content:
application/json:
schema:
type: object
properties:
error:
type: object
properties:
code:
type: string
description: Machine-readable error code
message:
type: string
description: Human-readable error message
details:
description: More about the error when there is more to say. A refusal lists its problems here as `{ path, message, upgradeTo? }`, where `upgradeTo` names the cheapest plan that runs it (null when only an enterprise plan does).
required:
- code
- message
required:
- error
'404':
description: Unknown token, or assetId not tracked by this session
content:
application/json:
schema:
type: object
properties:
error:
type: object
properties:
code:
type: string
description: Machine-readable error code
message:
type: string
description: Human-readable error message
details:
description: More about the error when there is more to say. A refusal lists its problems here as `{ path, message, upgradeTo? }`, where `upgradeTo` names the cheapest plan that runs it (null when only an enterprise plan does).
required:
- code
- message
required:
- error
'409':
description: Asset is not in a finalizable state, or the upload was not found in storage
content:
application/json:
schema:
type: object
properties:
error:
type: object
properties:
code:
type: string
description: Machine-readable error code
message:
type: string
description: Human-readable error message
details:
description: More about the error when there is more to say. A refusal lists its problems here as `{ path, message, upgradeTo? }`, where `upgradeTo` names the cheapest plan that runs it (null when only an enterprise plan does).
required:
- code
- message
required:
- error
'410':
description: Session expired or no longer active
content:
application/json:
schema:
type: object
properties:
error:
type: object
properties:
code:
type: string
description: Machine-readable error code
message:
type: string
description: Human-readable error message
details:
description: More about the error when there is more to say. A refusal lists its problems here as `{ path, message, upgradeTo? }`, where `upgradeTo` names the cheapest plan that runs it (null when only an enterprise plan does).
required:
- code
- message
required:
- error
'413':
description: Uploaded file exceeds the org's plan size limit
content:
application/json:
schema:
type: object
properties:
error:
type: object
properties:
code:
type: string
description: Machine-readable error code
message:
type: string
description: Human-readable error message
details:
description: More about the error when there is more to say. A refusal lists its problems here as `{ path, message, upgradeTo? }`, where `upgradeTo` names the cheapest plan that runs it (null when only an enterprise plan does).
required:
- code
- message
required:
- error
/upload-sessions/{token}/done:
post:
x-scope-exempt: 'the single-use token in the path IS the credential: this is how someone with no account uploads to a shared session'
operationId: completeUploadSession
tags:
- Upload Sessions
summary: Mark an upload session done
description: Marks the session done (the page's finish button). Any MCP tool waiting on this session's completion observes the status flip.
parameters:
- schema:
type: string
description: Upload session bearer token
required: true
description: Upload session bearer token
name: token
in: path
responses:
'200':
description: Session marked done
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
status:
type: string
enum:
- done
required:
- status
required:
- data
'404':
description: Unknown token
content:
application/json:
schema:
type: object
properties:
error:
type: object
properties:
code:
type: string
description: Machine-readable error code
message:
type: string
description: Human-readable error message
details:
description: More about the error when there is more to say. A refusal lists its problems here as `{ path, message, upgradeTo? }`, where `upgradeTo` names the cheapest plan that runs it (null when only an enterprise plan does).
required:
- code
- message
required:
- error
'410':
description: Session expired or already done
content:
application/json:
schema:
type: object
properties:
error:
type: object
properties:
code:
type: string
description: Machine-readable error code
message:
type: string
description: Human-readable error message
details:
description: More about the error when there is more to say. A refusal lists its problems here as `{ path, message, upgradeTo? }`, where `upgradeTo` names the cheapest plan that runs it (null when only an enterprise plan does).
required:
- code
- message
required:
- error
components:
securitySchemes:
bearerAuth:
type: http
scheme: bearer
bearerFormat: API key or OAuth access token
description: 'Bearer authentication. Accepts an API key from https://app.rendobar.com/settings/api-keys (`Authorization: Bearer rb_xxx`) or an OAuth 2.1 access token. Both carry the same scopes and the same authority: what a caller may do is a property of the grant, not of how it authenticated.'
oauth2:
type: oauth2
description: OAuth 2.1 with PKCE. Register a client at https://api.rendobar.com/oauth2/register or connect through an integration that does it for you. Scopes are granted at consent and carry the same authority as an API key holding them.
flows:
authorizationCode:
authorizationUrl: https://api.rendobar.com/auth/oauth2/authorize
tokenUrl: https://api.rendobar.com/auth/oauth2/token
refreshUrl: https://api.rendobar.com/auth/oauth2/token
scopes:
jobs:read: See your jobs and their results
jobs:write: Run and cancel jobs
assets:read: See and download your files
assets:write: Upload and delete files
webhooks:read: See where your events are delivered
webhooks:write: Manage where your events are delivered
billing:read: See your plan, balance and usage
billing:write: Change your plan and payment methods
orgs:read: See your organization and its members
orgs:write: Manage your organization and its members
keys:read: See which API keys exist
keys:write: Create and revoke API keys
storage:read: See which storage connections exist
storage:write: Connect, rotate and remove storage connections
externalDocs:
description: Full developer documentation
url: https://rendobar.com/docs/