API docs navigation
Categories
post
/api/v1/categoriesSuggest category
Request Body
application/json
Responses
200Existing category or suggestionapplication/json
201Suggestion acceptedapplication/json
400Invalid request bodyapplication/json
401Unauthorizedapplication/json
403Workspace not entitledapplication/json
429Rate limit or daily quota exceededapplication/json
503Service unavailableapplication/json
Request examples
cURL
bashcurl --request POST \
--url 'https://questionstock.com/api/v1/categories' \
--header 'Authorization: Bearer qsk_v1_your_api_key' \
--header 'Content-Type: application/json' \
--data '{
"name": "World Capitals",
"description": "Country-capital geography questions"
}'JavaScript fetch
javascriptconst response = await fetch("https://questionstock.com/api/v1/categories", {
method: "POST",
headers: {
Authorization: "Bearer qsk_v1_your_api_key",
"Content-Type": "application/json",
},
body: JSON.stringify({
"name": "World Capitals",
"description": "Country-capital geography questions"
}),
});
if (!response.ok) {
throw new Error("API error: " + response.status);
}
const data = await response.json();