# Poelis Public API

## Docs

- [Authentication](https://docs.poelis.com/api-reference/authentication.md): How to authenticate API requests in the API reference
- [Download file by ID](https://docs.poelis.com/api-reference/files/download-file-by-id.md): Download a single file as binary content.
- [Get file by ID](https://docs.poelis.com/api-reference/files/get-file-by-id.md): Return file metadata and current `used_in` links.
- [List files](https://docs.poelis.com/api-reference/files/list-files.md): Retrieve files by scope.
- [Update file metadata](https://docs.poelis.com/api-reference/files/update-file-metadata.md): Update editable file metadata fields.
- [Upload a file](https://docs.poelis.com/api-reference/files/upload-a-file.md): Attach a file to a target identified by `target_id`.
- [API Reference](https://docs.poelis.com/api-reference/introduction.md): Complete reference for Poelis Public API endpoints
- [Create item](https://docs.poelis.com/api-reference/items/create-item.md): Create a new item in a product.
- [Delete item](https://docs.poelis.com/api-reference/items/delete-item.md): Delete an item. Only draft items can be deleted. Versioned items (snapshots from product versions) cannot be deleted.
- [Get item by ID](https://docs.poelis.com/api-reference/items/get-item-by-id.md): Retrieve a single item by its unique identifier.
- [List items in a product](https://docs.poelis.com/api-reference/items/list-items-in-a-product.md): Retrieve a paginated list of items within a specific product.
- [Update item](https://docs.poelis.com/api-reference/items/update-item.md): Update an item's metadata (name, readable_id, parent).
- [List organization users](https://docs.poelis.com/api-reference/organization/list-organization-users.md): Retrieve a paginated list of all organization members together with their access rights.
- [Pagination](https://docs.poelis.com/api-reference/pagination.md): How list endpoints are paginated in the Poelis API
- [Create product](https://docs.poelis.com/api-reference/products/create-product.md): Create a new product in a workspace.
- [Delete product](https://docs.poelis.com/api-reference/products/delete-product.md): Delete a product. This operation is permanent and cannot be undone.
- [Get product by ID](https://docs.poelis.com/api-reference/products/get-product-by-id.md): Retrieve a single product by its unique identifier.
- [List products in a workspace](https://docs.poelis.com/api-reference/products/list-products-in-a-workspace.md): Retrieve a paginated list of products within a specific workspace.
- [Update product](https://docs.poelis.com/api-reference/products/update-product.md): Update a product's metadata (name, readable_id, baseline_version_number).
- [Create property](https://docs.poelis.com/api-reference/properties/create-property.md): Create a new property on an item. Only draft items can have properties created.
- [Delete property](https://docs.poelis.com/api-reference/properties/delete-property.md): Soft-delete a property. Only draft properties can be deleted. Versioned properties (snapshots from product versions) cannot be deleted.     Supports all property types including formula.
- [Get property by ID](https://docs.poelis.com/api-reference/properties/get-property-by-id.md): Retrieve a single property by its unique identifier.
- [List properties for an item](https://docs.poelis.com/api-reference/properties/list-properties-for-an-item.md): Retrieve all properties for a specific item with optional filtering and versioning support.
- [Update property](https://docs.poelis.com/api-reference/properties/update-property.md): Update a property's metadata (name, readable_id, value, display_unit).
- [Response Format](https://docs.poelis.com/api-reference/response-format.md): Success and error response structures for the Poelis API
- [Status Codes](https://docs.poelis.com/api-reference/status-codes.md): HTTP status codes returned by the Poelis API
- [Versioning](https://docs.poelis.com/api-reference/versioning.md): How Poelis stores versions as deltas and what Item/Property IDs mean in the API
- [Get workspace by ID](https://docs.poelis.com/api-reference/workspaces/get-workspace-by-id.md): Retrieve a single workspace by its unique identifier.
- [List workspaces](https://docs.poelis.com/api-reference/workspaces/list-workspaces.md): Retrieve a paginated list of all workspaces.
- [Authentication](https://docs.poelis.com/authentication.md): Learn how to authenticate your API requests
- [Changelog](https://docs.poelis.com/changelog.md): API changes and updates
- [Error Handling](https://docs.poelis.com/guides/error-handling.md): Learn how to handle API errors properly
- [Pagination](https://docs.poelis.com/guides/pagination.md): Learn how to paginate through API responses
- [Rate Limiting](https://docs.poelis.com/guides/rate-limiting.md): Understand API rate limits and how to handle them
- [Introduction](https://docs.poelis.com/index.md): Welcome to the Poelis Public API documentation
- [Quick Start](https://docs.poelis.com/quickstart.md): Get started with the Poelis Public API in minutes

## OpenAPI Specs

- [openapi](https://docs.poelis.com/openapi.json)

## Optional

- [Poelis Inbox ↗︎](https://app.poelis.com)
- [User documentation ↗︎](https://poelis.notion.site/documentation)
- [Support ↗︎](mailto:support@poelis.com)