---
title: "POST /v1/{+parent}/processors"
method: POST
path: "/v1/{+parent}/processors"
tags: ["projects"]
---

# POST /v1/{+parent}/processors

`POST /v1/{+parent}/processors`

Creates a processor from the ProcessorType provided. The processor will be at `ENABLED` state by default after its creation. Note that this method requires the `documentai.processors.create` permission on the project, which is highly privileged. A user or service account with this permission can create new processors that can interact with any gcs bucket in your project.

## Path parameters

- `parent` string, required

## Request body

- GoogleCloudDocumentaiV1Processor — The first-class citizen for Document AI. Each processor defines how to extract structural information from a document.
  - `defaultProcessorVersion` string — The default processor version.
  - `satisfiesPzs` boolean — Output only. Reserved for future use.
  - `activeSchemaVersion` string — Optional. SchemaVersion used by the Processor. It is the same as Processor's DatasetSchema.schema_version Format is `projects/{project}/locations/{location}/schemas/{schema}/schemaVersions/{schema_version}.
  - `state` 'STATE_UNSPECIFIED' | 'ENABLED' | 'DISABLED' | 'ENABLING' | 'DISABLING' | 'CREATING' | 'FAILED' | 'DELETING' — Output only. The state of the processor.
  - `createTime` string, google-datetime — Output only. The time the processor was created.
  - `kmsKeyName` string — The [KMS key](https://cloud.google.com/security-key-management) used for encryption and decryption in CMEK scenarios.
  - `displayName` string — The display name of the processor.
  - `processEndpoint` string — Output only. Immutable. The http endpoint that can be called to invoke processing.
  - `satisfiesPzi` boolean — Output only. Reserved for future use.
  - `name` string — Output only. Immutable. The resource name of the processor. Format: `projects/{project}/locations/{location}/processors/{processor}`
  - `type` string — The processor type, such as: `OCR_PROCESSOR`, `INVOICE_PROCESSOR`. To get a list of processor types, see FetchProcessorTypes.
  - `processorVersionAliases` GoogleCloudDocumentaiV1ProcessorVersionAlias[] — Output only. The processor version aliases.
    - `alias` string — The alias in the form of `processor_version` resource name.
    - `processorVersion` string — The resource name of aliased processor version.

## Response `200`

Successful response

---

[API](https://skmtc.dev/google/apis/documentai.md) · [All operations](https://skmtc.dev/google/apis/documentai/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/google/documentai/revisions/88d43b76c9f3/schema)