---
title: "Create"
method: POST
path: "/processor"
tags: ["processors"]
---

# Create

`POST /processor`

Create a Processor and initialize its empty dynamic configuration.

**Permissions**: organization admin.

**Errors**:

| Status | Code | Cause |
|--------|------|-------|
| 409 | `PROCESSOR_NAME_CONFLICT` | Display name already exists in the organization |
| 503 | `PROCESSOR_CONFIG_STORAGE_UNAVAILABLE` | Config bucket is unavailable |

## Request body

- CreateProcessorRequest
  - `display_name` string, required
  - `description` string, nullable

## Response `201`

Successful Response

- ProcessorResponse
  - `id` string, uuid, required
  - `display_name` string, required
  - `description` string, nullable, required
  - `created_at` string, date-time, required

## Other responses

- `422` — Validation Error

## Changes

> 57 revisions in range; 9 not diffed.

- **2026-09-18** `af140c3c54d8` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/traversal/apis/fastapi/changes/processor/post.md)

---

[API](https://skmtc.dev/traversal/apis/fastapi.md) · [All operations](https://skmtc.dev/traversal/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc.dev/traversal/apis/fastapi/revisions/c3bd9dec6c16?raw)