---
metadata:
  - name: generator
    content: Diplodoc Platform v5.62.0
alternate:
  - https://sourcecraft.dev/portal/docs/en/api-ref/Organization/ListMyOrganizations.md
  - https://sourcecraft.dev/portal/docs/ru/api-ref/Organization/ListMyOrganizations.md
  - href: https://sourcecraft.dev/portal/docs/en/api-ref/Organization/ListMyOrganizations.md
    type: text/markdown
    title: Markdown version
  - href: https://sourcecraft.dev/portal/docs/en/llms.txt
    rel: describedby
---
> **Documentation Index:** Fetch the complete configuration index at https://sourcecraft.dev/portal/docs/en/llms.txt

<div class="openapi">

# List organizations available to the authenticated user.

<!-- markdownlint-disable-file -->

IAM tokens and regular personal access tokens (PATs) discover the user's
organizations using the same mechanism as the private organization list.
Only organizations already registered in SourceCraft are selected; missing
organizations are not imported. Discovery may return a partial or empty
list when an organization backend fails.
Requires permission to list the user's organizations. The list is not
additionally filtered by the PAT's object scope.
Federated users are supported with IAM tokens. PATs for federated users
and delegated PATs are not supported.

## Request

<div class="openapi__requests">

<div class="openapi__request__wrapper" style="--method: var(--dc-openapi-methods-get);margin-bottom: 12px">

<div class="openapi__request">

GET {.openapi__method}
```text translate=no
https://api.sourcecraft.tech/me/orgs
```

</div>

</div>

</div>

## Responses

<div class="openapi__response__code__200">

## 200 OK

A successful response.

<div class="openapi-entity">

### Body

{% cut "application/json" %}

```json translate=no
{
  "organizations": [
    {
      "id": "example",
      "slug": "example",
      "display_name": "example",
      "visibility": "public",
      "logo": {
        "url": "example"
      },
      "web_url": "example"
    }
  ]
}
```

{% endcut %}

#|
|| **Name** | **Description** ||
||

_organizations_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: [Organization](#entity-Organization)[]

{% cut "**Example**" %}{.json-schema-example}

```json translate=no
[
  {
    "id": "example",
    "slug": "example",
    "display_name": "example",
    "visibility": "public",
    "logo": {
      "url": "example"
    },
    "web_url": "example"
  }
]
```

{% endcut %}
{.table-cell}
||
|#{.json-schema-properties}

</div>

<div class="openapi-entity">

### Organization.Visibility {#entity-Organization.Visibility}

**Type**: string

_Enum:_{.json-schema-reset .json-schema-value} `public`, `internal`, `private`

</div>

<div class="openapi-entity">

### Image {#entity-Image}

#|
|| **Name** | **Description** ||
||

_url_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
|#{.json-schema-properties}

{% cut "**Example**" %}{.json-schema-example}

```json translate=no
{
  "url": "example"
}
```

{% endcut %}

</div>

<div class="openapi-entity">

### Organization {#entity-Organization}

#|
|| **Name** | **Description** ||
||

_display_name_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||

_id_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||

_logo_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: [Image](#entity-Image)

{% cut "**Example**" %}{.json-schema-example}

```json translate=no
{
  "url": "example"
}
```

{% endcut %}
{.table-cell}
||
||

_slug_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||

_visibility_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: [Organization.Visibility](#entity-Organization.Visibility)

_Enum:_{.json-schema-reset .json-schema-value} `public`, `internal`, `private`
{.table-cell}
||
||

_web_url_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
|#{.json-schema-properties}

{% cut "**Example**" %}{.json-schema-example}

```json translate=no
{
  "id": "example",
  "slug": "example",
  "display_name": "example",
  "visibility": "public",
  "logo": {
    "url": "example"
  },
  "web_url": "example"
}
```

{% endcut %}

</div>

</div>

<div class="openapi__response__code__default">

## default

Both Client Errors (4xx) and Server Errors (5xx) are serialized into this scheme

<div class="openapi-entity">

### Body

{% cut "application/json" %}

```json translate=no
{
  "error_code": "example",
  "message": "example",
  "request_id": "example",
  "details": null
}
```

{% endcut %}

#|
|| **Name** | **Description** ||
||

_details_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: unknown

_Example:_{.json-schema-reset .json-schema-example} `null`
{.table-cell}
||
||

_error_code_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||

_message_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||

_request_id_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
|#{.json-schema-properties}

</div>

</div>

</div>

[*Deprecated]: No longer supported, please use an alternative and newer version.