Liaisons

Liaisons are dedicated agents that bridge two teams, tracking handoffs between them. They ensure context is preserved when work moves from one team to another.

Assigning a liaison

bash

# Assign a liaison agent between two teams
curl -X POST http://localhost:3000/liaisons \
  -H "Authorization: Bearer ${JWT_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "agentId": "liaison-agent",
    "teamA": "engineering",
    "teamB": "design"
  }'

Recording handoffs

Each handoff records which team is passing work, which team receives it, and a summary of the context. The liaison's handoff count is automatically incremented.

bash

# Record a handoff between teams
curl -X POST http://localhost:3000/liaisons/lsn_abc123/handoffs \
  -H "Authorization: Bearer ${JWT_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "fromTeam": "engineering",
    "toTeam": "design",
    "summary": "API spec finalized — ready for UI mockups"
  }'

Endpoint reference

Method	Endpoint	Description
`POST`	`/liaisons`	Create liaison
`GET`	`/liaisons`	List liaisons
`GET`	`/liaisons/:id`	Get liaison details
`DELETE`	`/liaisons/:id`	Deactivate liaison
`POST`	`/liaisons/:id/handoffs`	Record handoff
`GET`	`/liaisons/:id/handoffs`	List handoffs