> ## Documentation Index
> Fetch the complete documentation index at: https://ago.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Task

> Create a task. Retrying with the same `Idempotency-Key` returns the first response.



## OpenAPI

````yaml /openapi-v1.json post /api/v1/tasks
openapi: 3.1.0
info:
  title: AGO Public API
  version: 1.0.0
  description: Programmatic access to your AGO workspace.
servers:
  - url: https://{tenant_id}.api.useago.com
    description: AGO Public API v1
    variables:
      tenant_id:
        default: your-tenant-id
        description: Your AGO tenant identifier
security: []
paths:
  /api/v1/tasks:
    post:
      tags:
        - Tasks
      summary: Create Task
      description: >-
        Create a task. Retrying with the same `Idempotency-Key` returns the
        first response.
      operationId: create_task
      parameters:
        - in: header
          name: Idempotency-Key
          schema:
            anyOf:
              - type: string
              - type: 'null'
            title: Idempotency-Key
          required: false
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TaskCreateIn'
        required: true
      responses:
        '201':
          description: Created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TaskOut'
      security:
        - ScopedAPIKeyAuth: []
components:
  schemas:
    TaskCreateIn:
      properties:
        title:
          maxLength: 200
          title: Title
          type: string
        description:
          anyOf:
            - maxLength: 5000
              type: string
            - type: 'null'
          title: Description
        status:
          anyOf:
            - type: string
            - type: 'null'
          description: Status key or id. Defaults to the first to-do status.
          title: Status
        priority:
          anyOf:
            - type: string
            - type: 'null'
          description: none, low, normal, high, or urgent
          title: Priority
        deadline:
          anyOf:
            - format: date
              type: string
            - type: 'null'
          title: Deadline
        owner_id:
          anyOf:
            - format: uuid
              type: string
            - type: 'null'
          description: An active staff member. Omit to leave unowned.
          title: Owner Id
        label_ids:
          items:
            format: uuid
            type: string
          title: Label Ids
          type: array
        links:
          items:
            $ref: '#/components/schemas/TaskLinkIn'
          maxItems: 10
          title: Links
          type: array
      required:
        - title
      title: TaskCreateIn
      type: object
    TaskOut:
      properties:
        id:
          title: Id
          type: string
        identifier:
          anyOf:
            - type: string
            - type: 'null'
          description: Short handle such as TASK-12, accepted wherever a task id is.
          title: Identifier
        title:
          title: Title
          type: string
        description:
          default: ''
          title: Description
          type: string
        status:
          $ref: '#/components/schemas/TaskStatusRef'
        priority:
          title: Priority
          type: string
        deadline:
          anyOf:
            - format: date
              type: string
            - type: 'null'
          title: Deadline
        owner:
          anyOf:
            - $ref: '#/components/schemas/TaskUserRef'
            - type: 'null'
        labels:
          items:
            $ref: '#/components/schemas/TaskLabelOut'
          title: Labels
          type: array
        links:
          items:
            $ref: '#/components/schemas/TaskLinkOut'
          title: Links
          type: array
        source:
          title: Source
          type: string
        created_by:
          anyOf:
            - $ref: '#/components/schemas/TaskUserRef'
            - type: 'null'
        revision:
          title: Revision
          type: integer
        created_at:
          format: date-time
          title: Created At
          type: string
        updated_at:
          format: date-time
          title: Updated At
          type: string
        finished_at:
          anyOf:
            - format: date-time
              type: string
            - type: 'null'
          title: Finished At
        archived_at:
          anyOf:
            - format: date-time
              type: string
            - type: 'null'
          title: Archived At
        admin_url:
          title: Admin Url
          type: string
      required:
        - id
        - title
        - status
        - priority
        - labels
        - links
        - source
        - revision
        - created_at
        - updated_at
        - admin_url
      title: TaskOut
      type: object
    TaskLinkIn:
      properties:
        target_type:
          description: conversation, ticket, feedback, message, or knowledge_update_request
          examples:
            - conversation
          title: Target Type
          type: string
        target_id:
          format: uuid
          title: Target Id
          type: string
      required:
        - target_type
        - target_id
      title: TaskLinkIn
      type: object
    TaskStatusRef:
      properties:
        key:
          title: Key
          type: string
        label:
          title: Label
          type: string
        category:
          description: todo, in_progress, done, or canceled
          title: Category
          type: string
        role:
          anyOf:
            - type: string
            - type: 'null'
          description: '"review" for the review column'
          title: Role
      required:
        - key
        - label
        - category
      title: TaskStatusRef
      type: object
    TaskUserRef:
      properties:
        id:
          title: Id
          type: string
        name:
          anyOf:
            - type: string
            - type: 'null'
          title: Name
        email:
          anyOf:
            - type: string
            - type: 'null'
          title: Email
      required:
        - id
      title: TaskUserRef
      type: object
    TaskLabelOut:
      properties:
        id:
          title: Id
          type: string
        name:
          title: Name
          type: string
        color:
          title: Color
          type: string
      required:
        - id
        - name
        - color
      title: TaskLabelOut
      type: object
    TaskLinkOut:
      properties:
        id:
          title: Id
          type: string
        target_type:
          title: Target Type
          type: string
        target_id:
          title: Target Id
          type: string
        context:
          $ref: '#/components/schemas/TaskLinkContext'
        deleted:
          description: True when the linked record was deleted; the link stays as history.
          title: Deleted
          type: boolean
        admin_url:
          anyOf:
            - type: string
            - type: 'null'
          title: Admin Url
      required:
        - id
        - target_type
        - target_id
        - context
        - deleted
      title: TaskLinkOut
      type: object
    TaskLinkContext:
      properties:
        conversation_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Conversation Id
        message_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Message Id
      title: TaskLinkContext
      type: object
  securitySchemes:
    ScopedAPIKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.