---
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.

## Changes

- **2026-02-11** `5f3024e244fa` — 1 info
  - endpoint added
- **2023-07-03** `fb8e107462aa` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/here/apis/here-xyz-hub/changes/references/post.md)

---

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