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

# Main Schemas

> Request/query/path schemas for core Process routes.

This page centralizes the **request/query/path schemas** for the main Process routes.
The canonical source is `api-reference/openapi.yml`.

## create-process

**Endpoint**: `POST /v1/process`\
**Schema**: `CreateProcessRequestSchema`\
**Body**: `application/json`

### Schema (OpenAPI-style, abridged)

```json theme={null}
{
  "type": "object",
  "additionalProperties": false,
  "required": ["orgId", "name", "label", "steps"],
  "properties": {
    "name": "string",
    "iconName": "string",
    "steps": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": ["policyNames", "label"],
        "properties": {
          "label": "string",
          "description": "string",
          "policyNames": "string[]",
          "orderedPolicies": "string[]",
          "webhookUrls": "string",
          "legalContractId": "string",
          "stepIdsDependencies": "string[]",
          "stepIdsReprovalDependencies": "string[]",
          "parameters": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": false,
              "required": ["id", "name", "label"],
              "properties": {
                "name": "string",
                "label": "string",
                "type": {
                  "type": "string",
                  "enum": [
                    "ATTACHMENT",
                    "IMAGE",
                    "SIGNATURE",
                    "CHECKBOX",
                    "COMPUTED",
                    "COMPUTED_NUMBER",
                    "COMPUTED_TEXT",
                    "CPF",
                    "USER",
                    "URL",
                    "HTML",
                    "CNPJ",
                    "CPFCNPJ",
                    "DATE",
                    "DATETIME",
                    "EMAIL",
                    "CEP",
                    "NUMBER",
                    "PHONE",
                    "RADIO",
                    "SELECT",
                    "TEXT",
                    "TEXTAREA",
                    "READ_FROM_OTHER_MEASUREMENT",
                    "TABLE",
                    "TOGGLE",
                    "CURRENCY",
                    "SECTION",
                    "PDF_RENDERER",
                    "LOCATION",
                    "TIME",
                    "ENTITY_UPDATE",
                    "ENTITY",
                    "API_CALL",
                    "CERTIDOES",
                    "PERCENTAGE",
                    "ENTITY_READ",
                    "CONTRACT_TEMPLATE",
                    "GSHEET_OUTPUT"
                  ]
                },
                "isUnique": "boolean",
                "isPermanent": "boolean",
                "isRequired": "boolean",
                "decimals": "number",
                "format": "float",
                "stepId": "string",
                "parameterId": "string",
                "computedFormula": "string[]",
                "optionItems": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "additionalProperties": false,
                    "required": ["value"],
                    "properties": {
                      "value": "string",
                      "label": "string",
                      "color": "string",
                      "meta": "object",
                      "persisted": "boolean"
                    }
                  }
                },
                "advancedOptions": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "tooltip": "string",
                    "description": "string",
                    "placeholder": "string",
                    "max": "number",
                    "maxLength": "number",
                    "min": "number",
                    "minLength": "number",
                    "decimals": "number",
                    "format": "float",
                    "sort": "number",
                    "format": "float",
                    "currency": "string",
                    "enum": ["USD", "BRL", "NONE"],
                    "locale": "string",
                    "enum": ["pt-BR", "en-US"],
                    "isHidden": "boolean",
                    "hasMetadata": "boolean",
                    "hiddenFrom": "string[]",
                    "isMultiple": "boolean",
                    "dateFormat": {
                      "type": "string",
                      "enum": [
                        "dd/MM/yyyy",
                        "MM/yyyy",
                        "MM/dd/yyyy",
                        "yyyy-MM-dd",
                        "yyyy-MM-dd HH:mm",
                        "dd/MM/yyyy HH:mm",
                        "yyyy-MM-dd HH:mm:ss"
                      ]
                    },
                    "entityOperation": {
                      "type": "array",
                      "items": {
                        "type": "string",
                        "enum": [
                          "WRITE",
                          "EDIT",
                          "DELETE",
                          "SELECT",
                          "TRANSPOSED_WRITE",
                          "CSV_IMPORT",
                          "READ_ONLY",
                          "BATCH_DELETE",
                          "G_SHEET_SYNC",
                          "IMPORT_AND_SYNC",
                          "GSHEET_INTEGRATION_WITH_FILTER"
                        ]
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}
```

## update-process

**Endpoint**: `PUT /v1/process/{id}`\
**Schema**: `UpdateProcessRequestSchema`\
**Path params**:

* **id**: `string` (required)

**Body**: `application/json`

### Schema (OpenAPI-style)

```json theme={null}
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "name": "string",
    "iconName": "string",
    "label": "string",
  }
}
```

## delete-process

**Endpoint**: `DELETE /v1/process/{id}`\
**Path params**:

* **id**: `string` (required)

**Query params**:

* **force**: `string` (optional)

**Body**: none

## list-processes

**Endpoint**: `GET /v1/process`\
**Query params**:

* **page**: `string` (optional)
* **pageLimit**: `string` (optional)
* **containsType**: `string` (optional)

**Body**: none