Skip to content

Select a set of alerts from an organization.

GET
/v1/alerts/{org_uuid}

Select a set of alerts from an organization.

Authorizations

apiKey

API key as username in Basic Authorization with
empty password.

TypeAPI Key (header: Authorization)
or
jwtToken
TypeHTTP (bearer)

Parameters

Path Parameters

org_uuid*

UUID of the organization

Typestring
Required
format"uuid"

Query Parameters

severity

Only alerts with this grade of severity

Typearray
user_uuid

Only entities that relates to those users.
Multiple fields can be provided separated by commas.
Negation can be achieved by prefixing a value with !. For example:
!uuid1,uuid2 would include alerts where assignees include uuid2 but not uuid1.

Typestring
Example"!683e0589-65a8-48b8-bd90-6ee89e0682ab,11111111-1111-1111-1111-111111111111"
unassigned

Only entities that are not assigned to a user.
Setting this value to false has no effect and is the same as omitting it.

Typeboolean
status

Only alerts with the provided status

Typearray
from

Only entities that has a timestamp from this date including
the date.

Typestring
Example"2024-04-11T20:31:00Z"
format"date-time"
to

Only entities that has a timestamp up to this timestamp including
the timestamp.

Typestring
Example"2024-04-11T21:31:00Z"
format"date-time"
resolved_at_from

Only entities that has a resolved_at timestamp from this date including
the date.

Typestring
Example"2024-04-11T20:31:00Z"
format"date-time"
resolved_at_to

Only entities that has a resolved_at timestamp up to this date including
the date.

Typestring
Example"2024-04-11T21:31:00Z"
format"date-time"
search

Select alerts where the following attributes match the provided
search query. Match is done using case-insensitive regular
expression search. If string contains a comma or spaces all terms will be
searched and matched.

  • title
Typestring
Example"fix,ut"
page

Page number to return

Typeinteger
Example1
format"int64"
minimum1
per_page

Number of elements per page

Typeinteger
format"int64"
minimum1
default10
sort

Alerts are sorted with updated_at by default.

Available sorts are:

  • created_at[,(asc|desc)
  • resolved_at[,(desc|asc)
  • updated_at[,(desc|asc)
Typearray
Example{ "UpdatedAtDescPathDescExample": { "Value": [ "updated_at,asc", "path,desc" ] } }

Responses

OK

application/json
JSON
{
"alerts": [
{
"id": "f1c9ecfe-1a45-499b-ab6d-1aa0a8ea2f95",
"severity": {
"name": "string",
"rank": 0
},
"created_at": "2024-04-12T07:06:00Z",
"updated_at": "2024-04-15T11:05:00Z",
"trigger": {
"started_at": "string",
"finished_at": "string",
"id": 0,
"auth_type": "string",
"auth_user": {
"display_name": "Marius Tolzmann",
"position": "CTPO",
"user_picture_url": "https://lh3.googleusercontent.com/a/AAcHTtcBqudpP0hVoQyjDv-v5b4lP6e0vN_92zi_aPp90hE=s96-c"
},
"auth_trust": {
"auth_id": "terramate-io/somerepo/.github/workflows/check-all.yml@refs/heads/main"
},
"org_uuid": "string",
"stack_id": 0,
"stack": {
"stack_id": 1337,
"repository": "github.com/terramate-io/iac-gcloud",
"target": "staging",
"path": "/path/to/stack",
"default_branch": "main",
"meta_id": "a754255a-c92a-4aeb-9668-bd3ce21dc8a2",
"meta_name": "My Stack Name",
"meta_description": "My Stack Description",
"meta_tags": [
[
"tagA",
"tagB"
]
],
"status": "string",
"created_at": "string",
"updated_at": "string",
"seen_at": "string",
"is_archived": true,
"archived_at": "string",
"archived_by_user_uuid": "string",
"unarchived_at": "string",
"unarchived_by_user_uuid": "string",
"deployment_status": "string",
"drift_status": "string",
"draft": true,
"related_stacks": [
{
"stack_id": 0,
"target": "string"
}
],
"resources": {
"count": 42,
"policy_check": {
"created_at": "2024-09-12T07:06:00Z",
"passed": false,
"counters": {
"passed_count": 42,
"severity_low_count": 3,
"severity_medium_count": 2,
"severity_high_count": 1
}
}
}
},
"status": "string",
"metadata": {
"additionalProperties": "string"
},
"drift_details": {
"provisioner": "string",
"serial": 0,
"changeset_ascii": "string",
"changeset_json": "string"
},
"grouping_key": "repo+id+1",
"cmd": [
[
"terraform",
"plan"
]
]
},
"triggered_event": {
"author_id": "string",
"created_at": "string",
"type": "string",
"actions": [
{
"action": "add",
"field": "resolved_at",
"value": "42",
"grouping_id": 323
}
]
},
"resolved_event": {
"author_id": "string",
"created_at": "string",
"type": "string",
"actions": [
{
"action": "add",
"field": "resolved_at",
"value": "42",
"grouping_id": 323
}
]
},
"assignees": [
{
"user_uuid": "683e0589-65a8-48b8-bd90-6ee89e0682ab",
"display_name": "Marius Tolzmann",
"user_picture_url": "https://lh3.googleusercontent.com/a/AAcHTtcBqudpP0hVoQyjDv-v5b4lP6e0vN_92zi_aPp90hE=s96-c"
}
],
"resolved_at": "2024-04-12T07:53:00Z",
"fixed_at": "2024-04-12T07:53:00Z"
}
],
"paginated_result": {
"total": 0,
"page": 0,
"per_page": 0
}
}

Playground

Authorization
Variables
Key
Value

Samples

Powered by VitePress OpenAPI