---
title: "Create Table Join"
method: POST
path: "/v1/table/{table_id}/join"
tags: ["Table"]
---

# Create Table Join

`POST /v1/table/{table_id}/join`

Create a join between two tables.

## Path parameters

- `table_id` string, uuid, required

## Request body

- CreateTableJoin
  - `context` BaseRequestContext
    - `projectId` string, uuid
    - `processPublicId` string, uuid, nullable
    - `processSectionPublicId` string, uuid, nullable
    - `processResponsePublicId` string, uuid, nullable
  - `joinViewId` string
  - `joinColumns` TableColumnJoin[]
    - `sourceColumnId` string
    - `targetColumnId` string
  - `dataColumns` string[]
  - `isOneToMany` boolean

## Response `200`

Successfully created a table join.

- object
  - `metadata` object
  - `data` Table
    - `publicId` string, uuid
    - `autodeskBim360ModelProperties` unknown
    - `name` string
    - `type` string
    - `logo` string
    - `columns` TableColumn[]
      - `publicId` string, uuid
      - `name` string
      - `kind` 'text' | 'datetime' | 'date' | 'link' | 'multilink' | 'select' | 'multiselect' | 'integer' | 'float' | 'percentage' | 'tag' | 'variable' | 'attachment' | 'phone' | 'email' | 'vote' | 'checkbox' | 'duration'
      - `width` integer
      - `description` union
        - object, nullable
        - Draftjs
          - `content` DraftjsContent, required
            - `blocks` DraftjsBlock[], required
              - …
            - `entityMap` object, required
      - `kindOptions` SelectOptionsLookup
        - `tableOptions` SelectTableOptions
          - `columnId` string
          - `tableId` string
          - `viewId` string
          - `dependencies` SelectTableDependency[], nullable
            - `columnId` string, required
            - `columnJoinId` string, nullable
          - `liveValues` boolean
        - `manualOptions` string[]
        - `autopopulate` boolean
      - `alterOptions` union
        - TableColumnAlter
          - `dateConversionFormat` 'DD/MM/YYYY' | 'MM/DD/YYYY' | 'ISO8601' | 'DD-Mon-YY'
          - `runScriptOnAllCells` boolean
        - object, nullable
      - `isIndexed` boolean
      - `script` string, nullable
      - `scriptEnabled` boolean
      - `formula` string, nullable
      - `formulaEnabled` boolean
      - `aggregate` integer
      - `isJoined` boolean, nullable
      - `thousandSeparator` boolean
      - `displayLink` boolean
      - `decimalPlaces` integer
      - `dateFormat` string, nullable
      - `headerBackgroundColor` string, nullable
      - `headerTextColor` string, nullable
      - `exportWidth` integer, nullable
      - `isSynced` boolean
    - `projects` Project[]
      - `publicId` string
      - `name` string
    - `createdAt` string, date-time
    - `updatedAt` string, date-time
    - `deletedAt` string, date-time
    - `isDeleted` boolean
    - `defaultViewId` string
    - `joins` TableJoin[], nullable
      - `publicId` string, uuid
      - `joinTableId` string
      - `joinViewId` string
      - `isOneToMany` boolean
      - `joinColumns` TableColumnJoin[]
        - `sourceColumnId` string
        - `targetColumnId` string
      - `dataColumns` TableJoinImportedColumns[]
        - `sourceColumnId` string
        - `targetColumnId` string
    - `keepValidationsInSync` boolean
    - `keepColoursInSync` boolean
    - `allowComments` boolean
    - `isReferenceTable` boolean
    - `isViewpointSynced` boolean
    - `isViewpointRfisSynced` boolean
    - `isAutodeskBim360Synced` boolean
    - `isAutodeskBim360ChecklistsSynced` boolean
    - `isAutodeskBim360IssuesSynced` boolean
    - `isAutodeskBim360ModelsSynced` boolean
    - `isAutodeskBim360UsersSynced` boolean
    - `isProcoreSynced` boolean
    - `isAconexSynced` boolean
    - `isAconexWorkflowsSynced` boolean
    - `isAsiteDocumentsSynced` boolean
    - `isAsiteFormsSynced` boolean
    - `isMortaSynced` boolean
    - `isMortaProjectsSynced` boolean
    - `isMortaResourcesSynced` boolean
    - `isMortaCommentsSynced` boolean
    - `isMortaColumnsSynced` boolean
    - `isMortaUsersSynced` boolean
    - `isReviztoIssuesSynced` boolean
    - `isSynced` boolean
    - `syncUser` User3
      - `publicId` string, uuid
      - `name` string
    - `lastSync` string, date-time
    - `isSyncing` boolean
    - `syncHourlyFrequency` integer
    - `failedSyncAttempts` integer
    - `projectPublicId` string, uuid
    - `projectName` string
    - `lockedFromDuplication` boolean

## Other responses

- `403` — Unauthorized action - User lacks necessary permissions.
- `404` — Table not found.

---

[API](https://skmtc.net/morta-technology/apis/morta-api-reference.md) · [All operations](https://skmtc.net/morta-technology/apis/morta-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/morta-technology/morta-api-reference/versions/9c58c1c1e7e8/schema)