shiftagent Integration API
This site documents the integration surface between an external host system and the shiftagent platform: how tenants and users are provisioned just-in-time from host-side identities, how conversations and messages flow over the streaming contract, how human-in-the-loop approvals and conversation secrets work, and how a stateless adapter sits between the two systems. The API Reference is generated directly from the platform’s OpenAPI 3.1 specification — the single source of truth for the contract.
Start here
Section titled “Start here” Integration Guide Architecture overview, authentication model, external-ID conventions, and the context-gathering skill pattern.
API Reference Generated reference for every endpoint, schema, and error in the OpenAPI 3.1 specification.
Contracts
Section titled “Contracts” Provisioning Flow Cold-start and warm-path walkthroughs, sequence diagrams, and concurrent-provisioning race semantics.
Streaming Contract NDJSON event reference for message streaming, plus a client-side parsing recipe.
Building your adapter
Section titled “Building your adapter” Adapter Implementation Guide How to build the stateless adapter for your host system — identity derivation, JIT provisioning, lifecycle reconciliation, HITL transport, and secrets pass-through.
Runtime Architecture How agent capabilities compose from git repositories at run time, pluggable agent runtimes, and the sandbox-per-run security model.