Stay organized with collections
Save and categorize content based on your preferences.
Full name: projects.locations.processors.create
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.
HTTP request
POST https://{endpoint}/v1beta3/{parent}/processors
Required. The parent (project and location) under which to create the processor. Format: projects/{project}/locations/{location} It takes the form projects/{project}/locations/{location}.
Request body
The request body contains an instance of Processor.
Response body
If successful, the response body contains a newly created instance of Processor.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-06-10 UTC."],[[["\u003cp\u003eThis endpoint (\u003ccode\u003eprojects.locations.processors.create\u003c/code\u003e) creates a new processor based on a specified \u003ccode\u003eProcessorType\u003c/code\u003e, which will be in an \u003ccode\u003eENABLED\u003c/code\u003e state upon creation.\u003c/p\u003e\n"],["\u003cp\u003eThe creation of a processor via this method requires the \u003ccode\u003edocumentai.processors.create\u003c/code\u003e permission on the project, allowing interaction with any GCS bucket within the project.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eparent\u003c/code\u003e parameter in the HTTP request path, formatted as \u003ccode\u003eprojects/{project}/locations/{location}\u003c/code\u003e, is required to specify where the processor will be created.\u003c/p\u003e\n"],["\u003cp\u003eThe request body for this endpoint should include an instance of the \u003ccode\u003eProcessor\u003c/code\u003e, and a newly created instance of \u003ccode\u003eProcessor\u003c/code\u003e will be received in the response body upon success.\u003c/p\u003e\n"],["\u003cp\u003eThe use of this endpoint requires the \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e OAuth scope and the \u003ccode\u003edocumentai.processors.create\u003c/code\u003e IAM permission on the parent resource.\u003c/p\u003e\n"]]],[],null,["# Method: processors.create\n\n**Full name**: projects.locations.processors.create\n\nCreates a processor from the [ProcessorType](/document-ai/docs/reference/rest/v1beta3/projects.locations.processorTypes#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.\n\n### HTTP request\n\n`POST https://{endpoint}/v1beta3/{parent}/processors`\n\nWhere `{endpoint}` is one of the [supported service endpoints](/document-ai/docs/reference/rest#rest_endpoints).\n\n### Path parameters\n\n### Request body\n\nThe request body contains an instance of [Processor](/document-ai/docs/reference/rest/v1beta3/projects.locations.processors#Processor).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [Processor](/document-ai/docs/reference/rest/v1beta3/projects.locations.processors#Processor).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/cloud-platform`\n\nFor more information, see the [Authentication Overview](https://cloud.google.com/docs/authentication/).\n\n### IAM Permissions\n\nRequires the following [IAM](https://cloud.google.com/iam/docs) permission on the `parent` resource:\n\n- `documentai.processors.create`\n\nFor more information, see the [IAM documentation](https://cloud.google.com/iam/docs)."]]
