---
title: "POST /connectors/{connector_id}/schema_object"
method: POST
path: "/connectors/{connector_id}/schema_object"
tags: ["connectors"]
---

# POST /connectors/{connector_id}/schema_object

`POST /connectors/{connector_id}/schema_object`

## Path parameters

- `connector_id` string, uuid, required

## Request body

- union
  - object
    - `description` string, nullable
    - `name` string, required
    - `notes` string, nullable
    - `type` 'database', required
  - object
    - `database_id` string, uuid, required
    - `description` string, nullable
    - `name` string, required
    - `notes` string, nullable
    - `type` 'schema', required
  - object
    - `description` string, nullable
    - `endpoint` string, nullable
    - `name` string, required
    - `notes` string, nullable
    - `schema_id` string, uuid, required
    - `type` 'table', required
  - object
    - `column_type` string, required
    - `name` string, required
    - `notes` string, nullable
    - `table_id` string, uuid, required
    - `type` 'column', required

## Response `201`

Schema object created successfully

- union
  - object
    - `id` string, uuid, required
    - `type` 'database', required
  - object
    - `id` string, uuid, required
    - `type` 'schema', required
  - object
    - `id` string, uuid, required
    - `type` 'table', required
  - object
    - `id` string, uuid, required
    - `type` 'column', required

## Other responses

- `400` — Bad request - invalid object specification
- `403` — Forbidden - user does not have access to connector
- `404` — Connector or parent object not found

## Changes

- **2026-01-28** `ac51b9f38f1f` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/structifyai/apis/structify/changes/connectors/:connector_id/schema_object/post.md)

---

[API](https://skmtc.dev/structifyai/apis/structify.md) · [All operations](https://skmtc.dev/structifyai/apis/structify/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/structifyai/structify/revisions/1364930b6980/schema)