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

# Create

`POST /processor`

## Request

- Base URL: `https://api.traversal.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.traversal.com/processor`
- Auth: none declared

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

> 66 revisions in range; 9 not diffed.

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

[Operation history](https://skmtc.dev/traversal/apis/traversal-api/changes/processor/post.md)

---

[API](https://skmtc.dev/traversal/apis/traversal-api.md) - [All operations](https://skmtc.dev/traversal/apis/traversal-api/llms.txt) - [OpenAPI document](https://skmtc.dev/traversal/apis/traversal-api/revisions/31e1a8b7cf89?raw)