Importing Schema from IPFS
POST /schemas/push/{topicId}/import/message
Imports a new schema from IPFS into the local database asynchronously. Returns a task ID immediately; poll GET /tasks/{taskId} for the result.
Authentication: Bearer token required (Authorization: Bearer <token>)
Permission: Permissions.SCHEMAS_SCHEMA_CREATE
Request
Path Parameters
Parameter
Type
Required
Description
topicId
string
Yes
The Hedera topic ID to import the schema under (e.g. 0.0.4532001)
Request Body
{
"messageId": "1680000000.000000001"
}Field
Type
Required
Description
messageId
string
Yes
The Hedera message ID containing the IPFS CID of the schema
Response
Success Response
Status: 202 Accepted
Poll GET /tasks/{taskId} to retrieve the result.
Error Responses
Status
Description
401 Unauthorized
Missing or invalid token
403 Forbidden
Insufficient permissions
422 Unprocessable Entity
Message ID is missing
500 Internal Server Error
Unexpected server failure
Was this helpful?