questions

Ask a question.

Requires an Idempotency-Key header (a UUID). The same key returns the same question for 24 hours; a different body with the same key is idempotency_conflict. Fails with insufficient_credits, spend_cap_reached or content_refused without spending anything. The portal and app are reminded once with 422 quality_reminder (nothing stored or charged) when the wording review has a strong suggestion the writer has not taken; ask again with acknowledgeQuality: true and the same key to send it as written. The API and MCP are never reminded.

post/v2/questions

Request

  • Base URL: https://api.50heads.com
  • URL: https://api.50heads.com/v2/questions
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://auth.50heads.com/authorize, token URL https://auth.50heads.com/token; client credentials, token URL https://auth.50heads.com/token, scopes: questions:write)

Headers

Idempotency-Keystring required

A fresh UUID per ask. The same key returns the same question for 24 hours and never charges twice.

Request body

fromDraftIdstring
variantOfstring
followUpOfstring
templateIdstring
projectIdstring nullable
labelsstring[]
externalRefstring
acknowledgeQualityboolean

Response

OK

Changes

No recorded changes to this operation across all 1 revision of this API.