Services

Get All Services

get

https://api.eu.squadcast.comhttps://api.squadcast.com

/v3/services

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

owner_idstringRequired

entity_ownerstringOptional

namestringOptional

Responses

200

The request has succeeded.

application/json

400

The server could not understand the request due to invalid syntax.

application/json

401

Access is unauthorized.

application/json

402

Client error

application/json

403

Access is forbidden.

application/json

404

The server cannot find the requested resource.

application/json

409

The request conflicts with the current state of the server.

application/json

422

Client error

application/json

500

Server error

application/json

502

Server error

application/json

503

Service unavailable.

application/json

504

Server error

application/json

get

/v3/services

Go (SDK)Python (SDK)Typescript (SDK)

package main

import(
	"context"
	"os"
	squadcastsdk "github.com/SquadcastHub/squadcast-sdk-go"
	"log"
)

func main() {
    ctx := context.Background()

    s := squadcastsdk.New(
        squadcastsdk.WithSecurity(os.Getenv("SQUADCASTSDK_BEARER_AUTH")),
    )

    res, err := s.Services.List(ctx, "<id>", nil, nil)
    if err != nil {
        log.Fatal(err)
    }
    if res.Object != nil {
        // handle response
    }
}

{
  "data": [
    {
      "id": "text",
      "name": "text",
      "slug": "text",
      "email": "text",
      "escalation_policy_id": "text",
      "organization_id": "text",
      "api_key": "text",
      "description": "text",
      "depends": [
        "text"
      ],
      "owner": {
        "id": "text",
        "type": "team"
      },
      "on_maintenance": true,
      "slack": {
        "channel_id": "text",
        "name": "text",
        "time": 1
      },
      "escalation_policy": {
        "id": "text",
        "name": "text",
        "description": "text",
        "slug": "text"
      },
      "jira_cloud": {
        "jira_client_key": "text",
        "project": {
          "id": "text",
          "key": "text",
          "name": "text"
        },
        "issue_type": {
          "id": "text",
          "name": "text",
          "statuses": [
            {
              "id": "text",
              "name": "text"
            }
          ]
        },
        "statusmaps": [
          {
            "jira_status": "text",
            "system_status": "text"
          }
        ],
        "is_manual": true
      },
      "maintainer": {
        "id": "text",
        "type": "user"
      },
      "tags": [
        {
          "key": "text",
          "value": "text"
        }
      ],
      "auto_pause_transient_alerts_config": {
        "is_enabled": true,
        "timeout_in_mins": 2
      },
      "intelligent_alerts_grouping_config": {
        "is_enabled": true,
        "rolling_window_in_mins": 5
      },
      "delay_notification_config": {
        "is_enabled": true,
        "timezone": "text",
        "fixed_timeslot_config": {
          "start_time": "text",
          "end_time": "text",
          "repeat_days": [
            1
          ]
        },
        "custom_timeslots_enabled": true,
        "custom_timeslots": {},
        "assigned_to": {
          "id": "text",
          "type": "text"
        }
      },
      "config": {
        "dedup_key_enabled": true
      },
      "created_at": "2026-03-18T06:41:43.004Z",
      "updated_at": "2026-03-18T06:41:43.004Z"
    }
  ]
}

Create Service

post

https://api.eu.squadcast.comhttps://api.squadcast.com

/v3/services

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

owner_idstringRequired

Body

application/json

namestringRequired

escalation_policy_idstringRequired

descriptionstringOptional

email_prefixstringOptional

Responses

201

The request has succeeded and a new resource has been created as a result.

application/json

400

The server could not understand the request due to invalid syntax.

application/json

401

Access is unauthorized.

application/json

402

Client error

application/json

403

Access is forbidden.

application/json

404

The server cannot find the requested resource.

application/json

409

The request conflicts with the current state of the server.

application/json

422

Client error

application/json

500

Server error

application/json

502

Server error

application/json

503

Service unavailable.

application/json

504

Server error

application/json

post

/v3/services

Go (SDK)Python (SDK)Typescript (SDK)

package main

import(
	"context"
	"os"
	squadcastsdk "github.com/SquadcastHub/squadcast-sdk-go"
	"github.com/SquadcastHub/squadcast-sdk-go/models/components"
	"log"
)

func main() {
    ctx := context.Background()

    s := squadcastsdk.New(
        squadcastsdk.WithSecurity(os.Getenv("SQUADCASTSDK_BEARER_AUTH")),
    )

    res, err := s.Services.Create(ctx, "<id>", components.V3ServicesCreateServiceRequest{
        Name: "<value>",
        EscalationPolicyID: "<id>",
    })
    if err != nil {
        log.Fatal(err)
    }
    if res.Object != nil {
        // handle response
    }
}

{
  "body": {
    "data": {
      "id": "text",
      "name": "text",
      "slug": "text",
      "email": "text",
      "escalation_policy_id": "text",
      "organization_id": "text",
      "api_key": "text",
      "description": "text",
      "depends": [
        "text"
      ],
      "owner": {
        "id": "text",
        "type": "team"
      },
      "on_maintenance": true,
      "slack": {
        "channel_id": "text",
        "name": "text",
        "time": 1
      },
      "escalation_policy": {
        "id": "text",
        "name": "text",
        "description": "text",
        "slug": "text"
      },
      "jira_cloud": {
        "jira_client_key": "text",
        "project": {
          "id": "text",
          "key": "text",
          "name": "text"
        },
        "issue_type": {
          "id": "text",
          "name": "text",
          "statuses": [
            {
              "id": "text",
              "name": "text"
            }
          ]
        },
        "statusmaps": [
          {
            "jira_status": "text",
            "system_status": "text"
          }
        ],
        "is_manual": true
      },
      "maintainer": {
        "id": "text",
        "type": "user"
      },
      "tags": [
        {
          "key": "text",
          "value": "text"
        }
      ],
      "auto_pause_transient_alerts_config": {
        "is_enabled": true,
        "timeout_in_mins": 2
      },
      "intelligent_alerts_grouping_config": {
        "is_enabled": true,
        "rolling_window_in_mins": 5
      },
      "delay_notification_config": {
        "is_enabled": true,
        "timezone": "text",
        "fixed_timeslot_config": {
          "start_time": "text",
          "end_time": "text",
          "repeat_days": [
            1
          ]
        },
        "custom_timeslots_enabled": true,
        "custom_timeslots": {},
        "assigned_to": {
          "id": "text",
          "type": "text"
        }
      },
      "config": {
        "dedup_key_enabled": true
      },
      "created_at": "2026-03-18T06:41:43.004Z",
      "updated_at": "2026-03-18T06:41:43.004Z"
    }
  }
}

Get Services By Name

get

https://api.eu.squadcast.comhttps://api.squadcast.com

/v3/services/by-name

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

namestringRequired

owner_idstringRequired

Responses

200

The request has succeeded.

application/json

400

The server could not understand the request due to invalid syntax.

application/json

401

Access is unauthorized.

application/json

402

Client error

application/json

403

Access is forbidden.

application/json

404

The server cannot find the requested resource.

application/json

409

The request conflicts with the current state of the server.

application/json

422

Client error

application/json

500

Server error

application/json

502

Server error

application/json

503

Service unavailable.

application/json

504

Server error

application/json

get

/v3/services/by-name

Go (SDK)Python (SDK)Typescript (SDK)

package main

import(
	"context"
	"os"
	squadcastsdk "github.com/SquadcastHub/squadcast-sdk-go"
	"log"
)

func main() {
    ctx := context.Background()

    s := squadcastsdk.New(
        squadcastsdk.WithSecurity(os.Getenv("SQUADCASTSDK_BEARER_AUTH")),
    )

    res, err := s.Services.GetByName(ctx, "<value>", "<id>")
    if err != nil {
        log.Fatal(err)
    }
    if res.Object != nil {
        // handle response
    }
}

{
  "data": {
    "id": "text",
    "name": "text",
    "slug": "text",
    "email": "text",
    "escalation_policy_id": "text",
    "organization_id": "text",
    "api_key": "text",
    "description": "text",
    "depends": [
      "text"
    ],
    "owner": {
      "id": "text",
      "type": "team"
    },
    "on_maintenance": true,
    "slack": {
      "channel_id": "text",
      "name": "text",
      "time": 1
    },
    "escalation_policy": {
      "id": "text",
      "name": "text",
      "description": "text",
      "slug": "text"
    },
    "jira_cloud": {
      "jira_client_key": "text",
      "project": {
        "id": "text",
        "key": "text",
        "name": "text"
      },
      "issue_type": {
        "id": "text",
        "name": "text",
        "statuses": [
          {
            "id": "text",
            "name": "text"
          }
        ]
      },
      "statusmaps": [
        {
          "jira_status": "text",
          "system_status": "text"
        }
      ],
      "is_manual": true
    },
    "maintainer": {
      "id": "text",
      "type": "user"
    },
    "tags": [
      {
        "key": "text",
        "value": "text"
      }
    ],
    "auto_pause_transient_alerts_config": {
      "is_enabled": true,
      "timeout_in_mins": 2
    },
    "intelligent_alerts_grouping_config": {
      "is_enabled": true,
      "rolling_window_in_mins": 5
    },
    "delay_notification_config": {
      "is_enabled": true,
      "timezone": "text",
      "fixed_timeslot_config": {
        "start_time": "text",
        "end_time": "text",
        "repeat_days": [
          1
        ]
      },
      "custom_timeslots_enabled": true,
      "custom_timeslots": {},
      "assigned_to": {
        "id": "text",
        "type": "text"
      }
    },
    "config": {
      "dedup_key_enabled": true
    },
    "created_at": "2026-03-18T06:41:43.004Z",
    "updated_at": "2026-03-18T06:41:43.004Z"
  }
}

Get Service By ID

get

https://api.eu.squadcast.comhttps://api.squadcast.com

/v3/services/{serviceID}

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

serviceIDstringRequired

Header parameters

authorizationstringRequired

Responses

200

The request has succeeded.

application/json

400

The server could not understand the request due to invalid syntax.

application/json

401

Access is unauthorized.

application/json

402

Client error

application/json

403

Access is forbidden.

application/json

404

The server cannot find the requested resource.

application/json

409

The request conflicts with the current state of the server.

application/json

422

Client error

application/json

500

Server error

application/json

502

Server error

application/json

503

Service unavailable.

application/json

504

Server error

application/json

get

/v3/services/{serviceID}

Go (SDK)Python (SDK)Typescript (SDK)

package main

import(
	"context"
	"os"
	squadcastsdk "github.com/SquadcastHub/squadcast-sdk-go"
	"log"
)

func main() {
    ctx := context.Background()

    s := squadcastsdk.New(
        squadcastsdk.WithSecurity(os.Getenv("SQUADCASTSDK_BEARER_AUTH")),
    )

    res, err := s.Services.GetByID(ctx, "<id>")
    if err != nil {
        log.Fatal(err)
    }
    if res.Object != nil {
        // handle response
    }
}

{
  "data": {
    "id": "text",
    "name": "text",
    "slug": "text",
    "email": "text",
    "escalation_policy_id": "text",
    "organization_id": "text",
    "api_key": "text",
    "description": "text",
    "depends": [
      "text"
    ],
    "owner": {
      "id": "text",
      "type": "team"
    },
    "on_maintenance": true,
    "slack": {
      "channel_id": "text",
      "name": "text",
      "time": 1
    },
    "escalation_policy": {
      "id": "text",
      "name": "text",
      "description": "text",
      "slug": "text"
    },
    "jira_cloud": {
      "jira_client_key": "text",
      "project": {
        "id": "text",
        "key": "text",
        "name": "text"
      },
      "issue_type": {
        "id": "text",
        "name": "text",
        "statuses": [
          {
            "id": "text",
            "name": "text"
          }
        ]
      },
      "statusmaps": [
        {
          "jira_status": "text",
          "system_status": "text"
        }
      ],
      "is_manual": true
    },
    "maintainer": {
      "id": "text",
      "type": "user"
    },
    "tags": [
      {
        "key": "text",
        "value": "text"
      }
    ],
    "auto_pause_transient_alerts_config": {
      "is_enabled": true,
      "timeout_in_mins": 2
    },
    "intelligent_alerts_grouping_config": {
      "is_enabled": true,
      "rolling_window_in_mins": 5
    },
    "delay_notification_config": {
      "is_enabled": true,
      "timezone": "text",
      "fixed_timeslot_config": {
        "start_time": "text",
        "end_time": "text",
        "repeat_days": [
          1
        ]
      },
      "custom_timeslots_enabled": true,
      "custom_timeslots": {},
      "assigned_to": {
        "id": "text",
        "type": "text"
      }
    },
    "config": {
      "dedup_key_enabled": true
    },
    "created_at": "2026-03-18T06:41:43.004Z",
    "updated_at": "2026-03-18T06:41:43.004Z"
  }
}

Update Service

put

https://api.eu.squadcast.comhttps://api.squadcast.com

/v3/services/{serviceID}

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

serviceIDstringRequired

Body

application/json

namestringOptional

escalation_policy_idstringOptional

descriptionstringOptional

email_prefixstringOptional

Responses

200

The request has succeeded.

application/json

400

The server could not understand the request due to invalid syntax.

application/json

401

Access is unauthorized.

application/json

402

Client error

application/json

403

Access is forbidden.

application/json

404

The server cannot find the requested resource.

application/json

409

The request conflicts with the current state of the server.

application/json

422

Client error

application/json

500

Server error

application/json

502

Server error

application/json

503

Service unavailable.

application/json

504

Server error

application/json

put

/v3/services/{serviceID}

Go (SDK)Python (SDK)Typescript (SDK)

package main

import(
	"context"
	"os"
	squadcastsdk "github.com/SquadcastHub/squadcast-sdk-go"
	"github.com/SquadcastHub/squadcast-sdk-go/models/components"
	"log"
)

func main() {
    ctx := context.Background()

    s := squadcastsdk.New(
        squadcastsdk.WithSecurity(os.Getenv("SQUADCASTSDK_BEARER_AUTH")),
    )

    res, err := s.Services.Update(ctx, "<id>", components.V3ServicesUpdateServiceRequest{})
    if err != nil {
        log.Fatal(err)
    }
    if res.Object != nil {
        // handle response
    }
}

{
  "data": {
    "id": "text",
    "name": "text",
    "slug": "text",
    "email": "text",
    "escalation_policy_id": "text",
    "organization_id": "text",
    "api_key": "text",
    "description": "text",
    "depends": [
      "text"
    ],
    "owner": {
      "id": "text",
      "type": "team"
    },
    "on_maintenance": true,
    "slack": {
      "channel_id": "text",
      "name": "text",
      "time": 1
    },
    "escalation_policy": {
      "id": "text",
      "name": "text",
      "description": "text",
      "slug": "text"
    },
    "jira_cloud": {
      "jira_client_key": "text",
      "project": {
        "id": "text",
        "key": "text",
        "name": "text"
      },
      "issue_type": {
        "id": "text",
        "name": "text",
        "statuses": [
          {
            "id": "text",
            "name": "text"
          }
        ]
      },
      "statusmaps": [
        {
          "jira_status": "text",
          "system_status": "text"
        }
      ],
      "is_manual": true
    },
    "maintainer": {
      "id": "text",
      "type": "user"
    },
    "tags": [
      {
        "key": "text",
        "value": "text"
      }
    ],
    "auto_pause_transient_alerts_config": {
      "is_enabled": true,
      "timeout_in_mins": 2
    },
    "intelligent_alerts_grouping_config": {
      "is_enabled": true,
      "rolling_window_in_mins": 5
    },
    "delay_notification_config": {
      "is_enabled": true,
      "timezone": "text",
      "fixed_timeslot_config": {
        "start_time": "text",
        "end_time": "text",
        "repeat_days": [
          1
        ]
      },
      "custom_timeslots_enabled": true,
      "custom_timeslots": {},
      "assigned_to": {
        "id": "text",
        "type": "text"
      }
    },
    "config": {
      "dedup_key_enabled": true
    },
    "created_at": "2026-03-18T06:41:43.004Z",
    "updated_at": "2026-03-18T06:41:43.004Z"
  }
}

Delete Service

delete

https://api.eu.squadcast.comhttps://api.squadcast.com

/v3/services/{serviceID}

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

serviceIDstringRequired

Header parameters

authorizationstringRequired

Responses

204

There is no content to send for this request, but the headers may be useful.

*/*

400

The server could not understand the request due to invalid syntax.

application/json

401

Access is unauthorized.

application/json

402

Client error

application/json

403

Access is forbidden.

application/json

404

The server cannot find the requested resource.

application/json

409

The request conflicts with the current state of the server.

application/json

422

Client error

application/json

500

Server error

application/json

502

Server error

application/json

503

Service unavailable.

application/json

504

Server error

application/json

delete

/v3/services/{serviceID}

Go (SDK)Python (SDK)Typescript (SDK)

package main

import(
	"context"
	"os"
	squadcastsdk "github.com/SquadcastHub/squadcast-sdk-go"
	"log"
)

func main() {
    ctx := context.Background()

    s := squadcastsdk.New(
        squadcastsdk.WithSecurity(os.Getenv("SQUADCASTSDK_BEARER_AUTH")),
    )

    res, err := s.Services.Delete(ctx, "<id>")
    if err != nil {
        log.Fatal(err)
    }
    if res.Body != nil {
        // handle response
    }
}

{}

Auto Pause Transient Alerts (APTA)

put

https://api.eu.squadcast.comhttps://api.squadcast.com

/v3/services/{serviceID}/apta-config

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

serviceIDstringRequired

Body

application/json

is_enabledbooleanRequired

timeout_in_minsintegerRequired

Responses

200

The request has succeeded.

application/json

400

The server could not understand the request due to invalid syntax.

application/json

401

Access is unauthorized.

application/json

402

Client error

application/json

403

Access is forbidden.

application/json

404

The server cannot find the requested resource.

application/json

409

The request conflicts with the current state of the server.

application/json

422

Client error

application/json

500

Server error

application/json

502

Server error

application/json

503

Service unavailable.

application/json

504

Server error

application/json

put

/v3/services/{serviceID}/apta-config

Go (SDK)Python (SDK)Typescript (SDK)

package main

import(
	"context"
	"os"
	squadcastsdk "github.com/SquadcastHub/squadcast-sdk-go"
	"github.com/SquadcastHub/squadcast-sdk-go/models/components"
	"log"
)

func main() {
    ctx := context.Background()

    s := squadcastsdk.New(
        squadcastsdk.WithSecurity(os.Getenv("SQUADCASTSDK_BEARER_AUTH")),
    )

    res, err := s.Services.CreateOrUpdateAptaConfig(ctx, "<id>", components.V3ServicesAPTAConfigRequest{
        IsEnabled: false,
        TimeoutInMins: 680029,
    })
    if err != nil {
        log.Fatal(err)
    }
    if res.Object != nil {
        // handle response
    }
}

{
  "data": {
    "msg": "text"
  }
}

Intelligent Alert Grouping (IAG)

put

https://api.eu.squadcast.comhttps://api.squadcast.com

/v3/services/{serviceID}/iag-config

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

serviceIDstringRequired

Body

application/json

is_enabledbooleanRequired

rolling_window_in_minsintegerRequired

Responses

200

The request has succeeded.

application/json

400

The server could not understand the request due to invalid syntax.

application/json

401

Access is unauthorized.

application/json

402

Client error

application/json

403

Access is forbidden.

application/json

404

The server cannot find the requested resource.

application/json

409

The request conflicts with the current state of the server.

application/json

422

Client error

application/json

500

Server error

application/json

502

Server error

application/json

503

Service unavailable.

application/json

504

Server error

application/json

put

/v3/services/{serviceID}/iag-config

Go (SDK)Python (SDK)Typescript (SDK)

package main

import(
	"context"
	"os"
	squadcastsdk "github.com/SquadcastHub/squadcast-sdk-go"
	"github.com/SquadcastHub/squadcast-sdk-go/models/components"
	"log"
)

func main() {
    ctx := context.Background()

    s := squadcastsdk.New(
        squadcastsdk.WithSecurity(os.Getenv("SQUADCASTSDK_BEARER_AUTH")),
    )

    res, err := s.Services.UpsertIagConfig(ctx, "<id>", components.V3ServicesIAGConfigRequest{
        IsEnabled: true,
        RollingWindowInMins: 246036,
    })
    if err != nil {
        log.Fatal(err)
    }
    if res.Object != nil {
        // handle response
    }
}

{
  "data": {
    "msg": "text"
  }
}

Delayed Notification Config

put

https://api.eu.squadcast.comhttps://api.squadcast.com

/v3/services/{serviceID}/notification-delay-config

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

serviceIDstringRequired

Body

application/json

Responses

200

The request has succeeded.

application/json

400

The server could not understand the request due to invalid syntax.

application/json

401

Access is unauthorized.

application/json

402

Client error

application/json

403

Access is forbidden.

application/json

404

The server cannot find the requested resource.

application/json

409

The request conflicts with the current state of the server.

application/json

422

Client error

application/json

500

Server error

application/json

502

Server error

application/json

503

Service unavailable.

application/json

504

Server error

application/json

put

/v3/services/{serviceID}/notification-delay-config

Go (SDK)Python (SDK)Typescript (SDK)

package main

import(
	"context"
	"os"
	squadcastsdk "github.com/SquadcastHub/squadcast-sdk-go"
	"github.com/SquadcastHub/squadcast-sdk-go/models/components"
	"log"
)

func main() {
    ctx := context.Background()

    s := squadcastsdk.New(
        squadcastsdk.WithSecurity(os.Getenv("SQUADCASTSDK_BEARER_AUTH")),
    )

    res, err := s.Services.UpdateNotificationDelayConfig(ctx, "<id>", components.V3ServicesNotificationDelayConfigRequest{
        IsEnabled: false,
    })
    if err != nil {
        log.Fatal(err)
    }
    if res.Object != nil {
        // handle response
    }
}

{
  "data": {
    "id": "text",
    "name": "text",
    "slug": "text",
    "email": "text",
    "escalation_policy_id": "text",
    "organization_id": "text",
    "api_key": "text",
    "description": "text",
    "depends": [
      "text"
    ],
    "owner": {
      "id": "text",
      "type": "team"
    },
    "on_maintenance": true,
    "slack": {
      "channel_id": "text",
      "name": "text",
      "time": 1
    },
    "escalation_policy": {
      "id": "text",
      "name": "text",
      "description": "text",
      "slug": "text"
    },
    "jira_cloud": {
      "jira_client_key": "text",
      "project": {
        "id": "text",
        "key": "text",
        "name": "text"
      },
      "issue_type": {
        "id": "text",
        "name": "text",
        "statuses": [
          {
            "id": "text",
            "name": "text"
          }
        ]
      },
      "statusmaps": [
        {
          "jira_status": "text",
          "system_status": "text"
        }
      ],
      "is_manual": true
    },
    "maintainer": {
      "id": "text",
      "type": "user"
    },
    "tags": [
      {
        "key": "text",
        "value": "text"
      }
    ],
    "auto_pause_transient_alerts_config": {
      "is_enabled": true,
      "timeout_in_mins": 2
    },
    "intelligent_alerts_grouping_config": {
      "is_enabled": true,
      "rolling_window_in_mins": 5
    },
    "delay_notification_config": {
      "is_enabled": true,
      "timezone": "text",
      "fixed_timeslot_config": {
        "start_time": "text",
        "end_time": "text",
        "repeat_days": [
          1
        ]
      },
      "custom_timeslots_enabled": true,
      "custom_timeslots": {},
      "assigned_to": {
        "id": "text",
        "type": "text"
      }
    },
    "config": {
      "dedup_key_enabled": true
    },
    "created_at": "2026-03-18T06:41:43.004Z",
    "updated_at": "2026-03-18T06:41:43.004Z"
  }
}