> For the complete documentation index, see [llms.txt](https://theblockchainchief.gitbook.io/web3stash/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://theblockchainchief.gitbook.io/web3stash/services/pinata.md).

# Pinata

Dive into the specifics of connecting and using pinata with web3stash

## Initialization

To use Pinata you have to pass "PINATA" as the service name. No other name will work!

```javascript
const pinataService = Web3Stash("PINATA",{apiKey:"", apiSecret:""},{pinata options})
```

## Configuration 

To use pinata in web3stash, you need two things:

* apiKey 
* apiSecret

Note: Use these name only while passing keys in object i.e, {apiKey:"", apiSecret:""}

#### Optional Config Options

There are no optional config options for this service

## Methods Available

The following methods are available for this service, More will be added soon

* Uploading JSON data 

```javascript
pinataService.uploadJson({name:"example", url:"abc.com"}, {pinataOptions}).then().catch()
```

* Uploading Image

```javascript
pinataService.uploadImage("./image.png", {pinataOptions}).then().catch()
```

* Uploading Video

```javascript
pinataService.uploadVideo("./video.mp4", {pinataOptions}).then().catch()
```

* Uploading File

<pre class="language-javascript"><code class="lang-javascript"><strong>pinataService.uploadFile("./data.txt", {pinataOptions}).then().catch()
</strong></code></pre>

* Uploading Images from Stream

<pre class="language-javascript"><code class="lang-javascript"><strong>pinataService.uploadImageFromStream(readableStream, {pinataOptions}).then().catch()
</strong></code></pre>

* Uploading Video from Stream

<pre class="language-javascript"><code class="lang-javascript"><strong>pinataService.uploadVideoFromStream(readableStream, {pinataOptions}).then().catch()
</strong></code></pre>

* Uploading File from Stream

<pre class="language-javascript"><code class="lang-javascript"><strong>pinataService.uploadFileFromStream(readableStream, {pinataOptions}).then().catch()
</strong></code></pre>

## Output

All the functions return id (cid) and metadata (data returned by the service on upload)

<pre class="language-javascript"><code class="lang-javascript"><strong>{id:"dewfnlpweurmwknrwiojhgcbxczz", metadata:{}}
</strong></code></pre>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://theblockchainchief.gitbook.io/web3stash/services/pinata.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.