---
sidebar_label: 'Uploading data'
sidebar_position: 2
---

# Uploading data

A job may upload one or more data entities to make them available for the next job in the flow. When an entity is uploaded, a temporary URL pointing to the data is returned.

:::note
The entity URLs has to be included when reporting the job's completion for the entity to be available to the next job in a flow. See [Reporting progress](reporting-progress.md) for more details.
:::

## Uploading a single entity

Use the [Add entity](/api#tag/Master-Data-Orchestrations/operation/CreateEntities) endpoint to upload a single data entity. Include the entity data in the request body.

### Example response

```json
{
	"id": "myEntityId",
	"url": "url-to-your-entity-data"
}
```

## Add collection

Use the [Add collection](/api#tag/Master-Data-Orchestrations/operation/64116f3e00e3e238a0ec8170) endpoint to upload multiple data entities at once.

### Example request

```json
{
	"entityId": {
		"myEntityId1": {
			// ... entity data ...
		},
		"myEntityId2": {
			// ... entity data ...
		}
	}
}
```

### Example response

```json
[
	{
		"id": "myEntityId1",
		"url": "url-to-your-entity-data"
	},
	{
		"id": "myEntityId2",
		"url": "url-to-your-entity-data"
	}
]
```