---
title: "Create/Replace Multiple"
method: POST
path: "/projects/{projectId}/schemas"
tags: ["Create Schemas"]
---

# Create/Replace Multiple

`POST /projects/{projectId}/schemas`

## Request body

- object
  - `entries` SchemaEntry[], required — The list of schema entries to upload
    - `entityType` 'event' | 'profile', required
    - `name` string, required — The entity name (eg: Added To Cart)
    - `schemaJson` Schema, required — The schema for the entity
      - `description` string — The entity description
      - `properties` object — The list of properties that should be included on an instance of this entity
      - `metadata` object
        - `com.mixpanel` object — Metadata about this entity that is specific to Mixpanel
          - `$source` string — The source of this schema. Used by partners to identify themselves
          - `displayName` string — If set, this name will be used in the Mixpanel UI instead of the entity name
          - `tags` string[] — A list of tags to associate to this entity that can be used in the Mixpanel UI for filtering
          - `hidden` boolean — If true, this entity will be hidden in the Mixpanel UI
          - `dropped` boolean — [Events only] If true, the event will be dropped at ingestion time.
          - `contacts` string[] — A list of emails belonging to users responsible for this entity.
          - `teamContacts` string[] — A list of team names responsible for this entity.
  - `truncate` boolean — If true, delete your entire data dictionary before inserting these entries. This is primarily useful if you want to upload a single file that represents your entire data dictionary.

## Response `200`

Success

- BatchUploadSchemasResponse
  - `results` object
    - `added` integer — The number of entries that were inserted
    - `deleted` integer — The number of entries that were deleted (on applicable if `truncate: true`)
  - `status` 'ok'

## Other responses

- `401` — Unauthorized
- `403` — Forbidden

---

[API](https://skmtc.net/mixpanel/apis/query-api.md) · [All operations](https://skmtc.net/mixpanel/apis/query-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mixpanel/query-api/revisions/f442da95252a/schema)