Skip to content
For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to the page URL.
Primary navigation

Suggested
Overview Models Agents Tools Audio & voice Production API reference

Create a vault

client.Beta.Agents.Vaults.New(ctx, body) (*Vault, error)
POST/vaults

Creates a vault for the current project. See vaults.

ParametersExpand Collapse
body BetaAgentVaultNewParams
Metadata param.Field[map[string, string]]Optional

Key-value pairs to associate with the vault, such as an application or team identifier.

Name param.Field[string]Optional

The name is trimmed before storage. It must contain 1 to 256 UTF-8 bytes after trimming.

minLength1
maxLength1048576
ReturnsExpand Collapse
type Vault struct{…}

A collection of credentials for MCP servers and OpenAI-hosted environments.

ID string

The ID of the vault.

minLength0
CreatedAt int64

The Unix timestamp, in seconds, when the vault was created.

formatint64
Metadata map[string, string]

Key-value pairs associated with the vault, such as an application or team identifier.

Name string

The human-readable name of the vault, if set.

minLength0
Object Vault

The object type. Always vault.

Create a vault

package main

import (
  "context"
  "fmt"

  "github.com/openai/openai-go"
  "github.com/openai/openai-go/option"
)

func main() {
  client := openai.NewClient(
    option.WithAPIKey("My API Key"),
  )
  vault, err := client.Beta.Agents.Vaults.New(context.TODO(), openai.BetaAgentVaultNewParams{

  })
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", vault.ID)
}

{
  "id": "id",
  "created_at": 0,
  "metadata": {
    "foo": "string"
  },
  "name": "name",
  "object": "vault"
}
Returns Examples
{
  "id": "id",
  "created_at": 0,
  "metadata": {
    "foo": "string"
  },
  "name": "name",
  "object": "vault"
}