Create Task

Create_Task creates a new GovTribe task inside a specific pipeline and pursuit and returns the created task resource as JSON text.

Input Contract

  • pipeline_id: GovTribe ID of the pipeline that owns the task context.

    • type: string

    • required: yes

    • default: n/a

  • pursuit_id: GovTribe ID of the pursuit the task is associated with.

    • type: string

    • required: yes

    • default: n/a

  • owner_model_id: GovTribe ID of the user who will own the task.

    • type: string

    • required: yes

    • default: n/a

  • name: Task name.

    • type: string

    • required: yes

    • default: n/a

    • shape: min length 1, max length 100

  • description: Optional task description text.

    • type: string

    • required: no

    • default: omit for no description

    • shape: max length 10000

  • dueDate: Due date for the task.

    • type: string

    • required: yes

    • default: n/a

    • shape: YYYY-MM-DD or ISO 8601

  • priority: Optional task priority.

    • type: string enum

    • required: no

    • default: omit for no priority

    • options: low, medium, high, urgent

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: Create a standard task with required fields only. Tool: Create_Task

Pattern B: Create a high-priority task with description for handoff clarity. Tool: Create_Task

Pattern C: Create an urgent task using ISO 8601 due date-time. Tool: Create_Task

Last updated

Was this helpful?