POST/workflow/users/{userId}/documents

決裁文書を作成する。
ユーザーアカウントで取得した Access Token を利用してアクセスしてください。

注意

  • 原職の所属会社でのみ作成できる。
  • 決裁ラインと共有範囲は、管理者が設定した内容で作成される。
  • 承認ライン情報を指定することで、決裁ラインを設定できる。

参考

  • 決裁ライン情報の決裁者 ID を設定すると、元の所属部署のメンバーとして通常の決裁ラインが作成される。
  • 決裁ライン情報で決裁者 ID のみを指定した場合、決裁ラインの順序は入力順となり、type は APPROVAL、status は最初の承認者は PENDING、それ以降は UPCOMING で作成される。

Authorization

oauth2

Access Token を指定します。
指定の方法や Access Token の取得方法は 共通仕様 を参照してください。

Scope

workflow

HTTP Request

POSThttps://www.worksapis.com/v1.0/workflow/users/{userId}/documents

Path Parameters

ParameterTypeDescription
userId string 

ユーザー ID またはログイン ID


required 

Header Parameters

HeadertypeDescription
Authorization string 

Bearer {token}


required 
Content-Type string 

application/json


required 

Request Body

PropertyTypeDescription
title string 

文書タイトル


required
minLength : 1
maxLength : 200 
documentFormId string 

申請フォーマット ID


required 
documentBody array (DocumentBody) 

決裁文書の作成と読み取り を参照する。


required 
approvalLines array (ApprovalLine) 

userId（承認者ID）は次のような形で指定する

  • リソース ID
 

DocumentBody

PropertyTypeDescription
componentType string 

コンポーネントタイプ


required 
componentId string 

コンポーネントID（コンポーネント ID、またはカスタムID）


required 
componentValue object 

コンポーネント値

 

ApprovalLine

PropertyTypeDescription
sequence integer 

決裁ラインの順序

 
type string 

決裁ラインの決裁タイプ

  • APPROVAL: 承認
  • REFERENCE: 自動承認
  • AGREEMENT: 合意
  • PARALLEL_APPROVAL: 並列承認
  • PARALLEL_AGREEMENT: 並列合意
 
status string 

決裁処理状態

  • UPCOMING: 予定
  • PENDING: 保留
  • APPROVED: 承認
  • REJECTED: 却下
  • DELEGATED_MANAGER: 管理者による委任
  • DELEGATED_USER: 承認者による委任
  • DELEGATED_AUTO: 自動的な委任
 
userId string 

決裁者 ID

 
userName string 

決裁者名

 
orgUnitId string 

決裁者の組織 ID

 
orgUnitName string 

決裁者の組織名

 
approvalTime string 

決裁日時（形式:YYYY-MM-DDThh:mm:ssTZD）

 

Request Example

example

1{2  "title": "休暇使用計画書",3  "documentFormId": "16d11974-1234-1234-1234-52322ff286ee",4  "documentBody": [5    {6      "componentType": "CP_TEXT",7      "componentId": "f230ab03-1234-1234-1234-3fd20d30d711",8      "componentValue": {9        "value": "ワークス太郎"10      }11    }12  ],13  "approvalLines": [14    {15      "userId": "20754547-1234-1234-1234-030918f30e4d"16    },17    {18      "userId": "33384672-1234-1234-1234-865423r31q2r"19    }20  ]21}

Response

HTTP 201

OK

PropertyTypeDescription
domainId integer 

ドメイン ID


required 
approvalDocumentId integer 

決裁文書 ID


required 
documentFormId string 

申請フォーマット ID


required 
categoryId integer 

カテゴリー ID


required 
documentNumber string 

文書番号

 
title string 

タイトル

 
status string 

ステータス

  • IN-PROGRESS: 進行中
  • APPROVED: 完了
  • REJECTED: 却下
  • CANCELED: 引き戻し

required 
userId string 

申請者 ID

 
userName string 

申請者名

 
orgUnitId string 

申請者の組織 ID

 
orgUnitName string 

申請者の組織名

 
createdTime string 

申請日時（形式:YYYY-MM-DDThh:mm:ssTZD）


required 
completedTime string 

完了日時（形式:YYYY-MM-DDThh:mm:ssTZD）

 
visible boolean 

文書の公開可否

 
viewUrl string 

文書の参照 URL

 
approvalLines array (ApprovalLine) 

決裁ライン情報

 
shareType string 

共有範囲

  • PART_SHARE: メンバー指定
  • ALL_SHARE: すべてのメンバー
 
sharedMembers array (Shared) 

共有範囲情報

 
opinionCount integer 

コメントの数

 
attachmentCount integer 

添付ファイルの数

 
relatedDocumentCount integer 

参考文書の数

 
recipientCount integer 

このPropertyは利用されていません。

 
recipients object 

このPropertyは利用されていません。


nullable : true 
documentBody object 

決裁文書の作成と読み取り を参照する。

 

ApprovalLine

PropertyTypeDescription
sequence integer 

決裁ラインの順序

 
type string 

決裁ラインの決裁タイプ

  • APPROVAL: 承認
  • REFERENCE: 自動承認
  • AGREEMENT: 合意
  • PARALLEL_APPROVAL: 並列承認
  • PARALLEL_AGREEMENT: 並列合意
 
status string 

決裁処理状態

  • UPCOMING: 予定
  • PENDING: 保留
  • APPROVED: 承認
  • REJECTED: 却下
  • DELEGATED_MANAGER: 管理者による委任
  • DELEGATED_USER: 承認者による委任
  • DELEGATED_AUTO: 自動的な委任
 
userId string 

決裁者 ID

 
userName string 

決裁者名

 
orgUnitId string 

決裁者の組織 ID

 
orgUnitName string 

決裁者の組織名

 
approvalTime string 

決裁日時（形式:YYYY-MM-DDThh:mm:ssTZD）

 

Shared

PropertyTypeDescription
type string 

共有先

  • DOMAIN: すべてのメンバー (ドメイン)
  • USER: メンバー
  • ORGUNIT: 組織
  • ORGUNIT_INCLUDE_SUBS: 下位を含む組織

required 
id string 

共有先の ID

  • 共有範囲が「すべてのメンバー」の場合には、ドメイン ID
  • 共有範囲が「メンバー」の場合、ユーザー ID
  • 共有範囲が「組織」または「下位を含む組織」の場合には、組織 ID

required 
name string 

共有先の名前

  • 共有範囲が「すべてのメンバー」の場合には、会社名
  • 共有範囲が「メンバー」の場合、ユーザー名
  • 共有範囲が「組織」または「下位を含む組織」の場合には、組織名
 

Response Example

example

1{2  "domainId": 10000001,3  "approvalDocumentId": 10001,4  "documentFormId": "16d11974-1234-1234-1234-52322ff286ee",5  "categoryId": 10,6  "documentNumber": "2026-CUS001-00001",7  "title": "休暇使用計画書",8  "status": "IN-PROGRESS",9  "userId": "userf7da-1234-1234-1234-030f3b4c756x",10  "userName": "ワークス太郎",11  "orgUnitId": "2c048949-1234-1234-1234-0374dd0b1976",12  "orgUnitName": "人事部",13  "createdTime": "2026-01-01T10:00:00+09:00",14  "completedTime": "",15  "visible": true,16  "viewUrl": "https://flow.worksmobile.com/user/view/doc/10001",17  "approvalLines": [18    {19      "sequence": 1,20      "type": "APPROVAL",21      "status": "PENDING",22      "userId": "20754547-1234-1234-1234-030918f30e4d",23      "userName": "Susan Nielsen",24      "orgUnitId": "2c048949-1234-1234-1234-0374dd0b1976",25      "orgUnitName": "人事部",26      "approvalTime": ""27    },28    {29      "sequence": 2,30      "type": "APPROVAL",31      "status": "UPCOMING",32      "userId": "1a29db81-1234-1234-1234-031ac869197d",33      "userName": "ワークス次郎",34      "orgUnitId": "2c048949-1234-1234-1234-0374dd0b1976",35      "orgUnitName": "総務部",36      "approvalTime": ""37    }38  ],39  "shareType": "PART_SHARE",40  "sharedMembers": [41    {42      "type": "USER",43      "id": "56006105-1234-1234-1234-27c0bde4258c",44      "name": "ワークス花子"45    }46  ],47  "opinionCount": 0,48  "attachmentCount": 0,49  "relatedDocumentCount": 0,50  "recipientCount": 0,51  "documentBody": {}52}

HTTP 403

Forbidden