---
title: "Append record(s)"
method: POST
path: "/streams/{owner}/{id}/{streamId}"
tags: ["streams"]
---

# Append record(s)

`POST /streams/{owner}/{id}/{streamId}`

Append JSON data to a stream associated with a dataset.

data.world streams are append-only by default. Alternatively, if a primary key is specified (see:
`POST:/streams/{owner}/{id}/{streamId}/schema`), data.world will replace records with the same primary
key value.

**Streams don't need to be created before you can append data to them**. They will be created on-demand,
 when the first record is appended or by defining its schema.

Multiple records can be appended at once by using JSON-L (`application/json-l`) as the request content type.

**IMPORTANT**

Data uploaded to a dataset via a stream is not immediatelly processed. Instead, it is processed
automatically in accordance with the dataset settings (default: daily) or as a result of calling
`POST:/datasets/{owner}/{id}/sync`.

Once processed, the contents of a stream will appear as part of the respective dataset as a `.jsonl`
file (e.g. `my-stream` will produce a file named `my-stream.jsonl`).

## Path parameters

- `owner` string, required
- `id` string, required
- `streamId` string, required

## Response `200`

default response

---

[API](https://skmtc.dev/data/apis/data-world-public-api.md) · [All operations](https://skmtc.dev/data/apis/data-world-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/data/data-world-public-api/revisions/0a0cb1f94dad/schema)