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

# 创建

> Creates a new task.



## OpenAPI

````yaml POST /task/create
openapi: 3.0.2
info:
  title: ORION Platform REST API
  description: OpenApi Spec for ORION Camunda Platform REST API.
  version: 7.22.6-ee
  license:
    name: Apache License 2.0
    url: http://www.apache.org/licenses/LICENSE-2.0.html
servers:
  - url: http://{host}:{port}/{contextPath}
    description: The API server for the default process engine
    variables:
      host:
        default: localhost
      port:
        default: '8080'
      contextPath:
        default: engine-rest
  - url: http://{host}:{port}/{contextPath}/engine/{engineName}
    description: The API server for a named process engine
    variables:
      host:
        default: localhost
      port:
        default: '8080'
      contextPath:
        default: engine-rest
      engineName:
        default: default
  - url: '{url}'
    description: The API server with a custom url
    variables:
      url:
        default: ''
security:
  - basicAuth: []
tags:
  - name: Authorization
  - name: Batch
  - name: Condition
  - name: Decision Definition
  - name: Decision Requirements Definition
  - name: Deployment
  - name: Engine
  - name: Event Subscription
  - name: Execution
  - name: External Task
  - name: Filter
  - name: Group
  - name: Historic Activity Instance
  - name: Historic Batch
  - name: Historic Decision Definition
  - name: Historic Decision Instance
  - name: Historic Decision Requirements Definition
  - name: Historic Detail
  - name: Historic External Task Log
  - name: Historic Identity Link Log
  - name: Historic Incident
  - name: Historic Job Log
  - name: Historic Process Definition
  - name: Historic Process Instance
  - name: Historic Task Instance
  - name: Historic User Operation Log
  - name: Historic Variable Instance
  - name: History Cleanup
  - name: Identity
  - name: Incident
  - name: Job
  - name: Job Definition
  - name: Message
  - name: Metrics
  - name: Migration
  - name: Modification
  - name: Process Definition
  - name: Process Instance
  - name: Signal
  - name: Schema Log
  - name: Task
  - name: Task Attachment
  - name: Task Comment
  - name: Task Identity Link
  - name: Task Local Variable
  - name: Task Variable
  - name: Telemetry
  - name: Tenant
  - name: User
  - name: Variable Instance
  - name: Version
externalDocs:
  description: Find out more about ORION Rest API
  url: https://docs.eorion.com
paths:
  /task/create:
    post:
      tags:
        - Task
      summary: Create
      description: Creates a new task.
      operationId: createTask
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TaskDto'
            examples:
              example-1:
                summary: POST /task/create
                value:
                  id: aTaskId
                  name: My Task
                  description: This have to be done very urgent
                  priority: 30
                  assignee: peter
                  owner: mary
                  delegationState: PENDING
                  due: 2014-08-30T10:00:00.000+0200
                  followUp: 2014-08-25T10:00:00.000+0200
                  parentTaskId: aParentTaskId
                  caseInstanceId: aCaseInstanceId
                  tenantId: null
      responses:
        '204':
          description: Request successful.
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExceptionDto'
          description: >-
            Returned if a not valid `delegationState` is supplied. See the

            [Introduction](https://docs.camunda.org/manual/7.22/reference/rest/overview/#error-handling)

            for the error response format.
components:
  schemas:
    TaskDto:
      type: object
      properties:
        id:
          type: string
          nullable: true
          description: The task id.
        name:
          type: string
          nullable: true
          description: The task name.
        assignee:
          type: string
          nullable: true
          description: The assignee's id.
        owner:
          type: string
          nullable: true
          description: The owner's id.
        created:
          type: string
          format: date-time
          nullable: true
          description: >-
            The date the task was created on.

            [Default
            format](https://docs.camunda.org/manual/7.22/reference/rest/overview/date-format/)

            `yyyy-MM-dd'T'HH:mm:ss.SSSZ`.
        lastUpdated:
          type: string
          format: date-time
          nullable: true
          description: >-
            The date the task was last updated. Every action that fires a [task
            update
            event](https://docs.camunda.org/manual/7.22/user-guide/process-engine/delegation-code/#task-listener-event-lifecycle)
            will update this property.

            [Default
            format](https://docs.camunda.org/manual/7.22/reference/rest/overview/date-format/)

            `yyyy-MM-dd'T'HH:mm:ss.SSSZ`.
        due:
          type: string
          format: date-time
          nullable: true
          description: >-
            The task's due date.

            [Default
            format](https://docs.camunda.org/manual/7.22/reference/rest/overview/date-format/)

            `yyyy-MM-dd'T'HH:mm:ss.SSSZ`.
        followUp:
          type: string
          format: date-time
          nullable: true
          description: >-
            The follow-up date for the task.

            [Default
            format](https://docs.camunda.org/manual/7.22/reference/rest/overview/date-format/)

            `yyyy-MM-dd'T'HH:mm:ss.SSSZ`.
        delegationState:
          type: string
          nullable: true
          enum:
            - PENDING
            - RESOLVED
          description: >-
            The task's delegation state. Possible values are `PENDING` and
            `RESOLVED`.
        description:
          type: string
          nullable: true
          description: The task's description.
        executionId:
          type: string
          nullable: true
          description: The id of the execution the task belongs to.
        parentTaskId:
          type: string
          nullable: true
          description: The id the parent task, if this task is a subtask.
        priority:
          type: integer
          format: int32
          nullable: true
          description: The task's priority.
        processDefinitionId:
          type: string
          nullable: true
          description: The id of the process definition the task belongs to.
        processInstanceId:
          type: string
          nullable: true
          description: The id of the process instance the task belongs to.
        caseExecutionId:
          type: string
          nullable: true
          description: The id of the case execution the task belongs to.
        caseDefinitionId:
          type: string
          nullable: true
          description: The id of the case definition the task belongs to.
        caseInstanceId:
          type: string
          nullable: true
          description: The id of the case instance the task belongs to.
        taskDefinitionKey:
          type: string
          nullable: true
          description: The task's key.
        suspended:
          type: boolean
          nullable: true
          description: Whether the task belongs to a process instance that is suspended.
        formKey:
          type: string
          nullable: true
          description: If not `null`, the form key for the task.
        camundaFormRef:
          $ref: '#/components/schemas/CamundaFormRef'
        tenantId:
          type: string
          nullable: true
          description: If not `null`, the tenant id of the task.
        taskState:
          type: string
          nullable: true
          description: The task's state.
    ExceptionDto:
      title: ExceptionDto
      type: object
      properties:
        type:
          type: string
          nullable: true
          description: An exception class indicating the occurred error.
        message:
          type: string
          nullable: true
          description: A detailed message of the error.
        code:
          type: number
          description: >-
            The code allows your client application to identify the error in an
            automated fashion.

            You can look up the meaning of all built-in codes and learn how to
            add custom codes

            in the [User
            Guide](https://docs.camunda.org/manual/7.22/user-guide/process-engine/error-handling/#exception-codes).
    CamundaFormRef:
      type: object
      properties:
        key:
          type: string
          nullable: true
          description: The key of the Camunda Form.
        binding:
          type: string
          nullable: true
          description: >-
            The binding of the Camunda Form. Can be `latest`, `deployment` or
            `version`.
        version:
          type: integer
          format: int32
          nullable: true
          description: >-
            The specific version of a Camunda Form. This property is only set if
            `binding` is `version`.
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic

````