Delete a question of a draft

DELETE /supplier-assessment-templates/{templateId}/questions/{questionId}

Scope supplier_template:write Plan Growth+

Remove a question and its options from a draft. The draft’s revision is optional: send it as an If-Match header or as {"revision": N} in an optional body of at most 4 KiB (otherwise 400 VALIDATION_FAILED) and a stale value fails with 409 STALE_REVISION. The question cannot be deleted while another question’s gating rule depends on it (409 QUESTION_REFERENCED, the dependants are in error.args.dependents), and the vendor-type (service-type) question that other questions are gated on can never be deleted (409 QUESTION_IS_GATING_TRIGGER). Structural write: 30 per token and hour. Requires the supplier_template:write scope (or a signed-in Owner, Manager or Contributor session).

Example

curl -X DELETE "https://api.autociso.io/api/v1/supplier-assessment-templates/<templateId>/questions/<questionId>" \
  -H "Authorization: Bearer <your-api-token>"

Response 204

No response body

Path parameters

  • templateId string required
    Questionnaire document id (satpl_...), or satpl_builtin_supplier_security_privacy_v1 for the built-in one.
  • questionId string required
    Question id, as returned in sections[].questions[].questionId.

Header parameters

  • If-Match string
    The draft revision as W/"<revision>", from the ETag header. Wins over a revision in the body. A write on an older revision fails with 409 STALE_REVISION. pattern ^W/"[0-9]+"$

Request body

  • revision integer
    minimum 0

Returns

Status 204 with no response body.

Errors

Status Code Retry Meaning
400 VALIDATION_FAILED no The JSON body does not match the request schema, or the revision is missing where required. code VALIDATION_FAILED.
401 INVALID_TOKEN no Missing (UNAUTHORIZED) or invalid, expired or revoked (INVALID_TOKEN) token.
402 FEATURE_GATED no The tenant plan does not include supply chain security. code FEATURE_GATED; args.feature, args.minTier, args.minTierName.
403 INSUFFICIENT_SCOPE no The token lacks supplier_template:write (INSUFFICIENT_SCOPE), has no accountable person (FORBIDDEN: this principal cannot edit questionnaires), or the target is the built-in questionnaire (BUILTIN_IMMUTABLE).
404 QUESTION_NOT_FOUND no Unknown questionnaire (NOT_FOUND), question (QUESTION_NOT_FOUND) or option (OPTION_NOT_FOUND).
409 QUESTION_REFERENCED no Everything in EditConflict, plus QUESTION_REFERENCED (another question’s gating rule depends on it; args.dependents lists them) and QUESTION_IS_GATING_TRIGGER (the vendor-type question cannot be deleted).
429 RATE_LIMITED yes Too many failed authentication attempts from this address, or the token used its hourly write budget (30 structural, 120 field edits). code RATE_LIMITED; wait Retry-After seconds, also in error.args.retryAfterSeconds.
500 DB_ERROR no Unexpected server error. code DB_ERROR; quote error.id to support.
503 BILLING_UNAVAILABLE yes Billing is temporarily unavailable, so the plan could not be checked. code BILLING_UNAVAILABLE. Retry later.
Last reviewed: 2026-10-13

Was this page helpful?

Esc