List a project's join requests
The requests to join the project still waiting for an answer, newest first.
The owner and the admins who may invite read them.
Authorization
Authorization: Bearer <key> Authentication
Path parameters
The project's id.
Query parameters
How many requests a page holds.
The cursor from the previous page's nextCursor; left out, the first page.
Response
200 The requests.
The requests to join the project.
Show properties of requestsHide properties of requests
The join request's id.
The request's version; an answer to it sends it as expectedVersion.
pending while it waits for an answer, approved or rejected once answered, cancelled when the link it came from was revoked, expired when nobody answered in time.
When the request was sent.
When the request lapses if nobody answers it.
When it was answered, cancelled or lapsed, or null while pending.
The person asking to join.
Show properties of requesterHide properties of requester
The person's id.
The person's name.
The cursor that reads the next page as after, or null when none remains.
Errors
invalid_query The query is not in the form the route takes; the limit is in the unit of the input details.field names (characters for a text, entries for a list, the value for a number).invalid_people_request The people request is not in the form the route takes; the limit is in the unit of the input details.field names (characters for a text, entries for a list, the value for a number).session_revoked The request carries no session the server holds, or its session has ended.session_expired The session has expired.personal_project_restricted The request acts on the signed-in person's own My Werk, which only they see, or on a reminder with no card, which lives there, and My Werk does not take this action.not_permitted The signed-in person's role, or whose the record is, does not allow this request.conversation_not_found The project the request names, or its chat, is not one the signed-in person is in.project_not_found The project the request names is not one the signed-in person can reach.session_changed The session changed while the request was in flight.cursor_expired The page cursor no longer fits the list as it stands or the arguments it was read with.project_archived The project is archived, so it does not take this request.rate_limited More requests of this kind were sent than Werk takes within the time it counts them over.server_error The server could not complete the request, and it is not known whether a write it holds was made.curl "https://api.getwerk.ai/api/v1/projects/2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73/join-requests?limit=20" \
-H "Authorization: Bearer wk_key_..."const res = await fetch("https://api.getwerk.ai/api/v1/projects/2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73/join-requests?limit=20", {
headers: {
Authorization: "Bearer wk_key_...",
},
});
const answer = await res.json();{
"requests": [
{
"id": "a9d3f7b1-6e0c-4a28-b4d6-9e5f7c1a3d75",
"version": 1,
"state": "pending",
"createdAt": "2026-11-20T18:10:00.000Z",
"expiresAt": "2026-12-20T18:10:00.000Z",
"resolvedAt": null,
"requester": {
"id": "1b2c3d4e-5f60-4718-9a2b-3c4d5e6f7a81",
"displayName": "Sam Rivera"
}
}
],
"nextCursor": null
}Send a requestGET
It is sent with the key you give, as you. A change made here is real.
The request could not be sent, or its response could not be read.