List invitations that have not been accepted
Open invitations your organisation has sent, newest first, and whether this deployment can send email. Owners and administrators, by console session.
GET
/
invitations
# cookies.txt holds the cookies from your signed-in console session.
curl "$MITHUNAI_URL/mithunai/api/v1/invitations" --cookie cookies.txt
import os
from http.cookiejar import MozillaCookieJar
import requests
jar = MozillaCookieJar("cookies.txt")
jar.load()
response = requests.get(
f"{os.environ['MITHUNAI_URL']}/mithunai/api/v1/invitations", cookies=jar, timeout=30
)
response.raise_for_status()
print(response.json()["data"])
// Runs in a page on the MITHUNAI console's own origin, while signed in.
const response = await fetch('/mithunai/api/v1/invitations', { credentials: 'include' })
console.log((await response.json()).data)
{
"data": [
{
"id": "9d4e2a71-3c5b-4f80-a6d1-8e7b2c0f4a13",
"email": "sarah.chen@example.com",
"role": "editor",
"status": "pending",
"invited_by_name": "Alex Mercer",
"created_at": "2026-10-13T09:12:05.640021+00:00",
"expires_at": "2026-10-20T09:12:05.640021+00:00",
"last_sent_at": "2026-10-13T09:12:05.640021+00:00"
}
],
"limit": { "max": 100 },
"mail_configured": true
}
{ "code": "authorization_error", "message": "You do not have permission to perform this action." }
Returns the invitations to your organisation that have not been accepted or withdrawn, newest first. An invitation whose link has expired stays in the list, marked
expired, so you can send it again.
Accepted and withdrawn invitations are not listed: an accepted one is a member now.
This endpoint takes a signed-in console session, not an API key: a request authenticated with an mithunai_sk_ key is refused with 403. It is a read, so it needs no X-CSRF-Token header.
You need the owner or admin role. The list is the addresses of people who are not members yet, so other roles cannot read it and receive 403. No response from this endpoint ever contains an invitation link.
The list is a single page of at most 100 invitations; there is no cursor. See Invitations.
integer
default:"100"
How many invitations to return, from 1 to 100. A value outside that range returns
400; it is not
clamped.Response
object[]
required
The open invitations, newest first.
Show properties
Show properties
string
required
The invitation’s ID (UUID).
string
required
The invited address.
string
required
admin, editor, normal or dataset_operator.string
required
pending while the link works; expired once its seven days have passed.string | null
required
The display name of the member who sent it, or
null if that account no longer exists.string
required
When it was first sent, ISO 8601 in UTC.
string
required
When the current link stops working, ISO 8601 in UTC.
string
required
When it was last sent, ISO 8601 in UTC.
boolean
required
Whether this deployment can send email. When
false, sending an invitation returns 503.# cookies.txt holds the cookies from your signed-in console session.
curl "$MITHUNAI_URL/mithunai/api/v1/invitations" --cookie cookies.txt
import os
from http.cookiejar import MozillaCookieJar
import requests
jar = MozillaCookieJar("cookies.txt")
jar.load()
response = requests.get(
f"{os.environ['MITHUNAI_URL']}/mithunai/api/v1/invitations", cookies=jar, timeout=30
)
response.raise_for_status()
print(response.json()["data"])
// Runs in a page on the MITHUNAI console's own origin, while signed in.
const response = await fetch('/mithunai/api/v1/invitations', { credentials: 'include' })
console.log((await response.json()).data)
{
"data": [
{
"id": "9d4e2a71-3c5b-4f80-a6d1-8e7b2c0f4a13",
"email": "sarah.chen@example.com",
"role": "editor",
"status": "pending",
"invited_by_name": "Alex Mercer",
"created_at": "2026-10-13T09:12:05.640021+00:00",
"expires_at": "2026-10-20T09:12:05.640021+00:00",
"last_sent_at": "2026-10-13T09:12:05.640021+00:00"
}
],
"limit": { "max": 100 },
"mail_configured": true
}
{ "code": "authorization_error", "message": "You do not have permission to perform this action." }
Last modified on November 7, 2026
# cookies.txt holds the cookies from your signed-in console session.
curl "$MITHUNAI_URL/mithunai/api/v1/invitations" --cookie cookies.txt
import os
from http.cookiejar import MozillaCookieJar
import requests
jar = MozillaCookieJar("cookies.txt")
jar.load()
response = requests.get(
f"{os.environ['MITHUNAI_URL']}/mithunai/api/v1/invitations", cookies=jar, timeout=30
)
response.raise_for_status()
print(response.json()["data"])
// Runs in a page on the MITHUNAI console's own origin, while signed in.
const response = await fetch('/mithunai/api/v1/invitations', { credentials: 'include' })
console.log((await response.json()).data)
{
"data": [
{
"id": "9d4e2a71-3c5b-4f80-a6d1-8e7b2c0f4a13",
"email": "sarah.chen@example.com",
"role": "editor",
"status": "pending",
"invited_by_name": "Alex Mercer",
"created_at": "2026-10-13T09:12:05.640021+00:00",
"expires_at": "2026-10-20T09:12:05.640021+00:00",
"last_sent_at": "2026-10-13T09:12:05.640021+00:00"
}
],
"limit": { "max": 100 },
"mail_configured": true
}
{ "code": "authorization_error", "message": "You do not have permission to perform this action." }