---
title: "Add a file to IPFS"
method: POST
path: "/ipfs/add"
tags: ["IPFS » Add"]
---

# Add a file to IPFS

`POST /ipfs/add`

You need to `/ipfs/pin/add` an object to avoid it being garbage collected. This usage
is being counted in your user account quota.

<p>
  <span class="hosted">Hosted</span> Endpoint only available for hosted variant.
</p>

## Response `200`

Returns information about added IPFS object

- object
  - `name` string, required — Name of the file
  - `ipfs_hash` string, required — IPFS hash of the file
  - `size` string, required — IPFS node size in Bytes

## Other responses

- `400` — Bad request
- `403` — Authentication secret is missing or invalid
- `404` — Component not found
- `418` — IP has been auto-banned for extensive sending of requests after usage limit has been reached
- `429` — Usage limit reached
- `500` — Internal Server Error

---

[API](https://skmtc.net/txpipe/apis/blockfrost-io-api-documentation.md) · [All operations](https://skmtc.net/txpipe/apis/blockfrost-io-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/txpipe/blockfrost-io-api-documentation/revisions/4a2f67b16876/schema)