---
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

## Changes

- **2024-12-20** `ca6fc1dfabc6` — 1 warning
  - removed the request property `max_num_compute_units`
- **2024-12-19** `3cfef1f8f2df` — 1 breaking, 1 warning
  - added the new required request property `price_per_one_million_compute_units`
  - removed the request property `price_per_compute_unit`
- **2024-12-05** `260c4becaf84` — 2 info
  - api tag `Nodes` added
  - api tag `nodes` removed
- **2024-12-04** `69d6e856b1bd` — 2 breaking, 1 warning, 2 info
  - added the new required request property `max_num_compute_units`
  - added the new required request property `price_per_compute_unit`
  - removed the request property `price_per_one_million_compute_units`
  - api tag `nodes` added
  - …1 more

[Change history](https://skmtc.dev/atomaai/apis/atoma-daemon/changes/nodes/task-subscribe/post.md)

---

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