Produuz.it Docs

Appearance

API v2 ​

The produuz.it REST API lets you automate design uploads, constructible management, report generation, and more from external systems.

Interactive Documentation ​

The full API is documented through an interactive Swagger interface:

Authentication ​

The API uses JWT (JSON Web Token) authentication with OTP (one-time password) verification.

  1. Obtain a token — POST /api/v2/my_user/token/ with your credentials and OTP code.
  2. Include the token — Add Authorization: Bearer <token> to all subsequent requests.
  3. Refresh the token — POST /api/v2/my_user/token/refresh/ before the token expires.

TIP

For automated integrations, ask your admin to create an API Account in Company Settings. API accounts can authenticate without OTP.

Main Endpoint Groups ​

GroupBase pathDescription
Constructibles/api/v2/constructibles/Designs, actuals (assemblies/modules), batches, parts
Company/api/v2/company/Projects, users, IFC parsing setups, API accounts
Reports/api/v2/reports/Report creation and status tracking
Factories/api/v2/factories/Production lines, stations, machines, triggers
Cloud Storage/api/v2/cloudstorage/File uploads and package management
Logistics/api/v2/logistics/Materials, stock, sizes, orders, delivery
Records/api/v2/records/Issues, production events
Integrations/api/v2/integrations/Webhooks
User/api/v2/my_user/Profile, authentication, settings

Common Workflows ​

For step-by-step API tutorials, see Connecting to the API:

Rate Limits ​

The API enforces rate limits to ensure fair usage. If you receive a 429 Too Many Requests response, wait before retrying.