Loading...
    • Developer Guide
    • API Reference
    • MCP
    • Resources
    • Release Notes
    Search...
    ⌘K
    Using the API
    Features overviewClient SDKsBeta headersErrors
    Messages
    Create a Message
    Count tokens in a Message
    Models
    List Models
    Get a Model
    Beta
    Admin
    Get Api Key
    List Api Keys
    Update Api Key
    Completions
    Create a Text Completion
    Support & configuration
    Rate limitsService tiersVersionsIP addressesSupported regionsOpenAI SDK compatibility
    Console
    Log in

    Update Api Key

    post/v1/organizations/api_keys/{api_key_id}

    Update Api Key

    Path ParametersExpand Collapse
    api_key_id: string

    ID of the API key.

    Body ParametersExpand Collapse
    name: optional string

    Name of the API key.

    maxLength500
    minLength1
    status: optional "active" or "inactive" or "archived"

    Status of the API key.

    Accepts one of the following:
    "active"
    "inactive"
    "archived"
    ReturnsExpand Collapse
    APIKey = object { id, created_at, created_by, 5 more }
    id: string

    ID of the API key.

    created_at: string

    RFC 3339 datetime string indicating when the API Key was created.

    formatdate-time
    created_by: object { id, type }

    The ID and type of the actor that created the API key.

    id: string

    ID of the actor that created the object.

    type: string

    Type of the actor that created the object.

    name: string

    Name of the API key.

    partial_key_hint: string

    Partially redacted hint for the API key.

    status: "active" or "inactive" or "archived"

    Status of the API key.

    Accepts one of the following:
    "active"
    "inactive"
    "archived"
    type: "api_key"

    Object type.

    For API Keys, this is always "api_key".

    Accepts one of the following:
    "api_key"
    workspace_id: string

    ID of the Workspace associated with the API key, or null if the API key belongs to the default Workspace.

    Update Api Key
    curl https://api.anthropic.com/v1/organizations/api_keys/$API_KEY_ID \
        -H 'Content-Type: application/json' \
        -H "X-Api-Key: $ANTHROPIC_ADMIN_API_KEY" \
        -d '{}'
    Response 200
    {
      "id": "apikey_01Rj2N8SVvo6BePZj99NhmiT",
      "created_at": "2024-10-30T23:58:27.427722Z",
      "created_by": {
        "id": "user_01WCz1FkmYMm4gnmykNKUu3Q",
        "type": "user"
      },
      "name": "Developer Key",
      "partial_key_hint": "sk-ant-api03-R2D...igAA",
      "status": "active",
      "type": "api_key",
      "workspace_id": "wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ"
    }
    Returns Examples
    Response 200
    {
      "id": "apikey_01Rj2N8SVvo6BePZj99NhmiT",
      "created_at": "2024-10-30T23:58:27.427722Z",
      "created_by": {
        "id": "user_01WCz1FkmYMm4gnmykNKUu3Q",
        "type": "user"
      },
      "name": "Developer Key",
      "partial_key_hint": "sk-ant-api03-R2D...igAA",
      "status": "active",
      "type": "api_key",
      "workspace_id": "wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ"
    }

    Solutions

    • AI agents
    • Code modernization
    • Coding
    • Customer support
    • Education
    • Financial services
    • Government
    • Life sciences

    Partners

    • Amazon Bedrock
    • Google Cloud's Vertex AI

    Learn

    • Blog
    • Catalog
    • Courses
    • Use cases
    • Connectors
    • Customer stories
    • Engineering at Anthropic
    • Events
    • Powered by Claude
    • Service partners
    • Startups program

    Company

    • Anthropic
    • Careers
    • Economic Futures
    • Research
    • News
    • Responsible Scaling Policy
    • Security and compliance
    • Transparency

    Learn

    • Blog
    • Catalog
    • Courses
    • Use cases
    • Connectors
    • Customer stories
    • Engineering at Anthropic
    • Events
    • Powered by Claude
    • Service partners
    • Startups program

    Help and security

    • Availability
    • Status
    • Support
    • Discord

    Terms and policies

    • Privacy policy
    • Responsible disclosure policy
    • Terms of service: Commercial
    • Terms of service: Consumer
    • Usage policy