Get a join request
One of the key's person's own requests to join a project.
Only the key's person's own requests are found.
Authorization
Authorization: Bearer <key> Authentication
Path parameters
The request's id.
Response
200 The request.
The request to join.
Show properties of requestHide properties of request
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 name of the project the request is for.
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).session_revoked The request carries no session the server holds, or its session has ended.session_expired The session has expired.not_found The route or record the request names does not exist, or is not one the signed-in person can reach.session_changed The session changed while the request was in flight.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/account/join-requests/a9d3f7b1-6e0c-4a28-b4d6-9e5f7c1a3d75" \
-H "Authorization: Bearer wk_key_..."const res = await fetch("https://api.getwerk.ai/api/v1/account/join-requests/a9d3f7b1-6e0c-4a28-b4d6-9e5f7c1a3d75", {
headers: {
Authorization: "Bearer wk_key_...",
},
});
const answer = await res.json();{
"request": {
"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,
"projectName": "Harbor Street kitchen"
}
}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.