> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wit.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# Releases API

> API reference for release management

The Releases API provides programmatic access to repository releases.

## Endpoints

### List Releases

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

### Get Release

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

### Create Release

```typescript theme={null}
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

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

### Delete Release

```typescript theme={null}
await client.releases.delete.mutate({
  repoId: 'repo_123',
  releaseId: 'release_abc',
});
```

## Release Schema

```typescript theme={null}
interface Release {
  id: string;
  tag: string;
  name: string;
  body: string;
  draft: boolean;
  prerelease: boolean;
  author: { id: string; username: string };
  createdAt: string;
  publishedAt?: string;
}
```

## Related

* [Tags](/commands/tags) - Tag management