> For the complete documentation index, see [llms.txt](https://docs.4everland.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.4everland.org/storage/4ever-pin/pinning-services-api.md).

# Pinning Services API

### Pinning Services API

#### The IPFS Pinning Services API Spec

IPFS builds a standardised set of specifications for developers, allowing applications to integrate pinning services without the need to understand the pinning service's unique API.

More information: <https://ipfs.github.io/pinning-services-api-spec/>.

#### Endpoints

Users who are looking to use the IPFS Pinning Services API can perform interactions from the following 4EVER dedicated API endpoints:

```
https://api.4everland.dev
```

Please visit the [Official Endpoint Documentation](https://ipfs.github.io/pinning-services-api-spec/#tag/pins) for more up-to-date information.

#### Authentication

You need to have an `accessToken` to authenticate with 4EVERLAND through the Pinning Services API spec and it can be easily found on the 4EVER Pin page. When you first enter the 4EVER Pin page, the `accessToken` is automatically generated.

This `accessToken` can not be deleted, but can be reset.

<figure><img src="/files/S3nftsLVqpWCD4f9MvnS" alt=""><figcaption></figcaption></figure>

Note: The Bearer Token method is used for authentication in the Pinning Services API Spec, and you'll provide an authentication header using your accessToken as follows:

```
Authorization: Bearer YourAccessToken
```

#### Configuring 4EVERLAND in the IPFS Desktop App

You can configure the 4EVER Pin in the IPFS desktop application. To do so, open the app > Preferences > Add Service:

<figure><img src="/files/OYq6jvsdErXSXeAmCLOn" alt=""><figcaption></figcaption></figure>

Select '**Add a custom one**', fill in the form information and your accessToken from the 4EVER Pin.

<figure><img src="/files/NrI8MburuQuw8AiNs0Vn" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
If you have any questions, please join our [Discord server](https://discord.com/invite/Cun2VpsdjF), or send us an email at <contact@4everland.org>.
{% endhint %}


---

# 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://docs.4everland.org/storage/4ever-pin/pinning-services-api.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.