Creating a War Room

Updated on 2024-10-21 GMT+08:00

Function

This API is used to create a WarRoom.

URI

POST /v1/external/WarRooms

Request Parameters

Table 1 Request body parameter

Parameter

Mandatory or Not

Type

Description

war_room_name

Yes

String

War room title.

Minimum length: 1 character

Maximum length: 255 characters

description

No

String

War room description.

Minimum length: 0 character

Maximum length: 255 characters

region_code_list

No

Array of strings

Region ID

Minimum length: 1 character

Maximum length: 255 characters

Array length: 0 to 1,000 elements

application_id_list

Yes

Array of strings

ID of the affected application

Minimum length: 1 character

Maximum length: 255 characters

Array length: 1 to 1,000 elements

incident_number

Yes

String

Incident ticket ID

Minimum length: 1 character

Maximum length: 255 characters

schedule_group

Yes

Array of ScheduleGroupInfo objects

Schedule groups

Array length: 0 to 1,000 elements

participant

No

Array of strings

Participants

Minimum length: 0 character

Maximum length: 255 characters

Array length: 0 to 1,000 elements

war_room_admin

Yes

String

War room administrator.

Minimum length: 1 character

Maximum length: 255 characters

application_names

No

Array of strings

Application name list.

Minimum length: 0 character

Maximum length: 1,000 characters

Array length: 0 to 1,000 elements

region_names

No

Array of strings

Region names

Minimum length: 0 character

Maximum length: 1,000 characters

Array length: 0 to 1,000 elements

enterprise_project_id

Yes

String

Enterprise project ID

Minimum length: 1 character

Maximum length: 64 characters

notification_type

No

String

Group creation mode

Minimum length: 0 character

Maximum length: 64 characters

The value can be:

  • WECHAT
  • DING_TALK
  • LARK
  • NULL_GROUP
Table 2 ScheduleGroupInfo

Parameter

Mandatory or Not

Type

Description

role_id

Yes

String

Role ID

Minimum length: 0 character

Maximum length: 255 characters

scene_id

Yes

String

Scenario ID

Minimum length: 0 character

Maximum length: 255 characters

Response Parameters

Status code: 200

Table 3 Response body parameters

Parameter

Type

Description

provider_code

String

Service ID

Default value: 4

Minimum length: 3 characters

Maximum length: 3 characters

error_code

String

Request response code. The value ranges from 0000 to 9999. The value is 0 in normal cases.

Minimum length: 1 character

Maximum length: 20 characters

error_msg

String

Request response description

Minimum length: 0 character

Maximum length: 10,240 characters

data

String

WarRoom Id

Minimum length: 0 character

Maximum length: 255 characters

Request Example

None

Response Example

None

Status Code

Status Code

Description

200

Success response

Feedback

Feedback

Feedback

0/500

Selected Content

Submit selected content with the feedback