bird auth create-org
Usage
代码示例
bird auth create-org <org_name> [flags]Description
Create the first organization and workspace and mint your credential.
Creates the org and first workspace from the onboarding_ticket, then stores the
minted credential so "bird" and the MCP server authenticate as you. One-time: a
second call returns 409.
Build the request from the <org_name> argument and flags, a JSON OnboardingRequest body via
--body-file ("-" reads stdin), or both — an inline value overrides the matching
body field. Run --example to print a ready-to-edit body, or --dry-run to print
the resolved request without sending it.
Procedure
Step 3 of 3 of "Sign up and create your first organization". Previous: bird auth verify-email.
Examples
代码示例
# print the body shape (no credentials needed)
bird auth create-org --example
# the body it prints:代码示例
{
"onboarding_ticket": "obt_9mP2wR5tY8uI1oL4nJ",
"org_name": "Acme Corp",
"region": "us1",
"workspace_name": "Production"
}代码示例
# finish signup and store the credential
bird auth create-org Acme --workspace-name Prod --region us1 --onboarding-ticket obt_...Options
Organization
| Name | Description |
|---|---|
| --workspace-name | Name of the first workspace under the organization |
| --region | Region the new account and its data live in (e.g. us1 or eu1) |
| --onboarding-ticket | The single-use ticket returned by verify-email |
Request
| Name | Description |
|---|---|
| --body-file | Read the JSON request body from this file; "-" reads stdin |
| --example | Print a complete example request body, then exit |
| --dry-run | Print the resolved request without sending it, then exit |
| --idempotency-key | Deduplication key; a retry with the same key won't act twice |
Options
| Name | Description |
|---|---|
| --response-schema | Print the fields this command returns, then exit |
Related
| Name | Description |
|---|---|
| bird auth login | Authenticate with Bird through your browser (OAuth) |
| bird auth logout | Revoke the OAuth grant (if any) and remove the stored credentials file |
| bird auth signup | Start a passwordless Bird signup and email a six-digit code. |
| bird auth status | Show current authentication state and validate the token against the API |
| bird auth verify-email | Confirm the emailed six-digit code and sign in. |