Get Environment Unified Model

Retrieve a single environment-unified-model record by its ID, including any overrides. You have the flexibility to customize a Unified Model and its configuration to better suit your specific needs. Customizing the models allow you to override default mappings, add new resources, and tailor the unified apis to fit seamlessly within your environment. Read more about Installing Unified Models

Endpoint

http

GET /environment-unified-model/{id}

Path parameters

string · uuid

REQUIRED ·

The ID of the environment-unified-model record.

Example: 4af1e38e-1d84-4bea-8ef4-2d705aec43bc

Query parameters

Refer Specifying query parameters in Truto APIs

unified_model_id

string · uuid

Filter by base unified model ID.

Example: 7c5c8cc2-e68e-4af8-84d1-4ceea1489338

string · uuid

Filter by environment unified model ID.

Example: 7c5c8cc2-e68e-4af8-84d1-4ceea1489338

unified_model.name

string

Filter by base unified model name.

Response Body

string · uuid

The ID of the environment-unified-model record.

Example: 4af1e38e-1d84-4bea-8ef4-2d705aec43bc

unified_model_id

string · uuid

The ID of the unified model being installed or overridden.

Example: 7c5c8cc2-e68e-4af8-84d1-4ceea1489338

environment_id

string · uuid

The ID of the environment where this unified model is installed.

Example: 1ba1f401-7183-47c5-9e39-e8e257e3c795

override

object

An optional object containing environment-level overrides for the unified model which can include any of the properties like resources, scopes, etc.

Example:

{
  "resources": {
    "users": {
      "description": "Overrides the user resource description for this environment.",
      "integration_mapping": {
        "my_integration": {
          "list": {
            "path_mapping": "/v2/users"
          }
        }
      }
    }
  }
}

created_at

string · date-time

Timestamp when this record was created.

Example: 2024-01-10T10:00:00.000Z

updated_at

string · date-time

Timestamp when this record was last updated.

Example: 2024-01-11T12:30:00.000Z

unified_model

object

The full unified model object, with any overrides merged in.

Example:

{
  "id": "7c5c8cc2-e68e-4af8-84d1-4ceea1489338",
  "name": "user-directory",
  "sharing": "deny",
  "resources": {
    "users": {
      "schema": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          }
        }
      },
      "integration_mapping": {
        "my_integration": {
          "list": {
            "method": "get",
            "resource": "/users"
          }
        }
      }
    }
  }
}

string · uuid

The ID of the unified model.

Example: 7c5c8cc2-e68e-4af8-84d1-4ceea1489338

name

string

The name of the unified model.

Example: user-directory

category

string

The category of the unified model.

Example: hris

description

string

A brief description of what this unified model represents.

Example: This model provides a user directory interface for various HRIS integrations.

team_id

string · uuid

The ID of the team that owns this unified model.

Example: 05daecaf-4365-42e8-8370-8127de5dd717

sharing

string

The sharing policy of the unified model.

All possible enum values:

allow
ask
deny

Example: deny

resources

object

A map of resource names to schema and integration mapping details.

Example:

{
  "users": {
    "description": "A resource representing user objects",
    "schema": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string"
        },
        "email": {
          "type": "string"
        }
      }
    },
    "integration_mapping": {
      "my_integration": {
        "list": {
          "resource": "/users",
          "method": "get"
        }
      }
    }
  }
}

docs

object

Optional documentation or instructions for each resource.

scopes

object

Optional OAuth/permission scopes or other relevant scopes for this unified model.

webhooks

object

Optional webhook definitions for this unified model.

created_at

string · date-time

The date and time when the unified model was created.

Example: 2021-08-10T10:00:00.000Z

updated_at

string · date-time

The date and time when the unified model was last updated.

Example: 2021-08-10T10:30:00.000Z

version

number

The current version of the unified model.

Example: 3

installed_environment

string[]

A list of environment IDs where this unified model is installed.

team

object

The team object that owns this unified model.

string · uuid

The ID of the team.

Example: 05daecaf-4365-42e8-8370-8127de5dd717

name

string

The name of the team.

Example: My Awesome Team

domain

string

The domain of the team.

Example: example.com

logo

string

The URL of the team's logo.

Example: https://example.com/logo.png

is_verified

boolean

Whether the team is verified or not.

Example: true

is_white_label

boolean

Whether the team is white-labeled or not.

tos_link

string

A link to the team's Terms of Service, if available.

Example: https://example.com/tos

allow_impersonation

boolean

Whether the team allows impersonation.

created_at

string · date-time

The date and time when the team was created.

Example: 2021-08-10T10:00:00.000Z

updated_at

string · date-time

The date and time when the team was last updated.

Example: 2021-08-10T10:00:00.000Z