---
# @generated by sylphx-gen 0.1.0 from contracts@e145cc7cf1bc9605f2b27439e5e17ed76a1a2fd7e7021906a013f7565e4a0cd5. Do not edit.
title: "Orgs"
description: "The `orgs` collection of Sylphx Access: An Org is the one Sylphx account: created once, billed once."
type: reference
product: platform
summary: "An Org is the one Sylphx account: created once, billed once."
updated: 2026-09-28
order: 900
---

> **This method is not served on the public API.** `api.sylphx.com` does not route this call: its backend is not deployed behind the public API, or does not implement the call. This page documents the contract. It is kept out of the sidebar and of search engines.

An Org is the one Sylphx account: created once, billed once.

**Service** Sylphx Access · **Resource type** `access.sylphx.com/Org` · **Name pattern** `orgs/{org}` · **Shape** `spec_status`

## Fields

| Field | Type | What it is |
| --- | --- | --- |
| `name` | `string` | `orgs/{org}`. |
| `uid` | `string` | `org_<cell><ulid>`; equals the name segment. Output only. |
| `meta` | `ResourceMeta` | Resource metadata. |
| `spec` | `OrgSpec` | Desired state. Required. |
| `status` | `OrgStatus` | Observed state. Output only. |

## Methods

Every method of the collection, in the registry's order, with the scope it
needs. The full request, response and examples are one link away.

| Method | Call | What it does |
| --- | --- | --- |
| `GET` | [`get`](/docs/api/orgs#get) | Gets an org. |
| `GET` | [`list`](/docs/api/orgs#list) | Lists orgs the caller can see. |
| `POST` | [`create`](/docs/api/orgs#create) | Creates an org. Access assigns the id. |
| `PATCH` | [`update`](/docs/api/orgs#update) | Updates an org. |
| `DELETE` | [`delete`](/docs/api/orgs#delete) | Deletes an org and everything in it. Deletion cascades through every service, so it returns an Operation. |

## get

Gets an org.

`GET https://api.sylphx.com/v1/orgs/acme` · scope `access:read` · effect `read` · [Request, response and examples](/docs/api/orgs/get)

## list

Lists orgs the caller can see.

`GET https://api.sylphx.com/v1/orgs` · scope `access:read` · effect `read` · paginated · [Request, response and examples](/docs/api/orgs/list)

## create

Creates an org. Access assigns the id.

`POST https://api.sylphx.com/v1/orgs` · scope `access:admin` · effect `write` · [Request, response and examples](/docs/api/orgs/create)

## update

Updates an org.

`PATCH https://api.sylphx.com/v1/orgs/acme` · scope `access:admin` · effect `write` · [Request, response and examples](/docs/api/orgs/update)

## delete

Deletes an org and everything in it. Deletion cascades through every service, so it returns an Operation.

`DELETE https://api.sylphx.com/v1/orgs/acme` · scope `access:admin` · effect `destructive` · long-running · [Request, response and examples](/docs/api/orgs/delete)