Create Group

Create a new IPFS group on Pinata’s legacy API. Groups let you organize pinned CIDs so you can manage and filter them by a single name.

POST /groups

Create Group

cURL

curl --request POST \
  --url https://api.pinata.cloud/groups \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "NFT-Project"
}
'

200

{
  "id": "61a4a882-1591-462e-bcb7-fa0eee5f3c51",
  "user_id": "ec50a085-a746-428d-b01d-167ac379fbd4",
  "name": "NFT-Project",
  "updatedAt": "2024-07-03T18:09:33.610Z",
  "createdAt": "2024-07-03T18:09:33.610Z"
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

name · string

Response

200 - application/json

OK

id · string

ID of the created Group

user_id · string

ID of the user who created the Group

name · string

Name of the Group

updatedAt · string

ISO 8601 format date of the last time Group was updated

createdAt · string

ISO 8601 format date of Group creation