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

# Transcribe

> Manage transcription workspaces and uploads with the Pawa AI Python SDK.

Long-form transcription workspaces are under `client.transcribe.workspaces`. See the [Transcribe API reference](/api-reference/endpoint/transcribe/introduction).

For short speech-to-text conversion, use [Voice → Speech to text](/python-sdk/voice#speech-to-text).

## Create a workspace

```python theme={null}
from pawa_ai import PawaAI

client = PawaAI()

workspace = client.transcribe.workspaces.create(name="My Workspace")
print(workspace)
```

## List and retrieve workspaces

```python theme={null}
workspaces = client.transcribe.workspaces.list()
print(workspaces)

workspace = client.transcribe.workspaces.retrieve(workspace_id=5)
print(workspace)
```

## Update and delete a workspace

```python theme={null}
updated = client.transcribe.workspaces.update(5, name="Podcasts")
print(updated)

deleted = client.transcribe.workspaces.delete(5)
print(deleted)
```

## Upload transcriptions

```python theme={null}
from pawa_ai import PawaAI

client = PawaAI()

result = client.transcribe.workspaces.upload_transcriptions(
    workspace_id=5,
    files=["episode-01.mp3", "episode-02.mp3"],
)

print(result)
```

## List transcriptions

```python theme={null}
transcriptions = client.transcribe.workspaces.list_transcriptions(
    workspace_id=5,
    page=1,
    limit=20,
)
print(transcriptions)
```

## Update a transcription

```python theme={null}
updated = client.transcribe.workspaces.update_transcription(
    workspace_id=5,
    transcription_id=12,
    # pass fields supported by the Transcribe update API
)
print(updated)
```

## Delete a transcription

```python theme={null}
deleted = client.transcribe.workspaces.delete_transcription(
    workspace_id=5,
    transcription_id=12,
)
print(deleted)
```