CreateData

Upload Data to a supported web3 storage provider

Description

This mutation will upload data into a specified web3 storage provider. There is no support for data encryption at this time.

Due to the public nature of decentralized storage protocols, users should NOT store any private or sensitive information in an unencrypted form or data that may need to be permanently deleted in the future using the Storedat API

Arguments

Input	Description
groupId	The unique grouping id identifying the data you are storing. You can use this to group related data that you want to store together (i.e. NFT project metadata, content to a given entity). Should only include alphanumerical characters and the - character
provider	The provider you wish to upload your data with
content	The content to be stored

Response Details

Detail	Description
operation	The Operation enum represents the supported mutation operations
providerId	The identifier of the content provided by the underlying storage protocol i.e transactionID, CID
url	The url pointing to the data hosted on the underlying storage protocol
provider	The web3 storage solution the data is stored.
metadata	An array of key/value pairs representing the metadata of your data
errorMessage	An error message if an issue occurs while mutating your data

Request Headers

Header	Description
client-id	An identifier representing you as a user of the API. This will be provided to you upon signing up for the beta program
Authorization	Your API Key required to be able to interact with this method. This will be provided to you upon signing up for the beta program

Sample Mutation

mutation {
  CreateData(
    groupId: "your-group-id-here"
    provider: ARWEAVE
    content: {
      contentType: JSON
      data: "{'perma': 'storedat'}"
      metadata: [
        { name: "key1", value: "value1" }
        { name: "key2", value: "value2" }
      ]
    }
  ) {
    operation
    providerId
    groupId
    url
    statusCode
    errorMessage
  }
}

Sample Response

{
  "data": {
    "GetData": [
      {
        "data": "{'perma': 'storedat'}",
        "providerId": "0pyv5KdH0MV1IhxXFRq7oiQkglslEIH1NrpNcFdAbv4",
        "url": "https://www.arweave.net/0pyv5KdH0MV1IhxXFRq7oiQkglslEIH1NrpNcFdAbv4",
        "creationTimestamp": "2022-12-09T05:54:22.575141+00:00",
        "metadata": [
          {
            "name": "key1",
            "value": "value1"
          },
          {
            "name": "key2",
            "value": "value2"
          }
        ],
        "provider": "ARWEAVE"
      }
    ]
  }
}