---
title: "SourceId"
description: "an id of a source object: its namespace, whether it is stable, the field that carries it and how far it is stable"
section: concepts
address: /concepts/sourceid
contract: 0476e35e6e275db5
---

# SourceId

an id of a source object: its namespace, whether it is stable, the field that carries it and how far it is stable

[figure: SourceId is a value at none scope. The drawing shows its fields and the objects that they point at.]

| property | value |
|---|---|
| kind | value |
| scope | none |
| key | none |
| store | none |
| family | sources |



## Fields


| field | type | required | note |
|---|---|---|---|
| `namespace` | `text` | yes |  |
| `stable` | `bool` | yes |  |
| `field` | `text` | no | the field of the object that carries the id; an id with no field cannot be resolved, and a mapping that needs it is not ready |
| `stable_within` | `one of the source \| one export \| one file \| one session` | no | how far the id stays the same; absent until read |



## Routes that use it
No route takes or returns SourceId directly. The record holds it, and the objects that point at it reach it.