---
title: "Create a Data Reference"
method: POST
path: "/references"
tags: ["Manage Data References"]
---

# Create a Data Reference

`POST /references`

Creates a Data Reference

## Request body

- DataReference — Reference to a dataset stored in an external system
  - `id` string, uuid — Unique identifier. If not provided, it will be generated automatically.
  - `entityId` string, required — HERE entity identifier (HRN format)
  - `isPatch` boolean, required — Indicates whether this reference represents a patch dataset
  - `startVersion` integer — Starting version of data (optional)
  - `endVersion` integer, required — Ending version of data
  - `objectType` string, required — Type of stored objects
  - `contentType` string, required — MIME type of stored content
  - `location` string, required — Storage location URI
  - `sourceSystem` string, required — Source system name
  - `targetSystem` string, required — Target system name

## Response `201`

A Data Reference

- DataReference — Reference to a dataset stored in an external system
  - `id` string, uuid — Unique identifier. If not provided, it will be generated automatically.
  - `entityId` string, required — HERE entity identifier (HRN format)
  - `isPatch` boolean, required — Indicates whether this reference represents a patch dataset
  - `startVersion` integer — Starting version of data (optional)
  - `endVersion` integer, required — Ending version of data
  - `objectType` string, required — Type of stored objects
  - `contentType` string, required — MIME type of stored content
  - `location` string, required — Storage location URI
  - `sourceSystem` string, required — Source system name
  - `targetSystem` string, required — Target system name

## Other responses

- `400` — Malformed or Bad Request.

---

[API](https://skmtc.net/here/apis/here-xyz-hub.md) · [All operations](https://skmtc.net/here/apis/here-xyz-hub/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/here/here-xyz-hub/revisions/1c6c6a2bcac9/schema)