个人 API

编辑组织资料

PUT /v1/personal/organizations/{slug}
PUT/v1/personal/organizations/{slug}
下载规范

仅活跃所有者可编辑未归档、未解散的 approved 组织;archived 组织只读,不能通过此接口编辑或恢复。提交当前正整数 version;资料变化后版本递增,旧版本返回 409。需要 organization:update:self。

Bearer 令牌(organization:update:self)

路径参数

slugstring必填

组织的稳定标识。

长度 ≥ 1 · 长度 ≤ 100 · 格式:^[a-z0-9][a-z0-9-]{0,99}$

请求体 必填

application/json

version 为必填的当前组织版本;其余字段至少提供一项。

versioninteger必填

≥ 1 · ≤ 9007199254740991

namestring可选

长度 ≥ 1 · 长度 ≤ 100

summarystring可选

长度 ≥ 0 · 长度 ≤ 200

taglinestring可选

长度 ≥ 0 · 长度 ≤ 200

descriptionstring可选

长度 ≥ 0 · 长度 ≤ 10000

categorystring可选

长度 ≥ 0 · 长度 ≤ 100

joinPolicystring可选
可选值"open""apply"
visibilitystring可选
可选值"public""private"
avatarstring可选

长度 ≥ 0 · 长度 ≤ 2048

bannerstring可选

长度 ≥ 0 · 长度 ≤ 2048

返回值

成功

organizationobject必填

方案 1 · object

idstring必填

长度 ≥ 26 · 长度 ≤ 26

slugstring必填

长度 ≥ 1 · 长度 ≤ 100 · 格式:^[a-z0-9][a-z0-9-]{0,99}$

namestring必填

长度 ≥ 1 · 长度 ≤ 100

summarystring必填

长度 ≥ 0 · 长度 ≤ 200

taglinestring必填

长度 ≥ 0 · 长度 ≤ 200

descriptionstring必填

长度 ≥ 0 · 长度 ≤ 10000

categorystring必填

长度 ≥ 0 · 长度 ≤ 100

avatarstring可选

长度 ≥ 0 · 长度 ≤ 2048

bannerstring可选

长度 ≥ 0 · 长度 ≤ 2048

ownerIdstring必填

长度 ≥ 26 · 长度 ≤ 26

rolestring必填
可选值"owner""admin""member"
statusstring必填
可选值"approved""suspended""pending""rejected"
visibilitystring必填
可选值"public""private"
joinPolicystring必填
可选值"open""apply"
versioninteger必填

≥ 1 · ≤ 9007199254740991

createdAtstring必填

长度 ≥ 1 · 长度 ≤ 64

updatedAtstring必填

长度 ≥ 1 · 长度 ≤ 64

方案 2 · object

idstring必填

长度 ≥ 26 · 长度 ≤ 26

slugstring必填

长度 ≥ 1 · 长度 ≤ 100 · 格式:^[a-z0-9][a-z0-9-]{0,99}$

namestring必填

长度 ≥ 1 · 长度 ≤ 100

summarystring必填

长度 ≥ 0 · 长度 ≤ 200

avatarstring可选

长度 ≥ 0 · 长度 ≤ 2048

rolestring必填
可选值"owner""admin""member"
statusstring必填
可选值"dissolved"
versioninteger必填

≥ 1 · ≤ 9007199254740991

dissolvedAtstring必填

长度 ≥ 1 · 长度 ≤ 64

接口信息

接口: PUT /v1/personal/organizations/{slug}
operationId: updateOrganization

所需权限: organization:update:self

仅活跃所有者可编辑未归档、未解散的 approved 组织;archived 组织只读,不能通过此接口编辑或恢复。提交当前正整数 version;资料变化后版本递增,旧版本返回 409。需要 organization:update:self。

参数:

  • path slug(必填):组织的稳定标识。
  • body version
  • body name
  • body summary
  • body tagline
  • body description
  • body category
  • body joinPolicy
  • body visibility
  • body avatar
  • body banner

请求体:version 为必填的当前组织版本;其余字段至少提供一项。