Activate a rail for the caller's tenant
Until a rail is active for a tenant, the Pix ingress resolves no tenant and the SPB drain reads nothing from the vendor. Activating spb starts the drain of the vendor queue, whose read is destructive: from then on the Courier, not the engines, consumes it. The tenant is the caller’s, from the validated identity, and is returned as tenantId — the identifier an engine’s credential path names. The first activation records the operator as registeredBy. Activating a suspended rail resumes it; an active one is returned unchanged. A single-tenant Courier carries one tenant per rail: activating a rail another tenant holds active is refused 409 JDC-0117. Needs the admin grant (channels activation:write); channels write is not enough.
Autorizaciones
JWT bearer token issued by the identity provider.
Encabezados
Idempotency key; a retry with the same key replays the first answer.
Parámetros de ruta
The rail. Closed vocabulary — a value outside it is a 404, never a new rail.
spb, pix Respuesta
OK
spb, pix The operator who first activated the rail for the tenant.
128REGISTERED, ACTIVE, SUSPENDED The caller's tenant, from the validated identity: the identifier an engine's credential path names.
255When the rail last began carrying traffic.
512
