> ## Documentation Index
> Fetch the complete documentation index at: https://docs.engini.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Anthropic

Discover how to connect Engini with Anthropic and use its activities to manage files, create message batches, and generate AI-powered responses with Claude models.

## Getting Started with Anthropic

### Prerequisites

* An Anthropic account.
  You can create an account at [Claude](https://claude.ai/login?from=logout).

## Retrieve Your Anthropic API Key

1. *Create an Anthropic Account -* Complete the sign-in process and get your account.

2. *Log in to Anthropic -* Once you have an account, log in to the Anthropic platform.

3. *Navigate to the API Key Section -* After logging in go to the **API Keys** section which is typically in the center of the page next to **Generate a prompt** and **Create a Prompt**.

   <img src="https://mintcdn.com/engini/mV-AWsgkc1kNftEo/help/assets/apps/anthropic/4WvTC5jhHwQJ4yuzrbc7k_screenshot-2025-12-29-150959.png?fit=max&auto=format&n=mV-AWsgkc1kNftEo&q=85&s=97727396a4a90e48e5d824088c7643db" alt="" width="1412" height="842" data-path="help/assets/apps/anthropic/4WvTC5jhHwQJ4yuzrbc7k_screenshot-2025-12-29-150959.png" />

4. *Generate an API Key*

   <img src="https://mintcdn.com/engini/mV-AWsgkc1kNftEo/help/assets/apps/anthropic/A_8f-dkiAIipUL75YQ4dm_screenshot-2025-12-29-151109.png?fit=max&auto=format&n=mV-AWsgkc1kNftEo&q=85&s=880740ec2bd9d5a9ebd10464e6b2f53b" alt="" width="1801" height="414" data-path="help/assets/apps/anthropic/A_8f-dkiAIipUL75YQ4dm_screenshot-2025-12-29-151109.png" />

   * Once you click to get API key, a key will be generated.

   * Copy the API key. Make sure to store it securely, as it provides access to your Anthropic resources in Engini.

## Connecting Engini to Anthropic

1. Enter your Engini account at [https://app.engini.io](https://app.engini.io/).

2. Navigate to Connections page by clicking on the Connections on the left sidebar or by clicking [here](https://app.engini.io/connections).

   <img src="https://mintcdn.com/engini/mV-AWsgkc1kNftEo/help/assets/apps/anthropic/Txoo1q-MivOjH5fwwjkDI_home-page-connector.png?fit=max&auto=format&n=mV-AWsgkc1kNftEo&q=85&s=724d68e92a6d3643f4ea32bb9cc6d41d" alt="" width="1920" height="1080" data-path="help/assets/apps/anthropic/Txoo1q-MivOjH5fwwjkDI_home-page-connector.png" />

3. Click on the "New Integration" option located at the top bar.

   <img src="https://mintcdn.com/engini/mV-AWsgkc1kNftEo/help/assets/apps/anthropic/Tc8OwXyO6hXXNLrpdVzA0_untitled-design-34.png?fit=max&auto=format&n=mV-AWsgkc1kNftEo&q=85&s=46cf79b47d550ae5944cc0e7f3464dab" alt="" width="1913" height="906" data-path="help/assets/apps/anthropic/Tc8OwXyO6hXXNLrpdVzA0_untitled-design-34.png" />

4. Choose Claude option from the available applications.

   <img src="https://mintcdn.com/engini/mV-AWsgkc1kNftEo/help/assets/apps/anthropic/jGFfjqnEOpx2JKd3M8-Lt_untitled-design-51.png?fit=max&auto=format&n=mV-AWsgkc1kNftEo&q=85&s=cce4bf6e9c722fe090a46f005ec4d5ab" alt="" width="1920" height="1080" data-path="help/assets/apps/anthropic/jGFfjqnEOpx2JKd3M8-Lt_untitled-design-51.png" />

5. Enter the following details in the “New Integration” form and press Save:

   <img src="https://mintcdn.com/engini/mV-AWsgkc1kNftEo/help/assets/apps/anthropic/j3te1lvh_H-KRU5dqOMyU_2-56.png?fit=max&auto=format&n=mV-AWsgkc1kNftEo&q=85&s=40d8d66efaae64215bb68a18cc002533" alt="" width="1920" height="1080" data-path="help/assets/apps/anthropic/j3te1lvh_H-KRU5dqOMyU_2-56.png" />

   1. *Connection name* – Enter a meaningful name for your connection.

   2. *API Key* – When you create an Anthropic account, you’ll receive an API key. Copy it and paste it into this field.

   3. *Save Settings* - Click on the save button to save your connection.

## Actions

### Create a File

Upload a new file to your Anthropic account.

<img src="https://mintcdn.com/engini/y3gz19O5kq0KGtU0/help/assets/apps/anthropic/pIJPbPuN4Z8_nl0Rs0lky_image.png?fit=max&auto=format&n=y3gz19O5kq0KGtU0&q=85&s=f6100732b7849a9f954b528ebde15637" alt="" width="976" height="320" data-path="help/assets/apps/anthropic/pIJPbPuN4Z8_nl0Rs0lky_image.png" />

* *Content -* Enter the content for the new file, encoded in Base64.

### Create a Message Batch

Submits multiple messages at once to Anthropic’s API for processing

<img src="https://mintcdn.com/engini/mV-AWsgkc1kNftEo/help/assets/apps/anthropic/f3lNTJB6CbZQOvRdhKa-B_image.png?fit=max&auto=format&n=mV-AWsgkc1kNftEo&q=85&s=f84c500f6cd1e4ea223f5d194fbd380d" alt="" width="968" height="286" data-path="help/assets/apps/anthropic/f3lNTJB6CbZQOvRdhKa-B_image.png" />

* *Add Field* - Click Add Field to add and populate additional fields for the selected activity. To learn more about managing activity data, [click here](/help/workflows/workflow-editor#add-fields).

### Create Messages

Send a structured list of messages to Anthropic Claude API and receives AI-generated responses.

<img src="https://mintcdn.com/engini/y3gz19O5kq0KGtU0/help/assets/apps/anthropic/yozB3zjIgzZNib7QiLzbV_screenshot-2025-12-29-152130.png?fit=max&auto=format&n=y3gz19O5kq0KGtU0&q=85&s=af4cb26faa988679319bd31e82f7fdf6" alt="" width="958" height="657" data-path="help/assets/apps/anthropic/yozB3zjIgzZNib7QiLzbV_screenshot-2025-12-29-152130.png" />

1. *Messages \[] -* Enter the messages array. Each message must include a role (user or assistant) and a content array. For Claude, each item in the content array must be an object that includes type and its corresponding fields.
   To build it for the Create Messages activity, you must follow these steps:
   1. Use [**Initialize Object** **Array**](/help/apps/anthropic#initialize-object-array) twice:
      * First: Create the inner content array
        * Variable: content, Object Element Type: content
          * Type – the common types are image, document and text.
            Note: If you choose *image* or *document*, don’t forget to fill in **Source Data**, **Source Type**, and **Media Type**.
      * Second: Create the outer messages array
        * Variable: messages, Object Element Type: messages
   2. Fields can be filled by clicking **Add Field**, and [**Append to Object Array**](/help/apps/anthropic#append-to-object-array) can be used to add additional objects.
   3. **Final Step:** In the Create Messages activity, set the Messages field to the dynamic variable from step 1 (e.g., messages\[]).
2. *Model -* Select the Anthropic Claude model you want to use (e.g., claude-3-sonnet-20240229, claude-3-opus-20240229).
3. *Max Tokens-* Set the maximum number of tokens Claude can generate in the response.
4. *Add Field* - Click Add Field to add and populate additional fields for the selected activity. To learn more about managing activity data, [click here](/help/workflows/workflow-editor#add-fields).

***Example:*** The **system field** for example is an **optional** field that acts as a super-prompt that the Claude model reads and internalizes before it processes the user’s messages.

<img src="https://mintcdn.com/engini/mV-AWsgkc1kNftEo/help/assets/apps/anthropic/B77UoiKWocAoIcDLc61_h_image.png?fit=max&auto=format&n=mV-AWsgkc1kNftEo&q=85&s=2f4073655c4c1ee2c2838ccab5241f29" alt="" width="1531" height="610" data-path="help/assets/apps/anthropic/B77UoiKWocAoIcDLc61_h_image.png" />

### Initialize Object Array

Creates a new variable object in your workflow to store structured data for use in subsequent Claude steps. For example, a Message\[] object can be initialized here and used in other actions, such as creating messages.

<img src="https://mintcdn.com/engini/mV-AWsgkc1kNftEo/help/assets/apps/anthropic/BeYyO6WZjQhW66PiFQGiy_image.png?fit=max&auto=format&n=mV-AWsgkc1kNftEo&q=85&s=4f198812a46ce8a84883dbdc947aa933" alt="" width="969" height="469" data-path="help/assets/apps/anthropic/BeYyO6WZjQhW66PiFQGiy_image.png" />

1. *Variable name -* Enter a name for the new object variable you’re creating. This name will be used to reference this object in other workflow steps.
2. *Object Element Type-* Select the type of data structure you want to initialize from the dropdown options. This action prepares an empty object of the specified type that you can then populate with data in later workflow steps.
3. *Add Field* - Click Add Field to add and populate additional fields for the selected activity. To learn more about managing activity data, [click here](/help/workflows/workflow-editor#add-fields).

### Append to Object Array

Adds new data elements to an existing array of objects in your workflow.

<img src="https://mintcdn.com/engini/mV-AWsgkc1kNftEo/help/assets/apps/anthropic/IzNYwrjLOqknM-mS-N12L_image.png?fit=max&auto=format&n=mV-AWsgkc1kNftEo&q=85&s=96da1c4129273ad41672bfcf26a9d6a3" alt="" width="1587" height="493" data-path="help/assets/apps/anthropic/IzNYwrjLOqknM-mS-N12L_image.png" />

1. *Select Variable -* Select the array variable from your workflow that you want to append new objects to. This dropdown shows all available array variables that you initialized from previous steps in your automation.
2. *Add Field* - Click Add Field to add and populate additional fields for the selected activity. To learn more about managing activity data, [click here](/help/workflows/workflow-editor#add-fields).

### Map Object Array

This activity is particularly useful when there is an array of data that needs to be translated into another structure.

<img src="https://mintcdn.com/engini/mV-AWsgkc1kNftEo/help/assets/apps/anthropic/1L2gt1-WagEkFlndJiJTL_image.png?fit=max&auto=format&n=mV-AWsgkc1kNftEo&q=85&s=c5406a4465b55a6a0d175662f7c60676" alt="" width="1588" height="758" data-path="help/assets/apps/anthropic/1L2gt1-WagEkFlndJiJTL_image.png" />

1. *Data List -* Choose a data list that you’ve obtained from previous activities in your workflow. This data list typically contains an array of objects that you want to process and transform.
2. *Object name -* You need to define the type of objects from the drop down that will be stored within the array.
3. *Add Field* - Click Add Field to add and populate additional fields for the selected activity. To learn more about managing activity data, [click here](/help/workflows/workflow-editor#add-fields).

### Delete a Message Batch

Cancels and removes a previously submitted batch of messages from Anthropic’s processing queue.

<img src="https://mintcdn.com/engini/mV-AWsgkc1kNftEo/help/assets/apps/anthropic/j5qzOIuXDYme63aAQbcxk_image.png?fit=max&auto=format&n=mV-AWsgkc1kNftEo&q=85&s=141248cb1ecfb9426de7e1123a966549" alt="" width="949" height="259" data-path="help/assets/apps/anthropic/j5qzOIuXDYme63aAQbcxk_image.png" />

* *Message batch id -* Enter the unique identifier of the message batch you want to delete. This ID was provided when you originally created the batch request to Anthropic’s API.

### Delete File

This action permanently deletes the file and cannot be undone. Ensure you have the correct file ID before executing this action.

<img src="https://mintcdn.com/engini/mV-AWsgkc1kNftEo/help/assets/apps/anthropic/kgZQFrAEwfLDkLKafQB7Z_image.png?fit=max&auto=format&n=mV-AWsgkc1kNftEo&q=85&s=d773d56c04ff1836348bb22c7f8466ef" alt="" width="959" height="265" data-path="help/assets/apps/anthropic/kgZQFrAEwfLDkLKafQB7Z_image.png" />

* *File Id -* Enter the unique identifier of the file you want to delete. This ID was provided when the file was originally created or uploaded to the system.

### Download File

Download the contents of a Claude generated file.

<img src="https://mintcdn.com/engini/mV-AWsgkc1kNftEo/help/assets/apps/anthropic/WmseFpDj4vAuHRoSqpdDo_image.png?fit=max&auto=format&n=mV-AWsgkc1kNftEo&q=85&s=93a04f0607aedef821b6a9938eb298a1" alt="" width="961" height="272" data-path="help/assets/apps/anthropic/WmseFpDj4vAuHRoSqpdDo_image.png" />

* *File Id -* Enter the unique identifier of the file you want to download. This ID was provided when the file was originally created or uploaded to the system.

### Cancel a Message Batch

Stops the processing of a submitted message batch that is currently in queue or being processed by Anthropic’s API.

<img src="https://mintcdn.com/engini/y3gz19O5kq0KGtU0/help/assets/apps/anthropic/x4QJEzsbd4cJupJBZ4RfW_image.png?fit=max&auto=format&n=y3gz19O5kq0KGtU0&q=85&s=74eb7911d7f01926d6eabf9bb5213537" alt="" width="961" height="290" data-path="help/assets/apps/anthropic/x4QJEzsbd4cJupJBZ4RfW_image.png" />

* *Message batch id -* Enter the unique identifier of the message batch you want to cancel. This ID was provided when you originally created the batch request to Anthropic’s API.

### Get File Metadata

Retrieves information about a file without downloading its actual content, such as file size, creation date, file type, and other properties.

<img src="https://mintcdn.com/engini/mV-AWsgkc1kNftEo/help/assets/apps/anthropic/Y5SEgFeA7CrrNpTweGYk0_image.png?fit=max&auto=format&n=mV-AWsgkc1kNftEo&q=85&s=566d109cdbada2b9e3cab9493fcaf7dc" alt="" width="960" height="275" data-path="help/assets/apps/anthropic/Y5SEgFeA7CrrNpTweGYk0_image.png" />

* *File Id -* Enter the unique identifier of the file you want to download. This ID was provided when the file was originally created or uploaded to the system.

### Retrieve a Message Batch

Fetches detailed information about a specific message batch, including its current processing status and metadata.

<img src="https://mintcdn.com/engini/mV-AWsgkc1kNftEo/help/assets/apps/anthropic/kjnomVDz5Vc5Y7ENBqMlu_image.png?fit=max&auto=format&n=mV-AWsgkc1kNftEo&q=85&s=9f32c7ba7e6a7a005f663150925f3381" alt="" width="957" height="310" data-path="help/assets/apps/anthropic/kjnomVDz5Vc5Y7ENBqMlu_image.png" />

* *Message batch id -* Enter the unique identifier of the message batch you want to retrieve information for. This ID was provided when you originally created the batch request.

### Retrieve Message Batch Results

Fetch the results of a previously submitted message batch.

<img src="https://mintcdn.com/engini/mV-AWsgkc1kNftEo/help/assets/apps/anthropic/-yTWR2BKqR53i5Y39W72U_image.png?fit=max&auto=format&n=mV-AWsgkc1kNftEo&q=85&s=429cb11b73f7045839650c85f1d2a4f6" alt="" width="960" height="271" data-path="help/assets/apps/anthropic/-yTWR2BKqR53i5Y39W72U_image.png" />

* *Message batch id -* Enter the unique identifier of the message batch you want to retrieve information for. This ID was provided when you originally created the batch request.

### Count Message Tokens

Calculates the total number of tokens that will be consumed by your messages before sending them to Anthropic’s API, helping you estimate costs and manage usage.

<img src="https://mintcdn.com/engini/mV-AWsgkc1kNftEo/help/assets/apps/anthropic/H0PzbTwzAnsQUJn_z_m8n_screenshot-2025-12-29-153814.png?fit=max&auto=format&n=mV-AWsgkc1kNftEo&q=85&s=69d5eb1771d4093a86481012329758e5" alt="" width="965" height="496" data-path="help/assets/apps/anthropic/H0PzbTwzAnsQUJn_z_m8n_screenshot-2025-12-29-153814.png" />

1. *Messages\[ ] -* Select the array of messages you want to count tokens for. Each message should contain the text content you plan to send to Claude.
2. *Model -* Choose the specific Anthropic model (e.g., Claude Sonnet, Claude Opus) you intend to use.
3. *Add Field* - Click Add Field to add and populate additional fields for the selected activity. To learn more about managing activity data, [click here](/help/workflows/workflow-editor#add-fields).

### List Files

Retrieves your list of files with options to filter and limit the results.

<img src="https://mintcdn.com/engini/mV-AWsgkc1kNftEo/help/assets/apps/anthropic/fsn-gYPWqSPoKiX5wJrwN_screenshot-2025-12-29-154002.png?fit=max&auto=format&n=mV-AWsgkc1kNftEo&q=85&s=cb51c6a3d4972b7e005eb4efd985790a" alt="" width="961" height="390" data-path="help/assets/apps/anthropic/fsn-gYPWqSPoKiX5wJrwN_screenshot-2025-12-29-154002.png" />

1. *Top N -* You can specify how many files you want to retrieve by clicking on ‘Top N’ and entering the maximum number of files you want to return.
   If you set `Top N = 1`, a single file will be returned instead of an array. If no file is found when using `Top N = 1`, the action will fail, allowing you to implement an IF condition within the workflow. This functionality is useful for processes where the existence of a specific file determines the next steps in the workflow.
2. *Add Filter -* Click Add Filter to define conditions that narrow down the data list and return only the relevant items. To learn more about using filters, [click here](/help/workflows/workflow-editor#add-filters).

### List Message Batches

Retrieves a list of all message batches that have been created in your Anthropic account, showing their details.

<img src="https://mintcdn.com/engini/mV-AWsgkc1kNftEo/help/assets/apps/anthropic/2yh05yemz1lFt7QA9Cck3_image.png?fit=max&auto=format&n=mV-AWsgkc1kNftEo&q=85&s=9f875c2926d8f2d104a4c788cc034c4c" alt="" width="955" height="221" data-path="help/assets/apps/anthropic/2yh05yemz1lFt7QA9Cck3_image.png" />


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.