# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for OpenAI Containers API
  version: 1.0.0
extends: openapi/openai-containers-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 9
- target: $.paths['/containers'].get
  update:
    x-apievangelist-phrasing:
      intent: List my code containers
      effect: read
      questions:
      - Which containers do I have running for code execution?
      - Can I find a container by its name?
      instructions:
      - text: List my containers.
      - text: Find containers named {name}.
        slots:
          name: query.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/containers'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a container for running code
      effect: write
      questions:
      - How do I spin up a new container for code execution?
      - Can I preload files into a container when I create it?
      - Is there a way to set a memory limit or expiry on a new container?
      instructions:
      - text: Create a container named {name}.
        slots:
          name: requestBody.name
      - text: Create container {name} preloaded with files {file_ids}.
        slots:
          name: requestBody.name
          file_ids: requestBody.file_ids
      - text: Spin up container {name} with a {memory_limit} memory limit.
        slots:
          name: requestBody.name
          memory_limit: requestBody.memory_limit
      method: generated
      generated: '2026-09-26'
- target: $.paths['/containers/{container_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a container's details
      effect: read
      questions:
      - What is the status of a particular container?
      - Can I look up a container's settings by its ID?
      instructions:
      - text: Show container {container_id}.
        slots:
          container_id: path.container_id
      - text: Check the status of container {container_id}.
        slots:
          container_id: path.container_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/containers/{container_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a container
      effect: destructive
      questions:
      - How do I shut down and delete a container I'm done with?
      - Can I remove a container entirely?
      instructions:
      - text: Delete container {container_id}.
        slots:
          container_id: path.container_id
      - text: Tear down container {container_id}.
        slots:
          container_id: path.container_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/containers/{container_id}/files'].get
  update:
    x-apievangelist-phrasing:
      intent: List files inside a container
      effect: read
      questions:
      - What files are inside one of my containers?
      - Can I page through a container's files newest first?
      instructions:
      - text: List the files in container {container_id}.
        slots:
          container_id: path.container_id
      - text: Show {limit} files from container {container_id}.
        slots:
          limit: query.limit
          container_id: path.container_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/containers/{container_id}/files'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a file to a container
      effect: write
      questions:
      - How do I put a file into a container so code can read it?
      - Can I copy an already-uploaded file into a container by its file ID?
      instructions:
      - text: Copy file {file_id} into container {container_id}.
        slots:
          file_id: requestBody.file_id
          container_id: path.container_id
      - text: Upload {file} to container {container_id}.
        slots:
          file: requestBody.file
          container_id: path.container_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/containers/{container_id}/files/{file_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get metadata for a file in a container
      effect: read
      questions:
      - What are the path and size of a file inside a container?
      - Can I look up a single container file's details?
      instructions:
      - text: Show file {file_id} in container {container_id}.
        slots:
          file_id: path.file_id
          container_id: path.container_id
      - text: Get the metadata of container {container_id}'s file {file_id}.
        slots:
          container_id: path.container_id
          file_id: path.file_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/containers/{container_id}/files/{file_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a file from a container
      effect: destructive
      questions:
      - How do I remove one file from a container?
      - Can I delete a container file without deleting the container?
      instructions:
      - text: Delete file {file_id} from container {container_id}.
        slots:
          file_id: path.file_id
          container_id: path.container_id
      - text: Remove {file_id} from container {container_id}.
        slots:
          file_id: path.file_id
          container_id: path.container_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/containers/{container_id}/files/{file_id}/content'].get
  update:
    x-apievangelist-phrasing:
      intent: Download the contents of a container file
      effect: read
      questions:
      - How do I download a file that my code produced inside a container?
      - Can I read the raw bytes of a container file?
      instructions:
      - text: Download the contents of file {file_id} in container {container_id}.
        slots:
          file_id: path.file_id
          container_id: path.container_id
      - text: Get the raw content of container {container_id}'s file {file_id}.
        slots:
          container_id: path.container_id
          file_id: path.file_id
      method: generated
      generated: '2026-09-26'