Containers

List containers

containers.list(**kwargs) -> CursorPage<ContainerListResponse>

get /containers

List containers

Parameters

after: String

A cursor for use in pagination. after is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include after=obj_foo in order to fetch the next page of the list.
limit: Integer

A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 20.
name: String

Filter results by container name.
order: :asc | :desc

Sort order by the created_at timestamp of the objects. asc for ascending order and desc for descending order.
- :asc
- :desc

Returns

class ContainerListResponse
- id: String
  
  Unique identifier for the container.
- created_at: Integer
  
  Unix timestamp (in seconds) when the container was created.
- name: String
  
  Name of the container.
- object: String
  
  The type of this object.
- status: String
  
  Status of the container (e.g., active, deleted).
- expires_after: ExpiresAfter{ anchor, minutes}
  
  The container will expire after this time period. The anchor is the reference point for the expiration. The minutes is the number of minutes after the anchor before the container expires.
  - anchor: :last_active_at
    
    The reference point for the expiration.
    - :last_active_at
  - minutes: Integer
    
    The number of minutes after the anchor before the container expires.
- last_active_at: Integer
  
  Unix timestamp (in seconds) when the container was last active.
- memory_limit: :"1g" | :"4g" | :"16g" | :"64g"
  
  The memory limit configured for the container.
  - :"1g"
  - :"4g"
  - :"16g"
  - :"64g"
- network_policy: NetworkPolicy{ type, allowed_domains}
  
  Network access policy for the container.
  - type: :allowlist | :disabled
    
    The network policy mode.
    - :allowlist
    - :disabled
  - allowed_domains: Array[String]
    
    Allowed outbound domains when type is allowlist.

Example

require "openai"

openai = OpenAI::Client.new(api_key: "My API Key")

page = openai.containers.list

puts(page)

Response

{
  "data": [
    {
      "id": "id",
      "created_at": 0,
      "name": "name",
      "object": "object",
      "status": "status",
      "expires_after": {
        "anchor": "last_active_at",
        "minutes": 0
      },
      "last_active_at": 0,
      "memory_limit": "1g",
      "network_policy": {
        "type": "allowlist",
        "allowed_domains": [
          "string"
        ]
      }
    }
  ],
  "first_id": "first_id",
  "has_more": true,
  "last_id": "last_id",
  "object": "list"
}

Create container

containers.create(**kwargs) -> ContainerCreateResponse

post /containers

Create container

Parameters

name: String

Name of the container to create.
expires_after: ExpiresAfter{ anchor, minutes}

Container expiration time in seconds relative to the 'anchor' time.
- anchor: :last_active_at
  
  Time anchor for the expiration time. Currently only 'last_active_at' is supported.
  - :last_active_at
- minutes: Integer
file_ids: Array[String]

IDs of files to copy to the container.
memory_limit: :"1g" | :"4g" | :"16g" | :"64g"

Optional memory limit for the container. Defaults to "1g".
- :"1g"
- :"4g"
- :"16g"
- :"64g"
network_policy: ContainerNetworkPolicyDisabled | ContainerNetworkPolicyAllowlist

Network access policy for the container.
- class ContainerNetworkPolicyDisabled
  - type: :disabled
    
    Disable outbound network access. Always disabled.
    - :disabled
- class ContainerNetworkPolicyAllowlist
  - allowed_domains: Array[String]
    
    A list of allowed domains when type is allowlist.
  - type: :allowlist
    
    Allow outbound network access only to specified domains. Always allowlist.
    - :allowlist
  - domain_secrets: Array[ContainerNetworkPolicyDomainSecret]
    
    Optional domain-scoped secrets for allowlisted domains.
    - domain: String
      
      The domain associated with the secret.
    - name: String
      
      The name of the secret to inject for the domain.
    - value: String
      
      The secret value to inject for the domain.
skills: Array[SkillReference | InlineSkill]

An optional list of skills referenced by id or inline data.
- class SkillReference
  - skill_id: String
    
    The ID of the referenced skill.
  - type: :skill_reference
    
    References a skill created with the /v1/skills endpoint.
    - :skill_reference
  - version: String
    
    Optional skill version. Use a positive integer or 'latest'. Omit for default.
- class InlineSkill
  - description: String
    
    The description of the skill.
  - name: String
    
    The name of the skill.
  - source: InlineSkillSource
    
    Inline skill payload
    - data: String
      
      Base64-encoded skill zip bundle.
    - media_type: :"application/zip"
      
      The media type of the inline skill payload. Must be application/zip.
      - :"application/zip"
    - type: :base64
      
      The type of the inline skill source. Must be base64.
      - :base64
  - type: :inline
    
    Defines an inline skill for this request.
    - :inline

Returns

class ContainerCreateResponse
- id: String
  
  Unique identifier for the container.
- created_at: Integer
  
  Unix timestamp (in seconds) when the container was created.
- name: String
  
  Name of the container.
- object: String
  
  The type of this object.
- status: String
  
  Status of the container (e.g., active, deleted).
- expires_after: ExpiresAfter{ anchor, minutes}
  
  The container will expire after this time period. The anchor is the reference point for the expiration. The minutes is the number of minutes after the anchor before the container expires.
  - anchor: :last_active_at
    
    The reference point for the expiration.
    - :last_active_at
  - minutes: Integer
    
    The number of minutes after the anchor before the container expires.
- last_active_at: Integer
  
  Unix timestamp (in seconds) when the container was last active.
- memory_limit: :"1g" | :"4g" | :"16g" | :"64g"
  
  The memory limit configured for the container.
  - :"1g"
  - :"4g"
  - :"16g"
  - :"64g"
- network_policy: NetworkPolicy{ type, allowed_domains}
  
  Network access policy for the container.
  - type: :allowlist | :disabled
    
    The network policy mode.
    - :allowlist
    - :disabled
  - allowed_domains: Array[String]
    
    Allowed outbound domains when type is allowlist.

Example

require "openai"

openai = OpenAI::Client.new(api_key: "My API Key")

container = openai.containers.create(name: "name")

puts(container)

Response

{
  "id": "id",
  "created_at": 0,
  "name": "name",
  "object": "object",
  "status": "status",
  "expires_after": {
    "anchor": "last_active_at",
    "minutes": 0
  },
  "last_active_at": 0,
  "memory_limit": "1g",
  "network_policy": {
    "type": "allowlist",
    "allowed_domains": [
      "string"
    ]
  }
}

Retrieve container

containers.retrieve(container_id) -> ContainerRetrieveResponse

get /containers/{container_id}

Retrieve container

Parameters

container_id: String

Returns

class ContainerRetrieveResponse
- id: String
  
  Unique identifier for the container.
- created_at: Integer
  
  Unix timestamp (in seconds) when the container was created.
- name: String
  
  Name of the container.
- object: String
  
  The type of this object.
- status: String
  
  Status of the container (e.g., active, deleted).
- expires_after: ExpiresAfter{ anchor, minutes}
  
  The container will expire after this time period. The anchor is the reference point for the expiration. The minutes is the number of minutes after the anchor before the container expires.
  - anchor: :last_active_at
    
    The reference point for the expiration.
    - :last_active_at
  - minutes: Integer
    
    The number of minutes after the anchor before the container expires.
- last_active_at: Integer
  
  Unix timestamp (in seconds) when the container was last active.
- memory_limit: :"1g" | :"4g" | :"16g" | :"64g"
  
  The memory limit configured for the container.
  - :"1g"
  - :"4g"
  - :"16g"
  - :"64g"
- network_policy: NetworkPolicy{ type, allowed_domains}
  
  Network access policy for the container.
  - type: :allowlist | :disabled
    
    The network policy mode.
    - :allowlist
    - :disabled
  - allowed_domains: Array[String]
    
    Allowed outbound domains when type is allowlist.

Example

require "openai"

openai = OpenAI::Client.new(api_key: "My API Key")

container = openai.containers.retrieve("container_id")

puts(container)

Response

{
  "id": "id",
  "created_at": 0,
  "name": "name",
  "object": "object",
  "status": "status",
  "expires_after": {
    "anchor": "last_active_at",
    "minutes": 0
  },
  "last_active_at": 0,
  "memory_limit": "1g",
  "network_policy": {
    "type": "allowlist",
    "allowed_domains": [
      "string"
    ]
  }
}

Delete a container

containers.delete(container_id) -> void

delete /containers/{container_id}

Delete a container

Parameters

container_id: String

Example

require "openai"

openai = OpenAI::Client.new(api_key: "My API Key")

result = openai.containers.delete("container_id")

puts(result)

Domain Types

Container List Response

class ContainerListResponse
- id: String
  
  Unique identifier for the container.
- created_at: Integer
  
  Unix timestamp (in seconds) when the container was created.
- name: String
  
  Name of the container.
- object: String
  
  The type of this object.
- status: String
  
  Status of the container (e.g., active, deleted).
- expires_after: ExpiresAfter{ anchor, minutes}
  
  The container will expire after this time period. The anchor is the reference point for the expiration. The minutes is the number of minutes after the anchor before the container expires.
  - anchor: :last_active_at
    
    The reference point for the expiration.
    - :last_active_at
  - minutes: Integer
    
    The number of minutes after the anchor before the container expires.
- last_active_at: Integer
  
  Unix timestamp (in seconds) when the container was last active.
- memory_limit: :"1g" | :"4g" | :"16g" | :"64g"
  
  The memory limit configured for the container.
  - :"1g"
  - :"4g"
  - :"16g"
  - :"64g"
- network_policy: NetworkPolicy{ type, allowed_domains}
  
  Network access policy for the container.
  - type: :allowlist | :disabled
    
    The network policy mode.
    - :allowlist
    - :disabled
  - allowed_domains: Array[String]
    
    Allowed outbound domains when type is allowlist.

Container Create Response

class ContainerCreateResponse
- id: String
  
  Unique identifier for the container.
- created_at: Integer
  
  Unix timestamp (in seconds) when the container was created.
- name: String
  
  Name of the container.
- object: String
  
  The type of this object.
- status: String
  
  Status of the container (e.g., active, deleted).
- expires_after: ExpiresAfter{ anchor, minutes}
  
  The container will expire after this time period. The anchor is the reference point for the expiration. The minutes is the number of minutes after the anchor before the container expires.
  - anchor: :last_active_at
    
    The reference point for the expiration.
    - :last_active_at
  - minutes: Integer
    
    The number of minutes after the anchor before the container expires.
- last_active_at: Integer
  
  Unix timestamp (in seconds) when the container was last active.
- memory_limit: :"1g" | :"4g" | :"16g" | :"64g"
  
  The memory limit configured for the container.
  - :"1g"
  - :"4g"
  - :"16g"
  - :"64g"
- network_policy: NetworkPolicy{ type, allowed_domains}
  
  Network access policy for the container.
  - type: :allowlist | :disabled
    
    The network policy mode.
    - :allowlist
    - :disabled
  - allowed_domains: Array[String]
    
    Allowed outbound domains when type is allowlist.

Container Retrieve Response

class ContainerRetrieveResponse
- id: String
  
  Unique identifier for the container.
- created_at: Integer
  
  Unix timestamp (in seconds) when the container was created.
- name: String
  
  Name of the container.
- object: String
  
  The type of this object.
- status: String
  
  Status of the container (e.g., active, deleted).
- expires_after: ExpiresAfter{ anchor, minutes}
  
  The container will expire after this time period. The anchor is the reference point for the expiration. The minutes is the number of minutes after the anchor before the container expires.
  - anchor: :last_active_at
    
    The reference point for the expiration.
    - :last_active_at
  - minutes: Integer
    
    The number of minutes after the anchor before the container expires.
- last_active_at: Integer
  
  Unix timestamp (in seconds) when the container was last active.
- memory_limit: :"1g" | :"4g" | :"16g" | :"64g"
  
  The memory limit configured for the container.
  - :"1g"
  - :"4g"
  - :"16g"
  - :"64g"
- network_policy: NetworkPolicy{ type, allowed_domains}
  
  Network access policy for the container.
  - type: :allowlist | :disabled
    
    The network policy mode.
    - :allowlist
    - :disabled
  - allowed_domains: Array[String]
    
    Allowed outbound domains when type is allowlist.

Files

List container files

containers.files.list(container_id, **kwargs) -> CursorPage<FileListResponse>

get /containers/{container_id}/files

List container files

Parameters

container_id: String
after: String

A cursor for use in pagination. after is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include after=obj_foo in order to fetch the next page of the list.
limit: Integer

A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 20.
order: :asc | :desc

Sort order by the created_at timestamp of the objects. asc for ascending order and desc for descending order.
- :asc
- :desc

Returns

class FileListResponse
- id: String
  
  Unique identifier for the file.
- bytes: Integer
  
  Size of the file in bytes.
- container_id: String
  
  The container this file belongs to.
- created_at: Integer
  
  Unix timestamp (in seconds) when the file was created.
- object: :"container.file"
  
  The type of this object (container.file).
  - :"container.file"
- path: String
  
  Path of the file in the container.
- source: String
  
  Source of the file (e.g., user, assistant).

Example

require "openai"

openai = OpenAI::Client.new(api_key: "My API Key")

page = openai.containers.files.list("container_id")

puts(page)

Response

{
  "data": [
    {
      "id": "id",
      "bytes": 0,
      "container_id": "container_id",
      "created_at": 0,
      "object": "container.file",
      "path": "path",
      "source": "source"
    }
  ],
  "first_id": "first_id",
  "has_more": true,
  "last_id": "last_id",
  "object": "list"
}

Create container file

containers.files.create(container_id, **kwargs) -> FileCreateResponse

post /containers/{container_id}/files

Create container file

Parameters

container_id: String
file: String

The File object (not file name) to be uploaded.
file_id: String

Name of the file to create.

Returns

class FileCreateResponse
- id: String
  
  Unique identifier for the file.
- bytes: Integer
  
  Size of the file in bytes.
- container_id: String
  
  The container this file belongs to.
- created_at: Integer
  
  Unix timestamp (in seconds) when the file was created.
- object: :"container.file"
  
  The type of this object (container.file).
  - :"container.file"
- path: String
  
  Path of the file in the container.
- source: String
  
  Source of the file (e.g., user, assistant).

Example

require "openai"

openai = OpenAI::Client.new(api_key: "My API Key")

file = openai.containers.files.create("container_id")

puts(file)

Response

{
  "id": "id",
  "bytes": 0,
  "container_id": "container_id",
  "created_at": 0,
  "object": "container.file",
  "path": "path",
  "source": "source"
}

Retrieve container file

containers.files.retrieve(file_id, **kwargs) -> FileRetrieveResponse

get /containers/{container_id}/files/{file_id}

Retrieve container file

Parameters

container_id: String
file_id: String

Returns

class FileRetrieveResponse
- id: String
  
  Unique identifier for the file.
- bytes: Integer
  
  Size of the file in bytes.
- container_id: String
  
  The container this file belongs to.
- created_at: Integer
  
  Unix timestamp (in seconds) when the file was created.
- object: :"container.file"
  
  The type of this object (container.file).
  - :"container.file"
- path: String
  
  Path of the file in the container.
- source: String
  
  Source of the file (e.g., user, assistant).

Example

require "openai"

openai = OpenAI::Client.new(api_key: "My API Key")

file = openai.containers.files.retrieve("file_id", container_id: "container_id")

puts(file)

Response

{
  "id": "id",
  "bytes": 0,
  "container_id": "container_id",
  "created_at": 0,
  "object": "container.file",
  "path": "path",
  "source": "source"
}

Delete a container file

containers.files.delete(file_id, **kwargs) -> void

delete /containers/{container_id}/files/{file_id}

Delete a container file

Parameters

container_id: String
file_id: String

Example

require "openai"

openai = OpenAI::Client.new(api_key: "My API Key")

result = openai.containers.files.delete("file_id", container_id: "container_id")

puts(result)

Domain Types

File List Response

class FileListResponse
- id: String
  
  Unique identifier for the file.
- bytes: Integer
  
  Size of the file in bytes.
- container_id: String
  
  The container this file belongs to.
- created_at: Integer
  
  Unix timestamp (in seconds) when the file was created.
- object: :"container.file"
  
  The type of this object (container.file).
  - :"container.file"
- path: String
  
  Path of the file in the container.
- source: String
  
  Source of the file (e.g., user, assistant).

File Create Response

class FileCreateResponse
- id: String
  
  Unique identifier for the file.
- bytes: Integer
  
  Size of the file in bytes.
- container_id: String
  
  The container this file belongs to.
- created_at: Integer
  
  Unix timestamp (in seconds) when the file was created.
- object: :"container.file"
  
  The type of this object (container.file).
  - :"container.file"
- path: String
  
  Path of the file in the container.
- source: String
  
  Source of the file (e.g., user, assistant).

File Retrieve Response

class FileRetrieveResponse
- id: String
  
  Unique identifier for the file.
- bytes: Integer
  
  Size of the file in bytes.
- container_id: String
  
  The container this file belongs to.
- created_at: Integer
  
  Unix timestamp (in seconds) when the file was created.
- object: :"container.file"
  
  The type of this object (container.file).
  - :"container.file"
- path: String
  
  Path of the file in the container.
- source: String
  
  Source of the file (e.g., user, assistant).

Content

Retrieve container file content

containers.files.content.retrieve(file_id, **kwargs) -> StringIO

get /containers/{container_id}/files/{file_id}/content

Retrieve container file content

Parameters

container_id: String
file_id: String

Returns

StringIO

Example

require "openai"

openai = OpenAI::Client.new(api_key: "My API Key")

content = openai.containers.files.content.retrieve("file_id", container_id: "container_id")

puts(content)

ruby/resources/containers/index.md +1169 −0 created

1# Containers

3## List containers

5`containers.list(**kwargs) -> CursorPage<ContainerListResponse>`

7**get** `/containers`

9List containers

11### Parameters

13- `after: String`

15 A cursor for use in pagination. `after` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include after=obj_foo in order to fetch the next page of the list.

17- `limit: Integer`

19 A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 20.

21- `name: String`

23 Filter results by container name.

25- `order: :asc | :desc`

27 Sort order by the `created_at` timestamp of the objects. `asc` for ascending order and `desc` for descending order.

29 - `:asc`

31 - `:desc`

33### Returns

35- `class ContainerListResponse`

37 - `id: String`

39 Unique identifier for the container.

41 - `created_at: Integer`

43 Unix timestamp (in seconds) when the container was created.

45 - `name: String`

47 Name of the container.

49 - `object: String`

51 The type of this object.

53 - `status: String`

55 Status of the container (e.g., active, deleted).

57 - `expires_after: ExpiresAfter{ anchor, minutes}`

59 The container will expire after this time period.

60 The anchor is the reference point for the expiration.

61 The minutes is the number of minutes after the anchor before the container expires.

63 - `anchor: :last_active_at`

65 The reference point for the expiration.

67 - `:last_active_at`

69 - `minutes: Integer`

71 The number of minutes after the anchor before the container expires.

73 - `last_active_at: Integer`

75 Unix timestamp (in seconds) when the container was last active.

77 - `memory_limit: :"1g" | :"4g" | :"16g" | :"64g"`

79 The memory limit configured for the container.

81 - `:"1g"`

83 - `:"4g"`

85 - `:"16g"`

87 - `:"64g"`

89 - `network_policy: NetworkPolicy{ type, allowed_domains}`

91 Network access policy for the container.

93 - `type: :allowlist | :disabled`

95 The network policy mode.

97 - `:allowlist`

99 - `:disabled`

100

101 - `allowed_domains: Array[String]`

102

103 Allowed outbound domains when `type` is `allowlist`.

104

105### Example

106

107```ruby

108require "openai"

109

110openai = OpenAI::Client.new(api_key: "My API Key")

111

112page = openai.containers.list

113

114puts(page)

115```

116

117#### Response

118

119```json

120{

121 "data": [

122 {

123 "id": "id",

124 "created_at": 0,

125 "name": "name",

126 "object": "object",

127 "status": "status",

128 "expires_after": {

129 "anchor": "last_active_at",

130 "minutes": 0

131 },

132 "last_active_at": 0,

133 "memory_limit": "1g",

134 "network_policy": {

135 "type": "allowlist",

136 "allowed_domains": [

137 "string"

138 ]

139 }

140 }

141 ],

142 "first_id": "first_id",

143 "has_more": true,

144 "last_id": "last_id",

145 "object": "list"

146}

147```

148

149## Create container

150

151`containers.create(**kwargs) -> ContainerCreateResponse`

152

153**post** `/containers`

154

155Create container

156

157### Parameters

158

159- `name: String`

160

161 Name of the container to create.

162

163- `expires_after: ExpiresAfter{ anchor, minutes}`

164

165 Container expiration time in seconds relative to the 'anchor' time.

166

167 - `anchor: :last_active_at`

168

169 Time anchor for the expiration time. Currently only 'last_active_at' is supported.

170

171 - `:last_active_at`

172

173 - `minutes: Integer`

174

175- `file_ids: Array[String]`

176

177 IDs of files to copy to the container.

178

179- `memory_limit: :"1g" | :"4g" | :"16g" | :"64g"`

180

181 Optional memory limit for the container. Defaults to "1g".

182

183 - `:"1g"`

184

185 - `:"4g"`

186

187 - `:"16g"`

188

189 - `:"64g"`

190

191- `network_policy: ContainerNetworkPolicyDisabled | ContainerNetworkPolicyAllowlist`

192

193 Network access policy for the container.

194

195 - `class ContainerNetworkPolicyDisabled`

196

197 - `type: :disabled`

198

199 Disable outbound network access. Always `disabled`.

200

201 - `:disabled`

202

203 - `class ContainerNetworkPolicyAllowlist`

204

205 - `allowed_domains: Array[String]`

206

207 A list of allowed domains when type is `allowlist`.

208

209 - `type: :allowlist`

210

211 Allow outbound network access only to specified domains. Always `allowlist`.

212

213 - `:allowlist`

214

215 - `domain_secrets: Array[ContainerNetworkPolicyDomainSecret]`

216

217 Optional domain-scoped secrets for allowlisted domains.

218

219 - `domain: String`

220

221 The domain associated with the secret.

222

223 - `name: String`

224

225 The name of the secret to inject for the domain.

226

227 - `value: String`

228

229 The secret value to inject for the domain.

230

231- `skills: Array[SkillReference | InlineSkill]`

232

233 An optional list of skills referenced by id or inline data.

234

235 - `class SkillReference`

236

237 - `skill_id: String`

238

239 The ID of the referenced skill.

240

241 - `type: :skill_reference`

242

243 References a skill created with the /v1/skills endpoint.

244

245 - `:skill_reference`

246

247 - `version: String`

248

249 Optional skill version. Use a positive integer or 'latest'. Omit for default.

250

251 - `class InlineSkill`

252

253 - `description: String`

254

255 The description of the skill.

256

257 - `name: String`

258

259 The name of the skill.

260

261 - `source: InlineSkillSource`

262

263 Inline skill payload

264

265 - `data: String`

266

267 Base64-encoded skill zip bundle.

268

269 - `media_type: :"application/zip"`

270

271 The media type of the inline skill payload. Must be `application/zip`.

272

273 - `:"application/zip"`

274

275 - `type: :base64`

276

277 The type of the inline skill source. Must be `base64`.

278

279 - `:base64`

280

281 - `type: :inline`

282

283 Defines an inline skill for this request.

284

285 - `:inline`

286

287### Returns

288

289- `class ContainerCreateResponse`

290

291 - `id: String`

292

293 Unique identifier for the container.

294

295 - `created_at: Integer`

296

297 Unix timestamp (in seconds) when the container was created.

298

299 - `name: String`

300

301 Name of the container.

302

303 - `object: String`

304

305 The type of this object.

306

307 - `status: String`

308

309 Status of the container (e.g., active, deleted).

310

311 - `expires_after: ExpiresAfter{ anchor, minutes}`

312

313 The container will expire after this time period.

314 The anchor is the reference point for the expiration.

315 The minutes is the number of minutes after the anchor before the container expires.

316

317 - `anchor: :last_active_at`

318

319 The reference point for the expiration.

320

321 - `:last_active_at`

322

323 - `minutes: Integer`

324

325 The number of minutes after the anchor before the container expires.

326

327 - `last_active_at: Integer`

328

329 Unix timestamp (in seconds) when the container was last active.

330

331 - `memory_limit: :"1g" | :"4g" | :"16g" | :"64g"`

332

333 The memory limit configured for the container.

334

335 - `:"1g"`

336

337 - `:"4g"`

338

339 - `:"16g"`

340

341 - `:"64g"`

342

343 - `network_policy: NetworkPolicy{ type, allowed_domains}`

344

345 Network access policy for the container.

346

347 - `type: :allowlist | :disabled`

348

349 The network policy mode.

350

351 - `:allowlist`

352

353 - `:disabled`

354

355 - `allowed_domains: Array[String]`

356

357 Allowed outbound domains when `type` is `allowlist`.

358

359### Example

360

361```ruby

362require "openai"

363

364openai = OpenAI::Client.new(api_key: "My API Key")

365

366container = openai.containers.create(name: "name")

367

368puts(container)

369```

370

371#### Response

372

373```json

374{

375 "id": "id",

376 "created_at": 0,

377 "name": "name",

378 "object": "object",

379 "status": "status",

380 "expires_after": {

381 "anchor": "last_active_at",

382 "minutes": 0

383 },

384 "last_active_at": 0,

385 "memory_limit": "1g",

386 "network_policy": {

387 "type": "allowlist",

388 "allowed_domains": [

389 "string"

390 ]

391 }

392}

393```

394

395## Retrieve container

396

397`containers.retrieve(container_id) -> ContainerRetrieveResponse`

398

399**get** `/containers/{container_id}`

400

401Retrieve container

402

403### Parameters

404

405- `container_id: String`

406

407### Returns

408

409- `class ContainerRetrieveResponse`

410

411 - `id: String`

412

413 Unique identifier for the container.

414

415 - `created_at: Integer`

416

417 Unix timestamp (in seconds) when the container was created.

418

419 - `name: String`

420

421 Name of the container.

422

423 - `object: String`

424

425 The type of this object.

426

427 - `status: String`

428

429 Status of the container (e.g., active, deleted).

430

431 - `expires_after: ExpiresAfter{ anchor, minutes}`

432

433 The container will expire after this time period.

434 The anchor is the reference point for the expiration.

435 The minutes is the number of minutes after the anchor before the container expires.

436

437 - `anchor: :last_active_at`

438

439 The reference point for the expiration.

440

441 - `:last_active_at`

442

443 - `minutes: Integer`

444

445 The number of minutes after the anchor before the container expires.

446

447 - `last_active_at: Integer`

448

449 Unix timestamp (in seconds) when the container was last active.

450

451 - `memory_limit: :"1g" | :"4g" | :"16g" | :"64g"`

452

453 The memory limit configured for the container.

454

455 - `:"1g"`

456

457 - `:"4g"`

458

459 - `:"16g"`

460

461 - `:"64g"`

462

463 - `network_policy: NetworkPolicy{ type, allowed_domains}`

464

465 Network access policy for the container.

466

467 - `type: :allowlist | :disabled`

468

469 The network policy mode.

470

471 - `:allowlist`

472

473 - `:disabled`

474

475 - `allowed_domains: Array[String]`

476

477 Allowed outbound domains when `type` is `allowlist`.

478

479### Example

480

481```ruby

482require "openai"

483

484openai = OpenAI::Client.new(api_key: "My API Key")

485

486container = openai.containers.retrieve("container_id")

487

488puts(container)

489```

490

491#### Response

492

493```json

494{

495 "id": "id",

496 "created_at": 0,

497 "name": "name",

498 "object": "object",

499 "status": "status",

500 "expires_after": {

501 "anchor": "last_active_at",

502 "minutes": 0

503 },

504 "last_active_at": 0,

505 "memory_limit": "1g",

506 "network_policy": {

507 "type": "allowlist",

508 "allowed_domains": [

509 "string"

510 ]

511 }

512}

513```

514

515## Delete a container

516

517`containers.delete(container_id) -> void`

518

519**delete** `/containers/{container_id}`

520

521Delete a container

522

523### Parameters

524

525- `container_id: String`

526

527### Example

528

529```ruby

530require "openai"

531

532openai = OpenAI::Client.new(api_key: "My API Key")

533

534result = openai.containers.delete("container_id")

535

536puts(result)

537```

538

539## Domain Types

540

541### Container List Response

542

543- `class ContainerListResponse`

544

545 - `id: String`

546

547 Unique identifier for the container.

548

549 - `created_at: Integer`

550

551 Unix timestamp (in seconds) when the container was created.

552

553 - `name: String`

554

555 Name of the container.

556

557 - `object: String`

558

559 The type of this object.

560

561 - `status: String`

562

563 Status of the container (e.g., active, deleted).

564

565 - `expires_after: ExpiresAfter{ anchor, minutes}`

566

567 The container will expire after this time period.

568 The anchor is the reference point for the expiration.

569 The minutes is the number of minutes after the anchor before the container expires.

570

571 - `anchor: :last_active_at`

572

573 The reference point for the expiration.

574

575 - `:last_active_at`

576

577 - `minutes: Integer`

578

579 The number of minutes after the anchor before the container expires.

580

581 - `last_active_at: Integer`

582

583 Unix timestamp (in seconds) when the container was last active.

584

585 - `memory_limit: :"1g" | :"4g" | :"16g" | :"64g"`

586

587 The memory limit configured for the container.

588

589 - `:"1g"`

590

591 - `:"4g"`

592

593 - `:"16g"`

594

595 - `:"64g"`

596

597 - `network_policy: NetworkPolicy{ type, allowed_domains}`

598

599 Network access policy for the container.

600

601 - `type: :allowlist | :disabled`

602

603 The network policy mode.

604

605 - `:allowlist`

606

607 - `:disabled`

608

609 - `allowed_domains: Array[String]`

610

611 Allowed outbound domains when `type` is `allowlist`.

612

613### Container Create Response

614

615- `class ContainerCreateResponse`

616

617 - `id: String`

618

619 Unique identifier for the container.

620

621 - `created_at: Integer`

622

623 Unix timestamp (in seconds) when the container was created.

624

625 - `name: String`

626

627 Name of the container.

628

629 - `object: String`

630

631 The type of this object.

632

633 - `status: String`

634

635 Status of the container (e.g., active, deleted).

636

637 - `expires_after: ExpiresAfter{ anchor, minutes}`

638

639 The container will expire after this time period.

640 The anchor is the reference point for the expiration.

641 The minutes is the number of minutes after the anchor before the container expires.

642

643 - `anchor: :last_active_at`

644

645 The reference point for the expiration.

646

647 - `:last_active_at`

648

649 - `minutes: Integer`

650

651 The number of minutes after the anchor before the container expires.

652

653 - `last_active_at: Integer`

654

655 Unix timestamp (in seconds) when the container was last active.

656

657 - `memory_limit: :"1g" | :"4g" | :"16g" | :"64g"`

658

659 The memory limit configured for the container.

660

661 - `:"1g"`

662

663 - `:"4g"`

664

665 - `:"16g"`

666

667 - `:"64g"`

668

669 - `network_policy: NetworkPolicy{ type, allowed_domains}`

670

671 Network access policy for the container.

672

673 - `type: :allowlist | :disabled`

674

675 The network policy mode.

676

677 - `:allowlist`

678

679 - `:disabled`

680

681 - `allowed_domains: Array[String]`

682

683 Allowed outbound domains when `type` is `allowlist`.

684

685### Container Retrieve Response

686

687- `class ContainerRetrieveResponse`

688

689 - `id: String`

690

691 Unique identifier for the container.

692

693 - `created_at: Integer`

694

695 Unix timestamp (in seconds) when the container was created.

696

697 - `name: String`

698

699 Name of the container.

700

701 - `object: String`

702

703 The type of this object.

704

705 - `status: String`

706

707 Status of the container (e.g., active, deleted).

708

709 - `expires_after: ExpiresAfter{ anchor, minutes}`

710

711 The container will expire after this time period.

712 The anchor is the reference point for the expiration.

713 The minutes is the number of minutes after the anchor before the container expires.

714

715 - `anchor: :last_active_at`

716

717 The reference point for the expiration.

718

719 - `:last_active_at`

720

721 - `minutes: Integer`

722

723 The number of minutes after the anchor before the container expires.

724

725 - `last_active_at: Integer`

726

727 Unix timestamp (in seconds) when the container was last active.

728

729 - `memory_limit: :"1g" | :"4g" | :"16g" | :"64g"`

730

731 The memory limit configured for the container.

732

733 - `:"1g"`

734

735 - `:"4g"`

736

737 - `:"16g"`

738

739 - `:"64g"`

740

741 - `network_policy: NetworkPolicy{ type, allowed_domains}`

742

743 Network access policy for the container.

744

745 - `type: :allowlist | :disabled`

746

747 The network policy mode.

748

749 - `:allowlist`

750

751 - `:disabled`

752

753 - `allowed_domains: Array[String]`

754

755 Allowed outbound domains when `type` is `allowlist`.

756

757# Files

758

759## List container files

760

761`containers.files.list(container_id, **kwargs) -> CursorPage<FileListResponse>`

762

763**get** `/containers/{container_id}/files`

764

765List container files

766

767### Parameters

768

769- `container_id: String`

770

771- `after: String`

772

773 A cursor for use in pagination. `after` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include after=obj_foo in order to fetch the next page of the list.

774

775- `limit: Integer`

776

777 A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 20.

778

779- `order: :asc | :desc`

780

781 Sort order by the `created_at` timestamp of the objects. `asc` for ascending order and `desc` for descending order.

782

783 - `:asc`

784

785 - `:desc`

786

787### Returns

788

789- `class FileListResponse`

790

791 - `id: String`

792

793 Unique identifier for the file.

794

795 - `bytes: Integer`

796

797 Size of the file in bytes.

798

799 - `container_id: String`

800

801 The container this file belongs to.

802

803 - `created_at: Integer`

804

805 Unix timestamp (in seconds) when the file was created.

806

807 - `object: :"container.file"`

808

809 The type of this object (`container.file`).

810

811 - `:"container.file"`

812

813 - `path: String`

814

815 Path of the file in the container.

816

817 - `source: String`

818

819 Source of the file (e.g., `user`, `assistant`).

820

821### Example

822

823```ruby

824require "openai"

825

826openai = OpenAI::Client.new(api_key: "My API Key")

827

828page = openai.containers.files.list("container_id")

829

830puts(page)

831```

832

833#### Response

834

835```json

836{

837 "data": [

838 {

839 "id": "id",

840 "bytes": 0,

841 "container_id": "container_id",

842 "created_at": 0,

843 "object": "container.file",

844 "path": "path",

845 "source": "source"

846 }

847 ],

848 "first_id": "first_id",

849 "has_more": true,

850 "last_id": "last_id",

851 "object": "list"

852}

853```

854

855## Create container file

856

857`containers.files.create(container_id, **kwargs) -> FileCreateResponse`

858

859**post** `/containers/{container_id}/files`

860

861Create container file

862

863### Parameters

864

865- `container_id: String`

866

867- `file: String`

868

869 The File object (not file name) to be uploaded.

870

871- `file_id: String`

872

873 Name of the file to create.

874

875### Returns

876

877- `class FileCreateResponse`

878

879 - `id: String`

880

881 Unique identifier for the file.

882

883 - `bytes: Integer`

884

885 Size of the file in bytes.

886

887 - `container_id: String`

888

889 The container this file belongs to.

890

891 - `created_at: Integer`

892

893 Unix timestamp (in seconds) when the file was created.

894

895 - `object: :"container.file"`

896

897 The type of this object (`container.file`).

898

899 - `:"container.file"`

900

901 - `path: String`

902

903 Path of the file in the container.

904

905 - `source: String`

906

907 Source of the file (e.g., `user`, `assistant`).

908

909### Example

910

911```ruby

912require "openai"

913

914openai = OpenAI::Client.new(api_key: "My API Key")

915

916file = openai.containers.files.create("container_id")

917

918puts(file)

919```

920

921#### Response

922

923```json

924{

925 "id": "id",

926 "bytes": 0,

927 "container_id": "container_id",

928 "created_at": 0,

929 "object": "container.file",

930 "path": "path",

931 "source": "source"

932}

933```

934

935## Retrieve container file

936

937`containers.files.retrieve(file_id, **kwargs) -> FileRetrieveResponse`

938

939**get** `/containers/{container_id}/files/{file_id}`

940

941Retrieve container file

942

943### Parameters

944

945- `container_id: String`

946

947- `file_id: String`

948

949### Returns

950

951- `class FileRetrieveResponse`

952

953 - `id: String`

954

955 Unique identifier for the file.

956

957 - `bytes: Integer`

958

959 Size of the file in bytes.

960

961 - `container_id: String`

962

963 The container this file belongs to.

964

965 - `created_at: Integer`

966

967 Unix timestamp (in seconds) when the file was created.

968

969 - `object: :"container.file"`

970

971 The type of this object (`container.file`).

972

973 - `:"container.file"`

974

975 - `path: String`

976

977 Path of the file in the container.

978

979 - `source: String`

980

981 Source of the file (e.g., `user`, `assistant`).

982

983### Example

984

985```ruby

986require "openai"

987

988openai = OpenAI::Client.new(api_key: "My API Key")

989

990file = openai.containers.files.retrieve("file_id", container_id: "container_id")

991

992puts(file)

993```

994

995#### Response

996

997```json

998{

999 "id": "id",

1000 "bytes": 0,

1001 "container_id": "container_id",

1002 "created_at": 0,

1003 "object": "container.file",

1004 "path": "path",

1005 "source": "source"

1006}

1007```

1008

1009## Delete a container file

1010

1011`containers.files.delete(file_id, **kwargs) -> void`

1012

1013**delete** `/containers/{container_id}/files/{file_id}`

1014

1015Delete a container file

1016

1017### Parameters

1018

1019- `container_id: String`

1020

1021- `file_id: String`

1022

1023### Example

1024

1025```ruby

1026require "openai"

1027

1028openai = OpenAI::Client.new(api_key: "My API Key")

1029

1030result = openai.containers.files.delete("file_id", container_id: "container_id")

1031

1032puts(result)

1033```

1034

1035## Domain Types

1036

1037### File List Response

1038

1039- `class FileListResponse`

1040

1041 - `id: String`

1042

1043 Unique identifier for the file.

1044

1045 - `bytes: Integer`

1046

1047 Size of the file in bytes.

1048

1049 - `container_id: String`

1050

1051 The container this file belongs to.

1052

1053 - `created_at: Integer`

1054

1055 Unix timestamp (in seconds) when the file was created.

1056

1057 - `object: :"container.file"`

1058

1059 The type of this object (`container.file`).

1060

1061 - `:"container.file"`

1062

1063 - `path: String`

1064

1065 Path of the file in the container.

1066

1067 - `source: String`

1068

1069 Source of the file (e.g., `user`, `assistant`).

1070

1071### File Create Response

1072

1073- `class FileCreateResponse`

1074

1075 - `id: String`

1076

1077 Unique identifier for the file.

1078

1079 - `bytes: Integer`

1080

1081 Size of the file in bytes.

1082

1083 - `container_id: String`

1084

1085 The container this file belongs to.

1086

1087 - `created_at: Integer`

1088

1089 Unix timestamp (in seconds) when the file was created.

1090

1091 - `object: :"container.file"`

1092

1093 The type of this object (`container.file`).

1094

1095 - `:"container.file"`

1096

1097 - `path: String`

1098

1099 Path of the file in the container.

1100

1101 - `source: String`

1102

1103 Source of the file (e.g., `user`, `assistant`).

1104

1105### File Retrieve Response

1106

1107- `class FileRetrieveResponse`

1108

1109 - `id: String`

1110

1111 Unique identifier for the file.

1112

1113 - `bytes: Integer`

1114

1115 Size of the file in bytes.

1116

1117 - `container_id: String`

1118

1119 The container this file belongs to.

1120

1121 - `created_at: Integer`

1122

1123 Unix timestamp (in seconds) when the file was created.

1124

1125 - `object: :"container.file"`

1126

1127 The type of this object (`container.file`).

1128

1129 - `:"container.file"`

1130

1131 - `path: String`

1132

1133 Path of the file in the container.

1134

1135 - `source: String`

1136

1137 Source of the file (e.g., `user`, `assistant`).

1138

1139# Content

1140

1141## Retrieve container file content

1142

1143`containers.files.content.retrieve(file_id, **kwargs) -> StringIO`

1144

1145**get** `/containers/{container_id}/files/{file_id}/content`

1146

1147Retrieve container file content

1148

1149### Parameters

1150

1151- `container_id: String`

1152

1153- `file_id: String`

1154

1155### Returns

1156

1157- `StringIO`

1158

1159### Example

1160

1161```ruby

1162require "openai"

1163

1164openai = OpenAI::Client.new(api_key: "My API Key")

1165

1166content = openai.containers.files.content.retrieve("file_id", container_id: "container_id")

1167

1168puts(content)

1169```

ruby/resources/containers/index.md 2026-07-07 08:02 UTC to 2026-07-09 20:58 UTC

Containers

List containers

Parameters

Returns

Example

Response

Create container

Parameters

Returns

Example

Response

Retrieve container

Parameters

Returns

Example

Response

Delete a container

Parameters

Example

Domain Types

Container List Response

Container Create Response

Container Retrieve Response

Files

List container files

Parameters

Returns

Example

Response

Create container file

Parameters

Returns

Example

Response

Retrieve container file

Parameters

Returns

Example

Response

Delete a container file

Parameters

Example

Domain Types

File List Response

File Create Response

File Retrieve Response

Content

Retrieve container file content

Parameters

Returns

Example