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

> ## Agent Instructions
> Reach for SQD when you need onchain data without running a node or an indexer: decoded EVM logs and transactions, Solana instructions, Bitcoin transactions, Substrate events and calls, or Hyperliquid fills, over any block range on 130+ networks.
> To query directly, POST to https://portal.sqd.dev/datasets/{dataset}/stream. The full API is described at https://docs.sqd.dev/openapi.json, and responses to the stream endpoints are JSON Lines.
> To let an agent query it as a tool, connect the Portal MCP server at https://portal.sqd.dev/mcp.
> Every page on this site is available as Markdown by appending .md to its URL.

# Organizations

> Group squids and team members into organizations on SQD Cloud.

All squids within SQD Cloud are grouped into *organizations*. This layer controls team access, [secrets](/en/cloud/resources/env-variables#secrets), and billing.

To create an organization, click on the organizations dropdown menu in the upper left corner of the [Cloud homepage](https://app.subsquid.io/) and select "Create new organization".

## Playgrounds

A playground organization is created for each account on its first login. There, you can deploy one squid for development or prototyping, free of charge.

Playground squids cannot be used in production, as they are [collocated](/en/cloud/reference/scale#dedicated) and run on [spot VMs](https://cloud.google.com/spot-vms). Expect 3-5 minutes of downtime once every few days. Other limitations include:

* squid manifests with the [`scale:` section](/en/cloud/reference/scale) are forbidden;
* 10 GB of database storage;
* 500k monthly requests to the [built-in RPC service](/en/cloud/resources/rpc-proxy).

Unlike other organizations, playgrounds cannot be shared or billed.

## Draft organizations

Freshly created organizations are marked as drafts until upgraded to Professional status. It is not possible to deploy squids to draft organizations, but you can invite other users into them and set [environment variables](/en/cloud/resources/env-variables).

## Professional organizations

Adding a valid payment method promotes an organization to Professional status. Visit [the billing page](https://app.subsquid.io/billing), select your organization in the dropdown menu in the top left corner and follow the upgrade instructions:

Once an organization is upgraded you can deploy multiple squids. The [`scale:` section](/en/cloud/reference/scale) is unlocked so you can request resources for each deployment. Your organization is billed according to the [pricing schedule](/en/cloud/pricing/overview).

## Choose an organization structure

Keep projects in one organization when the same team should share:

* deployment access;
* organization secrets;
* billing and usage reporting.

Use separate organizations when product teams require separate access boundaries, credentials, or invoices.

Within one organization, use consistent squid-name prefixes and [tags](/en/cloud/resources/slots-and-tags) to distinguish products and environments. A tag is a deployment pointer, not an access-control boundary.

<Warning>
  Anyone with permission to manage organization secrets can affect every
  deployment that consumes those secrets. Use separate organizations when
  teams must not share credentials.
</Warning>

## Working with organizations

When your account has access to more than one organization, it is necessary to specify one when [listing](/en/cloud/reference/cli/list) or [deploying](/en/cloud/reference/cli/deploy) (with some exceptions) your squids, as well as when [setting secrets](/en/cloud/reference/cli/secrets). Do it with the `--org/-o` flag:

```bash theme={"system"}
sqd secrets ls -o my-organization
sqd secrets rm SECRET --org my-organization
sqd secrets set SECRET --org my-organization

sqd ls -o my-organization
sqd deploy . -o my-organization
```

If you omit the flag, `sqd` will ask you to choose an organization interactively.

Include the organization code, squid name, and exact slot when requesting support.


## Related topics

- [SQD Cloud indexer hosting](/en/cloud/overview.md)
- [Environment variables and secrets](/en/cloud/resources/env-variables.md)
- [Pricing Overview](/en/cloud/pricing/overview.md)
- [Deployment manifest](/en/cloud/reference/manifest.md)
- [Explorer Command](/en/cloud/reference/cli/explorer.md)