---
title: "解析共享邀请链接 token"
method: POST
path: "/auth/invitations/lookup"
tags: ["认证"]
---

# 解析共享邀请链接 token

`POST /auth/invitations/lookup`

根据邀请链接中的 token 返回邀请上下文（空间名 / 角色 / 过期时间），
供注册页展示。无认证；token 无效或被撤销返回 410。
使用 POST + body 而非 GET + path，避免 token 落入访问日志 / 浏览器历史 / tracing。

## Request body

- InternalHandlerInvitationLookupRequest
  - `token` string, required

## Response `200`

OK

- InternalHandlerInvitationLookupResponse
  - `expires_at` string
  - `role` 'owner' | 'admin' | 'contributor' | 'viewer'
  - `tenant_id` integer
  - `tenant_name` string

## Other responses

- `410` — 链接无效或已撤销

## Changes

- **2026-06-05** `e7c0c953963b` — 1 info
  - endpoint added
- **2025-12-16** `edf61e68559d` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/tencentblueking/apis/weknora-api/changes/auth/invitations/lookup/post.md)

---

[API](https://skmtc.dev/tencentblueking/apis/weknora-api.md) · [All operations](https://skmtc.dev/tencentblueking/apis/weknora-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/tencentblueking/weknora-api/revisions/a5ce73ad8921/schema)