> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zylon.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Organizations

> List and update organizations within your workspace.

Organizations are the top-level container for users and projects. Use these endpoints to list orgs visible to your account and update org-level settings.

## Basic request and response

List organizations visible to your account with `GET /api/v1/app/organization`.

```bash theme={null}
curl "https://{BASE_URL}/api/v1/app/organization" \
  -H "Authorization: Bearer {API_TOKEN}"
  -H "x-org: {org_slug}"
```

<Accordion title="Example response">
  ```json theme={null}
  [
    {
      "name": "Aurora Labs",
      "context": "Enterprise R&D and analytics.",
      "email_regex": ".*@auroralabs.com"
    }
  ]
  ```
</Accordion>

## Update organization settings

```bash theme={null}
curl -X POST "https://{BASE_URL}/api/v1/app/organization" \
  -H "Authorization: Bearer {API_TOKEN}" \
  -H "x-org: {org_slug}" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Aurora Labs",
    "context": "Private AI platform for product and support teams.",
    "email_regex": ".*@auroralabs.com"
  }'
```

<Accordion title="Example response">
  ```text theme={null}
  HTTP/1.1 200 OK
  ```
</Accordion>

## Errors and edge cases

* **401/403**: missing or invalid API token.
* **400**: invalid regex or payload shape.