---
title: "Model reference"
url: https://developers.dagio.ai/reference/
---

# Model reference

   
                        
                                                                      
                 
                  
           
   

A Model describes the structure, data, behavior and interfaces of a Surface app. Use this reference to verify a property, explore a variant or generate sources with a tool. To learn app composition, start with the [Models guide](https://developers.dagio.ai/models/).

## Reading the reference

Tables separate the exact field name, admitted values and purpose. Versions discriminate contracts; they are not business parameters to ask an end user to enter. Studio and authoring tools handle technical structure; integrators use this reference for sources and artifacts.

## Validated structures

- [flowComposition](https://developers.dagio.ai/reference/flow-composition/)
- [knowledgeCurationReviewProfile](https://developers.dagio.ai/reference/knowledge-curation-review-profile/)
- [knowledgeCurationSuggestionKind](https://developers.dagio.ai/reference/knowledge-curation-suggestion-kind/)
- [managedExactDataUnit](https://developers.dagio.ai/reference/managed-exact-data-unit/)
- [managedExactDecimalFormat](https://developers.dagio.ai/reference/managed-exact-decimal-format/)
- [managedExactDecimalRounding](https://developers.dagio.ai/reference/managed-exact-decimal-rounding/)
- [managedNumericFieldV2](https://developers.dagio.ai/reference/managed-numeric-field-v2/)
- [managedModelSourcePackage](https://developers.dagio.ai/reference/managed-model-source-package/)
- [managedModelAuthorFlow](https://developers.dagio.ai/reference/managed-model-author-flow/)
- [managedModelAuthorTask](https://developers.dagio.ai/reference/managed-model-author-task/)
- [managedApproximateRealValue](https://developers.dagio.ai/reference/managed-approximate-real-value/)
- [managedIntegerValue](https://developers.dagio.ai/reference/managed-integer-value/)
- [managedChoiceValue](https://developers.dagio.ai/reference/managed-choice-value/)
- [managedTypedFieldV2](https://developers.dagio.ai/reference/managed-typed-field-v2/)
- [managedTypedValue](https://developers.dagio.ai/reference/managed-typed-value/)
- [modelGanttSchedule](https://developers.dagio.ai/reference/model-gantt-schedule/)
- [surfaceRelationPolicy](https://developers.dagio.ai/reference/surface-relation-policy/)
- [surfaceTriggerDeadline](https://developers.dagio.ai/reference/surface-trigger-deadline/)
- [surfaceWorkBinding](https://developers.dagio.ai/reference/surface-work-binding/)
- [surfaceWorkExperience](https://developers.dagio.ai/reference/surface-work-experience/)
- [surfaceWorkHeaderFact](https://developers.dagio.ai/reference/surface-work-header-fact/)
- [surfaceWorkHeader](https://developers.dagio.ai/reference/surface-work-header/)
- [surfaceWorkHeaderValue](https://developers.dagio.ai/reference/surface-work-header-value/)
- [surfaceWorkQueryBinding](https://developers.dagio.ai/reference/surface-work-query-binding/)
- [surfaceWorkScope](https://developers.dagio.ai/reference/surface-work-scope/)
- [workspaceActionContextSelection](https://developers.dagio.ai/reference/workspace-action-context-selection/)
- [workspaceCompositionPresentation](https://developers.dagio.ai/reference/workspace-composition-presentation/)
- [managedExactDataExpression](https://developers.dagio.ai/reference/managed-exact-data-expression/)
- [managedExactDataValueType](https://developers.dagio.ai/reference/managed-exact-data-value-type/)
- [workspaceExactData](https://developers.dagio.ai/reference/workspace-exact-data/)
- [workspaceGraphLayout](https://developers.dagio.ai/reference/workspace-graph-layout/)
- [workspaceGraphPresentation](https://developers.dagio.ai/reference/workspace-graph-presentation/)
- [workspaceGraphProfile](https://developers.dagio.ai/reference/workspace-graph-profile/)
- [workspaceHomeIcon](https://developers.dagio.ai/reference/workspace-home-icon/)
- [workspaceHomePresentation](https://developers.dagio.ai/reference/workspace-home-presentation/)
- [workspaceHomePresentationV2](https://developers.dagio.ai/reference/workspace-home-presentation-v2/)
- [exactDataWorkspaceFormControl](https://developers.dagio.ai/reference/exact-data-workspace-form-control/)
- [exactDataWorkspaceForm](https://developers.dagio.ai/reference/exact-data-workspace-form/)
- [modelSourceRights](https://developers.dagio.ai/reference/model-source-rights/)
- [surfaceConsolidationProfile](https://developers.dagio.ai/reference/surface-consolidation-profile/)
- [surfaceContextPolicyV4](https://developers.dagio.ai/reference/surface-context-policy-v4/)
- [surfaceFlowReferenceContextSource](https://developers.dagio.ai/reference/surface-flow-reference-context-source/)
- [workspaceActionLaunchSelection](https://developers.dagio.ai/reference/workspace-action-launch-selection/)
- [workspaceModelFoundation](https://developers.dagio.ai/reference/workspace-model-foundation/)
- [contentSpaceActionPolicy](https://developers.dagio.ai/reference/content-space-action-policy/)
- [workspaceNavigationMetrics](https://developers.dagio.ai/reference/workspace-navigation-metrics/)
- [workspacePresentationIcon](https://developers.dagio.ai/reference/workspace-presentation-icon/)
- [workspaceQuery](https://developers.dagio.ai/reference/workspace-query/)
- [workspaceQueryBinding](https://developers.dagio.ai/reference/workspace-query-binding/)
- [workspaceQueryParameterKey](https://developers.dagio.ai/reference/workspace-query-parameter-key/)
- [workspaceQueryControls](https://developers.dagio.ai/reference/workspace-query-controls/)
- [workspaceRecordCalculationSource](https://developers.dagio.ai/reference/workspace-record-calculation-source/)
- [workspaceRecordDirectValueSource](https://developers.dagio.ai/reference/workspace-record-direct-value-source/)
- [workspaceRecordPresentation](https://developers.dagio.ai/reference/workspace-record-presentation/)
- [workspaceRecordProfile](https://developers.dagio.ai/reference/workspace-record-profile/)
- [workspaceRecordQueryBinding](https://developers.dagio.ai/reference/workspace-record-query-binding/)
- [workspaceRecordTableColumnSource](https://developers.dagio.ai/reference/workspace-record-table-column-source/)
- [workspaceRecordValueSource](https://developers.dagio.ai/reference/workspace-record-value-source/)
- [workspaceRule](https://developers.dagio.ai/reference/workspace-rule/)
- [workspaceTableCellFormat](https://developers.dagio.ai/reference/workspace-table-cell-format/)
- [workspaceTableGrouping](https://developers.dagio.ai/reference/workspace-table-grouping/)
- [workspaceTableLayout](https://developers.dagio.ai/reference/workspace-table-layout/)
- [managedFlowBlueprint](https://developers.dagio.ai/reference/managed-flow-blueprint/)
- [managedDocumentProfileV1](https://developers.dagio.ai/reference/managed-document-profile-v1/)
- [managedDocumentProfileV2](https://developers.dagio.ai/reference/managed-document-profile-v2/)
- [managedDocumentProfileV3](https://developers.dagio.ai/reference/managed-document-profile-v3/)
- [surfaceCompositionCatalogueIdentity](https://developers.dagio.ai/reference/surface-composition-catalogue-identity/)
- [surfaceCompositionCatalogueVersion](https://developers.dagio.ai/reference/surface-composition-catalogue-version/)
- [surfaceCompositionElement](https://developers.dagio.ai/reference/surface-composition-element/)
- [surfaceCompositionPrepareActionParams](https://developers.dagio.ai/reference/surface-composition-prepare-action-params/)
- [surfaceCompositionQueryBinding](https://developers.dagio.ai/reference/surface-composition-query-binding/)
- [surfaceCompositionSpec](https://developers.dagio.ai/reference/surface-composition-spec/)
- [surfaceCompositionWorkActionParams](https://developers.dagio.ai/reference/surface-composition-work-action-params/)
- [surfaceCompositionWorkConsolidationParams](https://developers.dagio.ai/reference/surface-composition-work-consolidation-params/)
- [surfaceCompositionWorkQueryBinding](https://developers.dagio.ai/reference/surface-composition-work-query-binding/)
- [surfaceCompositionWorkScope](https://developers.dagio.ai/reference/surface-composition-work-scope/)

## Named types and native formats

- [FlowComposition · types](https://developers.dagio.ai/reference/types-flow-composition/)
- [KnowledgeCurationReviewProfile · types](https://developers.dagio.ai/reference/types-knowledge-curation-review-profile/)
- [ManagedExactDecimal · types](https://developers.dagio.ai/reference/types-managed-exact-decimal/)
- [ManagedModelAuthoring · types](https://developers.dagio.ai/reference/types-managed-model-authoring/)
- [ManagedModelFlowAuthoring · types](https://developers.dagio.ai/reference/types-managed-model-flow-authoring/)
- [ManagedModelSource · types](https://developers.dagio.ai/reference/types-managed-model-source/)
- [ManagedModelSourceFile · types](https://developers.dagio.ai/reference/types-managed-model-source-file/)
- [ManagedNumericField · types](https://developers.dagio.ai/reference/types-managed-numeric-field/)
- [ManagedTypedValue · types](https://developers.dagio.ai/reference/types-managed-typed-value/)
- [ModelApplicationProfiles · types](https://developers.dagio.ai/reference/types-model-application-profiles/)
- [ModelArtifact · types](https://developers.dagio.ai/reference/types-model-artifact/)
- [ModelGantt · types](https://developers.dagio.ai/reference/types-model-gantt/)
- [SurfaceRelationPolicy · types](https://developers.dagio.ai/reference/types-surface-relation-policy/)
- [SurfaceTriggerDeadline · types](https://developers.dagio.ai/reference/types-surface-trigger-deadline/)
- [SurfaceWorkExperience · types](https://developers.dagio.ai/reference/types-surface-work-experience/)
- [WorkspaceActionContextSelection · types](https://developers.dagio.ai/reference/types-workspace-action-context-selection/)
- [WorkspaceCompositionPresentation · types](https://developers.dagio.ai/reference/types-workspace-composition-presentation/)
- [WorkspaceCompositionReferences · types](https://developers.dagio.ai/reference/types-workspace-composition-references/)
- [WorkspaceExactData · types](https://developers.dagio.ai/reference/types-workspace-exact-data/)
- [WorkspaceGraphPresentation · types](https://developers.dagio.ai/reference/types-workspace-graph-presentation/)
- [WorkspaceHomePresentation · types](https://developers.dagio.ai/reference/types-workspace-home-presentation/)
- [WorkspaceModelFoundation · types](https://developers.dagio.ai/reference/types-workspace-model-foundation/)
- [WorkspaceNavigationMetrics · types](https://developers.dagio.ai/reference/types-workspace-navigation-metrics/)
- [WorkspacePresentationIcon · types](https://developers.dagio.ai/reference/types-workspace-presentation-icon/)
- [WorkspaceQuery · types](https://developers.dagio.ai/reference/types-workspace-query/)
- [WorkspaceQueryControls · types](https://developers.dagio.ai/reference/types-workspace-query-controls/)
- [WorkspaceRecordPresentation · types](https://developers.dagio.ai/reference/types-workspace-record-presentation/)
- [WorkspaceRule · types](https://developers.dagio.ai/reference/types-workspace-rule/)
- [WorkspaceTableLayout · types](https://developers.dagio.ai/reference/types-workspace-table-layout/)
- [types · types](https://developers.dagio.ai/reference/types-types/)
- [surface-asset · types](https://developers.dagio.ai/reference/types-surface-asset/)
- [SurfaceCompositionAdmission · types](https://developers.dagio.ai/reference/types-surface-composition-admission/)
- [SurfaceCompositionBindings · types](https://developers.dagio.ai/reference/types-surface-composition-bindings/)
- [SurfaceCompositionEvents · types](https://developers.dagio.ai/reference/types-surface-composition-events/)
- [SurfaceCompositionHomeBindings · types](https://developers.dagio.ai/reference/types-surface-composition-home-bindings/)
- [SurfaceCompositionIdentity · types](https://developers.dagio.ai/reference/types-surface-composition-identity/)
- [SurfaceCompositionSchema · types](https://developers.dagio.ai/reference/types-surface-composition/)
- [SurfaceCompositionWorkBindings · types](https://developers.dagio.ai/reference/types-surface-composition-work-bindings/)

## Using the reference with AI

Each page has a Markdown version and a Copy button. [/llms.txt](/llms.txt) lists the pages and their addresses. Give AI the sections relevant to a change, then validate the complete Model before publication.

<!-- surface-examples:start -->

## Applied examples : Read a complete profile and view

Compare properties with the linked contracts before inserting each fragment into the Model.

### Configuration

Fragment placed in `presentation.recordProfiles[]`. [Properties and accepted values](https://developers.dagio.ai/reference/workspace-record-profile/).

```json
{
  "key": "client",
  "definitionPaths": [
    "workspace/clients/surface/client"
  ],
  "editActionKey": "edit-client",
  "identity": {
    "title": {
      "kind": "field",
      "fieldPath": "fields/company"
    },
    "avatar": {
      "kind": "initials",
      "maximumLetters": 2
    },
    "subtitle": {
      "kind": "field",
      "fieldPath": "fields/status"
    }
  },
  "valueLabels": [
    {
      "fieldPath": "fields/status",
      "values": [
        {
          "value": "prospect",
          "label": "Prospect"
        },
        {
          "value": "active",
          "label": "Active"
        }
      ]
    }
  ],
  "card": {
    "summary": {
      "kind": "field",
      "fieldPath": "fields/notes"
    },
    "tags": {
      "namespace": "user",
      "maximumVisible": 3
    },
    "metricKeys": [],
    "openLabel": "Open client"
  },
  "queryBindings": [],
  "metrics": [],
  "detail": {
    "primaryActionKey": null,
    "creationActionKeys": [],
    "actionKeys": [],
    "sections": [
      {
        "kind": "fields",
        "key": "follow-up",
        "label": "Client follow-up",
        "fieldPaths": [
          "fields/notes",
          "fields/status"
        ]
      }
    ],
    "settings": {
      "fieldPaths": [
        "fields/email"
      ]
    },
    "tags": {
      "namespace": "user",
      "maximumVisible": 3
    },
    "relatedGroups": [],
    "primaryActionLabel": null
  }
}
```

### Variation and connection

Fragment placed in `presentation.tableViews[]`. [Properties and accepted values](https://developers.dagio.ai/reference/workspace-record-presentation/).

```json
{
  "viewKey": "quotes-table",
  "columns": [
    {
      "key": "number",
      "label": "Number",
      "source": {
        "kind": "native",
        "property": "title"
      }
    },
    {
      "key": "status",
      "label": "Status",
      "source": {
        "kind": "field",
        "fieldPath": "fields/status"
      }
    },
    {
      "key": "amount",
      "label": "Amount",
      "source": {
        "kind": "field",
        "fieldPath": "fields/amount"
      }
    }
  ],
  "openLabel": "Open quote"
}
```

### UI layout example

The illustrative layout below places this configuration in the Clients/Quotes app. Insert each fragment at the stated location, with Field, Query and Action references matching the Model declarations.

1. Property
2. Value
3. Reference
4. Validation

<!-- surface-examples:end -->