Skip to main content
Server path: /chatwork | Type: Application | PCID required: Yes

Tools

ToolDescription
chatwork_accept_incoming_requestAccept contact request
chatwork_create_roomCreate new group chat
chatwork_create_room_linkCreate room invite link
chatwork_create_room_taskCreate new task
chatwork_delete_or_leave_roomLeave or delete group chat
chatwork_delete_room_linkDelete room invite link
chatwork_delete_room_messageDelete message
chatwork_get_contactsList contacts
chatwork_get_incoming_requestsList contact requests
chatwork_get_meGet own account info
chatwork_get_my_statusGet unread/mention/task counts
chatwork_get_my_tasksList own tasks
chatwork_get_roomGet chat info
chatwork_get_room_fileGet file info
chatwork_get_room_filesList room files
chatwork_get_room_linkGet room invite link
chatwork_get_room_membersList chat members
chatwork_get_room_messageGet specific message
chatwork_get_room_messagesList messages
chatwork_get_room_taskGet task info
chatwork_get_room_tasksList room tasks
chatwork_get_roomsList chats
chatwork_post_room_messagePost new message
chatwork_read_room_messagesMark messages as read
chatwork_reject_incoming_requestReject contact request
chatwork_unread_room_messageMark message as unread
chatwork_update_roomUpdate chat info
chatwork_update_room_linkUpdate room invite link
chatwork_update_room_membersBulk update chat members
chatwork_update_room_messageUpdate message
chatwork_update_room_task_statusUpdate task status

chatwork_accept_incoming_request

Accept contact request Parameters:
ParameterTypeRequiredDefaultDescription
request_idintegerYesContact request ID

chatwork_create_room

Create new group chat Parameters:
ParameterTypeRequiredDefaultDescription
descriptionstringNoChat room description
icon_presetstringNoIcon type
linkintegerNo0 or 1. Whether to create an invitation link
link_codestringNoInvitation link code (1-50 chars). Random if omitted
link_need_acceptanceintegerNo0 or 1. Whether admin approval is required for link
members_admin_idsstringYesComma-separated admin account IDs (at least one required)
members_member_idsstringNoComma-separated member account IDs
members_readonly_idsstringNoComma-separated readonly account IDs
namestringYesChat room name (1-255 chars)

Create room invite link Parameters:
ParameterTypeRequiredDefaultDescription
room_idintegerYesChat room ID
codestringNoLink code (1-50 chars). Random if omitted
descriptionstringNoLink description
need_acceptanceintegerNo0 or 1. Whether admin approval is required (default 1)

chatwork_create_room_task

Create new task Parameters:
ParameterTypeRequiredDefaultDescription
room_idintegerYesChat room ID
bodystringYesTask content (max 65535 chars)
limitintegerNoDeadline as Unix timestamp
limit_typestringNoDeadline type
to_idsstringYesComma-separated assignee account IDs

chatwork_delete_or_leave_room

Leave or delete group chat Parameters:
ParameterTypeRequiredDefaultDescription
room_idintegerYesChat room ID
action_typestringYesWhether to leave or delete the room

Delete room invite link Parameters:
ParameterTypeRequiredDefaultDescription
room_idintegerYesChat room ID

chatwork_delete_room_message

Delete message Parameters:
ParameterTypeRequiredDefaultDescription
room_idintegerYesChat room ID
message_idstringYesMessage ID

chatwork_get_contacts

List contacts

chatwork_get_incoming_requests

List contact requests

chatwork_get_me

Get own account info

chatwork_get_my_status

Get unread/mention/task counts

chatwork_get_my_tasks

List own tasks Parameters:
ParameterTypeRequiredDefaultDescription
assigned_by_account_idintegerNoFilter by the account ID of the person who assigned the task.
statusstringNoFilter by task status.

chatwork_get_room

Get chat info Parameters:
ParameterTypeRequiredDefaultDescription
room_idintegerYesChat room ID

chatwork_get_room_file

Get file info Parameters:
ParameterTypeRequiredDefaultDescription
room_idintegerYesChat room ID
file_idintegerYesFile ID
create_download_urlintegerNoSet to 1 to include a temporary download URL (valid for 30 seconds).

chatwork_get_room_files

List room files Parameters:
ParameterTypeRequiredDefaultDescription
room_idintegerYesChat room ID
account_idintegerNoFilter by uploader account ID.

Get room invite link Parameters:
ParameterTypeRequiredDefaultDescription
room_idintegerYesChat room ID

chatwork_get_room_members

List chat members Parameters:
ParameterTypeRequiredDefaultDescription
room_idintegerYesChat room ID

chatwork_get_room_message

Get specific message Parameters:
ParameterTypeRequiredDefaultDescription
room_idintegerYesChat room ID
message_idstringYesMessage ID

chatwork_get_room_messages

List messages Parameters:
ParameterTypeRequiredDefaultDescription
room_idintegerYesChat room ID
forceintegerNoSet to 1 to get the latest 100 messages regardless of read state. Default is 0 (new messages only).

chatwork_get_room_task

Get task info Parameters:
ParameterTypeRequiredDefaultDescription
room_idintegerYesChat room ID
task_idintegerYesTask ID

chatwork_get_room_tasks

List room tasks Parameters:
ParameterTypeRequiredDefaultDescription
room_idintegerYesChat room ID
account_idintegerNoFilter by assignee account ID.
assigned_by_account_idintegerNoFilter by assigner account ID.
statusstringNoFilter by task status.

chatwork_get_rooms

List chats

chatwork_post_room_message

Post new message Parameters:
ParameterTypeRequiredDefaultDescription
room_idintegerYesChat room ID
bodystringYesMessage body (1-65535 chars)
self_unreadintegerNo0 (default, mark as read) or 1 (mark as unread for self)

chatwork_read_room_messages

Mark messages as read Parameters:
ParameterTypeRequiredDefaultDescription
room_idintegerYesChat room ID
message_idstringNoMessage ID. All messages up to this ID are marked as read.

chatwork_reject_incoming_request

Reject contact request Parameters:
ParameterTypeRequiredDefaultDescription
request_idintegerYesContact request ID

chatwork_unread_room_message

Mark message as unread Parameters:
ParameterTypeRequiredDefaultDescription
room_idintegerYesChat room ID
message_idstringYesMessages from this ID onward become unread

chatwork_update_room

Update chat info Parameters:
ParameterTypeRequiredDefaultDescription
room_idintegerYesChat room ID
descriptionstringNoChat room description
icon_presetstringNoIcon type
namestringNoChat room name (1-255 chars)

Update room invite link Parameters:
ParameterTypeRequiredDefaultDescription
room_idintegerYesChat room ID
codestringNoLink code (1-50 chars)
descriptionstringNoLink description
need_acceptanceintegerNo0 or 1. Whether admin approval is required

chatwork_update_room_members

Bulk update chat members Parameters:
ParameterTypeRequiredDefaultDescription
room_idintegerYesChat room ID
members_admin_idsstringYesComma-separated admin account IDs (at least one required)
members_member_idsstringNoComma-separated member account IDs
members_readonly_idsstringNoComma-separated readonly account IDs

chatwork_update_room_message

Update message Parameters:
ParameterTypeRequiredDefaultDescription
room_idintegerYesChat room ID
message_idstringYesMessage ID
bodystringYesNew message body (1-65535 chars)

chatwork_update_room_task_status

Update task status Parameters:
ParameterTypeRequiredDefaultDescription
room_idintegerYesChat room ID
task_idintegerYesTask ID
bodystringYesTask status