Tasks

Skip a task

Skips a task without completing the associated action. For sequence tasks, skipping advances the prospect to the next step in the sequence. The task status will be updated to skipped.

post/tasks/{id}/skip

Request

  • Base URL: https://partner-api.nooks.in/v1
  • URL: https://partner-api.nooks.in/v1/tasks/{id}/skip
  • 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:write)

Path parameters

idstring uuid required

Unique identifier for the task to skip

Response

Task successfully skipped

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.