Update Task

Update_Task modifies an existing GovTribe task and returns the updated task resource as JSON text.

Input Contract

  • task_id: GovTribe ID of the task to update.

    • type: string

    • required: yes

    • default: n/a

  • pipeline_id: GovTribe ID of the pipeline that owns the task context (required on every call).

    • type: string

    • required: yes

    • default: n/a

  • pursuit_id: GovTribe ID of the pursuit associated with the task context (required on every call).

    • type: string

    • required: yes

    • default: n/a

  • owner_model_id: Assign or reassign the task owner.

    • type: string

    • required: no

    • default: omit to keep current owner

  • name: Task name update.

    • type: string

    • required: no

    • default: omit to keep current name

    • shape: min length 1, max length 100

  • description: Task description update.

    • type: string

    • required: no

    • default: omit to keep current description

    • shape: max length 10000

  • dueDate: Due date update.

    • type: string

    • required: no

    • default: omit to keep current due date

    • shape: YYYY-MM-DD or ISO 8601

  • priority: Task priority update.

    • type: string enum

    • required: no

    • default: omit to keep current priority

    • options: low, medium, high, urgent

  • comment: Comment to attach with the update.

    • type: string

    • required: no

    • default: omit for no comment update

    • shape: max length 1000

Output Contract

  • Top-level keys:

    • govtribe_id

    • govtribe_ai_summary

    • govtribe_type

    • govtribe_url

    • name

    • description

    • comment

    • due_date

    • past_due

    • due_soon

    • priority

    • completed_at

    • reopened_at

    • created_at

    • updated_at

    • owner

    • creator

    • pipeline

    • pursuit

    • stage

  • Row keys:

    • n/a

  • Relationship retrieval map:

    • creator

      • resource_type: user

      • tool: Search_Users

      • filter: user_ids

      • nested_keys: govtribe_id, govtribe_type, name, email

    • owner

      • resource_type: user

      • tool: Search_Users

      • filter: user_ids

      • nested_keys: govtribe_id, govtribe_type, name, email

    • pipeline

      • resource_type: pipeline

      • tool: Search_Pipelines

      • filter: creator_ids

      • nested_keys: govtribe_id, govtribe_type, govtribe_url, name

    • pursuit

      • resource_type: pursuit

      • tool: Search_Pursuits

      • filter: creator_ids

      • nested_keys: govtribe_id, govtribe_type, govtribe_url, name

    • stage

      • resource_type: stage

      • tool: Search_Stages

      • filter: creator_ids

      • nested_keys: govtribe_id, govtribe_type, govtribe_url, name, type

Usage Patterns

Pattern A: Reassign ownership, set priority, and update due date. Tool: Update_Task

Last updated

Was this helpful?