Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
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.
All 92 tools →
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/rendobar-com:rendobar-com-upload-sessions-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
Get an API 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/