OpenAI 获取组织邀请
2026-11-17 17:57 更新
获取邀请
get /organization/invites/{invite_id}
获取一个邀请。
路径参数
invite_id: string
要获取的邀请 ID。
返回值
Invite object { id, created_at, email, 6 more }
表示发往组织的单个 invite(邀请)。
id: string
标识符,可在 API 端点中引用。
created_at: integer
邀请发送时间的 Unix 时间戳,单位为秒。
format: unixtime
email: string
邀请接收者的电子邮件地址。
object: "organization.invite"
对象类型,固定为 organization.invite。
"organization.invite"
projects: array of object { id, role }
接受邀请时获授成员身份的项目。
id: string
项目的公开 ID。
role: "member" or "owner"
项目成员角色。
"member"
"owner"
role: "owner" or "reader"
owner(所有者)或 reader(读取者)。
"owner"
"reader"
status: "accepted" or "expired" or "pending"
accepted(已接受)、expired(已过期)或 pending(待接受)。
"accepted"
"expired"
"pending"
accepted_at: optional integer or null
邀请接受时间的 Unix 时间戳,单位为秒。
format: unixtime
expires_at: optional integer or null
邀请过期时间的 Unix 时间戳,单位为秒。
format: unixtime
示例
## 从环境变量读取管理员密钥;组织邀请ID和示例电子邮件地址应替换为实际值
curl https://api.openai.com/v1/organization/invites/$INVITE_ID \
-H "Authorization: Bearer $OPENAI_ADMIN_KEY"
200 — 示例
以下 JSON 展示返回字段;字段名、对象类型、角色、状态和标识符按原文保留。
{
"id": "id",
"created_at": 0,
"email": "email",
"object": "organization.invite",
"projects": [
{
"id": "id",
"role": "member"
}
],
"role": "owner",
"status": "accepted",
"accepted_at": 0,
"expires_at": 0
}
示例
## 从环境变量读取管理员密钥;组织邀请ID和示例电子邮件地址应替换为实际值
curl https://api.openai.com/v1/organization/invites/invite-abc \
-H "Authorization: Bearer $OPENAI_ADMIN_KEY" \
-H "Content-Type: application/json"
响应示例
以下为对应请求的响应示例。
{
"object": "organization.invite",
"id": "invite-abc",
"email": "user@example.com",
"role": "owner",
"status": "accepted",
"created_at": 1711471533,
"expires_at": 1711471533,
"accepted_at": 1711471533,
"projects": []
}以上内容是否对您有帮助:

TRAE-AI编程


更多建议: