---
title: "Service Accounts"
slug: "service-accounts"
tags: ["API"]
updated: 2025-06-04T12:05:38Z
published: 2025-06-04T12:05:38Z
canonical: "docs.bobsled.com/service-accounts"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bobsled.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Service Account Management

This article will describe the steps for creating a Service Account to access the Bobsled API.

A Service Account represents an application or machine identity. Creating a **Service Account** allows you to generate **Secrets** that you supply to access the [Bobsled API ↗](https://api.bobsled.com/)

![](https://cdn.document360.io/87a415ff-4d6a-4c0c-adbb-26c563a2d9a8/Images/Documentation/sa1(1).png)

---

## Creating a Service Account

To create a Service Account you will need to supply:

1. Service Account Name
2. Service Account Label

#### Service Account Name (Required)

The Service Account name is the identity of your service account. Service Account Name and Domain will be the value to supply to sled-service-account-email:

- e.g. `<service-account-name>@sa.<your-environment-name>.bobsled-cloud-api.com`

#### Service Account Label (Optional)

A human-readable identifier for your service account e.g., P*roduction Service Account.* You can modify the Label if you need by using the **Edit** Label menu option for the chosen Service Account.

![](https://cdn.document360.io/87a415ff-4d6a-4c0c-adbb-26c563a2d9a8/Images/Documentation/sa2.png)

#### Service Account Domain (Configured)

This is automatically set for your environment. It will look like: `@sa.<your-environment-name>.bobsled-cloud-api.com`

---

## **Generating a Secret**

1. Find the **Service Account** you will generate a secret against and press the **Generate Secret button**.
2. After clicking, you will be returned to the following:
  - `Secret ID`: `STRING ID` for the secret to identify the secret as part of rotating secrets within the UI
  - `Access Secret`: `STRING` represents the access secret
3. Use the *copy and paste button* to copy and store your secret somewhere safe, as you will not be able to see it again

> [!NOTE]
> **NOTE:** You will be prompted to have a place to store your secret as secrets will only be shown once.

---

## Removing a Service Account

To remove a Service Account, locate the Service Account you want to delete. Within the **menu** button icon (ellipsis), you can select **Delete Service Account**.

---

## Removing Service Account Secret(s)

You can remove either a single or all Secrets for a Service Account.

#### Removing a single Secret:

To remove a single Service Account Secret, use the **delete** icon (bin basket) next to the Secret you wish to delete.

#### Removing all Secrets

To remove all Service Account Secrets, within the **menu** icon (ellipsis) next to the Service Account you wish to delete all secrets for, select **Delete all secrets**.

---

## Rotating Service Account Secret

Secrets may expire, or you may want to rotate secrets for security reasons. To rotate a Service Account secret, it is advised to do the following:

1. Locate the Service Account for the secret you wish to rotate
2. **Generate** a new Secret for the service account
3. Apply the new Secret to your environment(s), thoroughly check everything works as expected
4. Identify the old Secret using the Secret ID that was given to you at the creation of the old Secret
5. Use the **delete** icon (bin basket) to delete the old Secret.