Skip to main content
Welcome to the Poelis Public API documentation. This API provides programmatic access to your Poelis workspace data, enabling you to integrate Poelis into your workflows and build custom applications.

What is Poelis?

Poelis is an AI-native PLM (Product Lifecycle Management) system that helps engineering teams manage product data, specifications, and documentation. The Public API allows you to:
  • Access Workspaces: List and retrieve workspace information
  • Manage Products: Access product data within your workspaces
  • Query Items: Retrieve items and their hierarchical structure
  • Read Properties: Access property values, metadata, and references

API Overview

The Poelis Public API is a RESTful API that follows standard HTTP conventions:
  • Base URL: https://api.poelis.com
  • Authentication: Bearer token (API Key) in the Authorization header
  • Content Type: JSON for requests and responses
  • Versioning: All endpoints are versioned under /v1/public/

Core Concepts

Workspaces

Workspaces are the top-level organizational unit in Poelis. Each workspace belongs to an organization and contains products, items, and properties.

Products

Products are collections of related items within a workspace. They represent a specific product line, project, or system.

Items

Items are the building blocks of products. They can be organized hierarchically (items can have parent items) and contain properties.

Properties

Properties are attributes attached to items. They can be of different types:
  • Numeric: Numbers with optional units and categories
  • Text: String values
  • Date: Date and timestamp values
  • Status: Enumeration/status values

Getting Help

  • Email Support: [email protected] ↗︎
  • Documentation Issues: Open an issue on our GitHub repository
  • Feature Requests: Contact your account manager

API Status

The Poelis API is actively maintained and versioned. Breaking changes will be communicated in advance and new versions will be released with backward compatibility when possible.