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

# Bulk API skill

> An assistant skill that walks you through sending conversations or tables into Rippit with the Bulk API: token, test upload, full upload, and a schedule.

The Bulk API skill (`rippit-bulk-ingest-api`) is an agent skill: a set of instructions your assistant loads when you ask it to send data into Rippit. It turns the [Bulk API](https://docs.rippit.com/api-reference/connect/bulk/overview.md) into a guided conversation. Tell it where your data lives and it handles the rest:

1. **Token.** Shows you where to create an API token, then has you paste it into a private file on your computer, so it never goes into the chat.
2. **Check.** Confirms the token works and the Bulk API is enabled for your workspace.
3. **Test upload.** Writes the upload script, runs it on 10 conversations or 1,000 rows, and shows you what was written and what was rejected.
4. **Full upload.** Once you've checked the test in Rippit, sends everything, then offers to put it on a schedule.

The skill needs an assistant that can run code on your computer, such as Claude Code, Codex, or Cursor. In a chat-only assistant, it writes the script and you run it.

## Install

> [tab] Claude Code
>
> ```sh theme={null}
> mkdir -p ~/.claude/skills/rippit-bulk-ingest-api
> curl -sL https://docs.rippit.com/.well-known/agent-skills/rippit-bulk-ingest-api/SKILL.md \
>   -o ~/.claude/skills/rippit-bulk-ingest-api/SKILL.md
> ```
>
> Start a new session and ask it to send your data to Rippit. To update, run the same command again.

> [tab] Claude web / desktop
>
> 1. Save [the skill file](https://docs.rippit.com/.well-known/agent-skills/rippit-bulk-ingest-api/SKILL.md) as `SKILL.md` in a folder named `rippit-bulk-ingest-api`.
> 2. Zip the folder.
> 3. In Claude, open **Settings**, then **Capabilities**, and upload the zip under **Skills**.

> [tab] Other assistants
>
> Most assistants that support agent skills read them from a skills folder in your project or home directory. Save [the skill file](https://docs.rippit.com/.well-known/agent-skills/rippit-bulk-ingest-api/SKILL.md) as `rippit-bulk-ingest-api/SKILL.md` in that folder.
>
> Without skills support, paste this into your assistant instead:
>
> ```text theme={null}
> Read https://docs.rippit.com/.well-known/agent-skills/rippit-bulk-ingest-api/SKILL.md and follow it to help me send my data into Rippit.
> ```

## Use it

```text theme={null}
I want to send our in-app chats from Postgres into Rippit.
```

```text theme={null}
Upload our accounts table from Snowflake to Rippit and keep it synced daily.
```

## Next steps

* [How the Bulk API works](https://docs.rippit.com/api-reference/connect/bulk/overview.md)
* [Bulk conversation upload reference](https://docs.rippit.com/api-reference/connect/bulk/conversations.md)
* [Bulk dataset upload reference](https://docs.rippit.com/api-reference/connect/bulk/tables.md)


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