---
title: "Transcribe voice input for the Home agent"
method: POST
path: "/v1/home/agent/transcribe"
tags: ["Home"]
---

# Transcribe voice input for the Home agent

`POST /v1/home/agent/transcribe`

Accepts raw audio bytes (e.g. webm from MediaRecorder). Returns transcribed text for the composer. Requires `ai.web_agent` and a signed-in session.

## Query parameters

- `workspace` string
- `seconds` number

## Response `200`

Transcript

- object
  - `text` string

## Other responses

- `422` — Transcription failed

---

[API](https://skmtc.net/shareout/apis/shareout-rest-api.md) · [All operations](https://skmtc.net/shareout/apis/shareout-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/shareout/shareout-rest-api/revisions/804359ead65a/schema)