remove_question

DELETE /v1/scoring_models/{model_id}/questions/{question_id} removes a question from a scoring model, without calibrating it.

A question the calibrated score uses is removed with remove_questions when you calibrate instead. See Changing questions. Free.

DELETE

/v1/scoring_models/{model_id}/questions/{question_id}

Removes a question from a scoring model, without calibrating it. A removed question isn't asked or tried again.

If it isn't calibrated yet, you can remove any question, as long as one is left.
If it's calibrated, you can remove your own questions it doesn't use. A question the score uses is removed with remove_questions when you calibrate, so the score is refit without it.

Path parameters

Field	Type	Description
`model_id`required	string	The scoring model's `model_id`.
`question_id`required	string	The question's `id`, from get_scoring_model.

Responses

The scoring model, as get_scoring_model returns it.

Field	Type	Description
`model_id`	string	The scoring model's id, `scm_…`.
`name`	string	A few words saying what it predicts: the `name` it was created with, or the one it was given in the Finic Portal. Empty for scoring models created before names, until someone names it there.
`status`	`training`, `ready`, `failed`	`training` while it's being created, `ready` to score records, `failed` if creating it failed (create it again).
`criteria`	string	The `criteria` it was created with. Empty if none was given.
`created_at`	string	When the scoring model was created.
`calibrated_at`	string or null	When it was last calibrated, or `null` if it isn't calibrated. One created from examples is calibrated from the start; one created from its criteria alone scores with Finic's estimated weights until you calibrate it.
`archived_at`	string or null	When it was archived in the Finic Portal, or `null`. Calls to score with or calibrate an archived scoring model fail with `scoring_model_archived` until it's unarchived.
`examples`	integer	The number of examples it was created from, or first calibrated with; 0 until then.
`bad_rate`	number	The share of those examples with `is_bad` true, 0 to 1; 0 until then.
`scored`	integer	The number of records scored with it.
`outcomes`	integer	The number of those records with an outcome sent to calibrate.
`questions`	array of object	The questions it uses, the strongest first. Your own questions it doesn't use are listed on its page in the Finic Portal.

Field	Type	Description
`id`	string	The question's id, such as `q007`, for remove_question or `remove_questions`.
`text`	string	The question
`source`	`finic`, `user`	`finic` for a question Finic wrote, `user` for one you added.
`weight`	number	How much it moves the score, from the latest calibration, or Finic's estimate if the scoring model isn't calibrated yet. Positive when a likely yes raises the score, negative when it lowers it; the larger, the more it counts.

Status	Type and when
`400`	`invalid_request`: it's the scoring model's last question. Add another before removing it.
`401`	`authentication_error`: the API key is missing, unknown, revoked or expired.
`404`	`scoring_model_not_found`: no scoring model with this `model_id` in your organization. `question_not_found`: the scoring model has no question with this id that you can see.
`409`	`question_in_use`: the calibrated score uses this question. Remove it with `remove_questions` when you calibrate. `scoring_model_not_ready`: the scoring model is still being created, or creating it failed. `scoring_model_archived`: the scoring model is archived. `calibration_in_progress`: it's being calibrated. Remove the question when its job completes. `conflict`: it changed at the same moment. Try again.
`429`	`rate_limited`: 50 changes to this scoring model in the last 24 hours, or over the request rate.

Every error has the same shape; see Errors.

Examples

Example Request

curl -X DELETE 'https://api.finic.ai/v1/scoring_models/string/questions/string' \  -H "Authorization: Bearer $FINIC_API_KEY"

Example ResponseSchema

{  "model_id": "scm_01M4XRC000RT2GZSKYPD8J86G9",  "name": "Card-not-present payment fraud",  "status": "ready",  "criteria": "Card-not-present payments at an online store. Bad: the payment was charged back as fraud within 90 days.",  "created_at": "2026-10-20T17:04:11Z",  "calibrated_at": null,  "archived_at": null,  "examples": 0,  "bad_rate": 0,  "scored": 12,  "outcomes": 0,  "questions": [    {      "id": "q003",      "text": "This record is a card payment. Is the IP address in a different country from the billing address?",      "source": "finic",      "weight": 1.24    },    {      "id": "q009",      "text": "Was the account opened less than a week before the payment?",      "source": "user",      "weight": 0.93    },    {      "id": "q006",      "text": "This record is a card payment. Has this card paid this merchant before without a dispute?",      "source": "finic",      "weight": -0.71    }  ]}

Path parameters

Responses

200 OK

Each question: questions[]

Errors (400, 401, 404, 409, 429)

Examples