Storedat API
Search
K

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"
}
]
}
}
Last modified 6mo ago