Orchestrator API

Overview

The Orchestrator API is a stateless passthrough to the canonical Gizzi orchestrator running in Gizzi Runtime. The platform API preserves the HTTP method, path suffix, query string, request body, and response status so the orchestrator remains the single source of orchestration state. Live executor sessions belong to the Gizzi Node process, not the platform API.

Base URL

https://api.allternit.com/api/orchestrator

For local development:

http://127.0.0.1:8013/api/orchestrator

The upstream target is the configured terminal server at /v1/orchestrator.

Authentication

All requests require a valid bearer token in the Authorization header. The platform also forwards Gizzi basic-auth credentials when GIZZI_PASSWORD or GIZZI_SERVER_PASSWORD is configured. See Authentication for details.

Endpoints

Method	Path	Description
`ANY`	`/orchestrator`	Proxy root to the Gizzi orchestrator.
`ANY`	`/orchestrator/*path`	Proxy any orchestrator sub-resource.

Proxy example

curl -X GET https://api.allternit.com/api/orchestrator/status \
  -H "Authorization: Bearer $TOKEN"

The platform forwards this to:

https://terminal-server.internal/v1/orchestrator/status

Streaming responses

If the upstream returns text/event-stream, the platform proxies the byte stream without buffering and sets the appropriate SSE headers:

curl -N https://api.allternit.com/api/orchestrator/sessions/sess_123/events \
  -H "Authorization: Bearer $TOKEN"

Request body forwarding

JSON bodies are forwarded verbatim:

curl -X POST https://api.allternit.com/api/orchestrator/execute \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "session_id": "sess_01hqx8x7x7x7x7x7x7x7x7x",
    "plan": [...]
  }'

Response

Responses are proxied with the same status code and Content-Type returned by Gizzi Runtime. A successful request returns whatever the orchestrator returns; the platform does not reshape the body.

Error codes

Status	Code	Description
`400`	`invalid orchestrator proxy path`	Path did not contain `/orchestrator`.
`401`	`Unauthorized`	Missing or invalid bearer token.
`502`	`orchestrator_unavailable`	Upstream Gizzi orchestrator is unreachable.
`502`	`invalid_orchestrator_response`	Upstream response body could not be read.

Overview

LLM Gateway

Agents & Runtime

Work Queue & Deployments

Files, Webhooks & Sandbox

Tools & Connectors

Collaboration & Workflows

Infrastructure & Platform

Canvases

Onboarding

A Labs

Playground

Users & Profiles

Overview

Base URL

Authentication

Endpoints

Proxy example

Streaming responses

Request body forwarding

Response

Error codes

​Overview

​Base URL

​Authentication

​Endpoints

​Proxy example

​Streaming responses

​Request body forwarding

​Response

​Error codes

​Related pages

Overview

Base URL

Authentication

Endpoints

Proxy example

Streaming responses

Request body forwarding

Response

Error codes

Related pages