Oracle Cloud Infrastructure Documentation

Container Files API

The Containers API lets agents upload, persist, and retrieve files within a secure, sandboxed container environment.

This localized file system keeps datasets and generated outputs (such as charts or logs) available across several steps of a task, enabling seamless multi-stage workflows and programmatic data exchange without manually passing content between steps.

Note

The Container Files API uses the same format as the OpenAI Container Files API. See OpenAI Container Files API documentation.

Creating a Container File

POST/containers/{container_id}/files

Reference

Create container file

Example:

# create container file
container_file = client.containers.files.create(
    container_id="container_id",
    file=open("data.csv", "rb"),
)
print(container_file.id)

Listing Container Files

GET/containers/{container_id}/files

Reference

List container files

Example:

# list container files
page = client.containers.files.list(
    container_id="container_id",
)
page = page.data[0]
print(page.id)

Retrieving Container File Information

GET/containers/{container_id}/files/{file_id}

Reference

Retrieve container

Example:

# retrieve container file content
content = client.containers.files.content.retrieve(
    file_id="file_id",
    container_id="container_id",
)
print(content)
data = content.read()
print(data)

Deleting a Container File

DELETE/containers/{container_id}/files/{file_id}

Reference

Delete container

Example:

# delete container file
client.containers.files.delete(
    file_id="file_id",
    container_id="container_id",
)