Skip to main content
  • Home
  • API
  • Identifying Workspaces and apps with their slugs

Identifying Workspaces and apps with their slugs

Abstract

The API (and the Bitrise support team) often asks for slugs: a Workspace slug or an app slug. A slug is a unique identifier of one of these resources, consisting of hexadecimal numbers. You can find the slugs of a given Workspace or app both on the UI and in the API.

The API (and the Bitrise support team) often asks for slugs: a Workspace slug or an app slug. A slug is a unique identifier of one of these resources, consisting of hexadecimal numbers. You can find the slugs of a given Workspace or app both on the UI and in the API.

Finding a slug on the Bitrise website

You can find both Workspace slugs and app slugs on the Bitrise website.

Workspace slugs

App slugs

  1. Log in to Bitrise and hover over the left navigation bar.

  2. Make sure you have the right Workspace selected.

  3. Select Settings.

    workspace-settings-new.png

  4. Once on the Workspace settings page, go to your browser's address bar.

    Your Workspace URL will look like this: https://app.bitrise.io/workspaces/2d0c5c70bbae73d8/settings/.

  5. Find the hexadecimal number after the /workspaces/ section of the URL. That is your Workspace slug.

  1. Open the app on Bitrise by clicking it on your Dashboard.

  2. Once on the app's page, go to your browser's address bar.

    The URL will look like this: https://app.bitrise.io/app/5c89d92-8be6-4892-b11d-efbc1fdd607.

  3. Find the hexadecimal number after the /app/ section of the URL. That is your app slug.

Finding a slug with the Bitrise API

You can get the slug for all Workspaces and apps you have access to with simple API calls.

Workspace slugs

App slugs

  1. Authenticate with the Bitrise API.

  2. Call the GET /organizations endpoint with your Personal Access Token:

    curl -X 'GET' \
  'https://api.bitrise.io/v0.1/organizations' \
  -H 'accept: application/json' \
  -H 'Authorization: <ACCESS-TOKEN>'

  3. Find the slug in the response:

        {
      "name": "TestOrg",
      "slug": "2dec5c71bbce73d9",
      "avatar_icon_url": "https://bitrise-public-content-production.s3.amazonaws.com/org-icons/default_avatar-09.png",
      "concurrency_count": null,
      "owners": [
        {
          "slug": "1b3f130835b1c09ef2",
          "username": "bitbot",
          "email": "[email protected]"
        },
      ]
    },

  1. Authenticate with the Bitrise API.

  2. Call the GET /apps endpoint with your Personal Access Token.

    curl -X 'GET' \
  'https://api.bitrise.io/v0.1/apps' \
  -H 'accept: application/json' \
  -H 'Authorization: <ACCESS-TOKEN>'

  3. Find the slug in the response:

    {
  "data": [
    {
      "slug": "13aa9897-3891-4fe7-8cf5-5b2f75638b0e",
      "title": "TestApp",
      "project_type": "ios",
      "provider": "github",
      "repo_owner": "bitrise",
      "repo_url": "[email protected]:bitrise/TestApp.git",
      "repo_slug": "TestApp",
      "is_disabled": false,
      "status": 1,
      "is_public": false,
      "is_github_checks_enabled": false,
      "owner": {
        "account_type": "organization",
        "name": "Bitrise",
        "slug": "03a9543ede4d12bd"
      },
      "avatar_url": null
    },
In this section:

A Workspace is an environment that allows you to manage your Bitrise apps and the team members working on the apps. You can create multiple Workspaces, and you can be invited to Workspaces by other Bitrise users. To be able to add apps and run builds, you either need to be part of a Workspace, or you have to be an outside contributor on an app's team.