openapi: 3.2.0 info: title: Finalcad One Project Meetings API version: '2.41' summary: 'Project-level operations for Finalcad One construction projects: project details, project libraries, members, locations (folders / plans / IFC), discussion groups, companies, modules (observations / forms / meetings), observations, forms and form answers, documents, phases, meetings and XLSX/PDF exports.' description: 'Project-level operations for Finalcad One construction projects: project details, project libraries, members, locations (folders / plans / IFC), discussion groups, companies, modules (observations / forms / meetings), observations, forms and form answers, documents, phases, meetings and XLSX/PDF exports. DERIVED, NOT PUBLISHED BY THE PROVIDER. Finalcad publishes no OpenAPI. This document was mechanically derived by API Evangelist from the first-party public Postman collection "Finalcad One API" served by Finalcad at https://developer.finalcad.com/ (collection JSON: https://developer.finalcad.com/api/collections/10995648/Tz5v1Es2), saved in this repo at collections/finalcad.postman_collection.json. Every path, method, header, query parameter, example request body and example response below is carried over from that collection; nothing was invented. Request/response bodies are typed as generic objects because the collection carries examples, not schemas. Four Finalcad employees'' personal e-mail addresses that appeared in the collection''s example payloads were replaced with placeholders; nothing else was changed.' 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: Meetings paths: /projects/{project_id}/meetings: get: operationId: meetingsGetMeetings summary: Get meetings description: "Get the list of meetings for a given project.\n\n Details \n\n project_Id \n the id of the project to be modified \n\n Query params optionals \n\n see Commmon behaviors / differential" tags: - Meetings parameters: - name: project_id in: path required: true schema: type: string description: Path variable `project_id` as published in the collection. responses: '200': description: OK content: application/json: schema: type: object examples: Success: value: meetings: - id: ed0c4147-c6b5-49e8-acc8-4c23a1368dc2 description: meet1 meeting_start_date: '2024-05-30T13:22:55Z' meeting_end_date: '2024-05-30T15:22:55Z' client_created_at: '2024-05-29T07:23:27.772Z' client_updated_at: '2024-05-29T07:23:27.772Z' created_at: '2024-05-29T07:23:28.087017Z' created_by: 25ff0593-dd4c64d0-1579-4354-8a2b-260b34025b6a updated_at: '2024-05-29T07:23:28.087017Z' updated_by: 25ff0593-dd4c64d0-1579-4354-8a2b-260b34025b6a - id: 83ae1a12-809f-4bbd-92fd-91c516ec9d13 description: meet1 meeting_start_date: '2024-05-30T13:22:55Z' meeting_end_date: '2024-05-30T15:22:55Z' client_created_at: '2024-05-29T07:23:48.21Z' client_updated_at: '2024-05-29T07:23:48.21Z' created_at: '2024-05-29T07:23:48.519077Z' created_by: 25ff0593-dd4c64d0-1579-4354-8a2b-260b34025b6a updated_at: '2024-05-29T07:23:48.519077Z' updated_by: 25ff0593-dd4c64d0-1579-4354-8a2b-260b34025b6a need_to_relaunch: true continuous_token: 0|2 count: 2 total_count: 5 '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' /projects/{project_id}/meetings/{meeting_id}: get: operationId: meetingsGetMeetingDetails summary: Get meeting details description: "Get the details of a specific meeting for a given project.\n\n Details \n\n project_Id \n the id of the project to be modified \n\n meeting_id \n id of the meeting" tags: - Meetings parameters: - name: project_id in: path required: true schema: type: string description: Path variable `project_id` as published in the collection. - name: meeting_id in: path required: true schema: type: string description: Path variable `meeting_id` as published in the collection. responses: '200': description: OK content: application/json: schema: type: object examples: Success: value: id: 336a8f8e-17b9-4d94-8a81-33a85861888f description: Reu 1 meeting_start_date: '2023-04-05T07:51:19.4Z' meeting_end_date: '2023-04-05T09:51:19.4Z' client_created_at: '2023-04-05T07:51:29.24Z' client_updated_at: '2023-04-05T07:52:36.470651Z' export_status: Success export_media_resource: id: 3e56a79d-81e2-46af-9f7e-5606d279319a file_name: TestFormsAnswer-Reu1-2023-04-05-09-52-23-568 mime_type: application/pdf created_at: '2023-04-05T07:52:36.473358Z' created_at: '2023-04-05T07:51:29.571677Z' created_by: 25ff0593-dd4c64d0-1579-4354-8a2b-260b34025b6a updated_at: '2023-04-05T07:52:36.475478Z' updated_by: 25ff0593-dd4c64d0-1579-4354-8a2b-260b34025b6a '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 `, or `Authorization: bearer ` for the legacy user-token flow (POST /auth).'