Tasks

Update a task

Updates one or more fields on an existing task.

Only the following fields can be changed:

  • dueAt reschedules the task to a new due date and time
  • ownerId reassigns the task to a different user
  • priority changes the task priority (low, normal, high, urgent)
  • note updates the task note (set to null to clear)

At least one field must be provided. All other task fields (action, prospect, sequence, etc.) are immutable through this endpoint.

patch/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:write)

Path parameters

idstring uuid required

Unique identifier for the task

Request body

Example request

{
  "data": {
    "dueAt": "2026-04-01T09:00:00.000Z",
    "ownerId": "KKLvN5wQoghWFwUvC75CZ12QM7I3",
    "priority": "high",
    "note": "Follow up after the demo"
  }
}

Response

Task successfully updated

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.