BurstIQ Graph Chain APIs API
In basic terms, these endpoints are the CRUD+T operations for transactional data on the platform
In basic terms, these endpoints are the CRUD+T operations for transactional data on the platform
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/burstiq-graph-chain-apis-api"
curl "https://apis.io/api/v1/apis?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: LifeGraph Graph Chain APIs API
description: LifeGraph API descriptions
license:
name: BurstIQ, Inc.
url: https://www.burstiq.com
version: 2.42.0
servers:
- url: https://api.burstiq.com
description: Generated server url
tags:
- name: Graph Chain APIs
description: In basic terms, these endpoints are the CRUD+T operations for transactional data on the platform
paths:
/api/graphchain/{fromDict}/edges/{edgeId}:
put:
tags:
- Graph Chain APIs
description: 'Allowed user roles:
sdzUser
updates an edge with a from chain and edge ID; must be owner or limited owner'
operationId: putUpdateEdgeById
parameters:
- name: fromDict
in: path
required: true
schema:
type: string
- name: edgeId
in: path
required: true
schema:
type: string
format: uuid
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/UpdateEdgeRequest'
required: true
responses:
'200':
description: OK
content:
'*/*':
schema:
$ref: '#/components/schemas/Edge'
summary: Put update edge by id
x-summary-source: derived
/api/graphchain/{chain}:
put:
tags:
- Graph Chain APIs
description: 'Allowed user roles:
sdzUser
upsert asset by primary key'
operationId: putUpsertAsset
parameters:
- name: chain
in: path
required: true
schema:
type: string
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/UpsertAssetRequest_Public'
required: true
responses:
'200':
description: OK
content:
'*/*':
schema:
$ref: '#/components/schemas/SDOAsset_Public'
summary: Put upsert asset
x-summary-source: derived
post:
tags:
- Graph Chain APIs
description: 'Allowed user roles:
sdzUser
create an asset in a chain'
operationId: postCreateAsset
parameters:
- name: chain
in: path
required: true
schema:
type: string
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/CreateAssetRequest_Public'
required: true
responses:
'200':
description: OK
content:
'*/*':
schema:
$ref: '#/components/schemas/SDOAsset_Public'
summary: Post create asset
x-summary-source: derived
patch:
tags:
- Graph Chain APIs
description: 'Allowed user roles:
sdzUser
patch specific elements of the asset by primary key (inline with other data)'
operationId: patchAsset
parameters:
- name: chain
in: path
required: true
schema:
type: string
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/UpdateAssetRequest'
required: true
responses:
'200':
description: OK
content:
'*/*':
schema:
$ref: '#/components/schemas/SDOAsset'
summary: Patch asset
x-summary-source: derived
/api/graphchain/{chain}/{sdoId}:
get:
tags:
- Graph Chain APIs
description: 'Allowed user roles:
sdzReadOnly
sdzUser
get smart data object by sdo id; must be owner or limited owner'
operationId: getSDO
parameters:
- name: chain
in: path
required: true
schema:
type: string
- name: sdoId
in: path
required: true
schema:
type: string
format: uuid
responses:
'200':
description: OK
content:
'*/*':
schema:
$ref: '#/components/schemas/SDO_Public'
summary: Get SDO
x-summary-source: derived
put:
tags:
- Graph Chain APIs
description: 'Allowed user roles:
sdzUser
update elements of the asset by SDO id'
operationId: putUpdateAsset
parameters:
- name: chain
in: path
required: true
schema:
type: string
- name: sdoId
in: path
required: true
schema:
type: string
format: uuid
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/UpdateAssetRequest_Public'
required: true
responses:
'200':
description: OK
content:
'*/*':
schema:
$ref: '#/components/schemas/SDOAsset_Public'
summary: Put update asset
x-summary-source: derived
delete:
tags:
- Graph Chain APIs
description: 'Allowed user roles:
sdzUser
get smart data object by sdo id; must be owner or limited owner'
operationId: deleteSDO
parameters:
- name: chain
in: path
required: true
schema:
type: string
- name: sdoId
in: path
required: true
schema:
type: string
format: uuid
responses:
'200':
description: OK
summary: Delete SDO
x-summary-source: derived
/api/graphchain/{chain}/{sdoId}/{attribute}/blobs:
put:
tags:
- Graph Chain APIs
description: 'Allowed user roles:
sdzUser
Upsert a blob, only works with scalar'
operationId: putUpsertBlob
parameters:
- name: chain
in: path
required: true
schema:
type: string
- name: sdoId
in: path
required: true
schema:
type: string
format: uuid
- name: attribute
in: path
required: true
schema:
type: string
- name: metadata
in: query
required: false
schema:
type: string
requestBody:
content:
multipart/form-data:
schema:
type: object
properties:
file:
type: string
format: binary
required:
- file
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/SDOBlob_Public'
summary: Put upsert blob
x-summary-source: derived
post:
tags:
- Graph Chain APIs
description: 'Allowed user roles:
sdzUser
adds a blob to an SDO by ID and its attribute'
operationId: postBlob
parameters:
- name: chain
in: path
required: true
schema:
type: string
- name: sdoId
in: path
required: true
schema:
type: string
format: uuid
- name: attribute
in: path
required: true
schema:
type: string
- name: metadata
in: query
required: false
schema:
type: string
requestBody:
content:
multipart/form-data:
schema:
type: object
properties:
file:
type: string
format: binary
required:
- file
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/SDOBlob_Public'
summary: Post blob
x-summary-source: derived
delete:
tags:
- Graph Chain APIs
description: 'Allowed user roles:
sdzUser
deletes a blob(s) from an SDO by attribute name'
operationId: deleteBlob
parameters:
- name: chain
in: path
required: true
schema:
type: string
- name: sdoId
in: path
required: true
schema:
type: string
format: uuid
- name: attribute
in: path
required: true
schema:
type: string
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/CountResponse'
summary: Delete blob
x-summary-source: derived
/api/graphchain/{chain}/{sdoId}/{attribute}/blobs/{blobHash}:
get:
tags:
- Graph Chain APIs
description: 'Allowed user roles:
sdzReadOnly
sdzUser
get blob data for an SDO specifically for an attribute and its hash'
operationId: getBlob
parameters:
- name: chain
in: path
required: true
schema:
type: string
- name: sdoId
in: path
required: true
schema:
type: string
format: uuid
- name: attribute
in: path
required: true
schema:
type: string
- name: blobHash
in: path
required: true
schema:
type: string
responses:
'200':
description: OK
content:
application/octet-stream:
schema:
type: string
format: binary
application/json:
schema:
type: string
format: binary
summary: Get blob
x-summary-source: derived
put:
tags:
- Graph Chain APIs
description: 'Allowed user roles:
sdzUser
Replace a specific blob on an SDO by its ID, attribute, and hash of the blob to replace'
operationId: putBlob
parameters:
- name: chain
in: path
required: true
schema:
type: string
- name: sdoId
in: path
required: true
schema:
type: string
format: uuid
- name: attribute
in: path
required: true
schema:
type: string
- name: blobHash
in: path
required: true
schema:
type: string
- name: metadata
in: query
required: false
schema:
type: string
requestBody:
content:
multipart/form-data:
schema:
type: object
properties:
file:
type: string
format: binary
required:
- file
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/SDOBlob_Public'
summary: Put blob
x-summary-source: derived
delete:
tags:
- Graph Chain APIs
description: 'Allowed user roles:
sdzUser
deletes a blob(s) from an SDO by attribute name and blob hash'
operationId: deleteBlobByHash
parameters:
- name: chain
in: path
required: true
schema:
type: string
- name: sdoId
in: path
required: true
schema:
type: string
format: uuid
- name: attribute
in: path
required: true
schema:
type: string
- name: blobHash
in: path
required: true
schema:
type: string
responses:
'200':
description: OK
summary: Delete blob by hash
x-summary-source: derived
/api/graphchain/{chain}/{sdoId}/verification:
put:
tags:
- Graph Chain APIs
description: 'Allowed user roles:
sdzUser
add verification data into the SDO; must be owner or limited owner'
operationId: putVerificationInSDO
parameters:
- name: chain
in: path
required: true
schema:
type: string
- name: sdoId
in: path
required: true
schema:
type: string
format: uuid
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/VerificationRequest_Public'
required: true
responses:
'200':
description: OK
content:
'*/*':
schema:
$ref: '#/components/schemas/SDO_Public'
summary: Put verification in SDO
x-summary-source: derived
/api/graphchain/{chain}/{sdoId}/transfer:
put:
tags:
- Graph Chain APIs
description: 'Allowed user roles:
sdzUser
transfer a smart data object by sdo id; must be owner or limited owner'
operationId: putTransferSDO
parameters:
- name: chain
in: path
required: true
schema:
type: string
- name: sdoId
in: path
required: true
schema:
type: string
format: uuid
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/TransferRequest_Public'
required: true
responses:
'200':
description: OK
content:
'*/*':
schema:
$ref: '#/components/schemas/SDO_Public'
summary: Put transfer SDO
x-summary-source: derived
/api/graphchain/{chain}/{sdoId}/revert:
put:
tags:
- Graph Chain APIs
description: 'Allowed user roles:
sdzUser
Revert an SDO by sdo id to the previous SDO. To revert an sdo, the following must be true:
1. The current sdo must be the result of an UPDATE or a TRANSFER,
2. You must be the signer of the current sdo.
3. You must be an owner of the previous sdo.
4. The revert must happen within 30 seconds of the update/transfer of the current sdo.
The revert will remove the previous version of the sdo in history and make it the current sdo. The sdo
reverted is not put into history. All manual edge and blob changes made between the pervious and current sdo
will need to be handled manually. Auto edges will update automatically.'
operationId: putRevertSDO
parameters:
- name: chain
in: path
required: true
schema:
type: string
- name: sdoId
in: path
required: true
schema:
type: string
format: uuid
responses:
'200':
description: OK
content:
'*/*':
schema:
$ref: '#/components/schemas/SDOAsset_Public'
summary: Put revert SDO
x-summary-source: derived
/api/graphchain/{chain}/smartcontracts/{sdoId}:
put:
tags:
- Graph Chain APIs
description: 'Allowed user roles:
sdzUser
update a smart contract'
operationId: putUpdateSmartContract
parameters:
- name: chain
in: path
required: true
schema:
type: string
- name: sdoId
in: path
required: true
schema:
type: string
format: uuid
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/SmartContractRequest_Public'
required: true
responses:
'200':
description: OK
content:
'*/*':
schema:
$ref: '#/components/schemas/SDOSmartContract_Public'
summary: Put update smart contract
x-summary-source: derived
/api/graphchain/{chain}/consentcontracts/{sdoId}:
put:
tags:
- Graph Chain APIs
description: 'Allowed user roles:
sdzAdmin
sdzUser
update a consent contract'
operationId: putUpdateConsentContract
parameters:
- name: chain
in: path
required: true
schema:
type: string
- name: sdoId
in: path
required: true
schema:
type: string
format: uuid
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/CreateOrUpdateConsentContractRequest_Public'
required: true
responses:
'200':
description: OK
content:
'*/*':
schema:
$ref: '#/components/schemas/SDO_Public'
summary: Put update consent contract
x-summary-source: derived
/api/graphchain/{chain}/bulk:
put:
tags:
- Graph Chain APIs
description: 'Allowed user roles:
sdzUser
bulk upsert assets by primary key (order may not be followed); takes an array of [{data:{}, metadata:{}}...] objects'
operationId: putUpsertBulkAssets
parameters:
- name: chain
in: path
required: true
schema:
type: string
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/UpsertBulkAssetRequest_Public'
required: true
responses:
'200':
description: OK
content:
'*/*':
schema:
$ref: '#/components/schemas/UpsertBulkAssetResponse_Public'
summary: Put upsert bulk assets
x-summary-source: derived
/api/graphchain/edge:
put:
tags:
- Graph Chain APIs
description: 'Allowed user roles:
sdzUser
upsert an edge between 2 SDOs; must be owner or limited owner'
operationId: putUpsertEdge
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/NewFullEdgeRequest'
required: true
responses:
'200':
description: OK
content:
'*/*':
schema:
$ref: '#/components/schemas/Edge'
summary: Put upsert edge
x-summary-source: derived
/api/graphchain/{chain}/{sdoId}/edges:
post:
tags:
- Graph Chain APIs
description: 'Allowed user roles:
sdzUser
create an edge between 2 SDOs; must be owner or limited owner; could return 200 empty response if edge already exists'
operationId: postCreateEdge_1
parameters:
- name: chain
in: path
required: true
schema:
type: string
- name: sdoId
in: path
required: true
schema:
type: string
format: uuid
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/NewEdgeRequest'
required: true
responses:
'200':
description: OK
content:
'*/*':
schema:
$ref: '#/components/schemas/Edge'
summary: Post create edge 1
x-summary-source: derived
/api/graphchain/{chain}/smartcontracts:
post:
tags:
- Graph Chain APIs
description: 'Allowed user roles:
sdzUser
create a smart contract; request body must be'
operationId: postCreateSmartContract
parameters:
- name: chain
in: path
required: true
schema:
type: string
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/SmartContractRequest_Public'
required: true
responses:
'200':
description: OK
content:
'*/*':
schema:
$ref: '#/components/schemas/SDO_Public'
summary: Post create smart contract
x-summary-source: derived
/api/graphchain/{chain}/consentcontracts:
post:
tags:
- Graph Chain APIs
description: 'Allowed user roles:
sdzAdmin
sdzUser
create a consent contract'
operationId: postCreateConsentContract
parameters:
- name: chain
in: path
required: true
schema:
type: string
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/CreateOrUpdateConsentContractRequest_Public'
required: true
responses:
'200':
description: OK
content:
'*/*':
schema:
$ref: '#/components/schemas/SDOConsentContract_Public'
summary: Post create consent contract
x-summary-source: derived
/api/graphchain/query:
post:
tags:
- Graph Chain APIs
description: 'Allowed user roles:
sdzReadOnly
sdzUser
DEPRECATED Content-Type=application/json (09 MAY 24): Use ContentType=text/plain instead. | Query assets by TQL.'
operationId: postQuery
requestBody:
content:
text/plain:
schema:
type: string
application/json:
schema:
$ref: '#/components/schemas/QueryRequest'
required: true
responses:
'200':
description: OK
content:
'*/*':
schema:
type: array
items:
type: object
summary: Post query
x-summary-source: derived
/api/graphchain/query/validate:
post:
tags:
- Graph Chain APIs
description: 'Allowed user roles:
sdzReadOnly
sdzUser
DEPRECATED Content-Type=application/json (09 MAY 24): Use ContentType=text/plain. | Validate a given query for syntax; optional enforcement options.'
operationId: postValidate
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/QueryValidateRequest'
text/plain:
schema:
type: string
required: true
responses:
'200':
description: OK
summary: Post validate
x-summary-source: derived
/api/graphchain/query/validate/graph:
post:
tags:
- Graph Chain APIs
description: 'Allowed user roles:
sdzReadOnly
sdzUser
DEPRECATED (use /query/validate): validate a given query for syntax, must have GRAPH command; optional enforcement options
Deprecated since 23 JUN 2025'
operationId: postValidateGraph
requestBody:
content:
text/plain:
schema:
type: string
required: true
responses:
'200':
description: OK
deprecated: true
summary: Post validate graph
x-summary-source: derived
/api/graphchain/{chain}/bypk:
patch:
tags:
- Graph Chain APIs
description: 'Allowed user roles:
sdzUser
patch specific elements of the asset by primary key (using pkFields and pkPatchFields. NOTE: this DOES allow for updating the primary key as well'
operationId: patchAssetWithPkFields
parameters:
- name: chain
in: path
required: true
schema:
type: string
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/PatchAssetRequest_Public'
required: true
responses:
'200':
description: OK
content:
'*/*':
schema:
$ref: '#/components/schemas/SDOAsset_Public'
summary: Patch asset with pk fields
x-summary-source: derived
/api/graphchain/{from}/edges/{edgeId}:
get:
tags:
- Graph Chain APIs
description: 'Allowed user roles:
sdzReadOnly
sdzUser
gets an edge with a from chain and edge ID'
operationId: getEdgeById_1
parameters:
- name: from
in: path
required: true
schema:
type: string
- name: edgeId
in: path
required: true
schema:
type: string
format: uuid
responses:
'200':
description: OK
content:
'*/*':
schema:
$ref: '#/components/schemas/Edge'
summary: Get edge by id 1
x-summary-source: derived
/api/graphchain/{fromDict}/{fromSdoId}/edges:
get:
tags:
- Graph Chain APIs
description: 'Allowed user roles:
sdzReadOnly
sdzUser
gets all outbound edges with a from SDO; must be owner or limited owner'
operationId: getEdges
parameters:
- name: fromDict
in: path
required: true
schema:
type: string
- name: fromSdoId
in: path
required: true
schema:
type: string
format: uuid
responses:
'200':
description: OK
content:
'*/*':
schema:
type: array
items:
$ref: '#/components/schemas/FullEdge_Public'
summary: Get edges
x-summary-source: derived
/api/graphchain/{chain}/{sdoId}/verify/signature:
get:
tags:
- Graph Chain APIs
description: 'Allowed user roles:
sdzReadOnly
sdzUser
verify signature of smart data object by sdo id or hash'
operationId: getVerifySignature
parameters:
- name: chain
in: path
required: true
schema:
type: string
- name: sdoId
in: path
required: true
schema:
type: string
format: uuid
responses:
'200':
description: OK
content:
'*/*':
schema:
$ref: '#/components/schemas/BooleanResponse'
summary: Get verify signature
x-summary-source: derived
/api/graphchain/{chain}/{sdoId}/verify/hash:
get:
tags:
- Graph Chain APIs
description: 'Allowed user roles:
sdzReadOnly
sdzUser
verify hash of smart data object by sdo id or hash'
operationId: getVerifyHash
parameters:
- name: chain
in: path
required: true
schema:
type: string
- name: sdoId
in: path
required: true
schema:
type: string
format: uuid
responses:
'200':
description: OK
content:
'*/*':
schema:
$ref: '#/components/schemas/BooleanResponse'
summary: Get verify hash
x-summary-source: derived
/api/graphchain/{chain}/{sdoId}/history:
get:
tags:
- Graph Chain APIs
description: 'Allowed user roles:
sdzReadOnly
sdzUser
get smart data object history by sdo id; must be owner or limited owner'
operationId: getSDOHistory
parameters:
- name: chain
in: path
required: true
schema:
type: string
- name: sdoId
in: path
required: true
schema:
type: string
format: uuid
responses:
'200':
description: OK
content:
'*/*':
schema:
type: array
items:
$ref: '#/components/schemas/SDO_Public'
summary: Get SDO history
x-summary-source: derived
/api/graphchain/{chain}/{sdoId}/blobs:
get:
tags:
- Graph Chain APIs
description: 'Allowed user roles:
sdzReadOnly
sdzUser
get blob(s) info for an SDO; optionally can specify a blob attribute for filtering'
operationId: getBlobInfo
parameters:
- name: chain
in: path
required: true
schema:
type: string
- name: sdoId
in: path
required: true
schema:
type: string
format: uuid
- name: attribute
in: query
required: false
schema:
type: string
responses:
'200':
description: OK
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/SDOBlob_Public'
summary: Get blob info
x-summary-source: derived
/api/graphchain/{chain}/smartcontracts/receipts:
get:
tags:
- Graph Chain APIs
description: 'Allowed user roles:
sdzAdmin
gets smart contract receipts, by where clause, orderBy clause, and limit/skip. these are optional but must include a where clause or a limit. the orderBy format is a comma separated list of: name [ACS | DESC]'
operationId: getQuerySmartContractReceipts
parameters:
- name: chain
in: path
required: true
schema:
type: string
- name: where
in: query
required: false
schema:
type: string
- name: orderBy
in: query
required: false
schema:
type: array
items:
type: string
- name: limit
in: query
required: false
schema:
type: integer
format: int32
- name: skip
in: query
required: false
schema:
type: integer
format: int32
responses:
'200':
description: OK
content:
'*/*':
schema:
type: array
items:
$ref: '#/components/schemas/SDOReceiptSmartContract_Public'
summary: Get query smart contract receipts
x-summary-source: derived
/api/graphchain/{chain}/smartcontracts/receipts/self:
get:
tags:
- Graph Chain APIs
description: 'Allowed user roles:
sdzReadOnly
sdzUser
gets smart contract receipts, by where clause, orderBy clause, and limit/skip. these are optional but must include a where clause or a limit. the orderBy format is a comma separated list of: name [ACS | DESC]'
operationId: getQuerySmartContractReceiptsSelf
parameters:
- name: chain
in: path
required: true
schema:
type: string
- name: where
in: query
required: false
schema:
type: string
- name: orderBy
in: query
required: false
schema:
type: array
items:
type: string
- name: limit
in: query
required: false
schema:
type: integer
format: int32
- name: skip
in: query
required: false
schema:
type: integer
format: int32
responses:
'200':
description: OK
content:
'*/*':
schema:
type: array
items:
$ref: '#/components/schemas/SDOReceiptSmartContract_Public'
summary: Get query smart contract receipts self
x-summary-source: derived
/api/graphchain/{chain}/query/smartcontracts:
get:
tags:
- Graph Chain APIs
description: 'Allowed user roles:
sdzReadOnly
sdzUser
query smart contracts by tql'
operationId: getQuerySmartContracts
parameters:
- name: chain
in: path
required: true
schema:
type: string
- name: where
in: query
required: false
schema:
type: string
- name: orderBy
in: query
required: false
schema:
type: array
items:
type: string
- name: limit
in: query
required: false
schema:
type: integer
format: int32
- name: skip
in: query
required: false
schema:
type: integer
format: int32
responses:
'200':
description: OK
content:
'*/*':
schema:
type: array
# --- truncated at 32 KB (58 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/burstiq/refs/heads/main/openapi/burstiq-graph-chain-apis-api-openapi.yml