Send Sources

1 endpoints from the published OpenAPI import.

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

Graduate one of your warmed sending sources to 'active'

Clear a warmed source to send.

Until a source reaches 'active' it is never claimed and every broadcast against it returns no_sources — this is the transition that ends that.

⚠️ It does not skip the warm-up. A graduated source starts at DAY 1 of its ramp (8/day on the default curve), not at its steady daily_cap, and it cannot send for min_gap_seconds after this call. Read effective_daily_cap in the response, not daily_cap.

⚠️ It refuses a source that has not soaked long enough, with a 409 naming the days served and the days required. That refusal is the feature: a source promoted on day 0 is the cold-start reputation burn the warm-up tier exists to prevent. There is no tenant-side override — an administrator has one.

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/dashboard/send/sources/{mailbox_id}/promote' \
  -H 'Authorization: Bearer <token>'

Python

import httpx

resp = httpx.post(
    "https://spideriq.ai/api/v1/dashboard/send/sources/{mailbox_id}/promote",
    headers={"Authorization": "Bearer <token>"},
)
resp.raise_for_status()
print(resp.json())

JavaScript

const resp = await fetch("https://spideriq.ai/api/v1/dashboard/send/sources/{mailbox_id}/promote", {
  method: "POST",
  headers: { "Authorization": "Bearer <token>" }
});
const data = await resp.json();
console.log(data);

package main

import (
	"net/http"
)

func main() {
	req, _ := http.NewRequest("POST", "https://spideriq.ai/api/v1/dashboard/send/sources/{mailbox_id}/promote", nil)
	req.Header.Set("Authorization", "Bearer <token>")
	resp, _ := http.DefaultClient.Do(req)
	defer resp.Body.Close()
}

Responses

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