GraphQL API Overview - Threadify Documentation

Use the GraphQL API on your own Engine to query threads, validation results, contracts, and entity profiles. Queries read persisted history, which can lag behind live contract state. Use SDK execution waits for permission decisions.

API Endpoint

POST https://threadify.example.com/graphql

Authentication

Include your API key in the X-API-Key header:

X-API-Key: YOUR_API_KEY

Query Complexity Limit

Maximum complexity: 1000 points
Use pagination to stay within limits

Example Query

query {
  thread(id: "thread-123") {
    id
    status
    contractName
    steps {
      stepName
      status
      latestContext
    }
  }
}

curl -X POST https://threadify.example.com/graphql \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "query { thread(id: \"thread-123\") { id status contractName } }"
  }'

Available Queries

Query	Description
`thread(id)`	Get a single thread by ID
`threads(...)`	Search threads with filters
`threadsByContract(...)`	Find threads by contract
`threadsByRef(...)`	Find threads by external reference
`threadChain(rootId)`	Get thread relationship chain
`stepHistory(...)`	Get step execution history
`validationResults(...)`	Get contract validation results
`contractGraph(name, version)`	Get contract structure
`verifyThreadIntegrity(threadId)`	Verify hash chain integrity