编辑组织资料
/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/jsonversion 为必填的当前组织版本;其余字段至少提供一项。
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必填
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。
参数:
pathslug(必填):组织的稳定标识。bodyversionbodynamebodysummarybodytaglinebodydescriptionbodycategorybodyjoinPolicybodyvisibilitybodyavatarbodybanner
请求体:version 为必填的当前组织版本;其余字段至少提供一项。