# Regenerate the client and fix the call sites it breaks

A generated client that no longer matches the specification, regenerated with the call sites it breaks fixed.

Category: API surface and contracts
Source: https://letsship.ai/use-cases/regenerate-the-client
Published: 2026-08-25

## Goal

Regenerate the API client from the current specification and fix the call sites the regeneration breaks.

## Acceptance criteria

- The client is regenerated by a committed command
- Every consumer compiles against the new client
- Behaviour changes from the regeneration are listed in the description
- Regenerating again produces no diff

## What lands as proof

A second regeneration producing an empty diff, which proves the committed client matches the specification.

## Prompt

Copy this to an agent to open the ticket:

```text
Create a Linear issue in my team and assign it to the SHIP agent.

Title: Regenerate the API client

Description: Regenerate the API client from the current specification and fix the call sites the regeneration breaks.

Acceptance criteria:
- The client is regenerated by a committed command
- Every consumer compiles against the new client
- Behaviour changes from the regeneration are listed in the description
- Regenerating again produces no diff

Before you create the issue, run this repository's client generation command and report how large the resulting diff is.
```

## Questions

### What does the agent actually change?

The ticket is scoped to one outcome: regenerate the API client from the current specification and fix the call sites the regeneration breaks. Work that serves that outcome is in scope, and anything outside it is left for a separate ticket, so the pull request stays reviewable.

### How do I know the work is done?

The pull request carries the evidence, not only the diff. Here that means generated client committed, every consumer compiles, so a reviewer can confirm the result without reproducing the work locally.

### How much oversight does this need?

None is required before the run starts. Every claim this ticket makes can be checked by machine, so the agent works straight through and a person reviews the finished pull request like any other.