Finalcad Chunk Upload API
The Chunk Upload API from Finalcad — 4 operation(s) for chunk upload.
Work with this as data
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.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/finalcad-chunk-upload-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 Specification
openapi: 3.2.0
info:
title: Finalcad One Medias Chunk Upload API
version: '2.41'
summary: 'Media upload and retrieval for the Finalcad One platform: single-shot upload, chunked upload (init / append / terminate / abort) for files over 5 MB, and downloadable media resource URLs.'
description: 'Media upload and retrieval for the Finalcad One platform: single-shot upload, chunked upload (init / append / terminate / abort) for files over 5 MB, and downloadable media resource URLs.'
contact:
name: Finalcad One API — developer portal
url: https://developer.finalcad.com/
x-generated-by: API Evangelist enrichment pipeline (derived from the first-party Postman collection)
x-source: collections/finalcad.postman_collection.json
x-source-url: https://developer.finalcad.com/
servers:
- url: https://developer.finalcad.cloud/api
description: Production — the baseUrl variable published in the Finalcad One API Postman collection.
- url: https://developer.sandbox.finalcad.cloud/api
description: Sandbox — published by Finalcad in the 'Retrieve data in Power BI' tutorial of the same collection.
security:
- apiKey: []
tokenAuth: []
tags:
- name: Chunk Upload
paths:
/medias/uploadinit:
post:
operationId: chunkUploadInit
summary: Init
description: 'Initialize the chunk upload process.
body mandatory infos
Details
file_name
name of the madia
total_bytes
total size in bytes of the media
md5
md5 of the media
returned infos
Details
chunk_id
id of the chunk
media_id
id of the new media'
tags:
- Chunk Upload
requestBody:
required: true
content:
application/json:
schema:
type: object
example:
file_name: lang1.png
total_bytes: 445721
md5: 55ed5b904a472b4d576f20caaef21c24
responses:
'200':
description: OK
content:
application/json:
schema:
type: object
examples:
Success:
value:
expires_after_secs: 3600
chunk_id: cc1aca15-a9f2-41b2-8968-c3905545b376
media_id: 03457d15-6ee1-4860-ba24-f554bf595962
min_chunk_size: 5242880
'400':
description: Bad Request — an `api_code` static error code and message envelope. See errors/finalcad-problem-types.yml.
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
'401':
description: Unauthorized — the API key or user token is missing or invalid.
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
'500':
description: Server error — a constructed `{ProcessCode}_ERR{n}` api_code envelope.
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
/medias/{media_id}/uploadabort:
post:
operationId: chunkUploadAbort
summary: Abort
description: 'Abort the chunk upload process.
Endpoint mandatory infos
Details
media_id
id of the media in progress
body mandatory infos
Details
chunk_id
id of the chunk in proress'
tags:
- Chunk Upload
parameters:
- name: media_id
in: path
required: true
schema:
type: string
description: Path variable `media_id` as published in the collection.
requestBody:
required: true
content:
application/json:
schema:
type: object
example:
chunk_id: '{{chunk_id}}'
responses:
'204':
description: No Content
'400':
description: Bad Request — an `api_code` static error code and message envelope. See errors/finalcad-problem-types.yml.
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
'401':
description: Unauthorized — the API key or user token is missing or invalid.
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
'500':
description: Server error — a constructed `{ProcessCode}_ERR{n}` api_code envelope.
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
/medias/{media_id}/uploadappend:
post:
operationId: chunkUploadUpload
summary: Upload
description: 'Upload a file part during the chunk upload process.
Endpoint mandatory infos
Details
media_id
id of the media in progress
form-data mandatory infos
Details
chunk_id
chunk id of the media in progress
segment_index
number of the chunk segment (first is 1)
last_chunk
true if it is the last chunk
stream
chunk content
md5
md5 of the stream'
tags:
- Chunk Upload
parameters:
- name: media_id
in: path
required: true
schema:
type: string
description: Path variable `media_id` as published in the collection.
requestBody:
required: true
content:
multipart/form-data:
schema:
type: object
properties:
chunk_id:
type: string
description: chunk id returned by init function
segment_index:
type: string
description: chunk segment number first = 1
last_chunk:
type: string
description: is it the last segment ?
stream:
type: string
md5:
type: string
responses:
'204':
description: No Content
'400':
description: Bad Request — an `api_code` static error code and message envelope. See errors/finalcad-problem-types.yml.
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
'401':
description: Unauthorized — the API key or user token is missing or invalid.
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
'500':
description: Server error — a constructed `{ProcessCode}_ERR{n}` api_code envelope.
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
/medias/{media_id}/uploadterminate:
post:
operationId: chunkUploadTerminate
summary: Terminate
description: 'Validate the chunk upload process.
Endpoint mandatory infos
Details
media_id
id of the media in progress
body mandatory infos
Details
chunk_id
id of the chunk in progress'
tags:
- Chunk Upload
parameters:
- name: media_id
in: path
required: true
schema:
type: string
description: Path variable `media_id` as published in the collection.
requestBody:
required: true
content:
application/json:
schema:
type: object
example:
chunk_id: '{{chunk_id}}'
responses:
'200':
description: OK
content:
application/json:
schema:
type: object
examples:
Success:
value:
id: 3a9d8d0b-0b53-4d24-b786-3b6a53aab795
file_name: lang1.png
mime_type: image/png
'400':
description: Bad Request — an `api_code` static error code and message envelope. See errors/finalcad-problem-types.yml.
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
'401':
description: Unauthorized — the API key or user token is missing or invalid.
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
'500':
description: Server error — a constructed `{ProcessCode}_ERR{n}` api_code envelope.
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
components:
schemas:
ApiError:
type: object
description: Finalcad One error envelope. `api_code` is either a static code (mostly 4xx, e.g. INVALID_INSTANCE_STATE) or a constructed code of the form {ProcessCode}_ERR{n} / {ProcessCode}_WRN{n} (mostly 5xx).
properties:
statut:
type: integer
description: HTTP status code, repeated in the body (spelled `statut`).
api_code:
type: string
description: Internal Finalcad API error code.
message:
type: string
description: Short explanation of the abnormality encountered.
data:
type: object
description: Complementary data to help understand the error.
additionalProperties: true
securitySchemes:
apiKey:
type: apiKey
in: header
name: X-API-Key
description: Organization API key issued by Finalcad to organizations on an Enterprise licence. Sent on every call.
tokenAuth:
type: apiKey
in: header
name: Authorization
description: '`Authorization: token <your_api_key>`, or `Authorization: bearer <user_token>` for the legacy user-token flow (POST /auth).'