---
updatedAt: 2026-09-24T20:53:29.000Z
agentTools:
  projectIndex: https://developer.intellistack.com/llms.txt
---

# Update a specific task assignee contact information

Updates the email or phone number for a single task assignee without affecting other assignees

# OpenAPI definition

```json
{
  "components": {
    "schemas": {
      "UpdateTaskAssigneeDto": {
        "properties": {
          "email": {
            "description": "New email address for the task assignee",
            "example": "updated.user@example.com",
            "type": "string"
          },
          "phone": {
            "description": "New phone number for the task assignee in E.164 format",
            "example": "+15551234567",
            "type": "string"
          }
        },
        "type": "object"
      },
      "UpdateTaskAssigneeResponseDto": {
        "properties": {
          "assignee": {
            "description": "Updated assignee contact (email or phone)",
            "example": "updated.user@example.com",
            "type": "string"
          },
          "notificationSent": {
            "description": "Whether a notification was sent to the new contact",
            "example": true,
            "type": "boolean"
          },
          "status": {
            "description": "Task status",
            "enum": [
              "ASSIGNED",
              "COMPLETED",
              "DECLINED",
              "CANCELLED"
            ],
            "example": "ASSIGNED",
            "type": "string"
          },
          "taskId": {
            "description": "The unique ID of the updated task",
            "example": "00000000-0000-4000-8000-000000000002",
            "type": "string"
          },
          "type": {
            "description": "Task type (EMAIL or SMS)",
            "enum": [
              "EMAIL",
              "SMS"
            ],
            "example": "EMAIL",
            "type": "string"
          }
        },
        "required": [
          "taskId",
          "assignee",
          "type",
          "status",
          "notificationSent"
        ],
        "type": "object"
      }
    },
    "securitySchemes": {
      "bearerAuth": {
        "bearerFormat": "JWT",
        "scheme": "bearer",
        "type": "http"
      }
    }
  },
  "info": {
    "contact": {},
    "description": "Workflows Sessions",
    "title": "Workflows Sessions",
    "version": "1.0"
  },
  "openapi": "3.0.0",
  "paths": {
    "/v1/sessions/{sessionId}/steps/{stepSessionId}/tasks/{taskId}/assignee": {
      "post": {
        "description": "Updates the email or phone number for a single task assignee without affecting other assignees",
        "operationId": "StepSessionsController_updateTaskAssignee_v1",
        "parameters": [
          {
            "in": "path",
            "name": "sessionId",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "stepSessionId",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "taskId",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateTaskAssigneeDto"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UpdateTaskAssigneeResponseDto"
                }
              }
            },
            "description": ""
          },
          "400": {
            "description": "Invalid email or phone format"
          },
          "403": {
            "description": "User lacks OPERATE permission"
          },
          "404": {
            "description": "Task not found"
          },
          "409": {
            "description": "Task is not in ASSIGNED status"
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "summary": "Update a specific task assignee contact information",
        "tags": [
          "Sessions/steps",
          "Public"
        ]
      }
    }
  },
  "servers": [
    {
      "description": "US Production Server",
      "url": "https://api-us.streamline.intellistack.ai"
    },
    {
      "description": "Canada Production Server",
      "url": "https://api-ca.streamline.intellistack.ai"
    }
  ]
}
```