Meta-Properties
A meta-property is a property that exists on every entity in Port by default.
Meta-properties are always referenced using a dollar sign ($) before them, this makes it easier to tell if a property is user-defined or a meta-property.
The following table lists all of the available meta-properties:
| Meta-property | Description | Notes |
|---|---|---|
$identifier | Unique Entity identifier, used for API calls, programmatic access and distinguishing between different entities | |
$title | A human-readable name for the entity | |
$team | The team this entity belongs to | |
$icon | The entity's icon | |
$createdAt | The entity's creation time | Value is set upon creation and never changes |
$updatedAt | The entity's last update time | Value is updated automatically |
$createdBy | The user who created the entity | Value is set upon creation and never changes |
$updatedBy | The user who last updated the entity | Value is updated automatically |
$blueprint | The entity's blueprint | |
$datasource | The data source associated with the entity | You can filter on this property in search queries, but API responses and CSV exports do not include its value. |
Filter entities by data source
Use $datasource in a search query to trace which integration an entity comes from. API responses, including search results, and CSV exports do not include $datasource, even when your query filters on it.
For example, send the following request body to the search a blueprint's entities endpoint. Replace my-integration with your integration identifier:
{
"query": {
"combinator": "and",
"rules": [
{
"property": "$datasource",
"operator": "contains",
"value": "my-integration"
}
]
}
}
The contains operator matches source values that contain the specified string. You can run separate searches with these example filter values:
| Filter value | What it matches |
|---|---|
Your integration identifier, such as my-integration | Source values that contain that integration identifier. |
port-auto-ocean | Source values that contain port-auto-ocean. |
When you know the complete source value, use the = operator for an exact match. Record the entity identifiers returned by each search alongside the filter value you used to trace their source without reading $datasource from the response.