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

# Create task subscription transaction

`POST /nodes/task-subscribe`

Create task subscription transaction

Subscribes a node to a specific task.

## Request body

- NodeTaskSubscriptionRequest — Represents a request to subscribe to a node task. This struct encapsulates the necessary parameters for subscribing to a node task, including optional gas-related fields.
  - `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`.
  - `node_badge_id` string — Optional node badge ID. If not provided, the default is `None`.
  - `price_per_one_million_compute_units` integer, required — The price per one million compute units.
  - `task_small_id` integer, required — The small ID of the task to subscribe to.

## Response `200`

Node task subscription successful

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

## Other responses

- `500` — Failed to submit task 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/versions/45bb2355d453/schema)