FOforem
surveys

Create a survey

Changed on

Create a new survey with optional nested polls and poll options. Requires Administrator privileges.

post/api/surveys

Request

  • Base URL
    https://dev.to
  • Auth
    • API key in header api-key
    • or HTTP bearer

Request body

Response

Created

type_of'survey' required

Resource discriminator

idinteger required
titlestring required
slugstring required
survey_type_of'community_pulse' | 'industry' | 'fun' | 'beta_testing' required

Survey category

activeboolean nullable

Whether the survey is currently active

display_titleboolean required

Whether to show the title to respondents

allow_resubmissionboolean required

Whether users can submit multiple times

daily_email_distributionsinteger

Daily email distributions count

extra_email_context_paragraphstring nullable

Optional context paragraph for emails

target_response_countinteger

Target response count

target_completion_datestring date-time nullable

Target completion date in the future

created_atstring date-time required
updated_atstring date-time required

Changes

  • v18b9d46508069Revision changes
    • warning

      added the new beta_testing enum value to the //// response property for the response status

    • info

      added the new beta_testing enum value to the request property /

    • info

      added the new beta_testing enum value to the request property /

  • v1ffddb865fa73Revision changes
    • info

      endpoint added