---
title: "Create model subscription transaction"
method: POST
path: "/nodes/model-subscribe"
tags: ["Nodes"]
---

# Create model subscription transaction

`POST /nodes/model-subscribe`

Create model subscription transaction

Subscribes a node to a specific model.

## Request body

- NodeModelSubscriptionRequest — Represents a request to subscribe to a node model. This struct encapsulates the necessary parameters for subscribing to a node model, including optional gas-related fields.
  - `echelon_id` integer, required — The echelon ID associated with the subscription.
  - `gas` string — Optional gas object ID. If not provided, the default is `None`.
  - `gas_budget` integer, nullable — Optional gas budget. If not provided, the default is `None`.
  - `gas_price` integer, nullable — Optional gas price. If not provided, the default is `None`.
  - `model_name` string, required — The name of the model to subscribe to.
  - `node_badge_id` string — Optional node badge ID. If not provided, the default is `None`.

## Response `200`

Node model subscription successful

- NodeModelSubscriptionResponse — Represents a response to a node model subscription request. This struct contains the transaction digest, which is a unique identifier for the transaction associated with the node model subscription.
  - `tx_digest` string, required — The transaction digest. This is a unique identifier for the transaction.

## Other responses

- `500` — Failed to submit model subscription transaction

---

[API](https://skmtc.net/atomaai/apis/atoma-daemon.md) · [All operations](https://skmtc.net/atomaai/apis/atoma-daemon/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/atomaai/atoma-daemon/revisions/45bb2355d453/schema)