> ## Documentation Index
> Fetch the complete documentation index at: https://docs.poelis.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview - Public REST API

> Welcome to the Poelis Public API documentation

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.

For Python, go to the [Python SDK](/python-sdk/overview).

New to Poelis? See the user manual [Overview](/user-manual/overview) and [basic concepts](/user-manual/getting-started#basic-concepts) before working with the API.

## API capabilities

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
* **Work with Files**: List, upload, update, and download files attached to items and properties
* **Read Organization Members**: List users in your organization together with their organization, workspace, and product access

## The API

The Poelis Public API is a RESTful API that follows standard HTTP conventions:

* **Base URL**: `https://api.poelis.com`
* **Authentication**: Bearer token (REST API Key) in the `Authorization` header
* **Content Type**: JSON for requests and responses
* **Versioning**: All endpoints are versioned under `/v1/public/`

## Quick Links

<CardGroup cols={2}>
  <Card title="Quick Start" icon="rocket" href="/quickstart">
    Get up and running with your first API request in minutes
  </Card>

  <Card title="Authentication" icon="key" href="/authentication">
    Learn how to authenticate your API requests
  </Card>

  <Card title="Public REST API" icon="code" href="/api-reference/introduction">
    Complete reference for all available endpoints
  </Card>

  <Card title="Rate Limiting" icon="gauge" href="/guides/rate-limiting">
    Understand rate limits and how to handle them
  </Card>
</CardGroup>

## 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.