Skip to Content
InvyteDocs
Organization & access

List join requests

List people waiting to join the organization, with the level they asked for. Admins only.

POST
/operations/joinRequests.list

Authorization

bearer
headerAuthorizationBearer <API key or OAuth token>

An organization API key (ink_live_…, ADR-0124), or the OAuth access token a person's AI client gets from the Recruiter MCP sign-in. Only the Authorization header is accepted.

Header Parameters

Idempotency-Key?string

Makes a write safe to repeat: the same key and input return the first result. Required for agents' writes and for anything a person confirms.

Match^[A-Za-z0-9._:-]+$
Length8 <= length <= 128

Request Body

application/json
  1. body
input*
confirmation?string

The id from a confirm or awaiting_approval Outcome, sent with the same input and key to go ahead.

Response Body

Done. A replay of the same key and input omits output.

application/json
  1. response
status*unknown
output?
actionId*string
Example Request
curl -X POST 'https://www.invyte.ai/api/recruiter/v1/operations/joinRequests.list' \  -H 'Content-Type: application/json' \  -d '{  "input": {}}'
Example Response
{  "status": "done",  "output": {    "requests": [      {        "requestId": "string",        "userId": "string",        "email": "string",        "name": "string",        "requestedLevel": "admin",        "requestedAt": "string"      }    ]  },  "actionId": "string"}

Approve or decline a join request POST

Approve a join request (they become a member, or an admin if they asked for that, and can sign in to the organization) or decline it. Admins only. Shows who and at what level before it is done.

List members POST

List the organization's members, newest first, 100 a page (`nextCursor` for more): name, email, whether each is an admin, and when they joined. What a member may do is their roles (access.listAssignments).