Entity

A node in the Geo knowledge graph. Has typed values (text/integer/date/etc. attached via properties) and typed relations (directed edges to other entities). Entities are not class instances — types are tags applied via the Types relation, and an entity can carry multiple types simultaneously.

type Entity implements Node {
  nodeId: ID!
  id: UUID!
  createdAt: String!
  createdAtBlock: String!
  updatedAt: String!
  updatedAtBlock: String!
  relationsWhereEntity(
    first: Int
    last: Int
    offset: Int
    before: Cursor
    after: Cursor
    orderBy: [RelationsOrderBy!] = [PRIMARY_KEY_ASC]
    condition: RelationCondition
    filter: RelationFilter
  ): RelationsConnection!
  relationsWhereEntityList(
    first: Int
    offset: Int
    orderBy: [RelationsOrderBy!]
    condition: RelationCondition
    filter: RelationFilter
  ): [Relation!]!
  relations(
    first: Int
    last: Int
    offset: Int
    before: Cursor
    after: Cursor
    orderBy: [RelationsOrderBy!] = [PRIMARY_KEY_ASC]
    condition: RelationCondition
    filter: RelationFilter
  ): RelationsConnection!
  relationsList(
    first: Int
    offset: Int
    orderBy: [RelationsOrderBy!]
    condition: RelationCondition
    filter: RelationFilter
  ): [Relation!]!
  backlinks(
    first: Int
    last: Int
    offset: Int
    before: Cursor
    after: Cursor
    orderBy: [RelationsOrderBy!] = [PRIMARY_KEY_ASC]
    condition: RelationCondition
    filter: RelationFilter
  ): RelationsConnection!
  backlinksList(
    first: Int
    offset: Int
    orderBy: [RelationsOrderBy!]
    condition: RelationCondition
    filter: RelationFilter
  ): [Relation!]!
  values(
    first: Int
    last: Int
    offset: Int
    before: Cursor
    after: Cursor
    orderBy: [ValuesOrderBy!] = [PRIMARY_KEY_ASC]
    condition: ValueCondition
    filter: ValueFilter
  ): ValuesConnection!
  valuesList(
    first: Int
    offset: Int
    orderBy: [ValuesOrderBy!]
    condition: ValueCondition
    filter: ValueFilter
  ): [Value!]!
  description: String
  name: String
  spaceIds: [UUID]
  spacesInConnection(
    first: Int
    last: Int
    offset: Int
    before: Cursor
    after: Cursor
    filter: SpaceFilter
  ): SpacesConnection!
  spacesIn(
    first: Int
    offset: Int
    filter: SpaceFilter
  ): [Space!]
  typeIds: [UUID]
  typesConnection(
    first: Int
    last: Int
    offset: Int
    before: Cursor
    after: Cursor
    filter: EntityFilter
  ): EntitiesConnection!
  types(
    first: Int
    offset: Int
    filter: EntityFilter
  ): [Entity!]
}

Fields

Entity.nodeId ● ID! non-null scalar

A globally unique identifier. Can be used in various places throughout the system to identify this single value.

Entity.id ● UUID! non-null scalar

The entity's UUID. Stable across edits — the same entity keeps the same ID through every revision.

Entity.createdAt ● String! non-null scalar

ISO timestamp of the first edit that created this entity (string).

Entity.createdAtBlock ● String! non-null scalar

Chain block number of the first edit that created this entity (string).

Entity.updatedAt ● String! non-null scalar

ISO timestamp of the most recent edit that touched this entity.

Entity.updatedAtBlock ● String! non-null scalar

Chain block number of the most recent edit that touched this entity.

Entity.relationsWhereEntity ● RelationsConnection! non-null object

Reads and enables pagination through a set of Relation.

Entity.relationsWhereEntity.first ● Int scalar

Only read the first n values of the set.

Entity.relationsWhereEntity.last ● Int scalar

Only read the last n values of the set.

Entity.relationsWhereEntity.offset ● Int scalar

Skip the first n values from our after cursor, an alternative to cursor based pagination. May not be used with last.

Entity.relationsWhereEntity.before ● Cursor scalar

Read all values in the set before (above) this cursor.

Entity.relationsWhereEntity.after ● Cursor scalar

Read all values in the set after (below) this cursor.

Entity.relationsWhereEntity.orderBy ● [RelationsOrderBy!] list enum

The method to use when ordering Relation.

Entity.relationsWhereEntity.condition ● RelationCondition input

A condition to be used in determining which values should be returned by the collection.

Entity.relationsWhereEntity.filter ● RelationFilter input

A filter to be used in determining which values should be returned by the collection.

Entity.relationsWhereEntityList ● [Relation!]! non-null object

Reads and enables pagination through a set of Relation.

Entity.relationsWhereEntityList.first ● Int scalar

Only read the first n values of the set.

Entity.relationsWhereEntityList.offset ● Int scalar

Skip the first n values.

Entity.relationsWhereEntityList.orderBy ● [RelationsOrderBy!] list enum

The method to use when ordering Relation.

Entity.relationsWhereEntityList.condition ● RelationCondition input

A condition to be used in determining which values should be returned by the collection.

Entity.relationsWhereEntityList.filter ● RelationFilter input

A filter to be used in determining which values should be returned by the collection.

Entity.relations ● RelationsConnection! non-null object

Reads and enables pagination through a set of Relation.

Entity.relations.first ● Int scalar

Only read the first n values of the set.

Entity.relations.last ● Int scalar

Only read the last n values of the set.

Entity.relations.offset ● Int scalar

Skip the first n values from our after cursor, an alternative to cursor based pagination. May not be used with last.

Entity.relations.before ● Cursor scalar

Read all values in the set before (above) this cursor.

Entity.relations.after ● Cursor scalar

Read all values in the set after (below) this cursor.

Entity.relations.orderBy ● [RelationsOrderBy!] list enum

The method to use when ordering Relation.

Entity.relations.condition ● RelationCondition input

A condition to be used in determining which values should be returned by the collection.

Entity.relations.filter ● RelationFilter input

A filter to be used in determining which values should be returned by the collection.

Entity.relationsList ● [Relation!]! non-null object

Reads and enables pagination through a set of Relation.

Entity.relationsList.first ● Int scalar

Only read the first n values of the set.

Entity.relationsList.offset ● Int scalar

Skip the first n values.

Entity.relationsList.orderBy ● [RelationsOrderBy!] list enum

The method to use when ordering Relation.

Entity.relationsList.condition ● RelationCondition input

A condition to be used in determining which values should be returned by the collection.

Entity.relationsList.filter ● RelationFilter input

A filter to be used in determining which values should be returned by the collection.

Entity.backlinks ● RelationsConnection! non-null object

Reads and enables pagination through a set of Relation.

Entity.backlinks.first ● Int scalar

Only read the first n values of the set.

Entity.backlinks.last ● Int scalar

Only read the last n values of the set.

Entity.backlinks.offset ● Int scalar

Skip the first n values from our after cursor, an alternative to cursor based pagination. May not be used with last.

Entity.backlinks.before ● Cursor scalar

Read all values in the set before (above) this cursor.

Entity.backlinks.after ● Cursor scalar

Read all values in the set after (below) this cursor.

Entity.backlinks.orderBy ● [RelationsOrderBy!] list enum

The method to use when ordering Relation.

Entity.backlinks.condition ● RelationCondition input

A condition to be used in determining which values should be returned by the collection.

Entity.backlinks.filter ● RelationFilter input

A filter to be used in determining which values should be returned by the collection.

Entity.backlinksList ● [Relation!]! non-null object

Reads and enables pagination through a set of Relation.

Entity.backlinksList.first ● Int scalar

Only read the first n values of the set.

Entity.backlinksList.offset ● Int scalar

Skip the first n values.

Entity.backlinksList.orderBy ● [RelationsOrderBy!] list enum

The method to use when ordering Relation.

Entity.backlinksList.condition ● RelationCondition input

A condition to be used in determining which values should be returned by the collection.

Entity.backlinksList.filter ● RelationFilter input

A filter to be used in determining which values should be returned by the collection.

Entity.values ● ValuesConnection! non-null object

Reads and enables pagination through a set of Value.

Entity.values.first ● Int scalar

Only read the first n values of the set.

Entity.values.last ● Int scalar

Only read the last n values of the set.

Entity.values.offset ● Int scalar

Skip the first n values from our after cursor, an alternative to cursor based pagination. May not be used with last.

Entity.values.before ● Cursor scalar

Read all values in the set before (above) this cursor.

Entity.values.after ● Cursor scalar

Read all values in the set after (below) this cursor.

Entity.values.orderBy ● [ValuesOrderBy!] list enum

The method to use when ordering Value.

Entity.values.condition ● ValueCondition input

A condition to be used in determining which values should be returned by the collection.

Entity.values.filter ● ValueFilter input

A filter to be used in determining which values should be returned by the collection.

Entity.valuesList ● [Value!]! non-null object

Reads and enables pagination through a set of Value.

Entity.valuesList.first ● Int scalar

Only read the first n values of the set.

Entity.valuesList.offset ● Int scalar

Skip the first n values.

Entity.valuesList.orderBy ● [ValuesOrderBy!] list enum

The method to use when ordering Value.

Entity.valuesList.condition ● ValueCondition input

A condition to be used in determining which values should be returned by the collection.

Entity.valuesList.filter ● ValueFilter input

A filter to be used in determining which values should be returned by the collection.

Entity.description ● String scalar

Convenience accessor: the latest text value on the Description property (9b1f76ff9711404c861e59dc3fa7d037). May be null.

Entity.name ● String scalar

Convenience accessor: the latest text value on the Name property (a126ca530c8e48d5b88882c734c38935). May be null if no Name has been set. The same data is also accessible via values filtered by that property ID.

Entity.spaceIds ● [UUID] list scalar

Every space ID that has published values or relations on this entity. An entity can exist in multiple spaces simultaneously.

Entity.spacesInConnection ● SpacesConnection! non-null object

Reads and enables pagination through a set of Space.

Entity.spacesInConnection.first ● Int scalar

Only read the first n values of the set.

Entity.spacesInConnection.last ● Int scalar

Only read the last n values of the set.

Entity.spacesInConnection.offset ● Int scalar

Skip the first n values from our after cursor, an alternative to cursor based pagination. May not be used with last.

Entity.spacesInConnection.before ● Cursor scalar

Read all values in the set before (above) this cursor.

Entity.spacesInConnection.after ● Cursor scalar

Read all values in the set after (below) this cursor.

Entity.spacesInConnection.filter ● SpaceFilter input

A filter to be used in determining which values should be returned by the collection.

Entity.spacesIn ● [Space!] list object

Reads and enables pagination through a set of Space.

Entity.spacesIn.first ● Int scalar

Only read the first n values of the set.

Entity.spacesIn.offset ● Int scalar

Skip the first n values.

Entity.spacesIn.filter ● SpaceFilter input

A filter to be used in determining which values should be returned by the collection.

Entity.typeIds ● [UUID] list scalar

Every type ID this entity is tagged with via a Types relation. An entity can have multiple types — Project + Open Source, for example.

Entity.typesConnection ● EntitiesConnection! non-null object

Reads and enables pagination through a set of Entity.

Entity.typesConnection.first ● Int scalar

Only read the first n values of the set.

Entity.typesConnection.last ● Int scalar

Only read the last n values of the set.

Entity.typesConnection.offset ● Int scalar

Skip the first n values from our after cursor, an alternative to cursor based pagination. May not be used with last.

Entity.typesConnection.before ● Cursor scalar

Read all values in the set before (above) this cursor.

Entity.typesConnection.after ● Cursor scalar

Read all values in the set after (below) this cursor.

Entity.typesConnection.filter ● EntityFilter input

A filter to be used in determining which values should be returned by the collection.

Entity.types ● [Entity!] list object

Reads and enables pagination through a set of Entity.

Entity.types.first ● Int scalar

Only read the first n values of the set.

Entity.types.offset ● Int scalar

Skip the first n values.

Entity.types.filter ● EntityFilter input

A filter to be used in determining which values should be returned by the collection.

Interfaces

Node interface

An object with a globally unique ID.

Returned By

entities query ● entitiesOrderedByProperty query ● entity query ● entityByNodeId query ● search query ● type query ● typesList query

Member Of

EntitiesConnection object ● EntitiesEdge object ● Entity object ● Relation object ● Space object ● Value object

:::tip See also

Cookbook recipes that use this:

• Inspect an Entity
• List Entities of a Type in a Space
• Find Entities by Name
• Multi-Hop Traversal — walk multiple edges in one query
• Get All Properties of a Type — schema discovery via the Type entity's Properties relation

:::