Answer a follow invitation
Accepts an invitation to follow a card, which follows it, or ignores it.
A second answer is refused.
Authorization
Authorization: Bearer <key> Authentication
Path parameters
The project's id.
The invitation's id.
Body
An id the caller makes for this request. Sent again with the same request, it returns the first answer and changes nothing twice; sent with a different request, it is refused.
The invitation's version as last read.
accept follows the card, ignore declines the invitation.
Response
200 What the request did.
applied when the answer was recorded, unchanged when it already was.
The invitation's id.
The invitation's version after the answer.
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_follow The follow 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).follow_invitation_unavailable The person invited has left the project, or the card is no longer visible to both people.session_revoked The request carries no session the server holds, or its session has ended.session_expired The session has expired.follow_invitation_actor_not_allowed The signed-in person may not invite anyone to follow a card here.conversation_not_found The project the request names, or its chat, is not one the signed-in person is in.item_not_found The card the request names, or its list, is not one the signed-in person can see.follow_invitation_not_found The invitation to follow a card that the request names is not one waiting for the signed-in person.session_changed The session changed while the request was in flight.project_deleted The project is being deleted.project_archived The project is archived, so it does not take this request.request_conflict The request id was already used with another request, or the change it asks could not be made to the record it names.request_erased The request id belongs to a request whose record was erased.follow_invitation_stale The card changed after the version the invitation to follow it names.follow_invitation_expired The invitation to follow a card has expired.follow_invitation_request_conflict The request id was already used for another invitation to follow a card.payload_too_large The request body has more bytes than the route takes.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 -X POST "https://api.getwerk.ai/api/v1/projects/2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73/follow-invitations/e1c6a4f8-0b3d-4e92-8f7a-5c2d9b1e6a30/respond" \
-H "Authorization: Bearer wk_key_..." \
-H "Content-Type: application/json" \
-d '{
"clientRequestId": "f1e2d3c4-b5a6-4978-8a9b-0c1d2e3f4f15",
"expectedVersion": 1,
"action": "accept"
}'const res = await fetch("https://api.getwerk.ai/api/v1/projects/2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73/follow-invitations/e1c6a4f8-0b3d-4e92-8f7a-5c2d9b1e6a30/respond", {
method: "POST",
headers: {
Authorization: "Bearer wk_key_...",
"Content-Type": "application/json",
},
body: JSON.stringify({
"clientRequestId": "f1e2d3c4-b5a6-4978-8a9b-0c1d2e3f4f15",
"expectedVersion": 1,
"action": "accept"
}),
});
const answer = await res.json();{
"kind": "applied",
"id": "e1c6a4f8-0b3d-4e92-8f7a-5c2d9b1e6a30",
"version": 2
}Send a requestPOST
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.