KakaFlow KB

Create Vault - Beta Vaults API

3 phút đọc

Create Vault - Beta Vaults API

Trust: ★★★☆☆ (0.90) · 0 validations · developer_reference

Published: 2026-05-10 · Source: crawler_authoritative

Tình huống

API reference for creating a vault to store credentials for use by agents during sessions in the Anthropic Claude beta platform.

Insight

The beta.vaults.create() method creates a new vault that stores credentials for use by agents. It accepts display_name (required, 1-255 characters), optional metadata dictionary (max 16 key-value pairs, keys up to 64 chars, values up to 512 chars), and optional betas list for specifying beta versions. Supported beta values include: message-batches-2024-09-24, prompt-caching-2024-07-31, computer-use-2024-10-22, computer-use-2025-01-24, pdfs-2024-09-25, token-counting-2024-11-01, token-efficient-tools-2025-02-19, output-128k-2025-02-19, files-api-2025-04-14, mcp-client-2025-04-04, mcp-client-2025-11-20, dev-full-thinking-2025-05-14, interleaved-thinking-2025-05-14, code-execution-2025-05-22, extended-cache-ttl-2025-04-11, context-1m-2025-08-07, context-management-2025-06-27, model-context-window-exceeded-2025-08-26, skills-2025-10-02, fast-mode-2026-02-01, output-300k-2026-03-24, user-profiles-2026-03-24, advisor-tool-2026-03-01, and managed-agents-2026-04-01. The method is available via POST /v1/vaults.

Hành động

Import Anthropic client, instantiate with api_key (can use ANTHROPIC_API_KEY env var), then call client.beta.vaults.create(display_name=‘Your Vault Name’, metadata={‘key’: ‘value’}). The display_name parameter is required and must be between 1-255 characters. Metadata is optional. The method returns a BetaManagedAgentsVault object.

Kết quả

Returns a BetaManagedAgentsVault object containing id (unique identifier), archived_at (RFC 3339 timestamp, nullable), created_at (datetime), display_name (string), metadata (Dict), type (‘vault’), and updated_at (datetime).

Điều kiện áp dụng

This is a beta API method. The managed-agents beta version (managed-agents-2026-04-01) may be required for full functionality.

Nội dung gốc (Original)

Create

beta.vaults.create(VaultCreateParams**kwargs) -> BetaManagedAgentsVault

post /v1/vaults

Create Vault

Parameters

  • display_name: str

    Human-readable name for the vault. 1-255 characters.

  • metadata: Optional[Dict[str, str]]

    Arbitrary key-value metadata to attach to the vault. Maximum 16 pairs, keys up to 64 chars, values up to 512 chars.

  • betas: Optional[List[AnthropicBetaParam]]

    Optional header to specify the beta version(s) you want to use.

    • str

    • Literal["message-batches-2024-09-24", "prompt-caching-2024-07-31", "computer-use-2024-10-22", 21 more]

      • "message-batches-2024-09-24"

      • "prompt-caching-2024-07-31"

      • "computer-use-2024-10-22"

      • "computer-use-2025-01-24"

      • "pdfs-2024-09-25"

      • "token-counting-2024-11-01"

      • "token-efficient-tools-2025-02-19"

      • "output-128k-2025-02-19"

      • "files-api-2025-04-14"

      • "mcp-client-2025-04-04"

      • "mcp-client-2025-11-20"

      • "dev-full-thinking-2025-05-14"

      • "interleaved-thinking-2025-05-14"

      • "code-execution-2025-05-22"

      • "extended-cache-ttl-2025-04-11"

      • "context-1m-2025-08-07"

      • "context-management-2025-06-27"

      • "model-context-window-exceeded-2025-08-26"

      • "skills-2025-10-02"

      • "fast-mode-2026-02-01"

      • "output-300k-2026-03-24"

      • "user-profiles-2026-03-24"

      • "advisor-tool-2026-03-01"

      • "managed-agents-2026-04-01"

Returns

  • class BetaManagedAgentsVault: …

    A vault that stores credentials for use by agents during sessions.

    • id: str

      Unique identifier for the vault.

    • archived_at: Optional[datetime]

      A timestamp in RFC 3339 format

    • created_at: datetime

      A timestamp in RFC 3339 format

    • display_name: str

      Human-readable name for the vault.

    • metadata: Dict[str, str]

      Arbitrary key-value metadata attached to the vault.

    • type: Literal["vault"]

      • "vault"

    • updated_at: datetime

      A timestamp in RFC 3339 format

Example

import os
from anthropic import Anthropic
 
client = Anthropic(
    api_key=os.environ.get("ANTHROPIC_API_KEY"),  # This is the default and can be omitted
)
beta_managed_agents_vault = client.beta.vaults.create(
    display_name="Example vault",
)
print(beta_managed_agents_vault.id)

Liên kết

Xem thêm:

Sơ đồ

Liên kết ngược