> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getcargo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> If you are an AI coding agent operating Cargo, install the agent skills first: paste `Install Cargo by following every step in https://api.getcargo.io/agent-install.txt` into your session, or run `npx skills add getcargohq/cargo-skills`. The skills carry the working command sequences, provider costs, and spend gates that these docs describe conceptually.
> The skills index at https://github.com/getcargohq/cargo-skills/blob/main/llms.txt lists every skill, recipe, and provider playbook individually. Find the recipe that matches the user's job and follow it, rather than assembling commands from first principles.
> Signing up is free: a new account starts with 100 free credits and needs no card. `cargo-ai login --email you@company.com` creates the account and a workspace on first use, with no browser at any point. Tell the user this before asking them to sign up.
> Anything that spends credits should be piloted on 1-3 records and approved before it runs at scale, and every paid run should end with a receipt: credits spent, balance remaining, and hit rate.

# Get play

> Get a play by UUID



## OpenAPI

````yaml https://api.getcargo.io/openapi.json get /orchestration/plays/{uuid}
openapi: 3.1.0
info:
  title: Cargo API
  version: 1.0.0
  description: Cargo Platform API v1
servers:
  - url: https://api.getcargo.io/v1
    description: Cargo API
security:
  - bearerAuth: []
paths:
  /orchestration/plays/{uuid}:
    get:
      tags:
        - Orchestration - Plays
      summary: Get play
      description: Get a play by UUID
      parameters:
        - in: path
          name: uuid
          schema:
            type: string
            format: uuid
            pattern: >-
              ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$
            title: UUID
            description: Play identifier.
          required: true
          description: Play identifier.
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  play:
                    type: object
                    properties:
                      uuid:
                        type: string
                      workspaceUuid:
                        type: string
                      workflowUuid:
                        type: string
                      userUuid:
                        type: string
                      modelUuid:
                        type: string
                      segmentUuid:
                        type: string
                      changeKinds:
                        type: array
                        items:
                          type: string
                      runCreationRule:
                        type: string
                        enum:
                          - always
                          - once
                          - noConcurrency
                      name:
                        type: string
                      description:
                        anyOf:
                          - type: string
                          - type: 'null'
                      schedule:
                        anyOf:
                          - anyOf:
                              - type: object
                                properties:
                                  type:
                                    type: string
                                    const: watch
                                  temporalScheduleWorkflowId:
                                    type: string
                                  meta:
                                    type: object
                                    propertyNames:
                                      type: string
                                    additionalProperties: {}
                                required:
                                  - type
                                  - temporalScheduleWorkflowId
                                additionalProperties: false
                              - type: object
                                properties:
                                  type:
                                    type: string
                                    const: realtime
                                required:
                                  - type
                                additionalProperties: false
                              - type: object
                                properties:
                                  type:
                                    type: string
                                    const: cron
                                  cron:
                                    type: string
                                  temporalScheduleWorkflowId:
                                    type: string
                                required:
                                  - type
                                  - cron
                                  - temporalScheduleWorkflowId
                                additionalProperties: false
                              - type: object
                                properties:
                                  type:
                                    type: string
                                    const: dbt
                                  jobId:
                                    type: string
                                required:
                                  - type
                                  - jobId
                                additionalProperties: false
                              - type: object
                                properties:
                                  type:
                                    type: string
                                    const: dependency
                                  playUuid:
                                    type: string
                                required:
                                  - type
                                  - playUuid
                                additionalProperties: false
                          - type: 'null'
                      isEnabled:
                        type: boolean
                      healthThreshold:
                        type: number
                      healthAlertActions:
                        type: array
                        items:
                          allOf:
                            - type: object
                              properties:
                                config:
                                  type: object
                                  propertyNames:
                                    type: string
                                  additionalProperties: {}
                                retry:
                                  type: object
                                  properties:
                                    maximumAttempts:
                                      type: number
                                    initialInterval:
                                      type: number
                                    backoffCoefficient:
                                      type: number
                                  additionalProperties: false
                              required:
                                - config
                              additionalProperties: false
                            - anyOf:
                                - type: object
                                  properties:
                                    kind:
                                      type: string
                                      enum:
                                        - native
                                    actionSlug:
                                      type: string
                                  required:
                                    - kind
                                    - actionSlug
                                  additionalProperties: false
                                - type: object
                                  properties:
                                    kind:
                                      type: string
                                      enum:
                                        - connector
                                    connectorUuid:
                                      type: string
                                    integrationSlug:
                                      type: string
                                    actionSlug:
                                      type: string
                                  required:
                                    - kind
                                    - integrationSlug
                                    - actionSlug
                                  additionalProperties: false
                                - type: object
                                  properties:
                                    kind:
                                      type: string
                                      enum:
                                        - tool
                                    toolUuid:
                                      type: string
                                    templateSlug:
                                      type: string
                                    releaseUuid:
                                      type: string
                                    waitUntilFinished:
                                      type: boolean
                                  required:
                                    - kind
                                  additionalProperties: false
                                - type: object
                                  properties:
                                    kind:
                                      type: string
                                      enum:
                                        - agent
                                    agentUuid:
                                      type: string
                                    templateSlug:
                                      type: string
                                    releaseUuid:
                                      type: string
                                    waitUntilFinished:
                                      type: boolean
                                  required:
                                    - kind
                                  additionalProperties: false
                      folderUuid:
                        anyOf:
                          - type: string
                          - type: 'null'
                      createdAt:
                        type: string
                      updatedAt:
                        type: string
                      deletedAt:
                        anyOf:
                          - type: string
                          - type: 'null'
                    required:
                      - uuid
                      - workspaceUuid
                      - workflowUuid
                      - userUuid
                      - modelUuid
                      - segmentUuid
                      - changeKinds
                      - runCreationRule
                      - name
                      - description
                      - schedule
                      - isEnabled
                      - healthThreshold
                      - healthAlertActions
                      - folderUuid
                      - createdAt
                      - updatedAt
                      - deletedAt
                    additionalProperties: false
                    title: Play
                    description: Play details.
                required:
                  - play
                additionalProperties: false
        '400':
          description: Bad request
        '401':
          description: Unauthorized
        '404':
          description: Not found
        '500':
          description: Internal server error
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````