Finalcad Datasets API
The Datasets API from Finalcad — 3 operation(s) for datasets.
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-datasets-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 Organization Management Datasets API
version: '2.41'
summary: 'Organization-level administration of a Finalcad One Enterprise tenant: workspaces, members and roles, observation status / trade / common-observation / priority / form-template libraries, form and observation module types, data referentials, and Power BI dataset configuration.'
description: 'Organization-level administration of a Finalcad One Enterprise tenant: workspaces, members and roles, observation status / trade / common-observation / priority / form-template libraries, form and observation module types, data referentials, and Power BI dataset configuration.'
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: Datasets
paths:
/organizations/{organization_id}/data/config:
get:
operationId: datasetsGetDatasets
summary: Get datasets
description: 'Get the list of datasets for the organization.
Endpoint mandatory parameters
Details
organization_id
id of your organization'
tags:
- Datasets
parameters:
- name: organization_id
in: path
required: true
schema:
type: string
description: Path variable `organization_id` as published in the collection.
responses:
'200':
description: OK
content:
application/json:
schema:
type: object
examples:
Success:
value:
data_sets:
- name: Observations
is_active: true
- name: Statuses
is_active: true
- name: CommonObservations
is_active: true
- name: FormInstances
is_active: true
- name: FormTemplates
is_active: true
- name: Plans
is_active: true
- name: Companies
is_active: true
- name: Phases
is_active: true
- name: Modules
is_active: true
- name: Users
is_active: true
- name: Projects
is_active: true
- name: Workspaces
is_active: true
- name: Documents
is_active: true
- name: FormAnswers
is_active: true
'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'
post:
operationId: datasetsPostDatasets
summary: Post datasets
description: 'Set the list of active datasets.
Endpoint mandatory parameters
Details
organization_id
id of your organization
body mandatory
data_sets
list of the active datasets
all missing dataset are invalidated
Dataset list :
CommonObservations, Companies, FormInstances, FormTemplates, Modules, Observations, Phases, Plans, Statuses, Projects, Workspaces, Documents, Users, FormAnswers, UserActivities, Priorities, ProjectsUsersRoles'
tags:
- Datasets
parameters:
- name: organization_id
in: path
required: true
schema:
type: string
description: Path variable `organization_id` as published in the collection.
requestBody:
required: true
content:
application/json:
schema:
type: object
example:
data_sets:
- CommonObservations
- Companies
- FormInstances
- FormTemplates
- Modules
- Observations
- Phases
- Plans
- Statuses
- Projects
- Workspaces
- Documents
- Users
- FormAnswers
- UserActivities
- Priorities
- ProjectsUsersRoles
responses:
'200':
description: OK
content:
application/json:
schema:
type: object
examples:
Success:
value:
data_sets:
- name: Observations
is_active: true
url: https://tf-business-organization......Amz....a886e
- name: Forms
is_active: true
- name: Plans
is_active: false
- name: Documents
is_active: false
'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'
/organizations/{organization_id}/data/config/dataset:
get:
operationId: datasetsGetDatasetContent
summary: Get dataset content
description: 'Get the content for an active dataset (limited to 10MB).
Endpoint mandatory parameters
Details
organization_id
id of your organization
name
name of the dataset'
tags:
- Datasets
parameters:
- name: organization_id
in: path
required: true
schema:
type: string
description: Path variable `organization_id` as published in the collection.
responses:
'200':
description: OK
'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'
/organizations/{organization_id}/data/config/dataseturl:
get:
operationId: datasetsGetDatasetUrl
summary: Get dataset URL
description: 'Get a downloadable URL for an active dataset.
Endpoint mandatory parameters
Details
organization_id
id of your organization
name
name of the dataset'
tags:
- Datasets
parameters:
- name: organization_id
in: path
required: true
schema:
type: string
description: Path variable `organization_id` as published in the collection.
responses:
'200':
description: OK
content:
application/json:
schema:
type: object
examples:
Success:
value:
url: https://medias....LSEQ
'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).'