Returns paginated comments for a fundraiser, newest first. Hidden and retracted comments are left out. A comment written as a donor's note from their receipt carries its gift (donation_amount_cents, donation_currency); on an anonymous gift the author fields are null and is_anonymous is true. Every row carries gif, a GIF object or null; a GIF comment's content may be empty.
Authentication is optional. Every row carries like_count; for a signed-in caller liked_by_me says whether they like it, and for a guest it is always false.
In the browser, authentication rides on the httpOnly session cookies set by /cognito/signin or the Google / Apple sign-in at /cognito/oauth/{provider}. For scripts and for Swagger UI testing, paste an API key (fh_live_…, created with POST /api-keys); a Cognito JWT is accepted too. Sign-in does not return a token in its body.
Creates a comment (or reply) on a fundraiser. The author is derived from the authenticated user. Content must be 2000 characters or less, and is required unless gif_id is set. gif_id attaches a GIF (#1963): a GIPHY id from GET /gifs/trending or GET /gifs/search. The server looks it up on GIPHY and stores the GIF object it builds itself; clients never send URLs. Only g and pg GIFs are accepted. A request with gif_id also counts against the GIF rate limit (60 a minute per account).
Requires a verified email address, and is gated by the features.comments flag — either gate failing answers 403.
In the browser, authentication rides on the httpOnly session cookies set by /cognito/signin or the Google / Apple sign-in at /cognito/oauth/{provider}. For scripts and for Swagger UI testing, paste an API key (fh_live_…, created with POST /api-keys); a Cognito JWT is accepted too. Sign-in does not return a token in its body.
GIPHY's trending GIFs, rated pg or lower, as GIF objects. Cached on the server for a few minutes. Page with offset = the previous answer's next_offset.
Authentication is optional. Rate limited at 60 requests a minute per account (per IP for a guest), on top of the public limit.
Answers 503 { "error": "gifs_unavailable" } while GIF comments are off (features.comment_gifs) or GIPHY is not configured. Clients should hide their GIF button when they get it.
In the browser, authentication rides on the httpOnly session cookies set by /cognito/signin or the Google / Apple sign-in at /cognito/oauth/{provider}. For scripts and for Swagger UI testing, paste an API key (fh_live_…, created with POST /api-keys); a Cognito JWT is accepted too. Sign-in does not return a token in its body.
GIPHY search, rated pg or lower, as GIF objects. Cached on the server by q, offset, limit and lang. Same limits and 503 behaviour as GET /gifs/trending.
In the browser, authentication rides on the httpOnly session cookies set by /cognito/signin or the Google / Apple sign-in at /cognito/oauth/{provider}. For scripts and for Swagger UI testing, paste an API key (fh_live_…, created with POST /api-keys); a Cognito JWT is accepted too. Sign-in does not return a token in its body.
Deletes a comment. Only the comment's author may delete it. A donor's note tied to a gift is retracted (hidden, kept for the record) rather than deleted.
In the browser, authentication rides on the httpOnly session cookies set by /cognito/signin or the Google / Apple sign-in at /cognito/oauth/{provider}. For scripts and for Swagger UI testing, paste an API key (fh_live_…, created with POST /api-keys); a Cognito JWT is accepted too. Sign-in does not return a token in its body.
Likes a comment or a reply as the authenticated user. Idempotent: liking a comment you already like changes nothing and answers the same state. No verified email is required. Gated by the features.comments flag and the per-account rate limit.
In the browser, authentication rides on the httpOnly session cookies set by /cognito/signin or the Google / Apple sign-in at /cognito/oauth/{provider}. For scripts and for Swagger UI testing, paste an API key (fh_live_…, created with POST /api-keys); a Cognito JWT is accepted too. Sign-in does not return a token in its body.
In the browser, authentication rides on the httpOnly session cookies set by /cognito/signin or the Google / Apple sign-in at /cognito/oauth/{provider}. For scripts and for Swagger UI testing, paste an API key (fh_live_…, created with POST /api-keys); a Cognito JWT is accepted too. Sign-in does not return a token in its body.
Comments
Fundraiser comments and replies
List comments for a fundraiser
Returns paginated comments for a fundraiser, newest first. Hidden and retracted comments are left out. A comment written as a donor's note from their receipt carries its gift (
donation_amount_cents,donation_currency); on an anonymous gift the author fields are null andis_anonymousis true. Every row carriesgif, a GIF object or null; a GIF comment'scontentmay be empty.Authentication is optional. Every row carries
like_count; for a signed-in callerliked_by_mesays whether they like it, and for a guest it is alwaysfalse.Authorizations
In the browser, authentication rides on the httpOnly session cookies set by
/cognito/signinor the Google / Apple sign-in at/cognito/oauth/{provider}. For scripts and for Swagger UI testing, paste an API key (fh_live_…, created withPOST /api-keys); a Cognito JWT is accepted too. Sign-in does not return a token in its body.Parameters
Path Parameters
"uuid"Query Parameters
50110000Responses
Comment list
Playground
Server
Authorization
Variables
Samples
Create a comment
Creates a comment (or reply) on a fundraiser. The author is derived from the authenticated user. Content must be 2000 characters or less, and is required unless
gif_idis set.gif_idattaches a GIF (#1963): a GIPHY id fromGET /gifs/trendingorGET /gifs/search. The server looks it up on GIPHY and stores the GIF object it builds itself; clients never send URLs. OnlygandpgGIFs are accepted. A request withgif_idalso counts against the GIF rate limit (60 a minute per account).Requires a verified email address, and is gated by the
features.commentsflag — either gate failing answers403.Authorizations
In the browser, authentication rides on the httpOnly session cookies set by
/cognito/signinor the Google / Apple sign-in at/cognito/oauth/{provider}. For scripts and for Swagger UI testing, paste an API key (fh_live_…, created withPOST /api-keys); a Cognito JWT is accepted too. Sign-in does not return a token in its body.Parameters
Path Parameters
"uuid"Request Body
Responses
Comment created — the stored row (including
gif, a GIF object or null) plusauthor_nameandauthor_avatar.Playground
Server
Authorization
Variables
Body
Samples
Trending GIFs for the comment GIF picker
GIPHY's trending GIFs, rated
pgor lower, as GIF objects. Cached on the server for a few minutes. Page withoffset= the previous answer'snext_offset.Authentication is optional. Rate limited at 60 requests a minute per account (per IP for a guest), on top of the public limit.
Answers
503 { "error": "gifs_unavailable" }while GIF comments are off (features.comment_gifs) or GIPHY is not configured. Clients should hide their GIF button when they get it.Authorizations
In the browser, authentication rides on the httpOnly session cookies set by
/cognito/signinor the Google / Apple sign-in at/cognito/oauth/{provider}. For scripts and for Swagger UI testing, paste an API key (fh_live_…, created withPOST /api-keys); a Cognito JWT is accepted too. Sign-in does not return a token in its body.Parameters
Query Parameters
24150004999Responses
A page of GIFs
Playground
Server
Authorization
Variables
Samples
Search GIFs for the comment GIF picker
GIPHY search, rated
pgor lower, as GIF objects. Cached on the server byq,offset,limitandlang. Same limits and503behaviour asGET /gifs/trending.Authorizations
In the browser, authentication rides on the httpOnly session cookies set by
/cognito/signinor the Google / Apple sign-in at/cognito/oauth/{provider}. For scripts and for Swagger UI testing, paste an API key (fh_live_…, created withPOST /api-keys); a Cognito JWT is accepted too. Sign-in does not return a token in its body.Parameters
Query Parameters
The search term. Whitespace is collapsed and it is cut to 50 characters.
124150004999The search language. Anything else is treated as
en."en""ru""uk""es""en"Responses
A page of GIFs
Playground
Server
Authorization
Variables
Samples
Delete a comment
Deletes a comment. Only the comment's author may delete it. A donor's note tied to a gift is retracted (hidden, kept for the record) rather than deleted.
Authorizations
In the browser, authentication rides on the httpOnly session cookies set by
/cognito/signinor the Google / Apple sign-in at/cognito/oauth/{provider}. For scripts and for Swagger UI testing, paste an API key (fh_live_…, created withPOST /api-keys); a Cognito JWT is accepted too. Sign-in does not return a token in its body.Parameters
Path Parameters
"uuid"Responses
Comment deleted
Playground
Server
Authorization
Variables
Samples
Like a comment
Likes a comment or a reply as the authenticated user. Idempotent: liking a comment you already like changes nothing and answers the same state. No verified email is required. Gated by the
features.commentsflag and the per-account rate limit.Authorizations
In the browser, authentication rides on the httpOnly session cookies set by
/cognito/signinor the Google / Apple sign-in at/cognito/oauth/{provider}. For scripts and for Swagger UI testing, paste an API key (fh_live_…, created withPOST /api-keys); a Cognito JWT is accepted too. Sign-in does not return a token in its body.Parameters
Path Parameters
"uuid"Responses
Liked; the comment's count after the write
Playground
Server
Authorization
Variables
Samples
Unlike a comment
Removes the authenticated user's like from a comment or a reply. Idempotent: unliking a comment you do not like changes nothing.
Authorizations
In the browser, authentication rides on the httpOnly session cookies set by
/cognito/signinor the Google / Apple sign-in at/cognito/oauth/{provider}. For scripts and for Swagger UI testing, paste an API key (fh_live_…, created withPOST /api-keys); a Cognito JWT is accepted too. Sign-in does not return a token in its body.Parameters
Path Parameters
"uuid"Responses
Not liked; the comment's count after the write
Playground
Server
Authorization
Variables
Samples