Nooks: Get Task

Get task by ID.

Tool ID: nooks_get_task

Run this action

Use the TypeScript SDK for a single call. Put ctx.tools.execute(...) inside a Play when the call should be durable, scheduled, or run across a CSV.

import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'nooks_get_task',
  {
    "id": "123e4567-e89b-42d3-a456-426614174000"
  },
);

console.log(result.toolResponse.raw);

CLI

deepline tools execute nooks_get_task --input '{
  "id": "123e4567-e89b-42d3-a456-426614174000"
}' --json

Example response

The SDK exposes this shape at result.toolResponse.raw. Values below are representative.

{
  "data": {
    "id": "123e4567-e89b-42d3-a456-426614174000",
    "action": "call",
    "completed": true,
    "dueAt": "2026-01-15T12:00:00Z",
    "note": "example",
    "status": "example",
    "priority": "low",
    "owner": {
      "id": "id_123",
      "_href": "example"
    },
    "prospect": {
      "id": "id_123",
      "_href": "example"
    },
    "sequence": {
      "id": "id_123",
      "_href": "example"
    },
    "sequenceState": {
      "id": "id_123",
      "_href": "example"
    },
    "sequenceStep": {
      "id": "id_123",
      "_href": "example"
    },
    "createdAt": "2026-01-15T12:00:00Z",
    "updatedAt": "2026-01-15T12:00:00Z"
  }
}

Use deepline tools get nooks_get_task --json for the latest machine-readable contract.

Input reference

Returns a single task by its unique identifier. Example:

bash curl -X GET 'https://partner-api.nooks.in/v1/tasks/dd0e8400-e29b-41d4-a716-446655440050' \ -H "Authorization: Bearer nooks-api-..."

Name	Type	Required	Default	Details
`payload.id`	`string`	Yes	—	Unique identifier for the task Format: `uuid`.
`payload.include`	`array`	No	—	Comma-separated relations to expand inline. Valid values: `owner`, `prospect`, `sequence`, `sequenceState`, `sequenceStep`. Max 3. Maximum items: 3.

Output reference

Standard tool result payload.

Name	Type	Required	Default	Details
`result.data`	`object`	Yes	—	A task representing an outreach activity assigned to a user
`result.data.id`	`string`	Yes	—	Unique identifier for the task Format: `uuid`.
`result.data.action`	`"call" \| "manual_email" \| "auto_email" \| "manual_email_reply" \| "auto_email_reply" \| "basic_task" \| "linkedin_connection_request" \| "manual_linkedin_connection_request" \| "manual_linkedin_message" \| "automatic_linkedin_message" \| "manual_sms" \| "auto_sms"`	Yes	—	Type of action for this task: - `call`: Phone call task - `manual_email`: Manually composed email - `auto_email`: Automatically sent email - `manual_email_reply`: Manual email reply - `auto_email_reply`: Automatic email reply - `basic_task`: Generic manual task - `linkedin_connection_request`: LinkedIn connection request - `manual_linkedin_connection_request`: Manual LinkedIn connection request - `manual_linkedin_message`: Manual LinkedIn message - `automatic_linkedin_message`: Automatically See the live schema for the complete constraint.
`result.data.completed`	`boolean`	Yes	—	Whether the task has been completed
`result.data.dueAt`	`string`	Yes	—	When the task is due Format: `date-time`.
`result.data.note`	`string \| null`	Yes	—	Optional note or instructions for the task
`result.data.status`	`string \| null`	Yes	—	Current status of the task (pending, ready, finished, skipped, failed)
`result.data.priority`	`"low" \| "normal" \| "high" \| "urgent"`	Yes	—	Priority level of the task Allowed: `low`, `normal`, `high`, `urgent`.
`result.data.owner`	`object`	Yes	—	A reference to a related resource
`result.data.owner.id`	`string`	Yes	—	Unique identifier of the referenced resource
`result.data.owner._href`	`string`	Yes	—	API path to the referenced resource
`result.data.prospect`	`object`	Yes	—	A reference to a related resource
`result.data.prospect.id`	`string`	Yes	—	Unique identifier of the referenced resource
`result.data.prospect._href`	`string`	Yes	—	API path to the referenced resource
`result.data.sequence`	`object \| null`	Yes	—	A reference to a related resource
`result.data.sequence.id`	`string`	Yes	—	Unique identifier of the referenced resource
`result.data.sequence._href`	`string`	Yes	—	API path to the referenced resource
`result.data.sequenceState`	`object \| null`	Yes	—	A reference to a related resource
`result.data.sequenceState.id`	`string`	Yes	—	Unique identifier of the referenced resource
`result.data.sequenceState._href`	`string`	Yes	—	API path to the referenced resource
`result.data.sequenceStep`	`object \| null`	Yes	—	A reference to a related resource
`result.data.sequenceStep.id`	`string`	Yes	—	Unique identifier of the referenced resource
`result.data.sequenceStep._href`	`string`	Yes	—	API path to the referenced resource
`result.data.createdAt`	`string`	Yes	—	When the task was created Format: `date-time`.
`result.data.updatedAt`	`string`	Yes	—	When the task was last updated Format: `date-time`.
`result.meta`	`object`	No	—	Additional response metadata (status, paging).

Deepline cost

Pricing model: fixed (per call).
Estimated Deepline credits: 0 per pricing unit.
Provider-native pricing may still exist outside Deepline credit billing.

Get started

Build and automate

Common workflows

Data and integrations

Reference

Run this action

CLI

Example response

Input reference

Output reference

Deepline cost

​Run this action

​CLI

​Example response

​Input reference

​Output reference

​Deepline cost

​Related documentation

Run this action

CLI

Example response

Input reference

Output reference

Deepline cost

Related documentation