{"components":{"responses":{"forbidden":{"content":{"application/json":{"example":{"errors":{"details":"Forbidden"}},"schema":{"type":"object"}}},"description":"Forbidden"},"no_content":{"description":"No Content"},"too_many_requests":{"content":{"application/json":{"example":{"code":"rate_limited","errors":"You're doing that a little too often. Please wait 4 minutes and try again.","retry_after":240},"schema":{"type":"object"}}},"description":"Too many writes from this address, or to this board, in a short time. Wait the number of seconds in the Retry-After header (also given as retry_after) and try again.","headers":{"Retry-After":{"description":"Seconds until the limit resets","schema":{"type":"integer"},"style":"simple"}}},"unauthorised":{"content":{"application/json":{"example":{"errors":{"details":"Unauthorised"}},"schema":{"type":"object"}}},"description":"Unauthorised"},"unprocessable_entity":{"content":{"application/json":{"example":{"errors":{"details":"Unprocessable Entity"}},"schema":{"type":"object"}}},"description":"Unprocessable Entity"}},"schemas":{"AuthResponse":{"description":"Successful authentication response","example":{"token":"vW4sIvFvqkw6iogdhNyyFXa2nKg4LlsVobOTR721hbs","token_type":"bearer"},"properties":{"token":{"description":"Token","type":"string"},"token_type":{"description":"Token Type","type":"string"}},"required":["token","token_type"],"title":"AuthResponse","type":"object"},"ChangelogEntries":{"description":"Response body for the published changelog","properties":{"labels":{"description":"Every label the board's published entries carry, for the widget's filter","items":{"properties":{"color":{"description":"Hex colour","type":"string"},"id":{"description":"Id","type":"string"},"name":{"description":"Name","type":"string"}},"required":["id","name","color"],"type":"object"},"type":"array"},"records":{"items":{"properties":{"description":{"description":"Body, in Markdown","nullable":true,"type":"string"},"description_html":{"description":"Body, rendered and sanitised","type":"string"},"id":{"description":"Id","type":"string"},"labels":{"items":{"properties":{"color":{"description":"Hex colour","type":"string"},"id":{"description":"Id","type":"string"},"name":{"description":"Name","type":"string"}},"required":["id","name","color"],"type":"object"},"type":"array"},"name":{"description":"Title of the entry","type":"string"},"published_at":{"description":"When it was published","nullable":true,"type":"string"},"published_date":{"description":"The date shown to readers","nullable":true,"type":"string"},"reactions":{"description":"Emoji reactions left on the entry, zero counts omitted. Empty when the board does not show reactions.","items":{"properties":{"count":{"description":"How many visitors left it","type":"integer"},"emoji":{"description":"Key of the emoji, e.g. rocket","type":"string"},"glyph":{"description":"The emoji itself","type":"string"}},"required":["emoji","glyph","count"],"type":"object"},"type":"array"},"url":{"description":"Public URL of the entry","type":"string"},"version":{"description":"Version","nullable":true,"type":"string"}},"required":["id","name","url","labels","reactions"],"type":"object"},"type":"array"}},"required":["records","labels"],"title":"ChangelogEntries","type":"object"},"Comment":{"description":"Feature comment","properties":{"contributor":{"$ref":"#/components/schemas/Contributor"},"id":{"description":"Id","type":"string"},"inserted_at":{"description":"Inserted At","format":"date-time","type":"string"},"message":{"description":"Message","type":"string"}},"title":"Comment","type":"object"},"CommentCreate":{"description":"Request body for commenting a feature","example":{"contributor":{"email":"john.doe@example.com","name":"John Doe"},"message":"Really nice feature!"},"properties":{"contributor":{"description":"Comment author","type":"Elixir.UpvotedApi.Schemas.Contributor"},"message":{"description":"Message","type":"string"}},"required":["message","contributor"],"title":"CommentCreate","type":"object"},"CommentCreateAuth":{"description":"Request body for commenting a feature (authenticated user)","example":{"message":"Really nice feature!"},"properties":{"message":{"description":"Message","type":"string"}},"required":["message"],"title":"CommentCreateAuth","type":"object"},"CommentFull":{"description":"Comment with feature and URLs (Zapier)","properties":{"contributor":{"$ref":"#/components/schemas/Contributor"},"feature":{"properties":{"id":{"description":"Feature Id","type":"string"},"title":{"description":"Feature Title","type":"string"},"url":{"description":"Feature URL","type":"string"}},"type":"object"},"id":{"description":"Id","type":"string"},"inserted_at":{"description":"Inserted At","format":"date-time","type":"string"},"message":{"description":"Message","type":"string"},"url":{"description":"Comment URL","type":"string"}},"title":"CommentFull","type":"object"},"CommentRecords":{"description":"Response body for comments list (Zapier)","properties":{"page":{"description":"Page","example":1,"type":"integer"},"per_page":{"description":"Per page","example":20,"type":"integer"},"records":{"items":{"$ref":"#/components/schemas/CommentFull"},"type":"array"},"total_count":{"description":"Total count","example":1,"type":"integer"},"total_pages":{"description":"Total pages","example":1,"type":"integer"}},"required":["records"],"title":"CommentRecords","type":"object"},"Contributor":{"description":"Current object author","properties":{"email":{"description":"Email of the submitter","format":"email","type":"string"},"name":{"description":"Name of the submitter","type":"string"}},"title":"Contributor","type":"object"},"FeatureCreate":{"description":"Request body for submitting a new feature","example":{"contributor":{"email":"john.doe@example.com","name":"John Doe"},"custom_fields":{"address":"123 Main St, Anytown, USA","telephone":"123456789"},"description":"Every time a feature is created, notifiy admins also with an email","image_upload":{"content_type":"image/jpeg","data":"base64encodeddata","filename":"image.jpg"},"title":"Add email notifications to users"},"properties":{"contributor":{"description":"Feature proposal author","type":"Elixir.UpvotedApi.Schemas.Contributor"},"custom_fields":{"description":"Custom fields","type":"Elixir.UpvotedApi.Schemas.CustomFields"},"description":{"description":"Description","type":"string"},"image_upload":{"description":"Image","format":"binary","type":"Elixir.UpvotedApi.Schemas.ImageUpload"},"title":{"description":"Title","type":"string"}},"required":["title","description","contributor"],"title":"FeatureCreate","type":"object"},"FeatureCreateAuth":{"description":"Request body for submitting a new feature","example":{"custom_fields":{"address":"123 Main St, Anytown, USA","telephone":"123456789"},"description":"Every time a feature is created, notifiy admins also with an email","image_upload":{"content_type":"image/jpeg","data":"base64encodeddata","filename":"image.jpg"},"title":"Add email notifications to users"},"properties":{"custom_fields":{"description":"Custom fields","type":"Elixir.UpvotedApi.Schemas.CustomFields"},"description":{"description":"Description","type":"string"},"image_upload":{"description":"Image","format":"binary","type":"Elixir.UpvotedApi.Schemas.ImageUpload"},"title":{"description":"Title","type":"string"}},"required":["title","description"],"title":"FeatureCreateAuth","type":"object"},"FeatureRecords":{"description":"Response body for feature list","properties":{"page":{"description":"Page","example":1,"type":"integer"},"per_page":{"description":"Per page","example":10,"type":"integer"},"records":{"items":{"$ref":"#/components/schemas/IndexFeature"},"type":"array"},"total_count":{"description":"Total count","example":1,"type":"integer"},"total_pages":{"description":"Total pages","example":1,"type":"integer"}},"required":["records"],"title":"FeatureRecords","type":"object"},"IndexFeature":{"description":"Response body for feature","example":{"comments_count":0,"contributor":{"email":"john.doe@example.com","name":"John Doe"},"id":"14e47888-028a-498a-9ba0-8d281f236cd2","image":"https://example.com/image.jpg","inserted_at":"2025-01-09T14:29:14Z","private_upvotes_count":0,"public_upvotes_count":0,"published":true,"status":"pending","title":"Add email notifications to users","url":"https://upvoted.io/app/board/acme/features/14e47888-028a-498a-9ba0-8d281f236cd2/detail"},"properties":{"comments_count":{"description":"Comments Count","type":"integer"},"contributor":{"$ref":"#/components/schemas/Contributor"},"estimate":{"description":"When the board expects to ship it, as a month (\"Oct 2026\") or a quarter (\"Q3 2026\"). Null unless the board shows its estimates publicly","nullable":true,"type":"string"},"id":{"description":"Id","type":"string"},"image":{"description":"Image","type":"string"},"inserted_at":{"description":"Inserted At","format":"date-time","type":"string"},"private_upvotes_count":{"description":"Private Upvotes Count","type":"integer"},"public_upvotes_count":{"description":"Public Upvotes Count","type":"integer"},"published":{"description":"False while the request is held for the board's approval and not yet on the public board","type":"boolean"},"status":{"description":"Status","type":"string"},"title":{"description":"Title","type":"string"},"url":{"description":"URL to feature detail","type":"string"}},"title":"IndexFeature","type":"object"},"ShowFeature":{"description":"Response body for feature","example":{"board":{"name":"Acme","slug":"acme"},"comments":[{"contributor":{"email":"steve@releasy.xyz","name":"Steve"},"inserted_at":"2025-01-09T14:30:02Z","message":"Good idea!"}],"comments_count":1,"contributor":{"email":"john.doe@example.com","name":"John Doe"},"custom_fields":{"address":"123 Main St, Anytown, USA","telephone":"123456789"},"description":"Every time a feature is created, notifiy admins also with an email","id":"14e47888-028a-498a-9ba0-8d281f236cd2","image":"https://example.com/image.jpg","inserted_at":"2025-01-09T14:29:14Z","private_upvotes_count":1,"public_upvotes_count":0,"published":true,"status":"pending","title":"Add email notifications to users","url":"https://upvoted.io/app/board/acme/features/14e47888-028a-498a-9ba0-8d281f236cd2/detail","votes":[{"contributor":{"email":"steve@releasy.xyz","name":"Steve"},"inserted_at":"2025-01-09T14:29:46Z","public":false}]},"properties":{"board":{"description":"Board info","properties":{"name":{"description":"Board name","type":"string"},"slug":{"description":"Board slug","type":"string"}},"type":"object"},"comments":{"items":{"$ref":"#/components/schemas/Comment"},"type":"array"},"comments_count":{"description":"Comments Count","type":"integer"},"contributor":{"$ref":"#/components/schemas/Contributor"},"custom_fields":{"description":"Custom fields","type":"Elixir.UpvotedApi.Schemas.CustomFields"},"description":{"description":"Description","type":"string"},"estimate":{"description":"When the board expects to ship it, as a month (\"Oct 2026\") or a quarter (\"Q3 2026\"). Null unless the board shows its estimates publicly","nullable":true,"type":"string"},"id":{"description":"Id","type":"string"},"image":{"description":"Image","type":"string"},"inserted_at":{"description":"Inserted At","format":"date-time","type":"string"},"private_upvotes_count":{"description":"Private Upvotes Count","type":"integer"},"public_upvotes_count":{"description":"Public Upvotes Count","type":"integer"},"published":{"description":"False while the request is held for the board's approval and not yet on the public board","type":"boolean"},"status":{"description":"Status","type":"string"},"title":{"description":"Title","type":"string"},"url":{"description":"URL to feature detail","type":"string"},"votes":{"items":{"$ref":"#/components/schemas/Vote"},"type":"array"}},"title":"ShowFeature","type":"object"},"StatusRecords":{"description":"Response body for status list","example":{"records":[{"is_final":false,"is_initial":true,"name":"Pending","order":0}]},"properties":{"records":{"items":{"properties":{"is_final":{"description":"Is final","type":"boolean"},"is_initial":{"description":"Is initial","type":"boolean"},"name":{"description":"Name","type":"string"},"order":{"description":"Order","type":"integer"}},"required":["name","order","is_final","is_initial"],"type":"object"},"type":"array"}},"required":["records"],"title":"StatusRecords","type":"object"},"UpvoteCreate":{"description":"Request body for upvoting feature","example":{"contributor":{"email":"carl.smith@example.com","name":"Carl Smith"}},"properties":{"contributor":{"description":"Upvoter","type":"Elixir.UpvotedApi.Schemas.Contributor"}},"required":["contributor"],"title":"UpvoteCreate","type":"object"},"User":{"description":"Response body for user","example":{"avatar":"","email":"admin@example.com","id":"1","is_admin":true,"is_confirmed":true,"is_deleted":false,"is_onboarded":true,"is_suspended":false,"name":"John Smith","role":"admin"},"properties":{"avatar":{"description":"Avatar url","type":"string"},"email":{"description":"Email address","format":"email","type":"string"},"id":{"description":"Id","type":"int"},"is_admin":{"description":"Is an admin user","type":"bool"},"is_confirmed":{"description":"Email address is confirmed","type":"bool"},"is_deleted":{"description":"Is deleted","type":"bool"},"is_onboarded":{"description":"Is onboarded","type":"bool"},"is_suspended":{"description":"User has been suspended","type":"bool"},"name":{"description":"Name","type":"string"},"role":{"description":"Role","type":"string"}},"required":["id","name","email"],"title":"User","type":"object"},"UserCredentials":{"description":"Request body for user credentials","example":{"email":"admin@example.com","password":"password"},"properties":{"email":{"description":"Email address","format":"email","type":"string"},"password":{"description":"Password","format":"password","type":"string"}},"required":["email","password"],"title":"UserCredentials","type":"object"},"UserRegistration":{"description":"Request body for user registration","example":{"avatar":"","email":"admin@example.com","name":"John Smith","password":"neat_password"},"properties":{"avatar":{"description":"Avatar url","type":"string"},"email":{"description":"Email address","format":"email","type":"string"},"name":{"description":"Name","type":"string"},"password":{"description":"Password","format":"password","type":"string"}},"required":["name","email","password"],"title":"UserRegistration","type":"object"},"Vote":{"description":"Feature upvote","properties":{"contributor":{"$ref":"#/components/schemas/Contributor"},"inserted_at":{"description":"Inserted At","format":"date-time","type":"string"},"public":{"description":"Public","type":"boolean"}},"title":"Vote","type":"object"},"WidgetConfig":{"description":"Response body for the widget's settings","properties":{"custom_css":{"description":"A Max board's custom CSS, the same stylesheet its public pages use, with every rule confined to `.upv-widget` and the board pages and nothing in it that loads from another address. The widget adds it last inside its shadow root. Null below Max or when the board has none.","nullable":true,"type":"string"},"language":{"description":"The language to show the widget in: the `locale` asked for when the board offers it, else the board's own. One of en, fr, de, es, it, pt, nl, pl, sv, da, ja, zh, ko, tr.","type":"string"},"logo_url":{"description":"A Max board's own logo, shown instead of Upvoted's. Null below Max.","nullable":true,"type":"string"},"show_powered_by":{"description":"Whether to show the \"Powered by Upvoted\" branding. Only a Max board can turn it off.","type":"boolean"},"strings":{"additionalProperties":{"type":"string"},"description":"The widget's interface text in `language`, keyed by its English. Empty for English. Anything missing shows in English.","type":"object"}},"required":["show_powered_by","logo_url","custom_css","language","strings"],"title":"WidgetConfig","type":"object"}},"securitySchemes":{"authorization":{"description":"You must generate an API token first for a given board","scheme":"bearer","type":"http"}}},"info":{"title":"Upvoted API","version":"1.0"},"openapi":"3.0.0","paths":{"/api/board/{org_slug}/features":{"get":{"callbacks":{},"description":"List all features for this board as the authenticated user","operationId":"UpvotedApi.FeaturesAuthController.auth_index","parameters":[{"description":"Organisation slug","in":"path","name":"org_slug","required":true,"schema":{"type":"string"}},{"description":"The name of one of this board's statuses, matched case-insensitively — not a fixed list. A board that kept the defaults has: Pending, Approved, In Progress, Done, Rejected, Published. Note the space in \"In Progress\": the old underscored spelling matches nothing.","in":"query","name":"status","required":false,"schema":{"type":"string"}},{"description":"Page number","in":"query","name":"page","required":false,"schema":{"type":"integer"}},{"description":"Number of items per page","in":"query","name":"per_page","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FeatureRecords"}}},"description":"Features"},"401":{"$ref":"#/components/responses/unauthorised"},"403":{"$ref":"#/components/responses/forbidden"}},"security":[{"authorization":[]}],"summary":"List all features for this board","tags":["AUTHENTICATED USER"]},"post":{"callbacks":{},"description":"Create a new feature","operationId":"UpvotedApi.FeaturesAuthController.auth_create","parameters":[{"description":"Organisation slug","in":"path","name":"org_slug","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FeatureCreateAuth"}}},"description":"Feature attributes","required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IndexFeature"}}},"description":"Created feature"},"401":{"$ref":"#/components/responses/unauthorised"},"422":{"$ref":"#/components/responses/unprocessable_entity"}},"security":[{"authorization":[]}],"summary":"Create a new feature","tags":["AUTHENTICATED USER"]}},"/api/board/{org_slug}/features/{id}":{"get":{"callbacks":{},"description":"Show specific feature for this board as the authenticated user","operationId":"UpvotedApi.FeaturesAuthController.auth_show","parameters":[{"description":"Organisation slug","in":"path","name":"org_slug","required":true,"schema":{"type":"string"}},{"description":"The id of the feature to load","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShowFeature"}}},"description":"Feature"},"401":{"$ref":"#/components/responses/unauthorised"},"403":{"$ref":"#/components/responses/forbidden"}},"security":[{"authorization":[]}],"summary":"Show specific feature for this board","tags":["AUTHENTICATED USER"]}},"/api/board/{org_slug}/features/{id}/comments":{"post":{"callbacks":{},"description":"Add a comment to a feature as the authenticated user","operationId":"UpvotedApi.FeaturesAuthController.auth_comment","parameters":[{"description":"Organisation slug","in":"path","name":"org_slug","required":true,"schema":{"type":"string"}},{"description":"The id of the feature to comment on","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommentCreateAuth"}}},"description":"Comment attributes","required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShowFeature"}}},"description":"Commented feature"},"401":{"$ref":"#/components/responses/unauthorised"},"422":{"$ref":"#/components/responses/unprocessable_entity"}},"security":[{"authorization":[]}],"summary":"Add a comment to a feature","tags":["AUTHENTICATED USER"]}},"/api/board/{org_slug}/features/{id}/upvote":{"post":{"callbacks":{},"description":"Upvote a feature as the authenticated user","operationId":"UpvotedApi.FeaturesAuthController.auth_upvote","parameters":[{"description":"Organisation slug","in":"path","name":"org_slug","required":true,"schema":{"type":"string"}},{"description":"The id of the feature to upvote","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShowFeature"}}},"description":"Upvoted feature"},"401":{"$ref":"#/components/responses/unauthorised"},"422":{"$ref":"#/components/responses/unprocessable_entity"}},"security":[{"authorization":[]}],"summary":"Upvote a feature","tags":["AUTHENTICATED USER"]}},"/api/board/{org_slug}/statuses":{"get":{"callbacks":{},"description":"Get statuses for current board as the authenticated user","operationId":"UpvotedApi.FeaturesAuthController.auth_statuses","parameters":[{"description":"Organisation slug","in":"path","name":"org_slug","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StatusRecords"}}},"description":"Statuses"}},"security":[{"authorization":[]}],"summary":"Get statuses for current board","tags":["AUTHENTICATED USER"]}},"/api/boards/changelog":{"get":{"callbacks":{},"description":"Published changelog entries for the board the API token belongs to, newest first.","operationId":"UpvotedApi.ChangelogController.index","parameters":[{"description":"Only entries carrying this changelog label id.","in":"query","name":"label","required":false,"schema":{"type":"string"}},{"description":"How many entries to return (1-50, default 20).","in":"query","name":"limit","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChangelogEntries"}}},"description":"Changelog"},"401":{"$ref":"#/components/responses/unauthorised"},"403":{"$ref":"#/components/responses/forbidden"}},"security":[{"authorization":[]}],"summary":"The board's published changelog","tags":["API TOKEN"]}},"/api/boards/config":{"get":{"callbacks":{},"description":"What the embeddable widget needs before it renders: the Upvoted branding, a Max board's own logo, a Max board's custom CSS, and the language to show it in with its interface text. Pass `locale` (e.g. `de`) to ask for a language; a board that does not offer it answers in its own.","operationId":"UpvotedApi.WidgetConfigController.show","parameters":[{"description":"The language to show the widget in, e.g. de or pt-BR","in":"query","name":"locale","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WidgetConfig"}}},"description":"Widget config"},"401":{"$ref":"#/components/responses/unauthorised"},"403":{"$ref":"#/components/responses/forbidden"}},"security":[{"authorization":[]}],"summary":"The widget's settings for the board","tags":["API TOKEN"]}},"/api/boards/features":{"get":{"callbacks":{},"description":"List all features for this board","operationId":"UpvotedApi.FeaturesTokenController.index","parameters":[{"description":"The name of one of this board's statuses, matched case-insensitively — not a fixed list. A board that kept the defaults has: Pending, Approved, In Progress, Done, Rejected, Published. Note the space in \"In Progress\": the old underscored spelling matches nothing.","in":"query","name":"status","required":false,"schema":{"type":"string"}},{"description":"Page number","in":"query","name":"page","required":false,"schema":{"type":"integer"}},{"description":"Number of items per page","in":"query","name":"per_page","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FeatureRecords"}}},"description":"Features"},"401":{"$ref":"#/components/responses/unauthorised"},"403":{"$ref":"#/components/responses/forbidden"}},"security":[{"authorization":[]}],"summary":"List all features for this board","tags":["API TOKEN"]},"post":{"callbacks":{},"description":"Create a new feature","operationId":"UpvotedApi.FeaturesTokenController.create","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FeatureCreate"}}},"description":"Feature attributes","required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IndexFeature"}}},"description":"Created feature"},"401":{"$ref":"#/components/responses/unauthorised"},"422":{"$ref":"#/components/responses/unprocessable_entity"},"429":{"$ref":"#/components/responses/too_many_requests"}},"security":[{"authorization":[]}],"summary":"Create a new feature","tags":["API TOKEN"]}},"/api/boards/features/{id}":{"get":{"callbacks":{},"description":"Show specific feature for this board","operationId":"UpvotedApi.FeaturesTokenController.show","parameters":[{"description":"The id of the feature to load","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShowFeature"}}},"description":"Feature"},"401":{"$ref":"#/components/responses/unauthorised"},"403":{"$ref":"#/components/responses/forbidden"}},"security":[{"authorization":[]}],"summary":"Show specific feature for this board","tags":["API TOKEN"]}},"/api/boards/features/{id}/comments":{"post":{"callbacks":{},"description":"Add a comment to a feature","operationId":"UpvotedApi.FeaturesTokenController.comment","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommentCreate"}}},"description":"Comment attributes","required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShowFeature"}}},"description":"Commented feature"},"401":{"$ref":"#/components/responses/unauthorised"},"422":{"$ref":"#/components/responses/unprocessable_entity"},"429":{"$ref":"#/components/responses/too_many_requests"}},"security":[{"authorization":[]}],"summary":"Add a comment to a feature","tags":["API TOKEN"]}},"/api/boards/features/{id}/upvote":{"post":{"callbacks":{},"description":"Upvote a feature","operationId":"UpvotedApi.FeaturesTokenController.upvote","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpvoteCreate"}}},"description":"Upvote attributes","required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShowFeature"}}},"description":"Upvoted feature"},"401":{"$ref":"#/components/responses/unauthorised"},"422":{"$ref":"#/components/responses/unprocessable_entity"},"429":{"$ref":"#/components/responses/too_many_requests"}},"security":[{"authorization":[]}],"summary":"Upvote a feature","tags":["API TOKEN"]}},"/api/boards/statuses":{"get":{"callbacks":{},"description":"Get statuses for current board","operationId":"UpvotedApi.FeaturesTokenController.statuses","parameters":[],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StatusRecords"}}},"description":"Statuses"}},"security":[{"authorization":[]}],"summary":"Get statuses for current board","tags":["API TOKEN"]}},"/api/register":{"post":{"callbacks":{},"description":"Register user","operationId":"UpvotedApi.RegistrationController.register","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserRegistration"}}},"description":"User registration attributes","required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/User"}}},"description":"Registered user"},"422":{"$ref":"#/components/responses/unprocessable_entity"}},"summary":"Register user","tags":["AUTHENTICATED USER"]}},"/api/sign-in":{"post":{"callbacks":{},"description":"Authenticate user and generate bearer token","operationId":"UpvotedApi.SessionController.create","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserCredentials"}}},"description":"User credentials","required":false},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthResponse"}}},"description":"Authenticated response"},"401":{"$ref":"#/components/responses/unauthorised"}},"summary":"Authenticate user","tags":["AUTHENTICATED USER"]}},"/api/zapier/comments/{id}":{"get":{"callbacks":{},"description":"Show a single comment by id (Zapier)","operationId":"UpvotedApi.FeaturesZapierController.zapier_comment","parameters":[{"description":"The id of the comment","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommentFull"}}},"description":"Comment"},"401":{"$ref":"#/components/responses/unauthorised"},"403":{"$ref":"#/components/responses/forbidden"}},"security":[{"authorization":[]}],"summary":"Zapier: Show single comment","tags":["ZAPIER"]}},"/api/zapier/features":{"get":{"callbacks":{},"description":"List features for Zapier integrations","operationId":"UpvotedApi.FeaturesZapierController.zapier_index","parameters":[{"description":"The name of one of this board's statuses, matched case-insensitively — not a fixed list. A board that kept the defaults has: Pending, Approved, In Progress, Done, Rejected, Published. Note the space in \"In Progress\": the old underscored spelling matches nothing.","in":"query","name":"status","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FeatureRecords"}}},"description":"Features"},"401":{"$ref":"#/components/responses/unauthorised"},"403":{"$ref":"#/components/responses/forbidden"}},"security":[{"authorization":[]}],"summary":"Zapier: List features","tags":["ZAPIER"]},"post":{"callbacks":{},"description":"Create a new feature (Zapier integrations)","operationId":"UpvotedApi.FeaturesZapierController.zapier_create","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FeatureCreate"}}},"description":"Feature attributes","required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IndexFeature"}}},"description":"Created feature"},"401":{"$ref":"#/components/responses/unauthorised"},"422":{"$ref":"#/components/responses/unprocessable_entity"}},"security":[{"authorization":[]}],"summary":"Zapier: Create a new feature","tags":["ZAPIER"]}},"/api/zapier/features/{id}":{"get":{"callbacks":{},"description":"Show specific feature for Zapier integrations","operationId":"UpvotedApi.FeaturesZapierController.zapier_show","parameters":[{"description":"The id of the feature to load","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShowFeature"}}},"description":"Feature"},"401":{"$ref":"#/components/responses/unauthorised"},"403":{"$ref":"#/components/responses/forbidden"}},"security":[{"authorization":[]}],"summary":"Zapier: Show feature","tags":["ZAPIER"]}},"/api/zapier/features/{id}/comments":{"get":{"callbacks":{},"description":"List comments for a specific feature (Zapier)","operationId":"UpvotedApi.FeaturesZapierController.zapier_comments","parameters":[{"description":"The id of the feature to load comments for","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommentRecords"}}},"description":"Comments"},"401":{"$ref":"#/components/responses/unauthorised"},"403":{"$ref":"#/components/responses/forbidden"}},"security":[{"authorization":[]}],"summary":"Zapier: List comments for a feature","tags":["ZAPIER"]}}},"security":[],"servers":[{"url":"https://upvoted.io","variables":{}}],"tags":[{"description":"Endpoints authenticated with a Board API Token. Use for server-to-server and Zapier token-based access to a specific board. All writing operations are done by an anonymous user (contributor).","name":"API TOKEN"},{"description":"Endpoints for signed-in users scoped by :org_slug. Uses Bearer auth; operations act on the current user's organizations. All writing operations are done by the current user.","name":"AUTHENTICATED USER"},{"description":"Routes tailored for Zapier integrations. Same auth as API Token but responses are optimized for Zapier triggers and actions. All writing operations are done by an anonymous user (contributor).","name":"ZAPIER"}]}