Sign in
Pinning

Pin content to IPFS

Changed on

Pins content to IPFS with optional metadata.

Creates a new pin object for the specified CID. Content will be pinned to the IPFS network and made available for retrieval. Supports adding names, origins, and custom metadata for organization.

Prerequisites: CID must be valid IPFS content identifier

See also: GET /pins (list pins), GET /pins/{id} (get pin details)

post/pins

Request

  • Base URL: / (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /pins
  • Auth: none declared

Request body

cidstring required
metaobject
namestring
originsstring[]

Response

Successful response

createdstring date-time required
infoobject
requestidstring required
statusstring required

Changes

  • 06e0fa4f446eRevision changes
    • breaking

      removed the success response with the status

    • info

      added the non-success response with the status

  • b97dd0465ab3Revision changes
    • breaking

      the response's property type changed from string to object for status

    • breaking

      the response's property type changed from string to object for status

    • breaking

      the response's property type changed from string to object for status

    • breaking

      the response's property type changed from string to object for status

    • breaking

      the response's property type changed from string to object for status

    • breaking

      the response's property type changed from string to object for status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the required property / to the response with the status

    • info

      added the required property / to the response with the status

    • info

      added the required property / to the response with the status

    • info

      added the required property / to the response with the status

    • info

      added the required property / to the response with the status

    • info

      added the required property / to the response with the status