
# `pipeUIMessageStreamToResponse`

The `pipeUIMessageStreamToResponse` function pipes streaming data to a Node.js ServerResponse object (see [Streaming Data](/docs/ai-sdk-ui/streaming-data)).

## Import

<Snippet
  text={`import { pipeUIMessageStreamToResponse } from "ai"`}
  prompt={false}
/>

## Example

```tsx
pipeUIMessageStreamToResponse({
  response: serverResponse,
  status: 200,
  statusText: 'OK',
  headers: {
    'Custom-Header': 'value',
  },
  stream: myUIMessageStream,
  consumeSseStream: ({ stream }) => {
    // Optional: consume the SSE stream independently
    console.log('Consuming SSE stream:', stream);
  },
});
```

## API Signature

### Parameters

<PropertiesTable
  content={[
    {
      name: 'response',
      type: 'ServerResponse',
      description: 'The Node.js ServerResponse object to pipe the data to.',
    },
    {
      name: 'stream',
      type: 'ReadableStream<UIMessageChunk>',
      description: 'The UI message stream to pipe to the response.',
    },
    {
      name: 'status',
      type: 'number',
      description: 'The status code for the response.',
    },
    {
      name: 'statusText',
      type: 'string',
      description: 'The status text for the response.',
    },
    {
      name: 'headers',
      type: 'Headers | Record<string, string>',
      description: 'Additional headers for the response.',
    },
    {
      name: 'consumeSseStream',
      type: '({ stream }: { stream: ReadableStream }) => void',
      description:
        'Optional function to consume the SSE stream independently. The stream is teed and this function receives a copy.',
    },
  ]}
/>


## Navigation

- [useChat](/v5/docs/reference/ai-sdk-ui/use-chat)
- [useCompletion](/v5/docs/reference/ai-sdk-ui/use-completion)
- [useObject](/v5/docs/reference/ai-sdk-ui/use-object)
- [convertToModelMessages](/v5/docs/reference/ai-sdk-ui/convert-to-model-messages)
- [pruneMessages](/v5/docs/reference/ai-sdk-ui/prune-messages)
- [createUIMessageStream](/v5/docs/reference/ai-sdk-ui/create-ui-message-stream)
- [createUIMessageStreamResponse](/v5/docs/reference/ai-sdk-ui/create-ui-message-stream-response)
- [pipeUIMessageStreamToResponse](/v5/docs/reference/ai-sdk-ui/pipe-ui-message-stream-to-response)
- [readUIMessageStream](/v5/docs/reference/ai-sdk-ui/read-ui-message-stream)
- [InferUITools](/v5/docs/reference/ai-sdk-ui/infer-ui-tools)
- [InferUITool](/v5/docs/reference/ai-sdk-ui/infer-ui-tool)


[Full Sitemap](/sitemap.md)
