Help Center/ CodeArts Pipeline/ API Reference/ API/ Pipeline Management/ Querying Pipeline Notification Details by Type
Updated on 2025-12-04 GMT+08:00

Querying Pipeline Notification Details by Type

Function

This API is used to query pipeline notification configuration details based on the notification type.

Calling Method

For details, see Calling APIs.

URI

GET /v5/{project_id}/api/pipeline-notices/{pipeline_id}/notice/detail

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

Definition:

Project ID. For details, see Obtaining a Project ID.

Constraints:

N/A

Value range:

The value consists of 32 characters, including digits and letters.

Default value:

N/A

pipeline_id

Yes

String

Definition:

Pipeline ID. Obtain the ID by calling the API for querying pipelines. pipelines.pipelineId indicates the pipeline ID.

Constraints:

N/A

Value range:

The value consists of 32 characters, including digits and letters.

Default value:

N/A

Table 2 Query Parameters

Parameter

Mandatory

Type

Description

type

Yes

Integer

Definition:

Pipeline notification type.

Constraints:

N/A

Range:

  • 1: System messages.

  • 2: Email notifications.

  • 3: WeCom.

  • 4: DingTalk.

  • 5: Feishu.

  • 6: Webhooks.

Default value:

N/A

Request Parameters

None

Response Parameters

Status code: 200

Table 3 Response body parameters

Parameter

Type

Description

type

Integer

Definition:

Pipeline notification type.

Constraints:

N/A

Range:

  • 1: System messages.

  • 2: Email notifications.

  • 3: WeCom.

  • 4: DingTalk.

  • 5: Feishu.

  • 6: Webhooks.

Default value:

N/A

event

EventStatusDTO object

Definition:

Configuration of notification events from third parties.

Constraints:

N/A

Range:

N/A

Default value:

N/A

webhook_config

ThirdPartEventDTO object

Definition:

Configuration of notification events from third parties.

Constraints:

N/A

Range:

N/A

Default value:

N/A

Table 4 EventStatusDTO

Parameter

Type

Description

id

String

Definition:

Event type.

Constraints:

N/A

Value range:

  • pipeline.updated: The pipeline configuration is updated.

  • pipeline.deleted: The pipeline is deleted.

  • pipelineRun.succeed: The pipeline is executed successfully.

  • pipelineRun.failed: The pipeline fails to be executed.

Default value:

N/A

selected

Boolean

Definition:

Whether to enable event notifications.

Constraints:

N/A

Value range:

  • true: enable notifications.

  • false: disable notifications.

Default value:

N/A

notice_roles

Array of strings

Definition:

Recipient list.

Constraints:

N/A

Range:

N/A

Default value:

N/A

Table 5 ThirdPartEventDTO

Parameter

Type

Description

notice_id

String

Definition:

Third-party notification configuration ID, the unique identifier of the third-party notification.

Constraints:

N/A

Range:

N/A

Default value:

N/A

url

String

Definition:

URL of the third-party notification. It can be obtained from the corresponding third-party platform.

Constraints:

The URL must start with http:// or https://.

Range:

N/A

Default value:

N/A

events

Array of strings

Definition:

Pipeline event type.

Constraints:

N/A

Range:

  • pipelineRun.succeed: completed.

  • pipelineRun.failed: failed.

  • pipelineRun.pause: paused.

  • pipelineRun.suspend: suspended.

  • pipelineRun.ignored: ignored.

Default value:

N/A

options

Array of strings

Definition:

Notification content list.

Constraints:

N/A

Range:

N/A

Default value:

N/A

mentioned_list

Array of strings

Definition:

Third-party user ID list. User IDs are separated by commas (,).

Constraints:

N/A

Range:

N/A

Default value:

N/A

mentioned_mobile_list

Array of strings

Definition:

Mobile number list.

Constraints:

N/A

Range:

N/A

Default value:

N/A

secret_info

String

Definition:

Signature key.

Constraints:

(Optional) Enter this parameter only when you have enabled security settings for the DingTalk, Feishu custom robots.

Value range:

N/A

Default value:

N/A

Status code: 400

Table 6 Response body parameters

Parameter

Type

Description

error_msg

String

Parameter description:

Error message.

Value range:

N/A

error_code

String

Parameter description:

Error code.

Value range:

N/A

Example Requests

GET https://(endpoint)/v5/e2e18230a85d4d6ab0b56cb6d2246c18/api/pipeline-notices/0747d5a7099e45f69dc1d099945909a9/notice/detail

Example Responses

Status code: 200

OK

{
  "events" : [ {
    "id" : "pipeline.updated",
    "name" : null,
    "selected" : false,
    "english_name" : null,
    "resource_role_receivers" : null
  }, {
    "id" : "pipeline.deleted",
    "name" : null,
    "selected" : false,
    "english_name" : null,
    "resource_role_receivers" : null
  }, {
    "id" : "pipelineRun.succeed",
    "name" : null,
    "selected" : false,
    "english_name" : null,
    "resource_role_receivers" : null
  }, {
    "id" : "pipelineRun.failed",
    "name" : null,
    "selected" : false,
    "english_name" : null,
    "resource_role_receivers" : null
  } ],
  "webhook_config" : null
}

Status Codes

Status Code

Description

200

OK

400

Bad request

401

Unauthorized

403

Forbidden

404

Not Found

Error Codes

See Error Codes.