# Orgs

## List organizations

`orgs.list() -> OrgListResponse`

**get** `/v0/orgs`

List organizations accessible to the current authentication method.

### Returns

- `class OrgListResponse`

  - `data: Array[Org]`

    - `display_name: String`

    - `enable_ai_commit_messages: bool`

    - `object: :org`

      - `:org`

    - `slug: String`

  - `has_more: bool`

  - `next_cursor: String`

### Example

```ruby
require "stainless_v0"

stainless = StainlessV0::Client.new(
  api_key: "My API Key",
  environment: "staging" # defaults to "production"
)

orgs = stainless.orgs.list

puts(orgs)
```

#### 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

`orgs.retrieve(org) -> Org`

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

Retrieve an organization by name.

### Parameters

- `org: String`

### Returns

- `class Org`

  - `display_name: String`

  - `enable_ai_commit_messages: bool`

  - `object: :org`

    - `:org`

  - `slug: String`

### Example

```ruby
require "stainless_v0"

stainless = StainlessV0::Client.new(
  api_key: "My API Key",
  environment: "staging" # defaults to "production"
)

org = stainless.orgs.retrieve("org")

puts(org)
```

#### Response

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

## Domain Types

### Org

- `class Org`

  - `display_name: String`

  - `enable_ai_commit_messages: bool`

  - `object: :org`

    - `:org`

  - `slug: String`

### Org List Response

- `class OrgListResponse`

  - `data: Array[Org]`

    - `display_name: String`

    - `enable_ai_commit_messages: bool`

    - `object: :org`

      - `:org`

    - `slug: String`

  - `has_more: bool`

  - `next_cursor: String`