---
title: "Create play"
method: POST
path: "/orchestration/plays"
tags: ["Orchestration - Plays"]
---

# Create play

`POST /orchestration/plays`

Create a new play

## Request body

- object — Request body schema.
  - `name` string, required — Play name.
  - `description` string — Play description.
  - `modelUuid` string, uuid, required — Model identifier.
  - `filter` object — Segment filter criteria.
    - `conjonction` 'or' | 'and', required
    - `groups` object[], required
      - `conjonction` 'or' | 'and', required
      - `conditions` union[], required
        - union
          - object
            - `kind` 'sql', required
            - `name` string, required
            - `clause` string, required
          - object
            - `kind` 'string', required
            - `relatedModelUuid` string
            - `columnSlug` string, required
            - `operator` 'is' | 'isNot' | 'contains' | 'doesNotContain' | 'startsWith' | 'endsWith', required
            - `values` union, required
              - …
          - object
            - `kind` 'string', required
            - `relatedModelUuid` string
            - `columnSlug` string, required
            - `operator` 'isNull' | 'isNotNull' | 'isEmpty' | 'isNotEmpty', required
          - object
            - `kind` 'number', required
            - `relatedModelUuid` string
            - `columnSlug` string, required
            - `operator` 'is' | 'isNot' | 'greaterThan' | 'lowerThan', required
            - `value` number, required
          - object
            - `kind` 'number', required
            - `relatedModelUuid` string
            - `columnSlug` string, required
            - `operator` 'between', required
            - `firstValue` number, required
            - `lastValue` number, required
          - object
            - `kind` 'number', required
            - `relatedModelUuid` string
            - `columnSlug` string, required
            - `operator` 'isNull' | 'isNotNull', required
          - object
            - `kind` 'objectProperty', required
            - `relatedModelUuid` string
            - `columnSlug` string, required
            - `propertyName` string, required
            - `operator` 'is' | 'isNot' | 'contains' | 'greaterThan' | 'lowerThan' | 'doesNotContain' | 'startsWith' | 'endsWith', required
            - `value` string, required
          - object
            - `kind` 'objectProperty', required
            - `relatedModelUuid` string
            - `columnSlug` string, required
            - `propertyName` string, required
            - `operator` 'isNull' | 'isNotNull' | 'isEmpty' | 'isNotEmpty', required
          - object
            - `kind` 'objectProperty', required
            - `relatedModelUuid` string
            - `columnSlug` string, required
            - `propertyName` string, required
            - `operator` 'between', required
            - `value` string, required
            - `otherValue` string, required
          - object
            - `kind` 'object', required
            - `relatedModelUuid` string
            - `columnSlug` string, required
            - `operator` 'isNull', required
          - object
            - `kind` 'object', required
            - `relatedModelUuid` string
            - `columnSlug` string, required
            - `operator` 'isNotNull', required
          - object
            - `kind` 'object', required
            - `relatedModelUuid` string
            - `columnSlug` string, required
            - `operator` 'matchConditions', required
            - `conjonction` 'or' | 'and', required
            - `propertyConditions` union[], required
              - …
          - object
            - `kind` 'array', required
            - `relatedModelUuid` string
            - `columnSlug` string, required
            - `operator` 'isNull', required
          - object
            - `kind` 'array', required
            - `relatedModelUuid` string
            - `columnSlug` string, required
            - `operator` 'isNotNull', required
          - object
            - `kind` 'array', required
            - `relatedModelUuid` string
            - `columnSlug` string, required
            - `operator` 'matchConditions', required
            - `conjonction` 'or' | 'and', required
            - `propertyConditions` union[], required
              - …
          - object
            - `kind` 'any', required
            - `relatedModelUuid` string
            - `columnSlug` string, required
            - `operator` 'isNull' | 'isNotNull', required
          - object
            - `kind` 'vector', required
            - `relatedModelUuid` string
            - `columnSlug` string, required
            - `operator` 'isNull' | 'isNotNull', required
          - object
            - `kind` 'date', required
            - `relatedModelUuid` string
            - `columnSlug` string, required
            - `operator` 'is' | 'isNot' | 'greaterThan' | 'lowerThan', required
            - `value` string, required
          - object
            - `kind` 'date', required
            - `relatedModelUuid` string
            - `columnSlug` string, required
            - `operator` 'between', required
            - `firstValue` string, required
            - `lastValue` string, required
          - object
            - `kind` 'date', required
            - `relatedModelUuid` string
            - `columnSlug` string, required
            - `operator` 'isNull' | 'isNotNull', required
          - object
            - `kind` 'boolean', required
            - `relatedModelUuid` string
            - `columnSlug` string, required
            - `operator` 'isTrue' | 'isFalse' | 'isNull' | 'isNotNull', required
          - object
            - `kind` 'occurrence', required
            - `relatedModelUuid` string, required
            - `frequency` union, required
              - …
            - `period` object, required
              - …
            - `conjonction` 'or' | 'and', required
            - `conditions` union[], required
              - …
          - object
            - `kind` 'enrollment', required
            - `workflowUuid` string, required
            - `activityKind` 'workflowEntered' | 'workflowNodeExecuted' | 'workflowLeft', required
            - `nodeSlug` string
            - `frequency` union, required
              - …
            - `period` object, required
              - …
          - object
            - `kind` 'segment', required
            - `segmentUuid` string, required
            - `operator` 'in' | 'notIn', required
  - `sort` object[] — Sort criteria.
    - `columnSlug` string, required
    - `kind` 'asc' | 'desc', required
  - `limit` number — Maximum number of records.
  - `trackingColumnSlugs` string[] — Tracking column identifiers.
  - `changeKinds` string[], required — Change kinds to include.
  - `runCreationRule` 'always' | 'once' | 'noConcurrency', required — Run creation rule.
  - `schedule` union — Play schedule configuration.
    - object
      - `type` 'dbt', required
      - `jobId` string, required
    - object
      - `type` 'cron', required
      - `cron` string, required
    - object
      - `type` 'realtime', required
    - object
      - `type` 'dependency', required
      - `playUuid` string, required
    - object
      - `type` 'watch', required
  - `folderUuid` string, uuid — Folder identifier.

## Response `200`

Successful response

- object
  - `play` object, required — Created play details.
    - `uuid` string, required
    - `workspaceUuid` string, required
    - `workflowUuid` string, required
    - `userUuid` string, required
    - `modelUuid` string, required
    - `segmentUuid` string, required
    - `changeKinds` string[], required
    - `runCreationRule` 'always' | 'once' | 'noConcurrency', required
    - `name` string, required
    - `description` string, nullable, required
    - `schedule` union, required
      - object
        - `type` 'watch', required
        - `temporalScheduleWorkflowId` string, required
        - `meta` object
      - object
        - `type` 'realtime', required
      - object
        - `type` 'cron', required
        - `cron` string, required
        - `temporalScheduleWorkflowId` string, required
      - object
        - `type` 'dbt', required
        - `jobId` string, required
      - object
        - `type` 'dependency', required
        - `playUuid` string, required
    - `isEnabled` boolean, required
    - `healthThreshold` number, required
    - `healthAlertActions` object[], required
      - `actionSlug` string, required
      - `connectorUuid` string, required
      - `config` object, required
    - `folderUuid` string, nullable, required
    - `createdAt` string, required
    - `updatedAt` string, required
    - `deletedAt` string, nullable, required

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `404` — Not found
- `500` — Internal server error

---

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