UpdateData

Update previously uploaded data stored through Storedat

Description

This mutation will update a single piece of previously uploaded data through Storedat; however, this operation will not actually update the previously stored data on the underlying decentralized storage platform as that is not possible. This operation will upload the content as net new and instruct the Storedat indexing layer to point to this new representation of your data. 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
providerId	The identifier of the data you wish to update at the decentralized storage level (i.e. TransactionId for Arweave or CID for Filecoin). To obtain this value you are recommended to first preform a GetData operation on the data you are trying to update.
content	The content representing the update

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 {
  UpdateData(
    groupId: "update-data-sample"
    providerId: "d8IatD1X3rxKNywpy8z0eMu1tzJQ9ENGslYSs7Z02ZU",
    content: {
      contentType: TEXT
      data: "This is a sample request for an update"
      metadata: [
        { name: "key", value: "value" }
      ]
    }
  ) {
    operation
    providerId
    groupId
    url
    statusCode
    errorMessage
  }
}

Sample Response

{
  "data": {
    "UpdateData": {
      "operation": "UPDATE",
      "providerId": "KMsIzPaIsNODKiFGXlRi2X900WRSWRda2jgW5aDdyh0",
      "groupId": "update-data-sample",
      "url": "https://www.arweave.net/KMsIzPaIsNODKiFGXlRi2X900WRSWRda2jgW5aDdyh0",
      "statusCode": "SUCCESS",
      "errorMessage": null
    }
  }
}