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

# Create Task

> Creates a new task.

## Create Card

```http theme={null}
POST /api/card HTTP/1.1
Content-Type: application/json
```

**Request body:**

| Field                       | Type    | Description                                                                                           |
| --------------------------- | ------- | ----------------------------------------------------------------------------------------------------- |
| `product`                   | string  | `Graphics`, `Video`, `Development`, `Canva Graphics`, `Canva Video`, `Canva Plus`, `Graphics + Video` |
| `title`                     | string  | Card title                                                                                            |
| `typeId`                    | string  | Request type ID                                                                                       |
| `description`               | string  | Task description                                                                                      |
| `brandId`                   | string  | Brand ID                                                                                              |
| `tagIds`                    | string  | Comma-separated tag IDs                                                                               |
| `isDraft`                   | boolean | Save as draft                                                                                         |
| `isDevelopmentTask`         | boolean | Switch to dev card flow                                                                               |
| `designSource`              | string  | `kimp` or `provided`                                                                                  |
| `dimension`                 | string  | Dimensions                                                                                            |
| `textCopy`                  | string  | Text copy content                                                                                     |
| `fileFormats`               | string  | Required file formats                                                                                 |
| `software`                  | string  | Software to use                                                                                       |
| `additionalFiles`           | string  | Comma-separated URLs                                                                                  |
| `referenceFiles`            | string  | Comma-separated URLs                                                                                  |
| `textCopyFiles`             | string  | Comma-separated URLs                                                                                  |
| `linkedDesignTask`          | array   | Array of linked card IDs                                                                              |
| `providedDesignLink`        | string  | Link to provided design                                                                               |
| `accessInfo`                | string  | Access credentials/info                                                                               |
| `functionalityRequirements` | string  | Dev task requirements                                                                                 |

**Response:**

```json theme={null}
{
  "id": "string",
  "title": "string",
  "status": { "id": "string", "name": "string" }
}
```


## OpenAPI

````yaml post /card
openapi: 3.0.0
info:
  title: KIMP360 API
  version: 1.0.0
servers:
  - url: https://api.kimp360.com
security:
  - ApiKeyAuth: []
paths:
  /card:
    post:
      summary: Create Task
      description: Creates a new task.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TaskInput'
      responses:
        '200':
          description: Created task object
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Task'
components:
  schemas:
    TaskInput:
      type: object
      required:
        - title
        - description
        - typeId
        - dimension
        - software
        - fileFormats
      properties:
        title:
          type: string
        description:
          type: string
        typeId:
          type: string
        dimension:
          type: string
        software:
          type: string
        fileFormats:
          type: string
        isDraft:
          type: boolean
        product:
          type: string
          enum:
            - Graphics
            - Video
            - Canva Graphics
            - Canva Plus
        textCopy:
          type: string
        brandId:
          type: string
        textCopyFiles:
          type: string
        additionalFiles:
          type: string
        additionalFilesNote:
          type: string
        referenceFiles:
          type: string
        referenceFilesNote:
          type: string
        tagIds:
          type: string
    Task:
      type: object
      properties:
        id:
          type: string
        title:
          type: string
        description:
          type: string
        product_type:
          type: string
        dimensions:
          type: string
        labels:
          type: string
        tags:
          type: string
        text_copy:
          type: string
        file_formats:
          type: string
        software:
          type: string
        created_at:
          type: string
        updated_at:
          type: string
        request_type:
          type: string
          nullable: true
        created_by:
          type: string
          nullable: true
        due_date:
          type: string
          nullable: true
        status:
          $ref: '#/components/schemas/TaskStatus'
        files:
          type: array
          items:
            $ref: '#/components/schemas/File'
        brand:
          type: string
          nullable: true
    TaskStatus:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
        color:
          type: string
    File:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
        ext:
          type: string
        urls:
          type: object
          properties:
            full:
              type: string
            large:
              type: string
            medium:
              type: string
            small:
              type: string
        type:
          type: string
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````