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

# All API Endpoints

> Complete reference of all API endpoints

## Quick Reference

This page provides a complete overview of all available API endpoints.

## Forms

| Method  | Endpoint          | Description                                                                       |
| ------- | ----------------- | --------------------------------------------------------------------------------- |
| `GET`   | `/v1/forms`       | [List forms with filtering and pagination](/api-reference/requests/list-requests) |
| `GET`   | `/v1/forms/count` | [Count forms with optional grouping](/api-reference/requests/count-requests)      |
| `POST`  | `/v1/forms`       | [Create a new form](/api-reference/requests/create-request)                       |
| `GET`   | `/v1/forms/{id}`  | [Get form details and responses](/api-reference/requests/get-request)             |
| `PATCH` | `/v1/forms/{id}`  | [Update form status or properties](/api-reference/requests/update-request)        |

## Responses

| Method | Endpoint             | Description                                                                    |
| ------ | -------------------- | ------------------------------------------------------------------------------ |
| `GET`  | `/v1/responses/{id}` | [Get response details with attachments](/api-reference/responses/get-response) |

## Form Templates

| Method | Endpoint                            | Description                                                                 |
| ------ | ----------------------------------- | --------------------------------------------------------------------------- |
| `GET`  | `/v1/form_templates`                | [List available form templates](/api-reference/flows/list-flows)            |
| `GET`  | `/v1/form_templates/{slug}/options` | [Get template configuration options](/api-reference/flows/get-flow-options) |
| `GET`  | `/v1/form_templates/{slug}/steps`   | [Get template structure and fields](/api-reference/flows/get-flow-steps)    |

## Cases

| Method | Endpoint                         | Description                                                                 |
| ------ | -------------------------------- | --------------------------------------------------------------------------- |
| `GET`  | `/v1/cases`                      | [List cases with filtering and pagination](/api-reference/cases/list-cases) |
| `GET`  | `/v1/cases/count`                | [Count cases](/api-reference/cases/count-cases)                             |
| `POST` | `/v1/cases`                      | [Create a new case](/api-reference/cases/create-case)                       |
| `GET`  | `/v1/cases/{id}`                 | [Get case details with steps](/api-reference/cases/get-case)                |
| `POST` | `/v1/cases/{id}/data`            | [Update case data fields](/api-reference/cases/update-case-data)            |
| `POST` | `/v1/cases/{id}/contacts`        | [Update case contacts](/api-reference/cases/update-case-contacts)           |
| `POST` | `/v1/cases/{id}`                 | [Archive or unarchive a case](/api-reference/cases/archive-case)            |
| `POST` | `/v1/cases/{id}/start/{stepKey}` | [Start a case step](/api-reference/cases/start-case-step)                   |

## Case Templates

| Method | Endpoint                  | Description                                                                             |
| ------ | ------------------------- | --------------------------------------------------------------------------------------- |
| `GET`  | `/v1/case_templates`      | [List case templates with filtering](/api-reference/case-templates/list-case-templates) |
| `GET`  | `/v1/case_templates/{id}` | [Get case template details with steps](/api-reference/case-templates/get-case-template) |

## Attachments

| Method | Endpoint               | Description                                                                                 |
| ------ | ---------------------- | ------------------------------------------------------------------------------------------- |
| `GET`  | `/v1/attachments/{id}` | [Download single attachment](/api-reference/attachments/get-attachment)                     |
| `GET`  | `/v1/attachments`      | [Download multiple attachments as PDF](/api-reference/attachments/get-attachments-multiple) |
| `POST` | `/v1/attachments`      | [Upload files (JSON or multipart)](/api-reference/attachments/upload-attachments)           |

## Document Intelligence

| Method | Endpoint                         | Description                                                                                         |
| ------ | -------------------------------- | --------------------------------------------------------------------------------------------------- |
| `POST` | `/v1/document_intelligence`      | [Create document extraction job](/api-reference/document-intelligence/create-document-intelligence) |
| `GET`  | `/v1/document_intelligence/{id}` | [Get extraction results](/api-reference/document-intelligence/get-document-intelligence)            |

## Signatures

| Method | Endpoint              | Description                                                                        |
| ------ | --------------------- | ---------------------------------------------------------------------------------- |
| `GET`  | `/v1/signatures/{id}` | [Get signature metadata or download file](/api-reference/signatures/get-signature) |

## Workspaces

| Method | Endpoint         | Description                                                             |
| ------ | ---------------- | ----------------------------------------------------------------------- |
| `GET`  | `/v1/workspaces` | [List accessible workspaces](/api-reference/workspaces/list-workspaces) |

## Response Formats

Most endpoints return JSON responses by default. Some endpoints support multiple response formats:

### JSON Responses

* Default for most endpoints
* Set `Accept: application/json` header

### Binary Responses

* Attachments and signatures support `Accept: application/octet-stream`
* Returns file content for download

### PDF Responses

* Responses support `Accept: application/pdf`
* Returns rendered PDF of form response

## Authentication Requirements

All endpoints require authentication via Bearer token:

```bash theme={null}
Authorization: Bearer YOUR_ACCESS_TOKEN
```

## Common Query Parameters

Most list endpoints support these query parameters:

* **`page[number]`** - Page number (starts at 1)
* **`page[size]`** - Items per page (default: 10, max: 100)
* **`filter`** - JSON string with filter criteria
* **`sort`** - Sort field (prefix with `-` for descending)
* **`group-by`** - Group counts by field (count endpoints only)

<Tip>
  See [Pagination & Sorting](/api-reference/pagination-and-sorting) and [Advanced Filters](/api-reference/advanced-filters) for detailed documentation.
</Tip>

## HTTP Methods

| Method  | Usage                                   |
| ------- | --------------------------------------- |
| `GET`   | Retrieve data (list, read, count)       |
| `POST`  | Create new resources or perform actions |
| `PATCH` | Update existing resources               |

## Base URL

All endpoints are relative to:

```text theme={null}
https://connect.penbox.io/v1
```

## Related Resources

<CardGroup cols={2}>
  <Card title="API Overview" icon="book" href="/api-reference/pen-connect-overview">
    Detailed guide to API capabilities
  </Card>

  <Card title="Authentication" icon="key" href="/api-reference/authentication">
    OAuth2 authentication guide
  </Card>

  <Card title="Advanced Filters" icon="filter" href="/api-reference/advanced-filters">
    Filter with operators and JSON queries
  </Card>

  <Card title="Pagination & Sorting" icon="arrows-up-down" href="/api-reference/pagination-and-sorting">
    Control result size and order
  </Card>
</CardGroup>
