REST API overview

​

Base URLs

• Client endpoints: /api/client/*
• Admin endpoints: /api/admin/*

​

Authentication

Authorization: Bearer YOUR_TOKEN

​

Client endpoints

​

Authentication

• POST /api/client/auth/sign-in - Sign in with credentials
• POST /api/client/auth/sign-up - Create new account
• POST /api/client/auth/sign-out - Sign out
• GET /api/client/auth/refresh - Refresh authentication token

​

OAuth and SSO

• GET /api/client/auth/oidc - OpenID Connect authentication
• POST /api/client/auth/okta-saml - Okta SAML authentication
• GET /api/client/auth/ms-dynamics - Microsoft Dynamics authentication

​

File operations

• POST /api/client/upload - Upload files
• GET /api/client/download-model/:type/:id - Download 3D models
• GET /api/client/download-zipped-job-report/:id - Download job report as ZIP

​

Reports

• GET /api/client/reports - Get reports
• POST /api/client/reports - Generate report
• GET /api/client/meter-report - Get meter report
• GET /api/client/meter-report-filters - Get available report filters

​

PDF generation

• GET /api/client/get-as-pdf/getTemplateAsPdf/:id - Export template as PDF
• GET /api/client/get-as-pdf/getJobHistoryAsPdf/:id - Export job history as PDF

​

Import/export

• POST /api/client/import-zip - Import template from ZIP
• POST /api/client/copy-entities - Copy entities between clients
• POST /api/client/replaceFile - Replace existing file

​

Point cloud and alignment

• GET /api/client/alignment-data - Get alignment data
• POST /api/client/alignment-data - Upload alignment data

​

Bug reports and diagnostics

• POST /api/client/add-bug-report - Submit bug report
• POST /api/client/bug-report-web - Submit web bug report
• POST /api/client/bug-report-github - Submit GitHub issue
• POST /api/client/clear-diagnostics - Clear diagnostic data

​

Client information

• GET /api/client/client-info - Get client configuration
• GET /api/client/version - Get API version
• GET /api/client/check-updates - Check for updates
• GET /api/client/on-premise - Check if on-premise deployment

​

Localization

• GET /api/client/translate - Get translations
• GET /api/client/internalization/:lang - Get localization for language

​

Licensing

• GET /api/client/license - Get license information
• POST /api/client/license - Update license

​

EULA and agreements

• GET /api/client/eula - Get EULA
• POST /api/client/eula/accept - Accept EULA
• GET /api/client/agreement - Get client agreement

​

Bing Maps integration

• GET /api/client/bingApi - Bing Maps API proxy

​

Oracle integration

• GET /api/client/oracle - Oracle integration endpoints
• POST /api/client/oracle - Sync with Oracle

​

Editorial analytics

• GET /api/client/editorial - Get editorial analytics
• POST /api/client/editorial - Track editorial events

​

Notifications

• POST /api/client/turn-push-notification - Enable/disable push notifications

​

Working together

• GET /api/client/workingTogether/handOffStatuses - Get hand-off statuses
• POST /api/client/workingTogether - Update collaboration status

​

Sensors and IoT

• POST /api/client/update-sensors - Update sensor data

​

Job history

• GET /api/client/job-history-users - Get users involved in job history

​

Tutorials

• GET /api/client/get-tutorials-info - Get tutorial information

​

Logos and branding

• GET /api/client/get-logo-by-owner - Get organization logo

​

WebRTC

• POST /api/client/web-rtc-logs - Submit WebRTC logs

​

Customer portal

• GET /api/client/customer-portal - Access customer portal (admin only)

​

Admin endpoints

​

Authentication

• POST /api/admin/auth/sign-in - Admin sign in
• POST /api/admin/auth/sign-out - Admin sign out

​

Client management

• GET /api/admin/client - List clients
• POST /api/admin/client - Create client
• PUT /api/admin/client/:id - Update client
• DELETE /api/admin/client/:id - Delete client

​

User management

• GET /api/admin/user - List users
• POST /api/admin/user - Create user
• PUT /api/admin/user/:id - Update user
• DELETE /api/admin/user/:id - Delete user

​

License management

• GET /api/admin/license - List licenses
• POST /api/admin/license - Create license
• PUT /api/admin/license/:id - Update license
• DELETE /api/admin/license/:id - Delete license

​

On-premise licensing

• GET /api/admin/license-on-prem - Get on-premise license
• POST /api/admin/license-on-prem - Upload license key

​

Logs

• GET /api/admin/logs - Get system logs
• DELETE /api/admin/logs/:id - Delete log entry

​

Agreements

• GET /api/admin/agreement - List agreements
• POST /api/admin/agreement - Create agreement
• PUT /api/admin/agreement/:id - Update agreement

​

Internationalization

• GET /api/admin/internationalization - Get translations
• POST /api/admin/internationalization - Add translation
• PUT /api/admin/internationalization/:id - Update translation

​

Activity reports

• GET /api/admin/activity-report - Get activity report

​

Docker notifications

• POST /api/admin/docker-notification-center - Docker deployment notifications

​

File uploads

• POST /api/admin/upload - Upload files (admin)

​

Response formats

​

Success response

{
  "success": true,
  "data": {
    // Response data
  }
}

​

Error response

{
  "success": false,
  "error": {
    "message": "Error description",
    "code": "ERROR_CODE",
    "details": {}
  }
}

​

HTTP status codes

• 200 - Success
• 201 - Created
• 400 - Bad request
• 401 - Unauthorized
• 403 - Forbidden
• 404 - Not found
• 409 - Conflict
• 422 - Unprocessable entity
• 500 - Internal server error
• 503 - Service unavailable

​

Rate limiting

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 999
X-RateLimit-Reset: 1640000000

​

File uploads

POST /api/client/upload
Content-Type: multipart/form-data

file: [binary data]
metadata: {"description": "File description"}

​

Next steps

• GraphQL API - GraphQL endpoint documentation
• Authentication - Authentication guide