
# 发起审批实例
**请求方法**
POST /v1.0/workflow/processInstances HTTP/1.1
Host:api.dingtalk.com
x-acs-dingtalk-access-token:String
Content-Type:application/json
{
"originatorUserId" : "String",
"processCode" : "String",
"deptId" : Long,
"microappAgentId" : Long,
"approvers" : \[ {
"actionType" : "String",
"userIds" : \[ "String" \]
} \],
"ccList" : \[ "String" \],
"ccPosition" : "String",
"targetSelectActioners" : \[ {
"actionerKey" : "String",
"actionerUserIds" : \[ "String" \]
} \],
"formComponentValues" : \[ {
"name" : "String",
"value" : "String"
} \],
"RequestId" : "String"
}
Header参数
|             名称              |   类型   | 是否必填 |                                                                                                                                                                                                                                                                                            描述                                                                                                                                                                                                                                                                                            |
|---|---|---|---|
| x-acs-dingtalk-access-token | String | 是    | 调用该接口的访问凭证。 - 企业内部应用可调用[获取企业内部应用的accessToken](https://open.dingtalk.com/document/orgapp-server/obtain-the-access_token-of-an-internal-app)接口获取。  - 第三方企业应用可调用[获取第三方应用授权企业的access_token](https://open.dingtalk.com/document/isvapp-server/obtain-the-access_token-of-the-authorized-enterprise)接口获取。   |
   
Body参数
|          名称           |       类型        | 是否必填 |                                                                                                                                                                                                                                                               描述                                                                                                                                                                                                                                                                |
|---|---|---|---|
| originatorUserId      | String          | 是    | 审批发起人的userId。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| processCode           | String          | 是    | 审批流的唯一码。 - 通过调用[创建或更新审批表单模板](https://open.dingtalk.com/document/orgapp-server/create-an-approval-form-template#topic-2163975)接口获取。  - 通过[OA审批概述-名词解释](https://open.dingtalk.com/document/orgapp-server/workflow-overview#topic-1946142)获取。   |
| deptId                | Long            | 否    | 审批发起人所在的部门ID。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| microappAgentId       | Long            | 否    | 应用标识AgentId，获取方式请参考[基础概念](https://open.dingtalk.com/document/org/basic-concepts)。                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| approvers             | Array           | 否    | 不使用审批流模板时，直接指定的审批人列表，最大列表长度：20。 **说明** 指定审批单的执行流程，会覆盖审批单在OA后台设置的默认流程。                                                                                                                                                                                                                                                                                                                                                                 |
| ccList                | Array of String | 否    | 抄送人 userId。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| ccPosition            | String          | 否    | 抄送时间点，取值： - START：开始时抄送  - FINISH：结束时抄送  - START_FINISH：开始和结束时都抄送                                                                                |
| targetSelectActioners | Array           | 否    | 使用审批流模板时，流程预测结果中节点规则上必填的自选操作人列表，最大列表长度：20。 **说明** 使用OA后台设置的默认流程，并且流程中有审批人自选节点，该参数必填。                                                                                                                                                                                                                                                                                                                                                  |
| formComponentValues   | Array           | 是    | 表单数据内容，控件列表，最大列表长度：150。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
   
返回参数
|     名称     |   类型   |   描述    |
|---|---|---|
| instanceId | String | 审批实例id。 |
   
