Send Sources (Admin)

1 endpoints from the published OpenAPI import.

POST/api/v1/admin/send/sources/{mailbox_id}/promote

Promote any sending source, optionally waiving the reputation gate

The operator door — the whole pool, and the D7 override.

Gate: require_super_admin_or_admin_key — an X-Admin-Key or a super_admin session. Deliberately NOT reachable with an ordinary tenant PAT: this is the only place the reputation precondition can be waived.

⚠️ override_reputation_gate=true arms a source for real sending with no reputation brake behind it. The ReputationBreaker is shipped and armed but has zero input until an owner provisions Google Postmaster / Microsoft SNDS credentials, so a source promoted under the override sends with nothing watching its complaint rate. That is a deliberate, attributed human decision — the Phase-1 tiny-smoke precedent — and it is logged as one. Pass reason.

Every other refusal still applies: the override waives D7 and D7 only. An immature source, an expired one and a non-'warming' one are refused here exactly as they are on the tenant route.

Parameters

Name	In	Type	Required	Description
`mailbox_id`	path	integer	true	The sending source to graduate. Must already be in 'warming'.

Try it

Examples

cURL

curl -X POST 'https://spideriq.ai/api/v1/admin/send/sources/{mailbox_id}/promote' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -d '{
  "override_reputation_gate": false,
  "reason": "string"
}'

Python

import httpx

resp = httpx.post(
    "https://spideriq.ai/api/v1/admin/send/sources/{mailbox_id}/promote",
    headers={"Authorization": "Bearer <token>", "Content-Type": "application/json"},
    json={"override_reputation_gate": false, "reason": "string"},
)
resp.raise_for_status()
print(resp.json())

JavaScript

const resp = await fetch("https://spideriq.ai/api/v1/admin/send/sources/{mailbox_id}/promote", {
  method: "POST",
  headers: { "Authorization": "Bearer <token>", "Content-Type": "application/json" },
  body: JSON.stringify({"override_reputation_gate": false, "reason": "string"})
});
const data = await resp.json();
console.log(data);

package main

import (
	"net/http"
	"strings"
)

func main() {
	body := strings.NewReader(`{"override_reputation_gate": false, "reason": "string"}`)
	req, _ := http.NewRequest("POST", "https://spideriq.ai/api/v1/admin/send/sources/{mailbox_id}/promote", body)
	req.Header.Set("Authorization", "Bearer <token>")
	req.Header.Set("Content-Type", "application/json")
	resp, _ := http.DefaultClient.Do(req)
	defer resp.Body.Close()
}

Responses

Status	Description
`200`	Successful Response
`422`	Validation Error