---
title: "Start Processor Status Checks"
method: POST
path: "/processor/status"
tags: ["processors"]
---

# Start Processor Status Checks

`POST /processor/status`

## 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/status`
- Auth: none declared

Start status checks for Processors owned by the caller.

Returns the requested ids that are currently pending. Open the status
socket with those ids. Online and offline Processors are omitted.

**Permissions**: organization admin.

**Errors**:

| Status | Code | Cause |
|--------|------|-------|
| 404 | `PROCESSOR_NOT_FOUND` | A Processor is missing or in another organization |

## Request body

- StartProcessorStatusChecksRequest
  - `processor_ids` string[], required

## Response `202`

Successful Response

- string[]

## Other responses

- `422`: Validation Error

## Changes

> 66 revisions in range; 9 not diffed.

- **2026-09-23** `3da9c3d0385f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/traversal/apis/traversal-api/changes/processor/status/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)