GET/api/v1/orgs/:orgId/invitations列出组织邀请

Try it 面板需要启用 JavaScript。

分页返回指定组织的邀请记录。

Request

Headers

Name	Data Type	Required	Description
Authorization	string	Yes	会话令牌认证，格式 `Bearer <sessionToken>`

type RequestHeaders = {
  /** 会话令牌认证，格式 `Bearer <sessionToken>` */
  Authorization: string
}

URL Parameters

Name	Data Type	Description
orgId	string	组织 ID

Query Parameters

Name	Data Type	Required	Description
page	number	No	页码，默认 1
pageSize	number	No	每页数量，默认 20，上限 100
status	string	No	按状态过滤：pending / accepted / expired

type QueryParams = {
  /** 页码，默认 1 */
  page?: number
  /** 每页数量，默认 20，上限 100 */
  pageSize?: number
  /** 按状态过滤：pending / accepted / expired */
  status?: string
}

{
  "page": 1,
  "pageSize": 20,
  "status": "pending"
}

Response

Body

Name	Data Type	Required	Description
items	array	Yes	邀请列表
total	number	Yes	总数
page	number	Yes	当前页码
pageSize	number	Yes	每页数量

type ResponseBody = {
  /** 邀请列表 */
  items: Record<string, unknown>[]
  /** 总数 */
  total: number
  /** 当前页码 */
  page: number
  /** 每页数量 */
  pageSize: number
}

{
  "items": [
    {
      "invitationId": "01JD8SRT5N8X2Z0BU9Y3BHK6C1O",
      "channel": "email",
      "target": "liu.yang@example.com",
      "invitorName": "陈林",
      "roleIds": [
        "01JD8SRR3N6V0X8ZS7X1ZFN4A9M"
      ],
      "status": "pending",
      "createdAt": "2026-10-14T13:00:00Z",
      "expiresAt": "2026-10-17T13:00:00Z"
    }
  ],
  "total": 1,
  "page": 1,
  "pageSize": 20
}

HTTP Code

HTTP Status	Meaning	Notes
200	成功	返回邀请列表

Response Code

响应使用统一信封 {id, code, messages, result}，其 code 字段：

code	Meaning	Notes
0	成功	返回邀请列表

Examples

GET /api/v1/orgs/01JD8SRP1N4T8W6XQ5V9XDL2Y7K/invitations?status=pending
Authorization: Bearer st_7c1f9e05b28d4a63

{
  "id": "01JD8SS1HU6F0H8JC",
  "code": 0,
  "messages": [],
  "result": {
    "items": [
      {
        "invitationId": "01JD8SRT5N8X2Z0BU9Y3BHK6C1O",
        "channel": "email",
        "target": "liu.yang@example.com",
        "invitorName": "陈林",
        "roleIds": ["01JD8SRR3N6V0X8ZS7X1ZFN4A9M"],
        "status": "pending",
        "createdAt": "2026-10-14T13:00:00Z",
        "expiresAt": "2026-10-17T13:00:00Z"
      }
    ],
    "total": 1,
    "page": 1,
    "pageSize": 20
  }
}