Pin Person Mutation

Pin a Person entity to IPFS for use in atom creation.

Endpoint and Auth

Use the public gated pinning endpoint and send your Intuition pin API key in an apikey header:

https://pin.intuition.systems/v1/graphql

Create an authenticated client before sending the mutation:

import { GraphQLClient } from 'graphql-request';
import { PIN_API_URL } from '@0xintuition/graphql';

const client = new GraphQLClient(PIN_API_URL, {
  headers: {
    apikey: process.env.INTUITION_PIN_API_KEY!,
  },
});

pinPerson is available as a raw GraphQL mutation. The SDK currently exposes a pinThing helper, but not a first-class pinPerson helper.

Mutation Structure

mutation PinPerson($person: PinPersonInput!) {
  pinPerson(person: $person) {
    uri
  }
}

Variables

{
  "person": {
    "name": "Vitalik Buterin",
    "description": "Co-founder of Ethereum",
    "email": "vitalik@ethereum.org",
    "identifier": "vitalik.eth",
    "image": "ipfs://QmXnnyufdzAWL5CqZ2RnSNgPbvCc1ALT73s6epPrRnZ1Xy",
    "url": "https://vitalik.ca"
  }
}

Best Practices

1. Include identifier (ENS, username, etc.)
2. Add image for visual representation
3. Provide description for context
4. Use person-specific fields for rich metadata