# 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`

```json
{
  "pipeline_id": "<PIPELINE_ID>",
  "pursuit_id": "<PURSUIT_ID>",
  "owner_model_id": "<USER_ID>",
  "name": "Draft technical volume outline",
  "dueDate": "2026-03-20"
}
```

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

```json
{
  "pipeline_id": "<PIPELINE_ID>",
  "pursuit_id": "<PURSUIT_ID>",
  "owner_model_id": "<USER_ID>",
  "name": "Finalize staffing matrix",
  "description": "Confirm labor categories, key personnel availability, and teammate resumes before pink team.",
  "dueDate": "2026-03-18",
  "priority": "high"
}
```

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

```json
{
  "pipeline_id": "<PIPELINE_ID>",
  "pursuit_id": "<PURSUIT_ID>",
  "owner_model_id": "<USER_ID>",
  "name": "Submit Q&A clarifications",
  "description": "Send final vendor clarification package before portal cutoff.",
  "dueDate": "2026-03-10T16:00:00Z",
  "priority": "urgent"
}
```
