# Orgs

## List organizations

`$ stl orgs list`

**get** `/v0/orgs`

List organizations accessible to the current authentication method.

### Returns

- `OrgListResponse: object { data, has_more, next_cursor }`

  - `data: array of Org`

    - `display_name: string`

    - `enable_ai_commit_messages: boolean`

    - `object: "org"`

      - `"org"`

    - `slug: string`

  - `has_more: boolean`

  - `next_cursor: optional string`

### Example

```cli
stl orgs list \
  --api-key 'My API Key'
```

#### Response

```json
{
  "data": [
    {
      "display_name": "display_name",
      "enable_ai_commit_messages": true,
      "object": "org",
      "slug": "slug"
    }
  ],
  "has_more": true,
  "next_cursor": "next_cursor"
}
```

## Retrieve an organization

`$ stl orgs retrieve`

**get** `/v0/orgs/{org}`

Retrieve an organization by name.

### Parameters

- `--org: string`

### Returns

- `org: object { display_name, enable_ai_commit_messages, object, slug }`

  - `display_name: string`

  - `enable_ai_commit_messages: boolean`

  - `object: "org"`

    - `"org"`

  - `slug: string`

### Example

```cli
stl orgs retrieve \
  --api-key 'My API Key' \
  --org org
```

#### Response

```json
{
  "display_name": "display_name",
  "enable_ai_commit_messages": true,
  "object": "org",
  "slug": "slug"
}
```

## Domain Types

### Org

- `org: object { display_name, enable_ai_commit_messages, object, slug }`

  - `display_name: string`

  - `enable_ai_commit_messages: boolean`

  - `object: "org"`

    - `"org"`

  - `slug: string`