Skip to main content
The Releases API provides programmatic access to repository releases.

Endpoints

List Releases

const releases = await client.releases.list.query({
  repoId: 'repo_123',
});

Get Release

const release = await client.releases.get.query({
  repoId: 'repo_123',
  tag: 'v1.0.0',
});

Create Release

const release = await client.releases.create.mutate({
  repoId: 'repo_123',
  tag: 'v1.0.0',
  name: 'Version 1.0.0',
  body: 'Release notes...',
  draft: false,
  prerelease: false,
});

Update Release

await client.releases.update.mutate({
  repoId: 'repo_123',
  releaseId: 'release_abc',
  body: 'Updated release notes',
});

Delete Release

await client.releases.delete.mutate({
  repoId: 'repo_123',
  releaseId: 'release_abc',
});

Release Schema

interface Release {
  id: string;
  tag: string;
  name: string;
  body: string;
  draft: boolean;
  prerelease: boolean;
  author: { id: string; username: string };
  createdAt: string;
  publishedAt?: string;
}
  • Tags - Tag management