Skip to content
EdgeKit

List people refused a seat

GET
/v1/org/list-seat-refusals
curl --request GET \
  --url 'https://your-tenant-host/v1/org/list-seat-refusals?organizationId=01926f3a-8b4e-7b33-a944-5e6f7a8b9c0d' \
  --header 'x-edgekit-site-id: site_example' \
  --cookie ek.session_token=<ek.session_token>

Everyone refused a seat because the organization was full — on accepting an invitation or signing up on a claimed email domain — and still without one. Owners and admins only; anyone else gets 404.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Query Parameters

Section titled “Query Parameters”
organizationId
required
string format: uuid
>= 1 characters <= 128 characters

Example 

01926f3a-8b4e-7b33-a944-5e6f7a8b9c0d

Header Parameters

Section titled “Header Parameters”
x-edgekit-site-id
required

The site this request is for, within this tenant. Every official EdgeKit SDK sets it from the client you configured; set it yourself only when calling this API directly.

string
>= 1 characters <= 128 characters

Example 

site_example

The site this request is for, within this tenant. Every official EdgeKit SDK sets it from the client you configured; set it yourself only when calling this API directly.

Responses

Section titled “Responses”

200

Section titled “200”

The refusals, most recent first.

Media typeapplication/json
object
refusals
required
Array<object>

source is the path refused, latest wins: accepting an invitation, or signing up on a claimed email domain.

object
user
required
object
id
required
string format: uuid
email
required
string
name
required
string | null
source
required

Open: accept a member not listed. Known: invitation, domain_auto_join.

string
count
required
integer
firstRefusedAt
required
string format: date-time
lastRefusedAt
required
string format: date-time

Example 

{
  "refusals": [
    {
      "user": {
        "id": "01926f3a-8b4c-7d2e-9f10-2a3b4c5d6e7f",
        "email": "ada@example.com",
        "name": "Ada Lovelace"
      },
      "source": "invitation",
      "count": 2,
      "firstRefusedAt": "2026-08-02T09:00:00.000Z",
      "lastRefusedAt": "2026-08-03T09:00:00.000Z"
    }
  ]
}

400

Section titled “400”

Invalid request.

Media typeapplication/json
object
error
required
object
code
required
string
message
required
string
details

Example 

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or missing API key."
  }
}

401

Section titled “401”

Missing or invalid credential.

Media typeapplication/json
object
error
required
object
code
required
string
message
required
string
details

Example 

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or missing API key."
  }
}

403

Section titled “403”

Not allowed.

Media typeapplication/json
object
error
required
object
code
required
string
message
required
string
details

Example 

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or missing API key."
  }
}

404

Section titled “404”

Resource not found.

Media typeapplication/json
object
error
required
object
code
required
string
message
required
string
details

Example 

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or missing API key."
  }
}

422

Section titled “422”

Request validation failed.

Media typeapplication/json
object
error
required
object
code
required
string
message
required
string
details

Example 

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or missing API key."
  }
}

500

Section titled “500”

Unexpected error.

Media typeapplication/json
object
error
required
object
code
required
string
message
required
string
details

Example 

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or missing API key."
  }
}