---
updatedAt: 2025-09-22T20:35:08.000Z
agentTools:
  projectIndex: https://docs.v7labs.com/llms.txt
---

# Slugs and Identifiers

Guide to slugs and identifiers in V7

In V7, we use slugs and identifiers (alphanumerical values) to uniquely identify objects such as teams, datasets, item and more. This guide takes you through some of the most important you will use and how you can find them.

## Alphanumerical Identifiers

The following table details the most common alphanumerical identifiers needed for API requests and SDK methods

<Table align={["left","left","left"]}>
  <thead>
    <tr>
      <th>
        Identifier
      </th>

      <th>
        Description
      </th>

      <th>
        Where to find it
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        stage\_id
      </td>

      <td>
        UUID representing a stage in a workflow
      </td>

      <td>
        ID in stages list when calling [this API request](https://docs.v7labs.com/v2.0/reference/workflows-index)
      </td>
    </tr>

    <tr>
      <td>
        user\_id/assignee\_id
      </td>

      <td>
        Unique id per user in your team
      </td>

      <td>
        user\_id in [this API request](https://docs.v7labs.com/v2.0/reference/memberships)
      </td>
    </tr>

    <tr>
      <td>
        team\_id
      </td>

      <td>
        Int used as identifier for your team
      </td>

      <td>
        team\_id in [this API request](https://docs.v7labs.com/v2.0/reference/memberships)
      </td>
    </tr>

    <tr>
      <td>
        dataset\_id
      </td>

      <td>
        Int used as identifier for a dataset
      </td>

      <td>
        IDs in objects when calling [this API request](https://docs.v7labs.com/v2.0/reference/list-dataset)
      </td>
    </tr>

    <tr>
      <td>
        workflow\_id
      </td>

      <td>
        UUID representing a workflow
      </td>

      <td>
        ID field in [this API request](https://docs.v7labs.com/v2.0/reference/workflows-index)
      </td>
    </tr>

    <tr>
      <td>
        item\_id/dataset\_item\_id
      </td>

      <td>
        UUID representing a dataset item
      </td>

      <td>
        Item\_ids in [this API request](https://docs.v7labs.com/v2.0/reference/items-list-ids)
      </td>
    </tr>

    <tr>
      <td>
        annotation\_classs\_id
      </td>

      <td>
        Unique int in team representing a particular class
      </td>

      <td>
        ID field in [this API request](https://docs.v7labs.com/v2.0/reference/list-annotation-classes)
      </td>
    </tr>

    <tr>
      <td>
        report\_uuid
      </td>

      <td>
        UUID for async CSV annotator item reports
      </td>

      <td>
        ID field in [this API request](https://docs.v7labs.com/v2.0/reference/list-async-csv-reports)
      </td>
    </tr>

    <tr>
      <td>
        upload\_id
      </td>

      <td>
        UUID for upload
      </td>

      <td>
        upload\_id in [this API request](https://docs.v7labs.com/v2.0/reference/items-get-one)
      </td>
    </tr>

    <tr>
      <td>
        thread\_id
      </td>

      <td>
        UUID representing a comment thread
      </td>

      <td>
        ID field in [this API request](https://docs.v7labs.com/v2.0/reference/comments-thread-index)
      </td>
    </tr>

    <tr>
      <td>
        comment\_id
      </td>

      <td>
        UUID representing an individual comment within a comment thread
      </td>

      <td>
        ID field in [this API request](https://docs.v7labs.com/v2.0/reference/comments-index)
      </td>
    </tr>

    <tr>
      <td>
        edge\_id/edge
      </td>

      <td>
        UUID representing an edge connecting workflow stages
      </td>

      <td>
        ID within edges objects when calling [this API request](https://docs.v7labs.com/v2.0/reference/workflows-index)
      </td>
    </tr>

    <tr>
      <td>
        source\_stage\_id
      </td>

      <td>
        stage\_id of the source stage of an edge
      </td>

      <td>
        source\_stage\_id within edges objects when calling [this API request](https://docs.v7labs.com/v2.0/reference/workflows-index)
      </td>
    </tr>

    <tr>
      <td>
        target\_stage\_id
      </td>

      <td>
        stage\_id of the target stage of an edge
      </td>

      <td>
        target\_stage\_id within edges objects  when calling [this API request](https://docs.v7labs.com/v2.0/reference/workflows-index)
      </td>
    </tr>

    <tr>
      <td>
        model\_id (WIND API)
      </td>

      <td>
        UUID representing  a model register in V7 (either V7 trained or external)
      </td>

      <td>
        ID field in [this API request](https://docs.v7labs.com/v2.0/reference/list-trainedmodels)
      </td>
    </tr>

    <tr>
      <td>
        model\_template\_id (WIND API)
      </td>

      <td>
        ID of the model template on which to base a TrainingSession
      </td>

      <td>
        ID field in [this API request](https://docs.v7labs.com/v2.0/reference/list-modeltemplates)
      </td>
    </tr>

    <tr>
      <td>
        running\_session\_id (WIND API)
      </td>

      <td>
        The ID of a running session
      </td>

      <td>
        ID field in [this API request](https://docs.v7labs.com/v2.0/reference/list-runningsessions)
      </td>
    </tr>
  </tbody>
</Table>

## Slugs and other identifiers

**Dataset Identifiers**\
A dataset identifier is a string that uniquely identifies a snapshot of a dataset. It is composed by 3 smaller sub-strings:

* team slug
* dataset slug
* version

And it looks like this: `<team-slug>/<dataset-slug>:<version>`.

Slugs here are normalized versions of the values they represent, usually without spaces and with special characters either removed or replaced with hyphens.

For our Cars dataset example in Andreas Team, the identifier for the latest version would be: `andreas-team/cars:latest`

> 📘 See the SDK documentation on this topic
>
> * [DatasetIdentifer](https://darwin-py-sdk.v7labs.com/darwin.dataset.html?highlight=datasetidentifier#darwin.dataset.identifier.DatasetIdentifier)

**Finding Team Slugs:**

Team slugs can either be found programmatically or in the UI.

**In the UI**\
In the Command Line Upload section of the data upload pop up after `push` in the automatically generated commands. So In the example below, `v7-labs` is the team\_slug:

![354](https://files.readme.io/679790c-BD06D4B7-145B-437E-BA58-1F5193C21463_4_5005_c.jpeg "BD06D4B7-145B-437E-BA58-1F5193C21463_4_5005_c.jpeg")

**Note:** The `dataset_slug` will be the part after the forward slash. So in this case it would be `traffic-lights`

**Using the SDK:**\
You can also run the code below using the `darwin-py` SDK:

```python
from darwin.client import Client

client = Client.local()
print("Client default team slug: {}".format(client.default_team))
```

**Storage Names and Storage Slugs:**

When using external storage, it is necessary to use the storage\_name or storage\_slug. This is the sluggified version of the Storage Name specified in your storage settings.

> 📘 Team and Dataset Slugs
>
> If you are unsure on how to generate slugs then you can use the [Slugify Python library](https://pypi.org/project/python-slugify/). However,  underscores are not replaced with a hyphens in this case.