Skip to main content

Pin Thing Mutation

Pin a "Thing" object (general entity) to IPFS for use in atom creation.

Mutation Structure​

mutation PinThing($thing: PinThingInput!) {
  pinThing(thing: $thing) {
    uri
  }
}

Variables​

{
  "thing": {
    "name": "TypeScript Programming Language",
    "description": "A strongly typed programming language that builds on JavaScript",
    "image": "ipfs://QmXnnyufdzAWL5CqZ2RnSNgPbvCc1ALT73s6epPrRnZ1Xy",
    "url": "https://www.typescriptlang.org"
  }
}

Response​

{
  "data": {
    "pinThing": {
      "uri": "ipfs://QmYx8C3kNN1sFSx5b..."
    }
  }
}

Workflow​

  1. Pin metadata using pinThing mutation
  2. Get IPFS URI from response
  3. Create atom on-chain using the URI
  4. Query the atom via GraphQL API

Best Practices​

  1. Upload images first if needed using uploadImage
  2. Include all metadata fields for rich display
  3. Store IPFS URI for future reference
  4. Wait for indexing before querying the atom