Tasks

Get task by ID

Returns a single task by its unique identifier.

get/tasks/{id}

Request

  • Base URL: https://partner-api.nooks.in/v1
  • URL: https://partner-api.nooks.in/v1/tasks/{id}
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://oauth.nooks.in/oauth/authorize, token URL https://oauth.nooks.in/oauth/token, scopes: tasks:read)

Path parameters

idstring uuid required

Unique identifier for the task

Query parameters

includestring[]

Comma-separated relations to expand inline. Valid values: owner, prospect, sequence, sequenceState, sequenceStep. Max 3.

Response

Successful response

idstring uuid required

Unique identifier for the task

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

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 sent LinkedIn message
  • manual_sms: Manual SMS message
  • auto_sms: Automatically sent SMS message
completedboolean required

Whether the task has been completed

dueAtstring date-time required

When the task is due

notestring nullable required

Optional note or instructions for the task

statusstring nullable required

Current status of the task (pending, ready, finished, skipped, failed)

priority'low' | 'normal' | 'high' | 'urgent' required

Priority level of the task

createdAtstring date-time required

When the task was created

updatedAtstring date-time required

When the task was last updated

Example response

{
  "id": "dd0e8400-e29b-41d4-a716-446655440050",
  "action": "call",
  "dueAt": "2026-03-19T23:26:21.536Z",
  "note": "Initial outreach call",
  "status": "ready",
  "priority": "normal",
  "owner": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "_href": "/v1/sequences/550e8400-e29b-41d4-a716-446655440000"
  },
  "prospect": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "_href": "/v1/sequences/550e8400-e29b-41d4-a716-446655440000"
  },
  "sequence": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "_href": "/v1/sequences/550e8400-e29b-41d4-a716-446655440000"
  },
  "sequenceState": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "_href": "/v1/sequences/550e8400-e29b-41d4-a716-446655440000"
  },
  "sequenceStep": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "_href": "/v1/sequences/550e8400-e29b-41d4-a716-446655440000"
  },
  "createdAt": "2026-03-18T10:00:00.000Z",
  "updatedAt": "2026-03-18T10:00:00.000Z"
}

Changes

No recorded changes to this operation across all 1 revision of this API.