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
    Create a Message Batch
    Retrieve a Message Batch
    List Message Batches
    Cancel a Message Batch
    Delete a Message Batch
    Retrieve Message Batch results
    Models
    List Models
    Get a Model
    Beta
    Admin
    Completions
    Create a Text Completion
    Support & configuration
    Rate limitsService tiersVersionsIP addressesSupported regionsOpenAI SDK compatibility
    Console
    Log in

    Delete a Message Batch

    client.Messages.Batches.Delete(ctx, messageBatchID) (*DeletedMessageBatch, error)
    delete/v1/messages/batches/{message_batch_id}

    Delete a Message Batch.

    Message Batches can only be deleted once they've finished processing. If you'd like to delete an in-progress batch, you must first cancel it.

    Learn more about the Message Batches API in our user guide

    ParametersExpand Collapse
    messageBatchID string

    ID of the Message Batch.

    ReturnsExpand Collapse
    type DeletedMessageBatch struct{…}
    ID string

    ID of the Message Batch.

    Type MessageBatchDeleted

    Deleted object type.

    For Message Batches, this is always "message_batch_deleted".

    Accepts one of the following:
    const MessageBatchDeletedMessageBatchDeleted MessageBatchDeleted = "message_batch_deleted"
    Delete a Message Batch
    package main
    
    import (
      "context"
      "fmt"
    
      "github.com/anthropics/anthropic-sdk-go"
      "github.com/anthropics/anthropic-sdk-go/option"
    )
    
    func main() {
      client := anthropic.NewClient(
        option.WithAPIKey("my-anthropic-api-key"),
      )
      deletedMessageBatch, err := client.Messages.Batches.Delete(context.TODO(), "message_batch_id")
      if err != nil {
        panic(err.Error())
      }
      fmt.Printf("%+v\n", deletedMessageBatch.ID)
    }
    
    Response 200
    {
      "id": "msgbatch_013Zva2CMHLNnXjNJJKqJ2EF",
      "type": "message_batch_deleted"
    }
    Returns Examples
    Response 200
    {
      "id": "msgbatch_013Zva2CMHLNnXjNJJKqJ2EF",
      "type": "message_batch_deleted"
    }

    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