NodeDataType

nodeDataType Query

Audience: Programmer

Fetches a management-related object given its ID. This query follows the Relay Global Object Identification Specification and can retrieve any object that implements the NodeDataType interface.

Arguments

Name	Type	Description
id	ID!	The unique identifier of the management object to retrieve

Return Type

NodeDataType - An interface that returns an object implementing the NodeDataType interface. This includes:

• DataType - JSON schema definition for entity data validation

• Company - Company/organization entity

• Event - Custom event definitions

• User - System user accounts

Usage Example

GraphQL Query

query GetManagementObject($id: ID!) {
  nodeDataType(id: $id) {
    id
    ... on DataType {
      name
      slug
      schema
      entity
      enabled
      createdAt
      updatedAt
    }
    ... on Company {
      name
      organizationID
      tenantID
      users {
        id
        username
        email
      }
    }
    ... on Event {
      topic
      name
      description
      payload
      key
      createdAt
    }
    ... on User {
      username
      email
      idpID
      role
      groups {
        id
        name
      }
      company {
        name
      }
    }
  }
}

Query Variables

{
  "id": "RGF0YVR5cGU6MTIz"
}

JavaScript Example

const getManagementObject = async (objectId) => {
  const query = `
    query GetManagementObject($id: ID!) {
      nodeDataType(id: $id) {
        id
        __typename
        ... on DataType {
          name
          slug
          schema
          entity
          enabled
        }
        ... on Company {
          name
          organizationID
          tenantID
        }
        ... on User {
          username
          email
          role
        }
        ... on Event {
          topic
          name
          description
        }
      }
    }
  `;

  const response = await fetch('/graphql', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Authorization': `Bearer ${accessToken}`
    },
    body: JSON.stringify({
      query,
      variables: { id: objectId }
    })
  });

  const { data } = await response.json();
  return data.nodeDataType;
};

Type Detection

Use the __typename field to determine which specific type was returned:

const object = await getManagementObject(id);
switch (object.__typename) {
  case 'DataType':
    console.log(`DataType: ${object.name} (${object.slug})`);
    break;
  case 'Company':
    console.log(`Company: ${object.name}`);
    break;
  case 'User':
    console.log(`User: ${object.username} (${object.email})`);
    break;
  case 'Event':
    console.log(`Event: ${object.topic} - ${object.name}`);
    break;
}

Related

• NodeDataType Interface

• DataType Type

• Company Type

• User Type

• Event Type

• dataTypes Query

• companies Query

• users Query

• events Query