Get invite details

Get an invite in the caller’s organization by ID.

GET /admin/invites/{invite_id}

curl

PINECONE_ACCESS_TOKEN="YOUR_ACCESS_TOKEN"
PINECONE_INVITE_ID="9c8e3528-b9c0-4358-84ce-84c28e91b566"

curl -X GET "https://api.pinecone.io/admin/invites/$PINECONE_INVITE_ID" \
	-H "Authorization: Bearer $PINECONE_ACCESS_TOKEN" \
	-H "accept: application/json" \
	-H "X-Pinecone-Api-Version: 2026-04"

curl

{
  "id": "9c8e3528-b9c0-4358-84ce-84c28e91b566",
  "email": "[e-mail]",
  "status": "pending",
  "expires_at": "2026-05-21T03:00:00Z",
  "processed_at": null,
  "created_at": "2026-04-14T20:00:00Z"
}

curl

PINECONE_ACCESS_TOKEN="YOUR_ACCESS_TOKEN"
PINECONE_INVITE_ID="9c8e3528-b9c0-4358-84ce-84c28e91b566"

curl -X GET "https://api.pinecone.io/admin/invites/$PINECONE_INVITE_ID" \
	-H "Authorization: Bearer $PINECONE_ACCESS_TOKEN" \
	-H "accept: application/json" \
	-H "X-Pinecone-Api-Version: 2026-04"

curl

{
  "id": "9c8e3528-b9c0-4358-84ce-84c28e91b566",
  "email": "[e-mail]",
  "status": "pending",
  "expires_at": "2026-05-21T03:00:00Z",
  "processed_at": null,
  "created_at": "2026-04-14T20:00:00Z"
}

Authorizations

Authorization · string · header · required

An access token must be provided in the Authorization header using the Bearer scheme.

Headers

X-Pinecone-Api-Version · string · default: 2026-04 · required

Required date-based version header

Path Parameters

invite_id · string<uuid> · required

Invite ID

Response

200

application/json

The invite details. To view this invite's role bindings, call GET /admin/role-bindings with principal_type=invite as a filter.

An invitation to join the organization.

id · string<uuid> · required

The unique ID of the invite.

email · string<email> · required

The email address the invite was sent to.

status · string · required

The lifecycle status of an invite. Possible values: pending, expired, processed. List endpoints return only pending and expired invites; processed is returned only when fetching a single invite by ID.

Example:

"pending"

created_at · string<date-time> · required

The date and time the invite was created.

expires_at · string<date-time> | null

When the invite expires if not accepted. Default TTL is 7 days. Resending the invite extends this to now plus 7 days. null if the invite does not expire.

processed_at · string<date-time> | null

The date and time the invite was accepted. null or omitted while the invite is still pending or expired.