Create a board watch
curl --request POST \
--url https://api.vaquill.ai/api/v1/watches \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"corpusType": "<string>"
}
'import requests
url = "https://api.vaquill.ai/api/v1/watches"
payload = { "corpusType": "<string>" }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({corpusType: '<string>'})
};
fetch('https://api.vaquill.ai/api/v1/watches', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.vaquill.ai/api/v1/watches"
payload := strings.NewReader("{\n \"corpusType\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}{
"detail": "<string>"
}Create a board watch
Subscribe to a board. webhookUrl is validated against an SSRF blocklist (loopback/private/link-local/cloud-metadata ranges) before acceptance and again on every dispatch.
Free.
POST
/
api
/
v1
/
watches
Create a board watch
curl --request POST \
--url https://api.vaquill.ai/api/v1/watches \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"corpusType": "<string>"
}
'import requests
url = "https://api.vaquill.ai/api/v1/watches"
payload = { "corpusType": "<string>" }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({corpusType: '<string>'})
};
fetch('https://api.vaquill.ai/api/v1/watches', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.vaquill.ai/api/v1/watches"
payload := strings.NewReader("{\n \"corpusType\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}{
"detail": "<string>"
}Authorizations
API key issued from the Vaquill developer dashboard. Pass as Authorization: Bearer vq_key_...
Body
application/json
Board's corpus_type, from GET /boards.
Board's state (lowercase 2-letter), or omit for a federal board.
Available options:
webhook, email, both Required when channel is webhook or both.
Optional. Used to HMAC-sign the X-Vaquill-Signature header. Stored encrypted, never returned.
Required when channel is email or both.
Response
Successful Response
Last modified on August 6, 2026
Was this page helpful?
⌘I

