组织 API 参考

组织 API。

共 33 个端点,其中 13 个只读。每一个都同时是 orbit 命令行中的命令、SDK 中的方法和 MCP 服务器上的工具。

01

通用

端点权限参数CLI · MCP 工具
GET /org
This account's organisation, created on first read
只读—orbit org get
org_get
PATCH /org
Rename the organisation or change its handle
读写请求体: name string, slug stringorbit org patch
org_patch
02

members

端点权限参数CLI · MCP 工具
GET /org/members
Everybody in the organisation, the owner included
只读—orbit org members list
org_members_list
POST /org/members
Invite somebody by email. Sending again to the same address replaces the previous link.
读写请求体: email* string, role admin | member | guest, template_ids string[]orbit org members invite
org_members_invite
PATCH /org/members/{sub}
Change somebody's role, or suspend and restore them
读写sub string
请求体: role admin | member | guest, state active | suspended
orbit org members patch <sub>
org_members_patch
DELETE /org/members/{sub}
Remove somebody from the organisation (offboarding with the default modes; restorable for 30 days)
读写sub stringorbit org members remove <sub>
org_members_remove
GET /org/members/{sub}/bindings
A member's (role, scope) bindings
只读sub stringorbit org members bindings list <sub>
org_members_bindings_list
POST /org/members/{sub}/bindings
Give a member a role on the organisation or on a group; joining a group gives what it carries
读写sub string
请求体: role* string, scope_id string
orbit org members bindings add <sub>
org_members_bindings_add
POST /org/members/{sub}/bindings/remove
Remove a binding; what that group gave is taken back
读写sub string
请求体: role* string, scope_id string
orbit org members bindings remove <sub>
org_members_bindings_remove
GET /org/members/{sub}/assignments
What a member has been given in each product
只读sub string
?all 1
orbit org members assignments list <sub>
org_members_assignments_list
POST /org/members/{sub}/assignments
Give a member one item (a mailbox, an extension, a shared drive, …); runs as a job
读写sub string
请求体: product* mail | voice | drive | chat | meet | helpdesk, kind* mailbox | mail_group | mailbox_access | extension | ring_group | shared_drive | drive_quota | chat_space | meet_host | helpdesk_seat, domain_id integer, local string, quota_gb number, group_id string, mailbox_id string, perm full | read, pbx_id string, range string, drive_id string, role string, gb integer, space_id string, readonly boolean, department_id integer
orbit org members assign <sub>
org_members_assign
POST /org/members/{sub}/templates
Apply role templates to a member (preview: true to see the plan first)
读写sub string
请求体: template_ids* string[], preview boolean
orbit org members templates <sub>
org_members_templates
POST /org/members/{sub}/offboard
Remove a member: every assignment goes where its mode says; restorable for 30 days (preview: true lists the items and modes)
读写sub string
请求体: preview boolean, modes object
orbit org members offboard <sub>
org_members_offboard
POST /org/members/{sub}/restore
Restore a member removed less than 30 days ago, with everything they had
读写sub stringorbit org members restore <sub>
org_members_restore
03

invites

端点权限参数CLI · MCP 工具
GET /org/invites
Invitations that have not been accepted yet
只读—orbit org invites list
org_invites_list
DELETE /org/invites/{id}
Revoke an invitation; its link stops working now
读写id stringorbit org invites revoke <id>
org_invites_revoke
04

apps

端点权限参数CLI · MCP 工具
PATCH /org/apps
Turn applications on and off for everybody in the organisation
读写请求体: mail boolean, meet boolean, chat boolean, drive booleanorbit org apps patch
org_apps_patch
05

domains

端点权限参数CLI · MCP 工具
GET /org/domains
Domains this organisation works under, and whether each is verified
只读—orbit org domains list
org_domains_list
06

orgs

端点权限参数CLI · MCP 工具
GET /orgs
Every organisation this account belongs to
只读—orbit org orgs list
org_orgs_list
07

groups

端点权限参数CLI · MCP 工具
GET /org/groups
Groups and departments (a tree of at most three levels)
只读—orbit org groups list
org_groups_list
POST /org/groups
Create a group, or a department inside one
读写请求体: name* string, parent_id string, description stringorbit org groups create
org_groups_create
PATCH /org/groups/{id}
Rename a group or change what it gives its members
读写id string
请求体: name string, description string, links object
orbit org groups patch <id>
org_groups_patch
DELETE /org/groups/{id}
Delete an empty group
读写id stringorbit org groups delete <id>
org_groups_delete
08

templates

端点权限参数CLI · MCP 工具
GET /org/templates
Role templates
只读—orbit org templates list
org_templates_list
POST /org/templates
Create a role template
读写请求体: name* string, description string, spec objectorbit org templates create
org_templates_create
PATCH /org/templates/{id}
Replace a role template's name and items
读写id string
请求体: name* string, description string, spec object
orbit org templates patch <id>
org_templates_patch
DELETE /org/templates/{id}
Delete a role template (what it gave stays)
读写id stringorbit org templates delete <id>
org_templates_delete
09

jobs

端点权限参数CLI · MCP 工具
GET /org/jobs
Assignment jobs, newest first
只读?state queued | running | failed | done | cancelled
?email string
orbit org jobs list
org_jobs_list
GET /org/jobs/{id}
One job and its steps
只读id stringorbit org jobs get <id>
org_jobs_get
POST /org/jobs/{id}/retry
Run a failed job again from its failed step
读写id stringorbit org jobs retry <id>
org_jobs_retry
10

policy

端点权限参数CLI · MCP 工具
GET /org/policy
Organisation policies
只读—orbit org policy get
org_policy_get
PUT /org/policy
Set organisation policies; they are pushed to every member's account
读写请求体: require_mfa boolean, session_max_hours integer, meet_hosts_only booleanorbit org policy put
org_policy_put
11

audit

端点权限参数CLI · MCP 工具
GET /org/audit
The organisation's audit log
只读?limit integer
?before integer
orbit org audit list
org_audit_list
继续

相关文档

账户 API 参考

Orbit API 中 账户 的全部 10 个端点:方法与路径、所需令牌权限、参数,以及对应的命令行命令与 MCP 工具。

服务 API 参考

Orbit API 中 服务 的全部 15 个端点:方法与路径、所需令牌权限、参数,以及对应的命令行命令与 MCP 工具。

DNS API 参考

Orbit API 中 DNS 的全部 30 个端点:方法与路径、所需令牌权限、参数,以及对应的命令行命令与 MCP 工具。

← 全部文档