Chatwork

Decline a contact approval request. DELETE /v2/incoming_requests/{request_id}. Declines one pending contact approval request. The requester is not added as a contact. Chatwork's own wording: コンタクト承認依頼を拒否する 自分へのコンタクト承認依頼を拒否します。

Leave or delete a group chat. DELETE /v2/rooms/{room_id}. Leaves or deletes a group chat, and `action_type` decides which. Leaving deletes every task assigned to you and every file you uploaded in that chat; deleting removes the chat and all of its messages, tasks and files for every member. Both are irreversible. Chatwork's own wording: チャットを退席/削除する グループチャットを退席、または削除します。 グループチャットを退席すると、このグループチャットにある自分が担当者のタスク、および自分が送信したファイルがすべて削除されます。 グループチャットを削除すると、このグループチャットにあるメッセージ、タスク、ファイルがすべて削除されます。 （一度削除すると元に戻せません。）

Delete a chat's invite link. DELETE /v2/rooms/{room_id}/link. Deletes the chat's invite link, so the URL stops admitting anyone. Returns 400 if the chat has no active invite link. Chatwork's own wording: チャットへの招待リンクを削除する チャットへの招待リンクを削除します。 招待リンクが無効になっている場合は400エラーを返します。

Delete a message. DELETE /v2/rooms/{room_id}/messages/{message_id}. Deletes one message from a chat. Irreversible. Chatwork's own wording: チャットのメッセージを削除する チャットのメッセージを削除します。

List your contacts. GET /v2/contacts. Returns every account in the connected account's contact list, with each contact's account id, direct-chat room id, organization and avatar. Chatwork's own wording: コンタクト一覧を取得する 自分のコンタクト一覧を取得します。

List contact approval requests sent to you. GET /v2/incoming_requests. Returns up to 100 pending contact approval requests addressed to the connected account, each with its request id and the requesting account's profile. Chatwork's own wording: コンタクト承認依頼一覧を取得する 自分へのコンタクト承認依頼一覧を最大100件まで取得します。

Get your own account information. GET /v2/me. Returns the connected account's own profile: account id, Chatwork ID, display name, organization id and name, department, title, both email addresses, the three phone numbers, Skype/Facebook/Twitter handles and the avatar URL. Chatwork's own wording: 自分の情報を取得する 自分自身の情報を取得します。

Get your unread and open-task counts. GET /v2/my/status. Returns three counters for the connected account: rooms with unread messages, rooms with an unread message addressed to them, and open tasks assigned to them. Cheap enough to poll, and the endpoint the credential probe uses. Chatwork's own wording: 自分の状態を取得する 自分の未読数、自分宛ての未読の数、未完了タスク数を取得します。

List the tasks assigned to you. GET /v2/my/tasks. Returns up to 100 tasks assigned to the connected account across every chat, each with its body, due date, status and the chat it belongs to. Filterable by who assigned it and by open/done status. Chatwork's own wording: 自分のタスク一覧を取得する 自分のタスク一覧を最大100件まで取得します。

List your chats. GET /v2/rooms. Returns every chat the connected account belongs to -- group chats, direct chats and My Chat -- with each chat's type, the account's role in it, unread and mention counts, and file and task counts. Chatwork's own wording: チャット一覧を取得する チャット一覧を取得します。

Get a chat's information. GET /v2/rooms/{room_id}. Returns one chat's name, description, icon, type, the connected account's role in it, its unread and mention counts, and its file and task counts. Chatwork's own wording: チャットの情報を取得する チャットの情報（名前、アイコン、種類など）を取得します。

List a chat's files. GET /v2/rooms/{room_id}/files. Returns up to 100 files uploaded to one chat, each with its file id, uploader, name, size and the message it was posted with. Optionally filtered to one uploader. Chatwork's own wording: チャットのファイル一覧を取得する チャットのファイル一覧を最大100件まで取得します。

Get a chat file's information. GET /v2/rooms/{room_id}/files/{file_id}. Returns one file's name, size, uploader and message id. Pass `create_download_url=1` to also receive a download URL, which Chatwork says is valid for 30 seconds -- so fetch it at the moment you need it, not ahead of time. Chatwork's own wording: チャットのファイルの情報を取得する チャットのファイルの情報を取得します。

Get a chat's invite link. GET /v2/rooms/{room_id}/link. Returns the chat's invite link: its code, full URL, description, and whether joining needs an administrator's approval. Chatwork's own wording: チャットへの招待リンクを取得する チャットへの招待リンクを取得します。

List a chat's members. GET /v2/rooms/{room_id}/members. Returns every member of one chat with their account id, role (admin, member or readonly), organization and avatar. Chatwork's own wording: チャットのメンバー一覧を取得する チャットのメンバー一覧を取得します。

List a chat's messages. GET /v2/rooms/{room_id}/messages. Returns up to 100 messages from one chat. By default only messages newer than the previous call are returned, and an empty result means nothing new rather than an empty chat; pass `force=1` for the latest 100 regardless. Chatwork's own wording: チャットのメッセージ一覧を取得する チャットのメッセージ一覧を最大100件まで取得します。

Get one message. GET /v2/rooms/{room_id}/messages/{message_id}. Returns a single message by id, with its author, body, send time and last-update time. Chatwork's own wording: チャットのメッセージを取得する チャットのメッセージを取得します。

List a chat's tasks. GET /v2/rooms/{room_id}/tasks. Returns up to 100 tasks in one chat, each with its body, assignee, assigner, due date and status. Filterable by assignee, by who assigned it, and by open/done status. Chatwork's own wording: チャットのタスク一覧を取得する チャットのタスク一覧を最大100件まで取得します。

Get a chat task. GET /v2/rooms/{room_id}/tasks/{task_id}. Returns one task's body, assignee, assigner, due date, due-date kind and completion status. Chatwork's own wording: チャットのタスクの情報を取得する チャットのタスクの情報を取得します。

Create a group chat. POST /v2/rooms. Creates a new group chat and returns its room id. At least one administrator must be named in `members_admin_ids`, and every account named in any of the three member lists must already be a contact or in the same organization. Chatwork's own wording: グループチャットを作成する 新しいグループチャットを作成します。

Create a chat's invite link. POST /v2/rooms/{room_id}/link. Creates an invite link for the chat. Returns 400 if one already exists -- update it instead. Chatwork's own wording: チャットへの招待リンクを作成する チャットへの招待リンクを作成します。 すでに招待リンクが作成されている場合は400エラーを返します。

Post a message to a chat. POST /v2/rooms/{room_id}/messages. Posts a new message and returns its message id. The body uses Chatwork's own message notation -- [To:<account_id>], [rp aid=...], [info], [title], [code] -- which is documented at https://developer.chatwork.com/docs/message-notation. Rate-limited to 10 posts per 10 seconds per chat, shared with task creation. Chatwork's own wording: チャットにメッセージを投稿する チャットに新しいメッセージを投稿します。

Add a task to a chat. POST /v2/rooms/{room_id}/tasks. Creates a task in one chat, assigns it to every account named in `to_ids`, and returns the created task ids -- one per assignee. Rate-limited to 10 creations per 10 seconds per chat, shared with message posting. Chatwork's own wording: チャットにタスクを追加する チャットに新しいタスクを追加します。

Accept a contact approval request. PUT /v2/incoming_requests/{request_id}. Accepts one pending contact approval request; the requester becomes a contact and the response carries their profile. Chatwork's own wording: コンタクト承認依頼を承認する 自分へのコンタクト承認依頼を承認します。

Update a chat's information. PUT /v2/rooms/{room_id}. Changes a chat's name, description or icon. Only the fields sent are changed. Chatwork's own wording: チャットの情報を変更する チャットの情報（名前、アイコンなど）を変更します。

Update a chat's invite link. PUT /v2/rooms/{room_id}/link. Changes an existing invite link's code, description or approval requirement. Returns 400 if the chat has no active invite link -- create one first. Chatwork's own wording: チャットへの招待リンクを変更する チャットへの招待リンクを変更します。 招待リンクが無効になっている場合は400エラーを返します。

Replace a chat's members. PUT /v2/rooms/{room_id}/members. Replaces the whole member list of one chat in a single call. This is not an add: an account missing from all three id lists is REMOVED from the chat, so send the full intended membership every time. Chatwork's own wording: チャットのメンバーを変更する チャットのメンバーを一括で変更します。

Update a message. PUT /v2/rooms/{room_id}/messages/{message_id}. Replaces the body of a message the connected account sent. Chatwork refuses another account's message. Chatwork's own wording: チャットのメッセージを更新する チャットのメッセージを更新します。

Mark a chat's messages as read. PUT /v2/rooms/{room_id}/messages/read. Marks messages up to and including `message_id` as read and returns the chat's remaining unread counters. Omitting `message_id` marks the whole chat read. Chatwork's own wording: チャットのメッセージを既読にする チャットのメッセージを既読にします。

Mark a chat's messages as unread. PUT /v2/rooms/{room_id}/messages/unread. Marks the chat unread from `message_id` onwards and returns the resulting unread counters. `message_id` is required here, unlike the read call. Chatwork's own wording: チャットのメッセージを未読にする チャットのメッセージを未読にします。

Change a task's completion status. PUT /v2/rooms/{room_id}/tasks/{task_id}/status. Marks one task open or done and returns its task id. Chatwork's own wording: チャットのタスクの完了状態を変更する チャットのタスクの完了状態を変更します。