Skip to main content

​
Get Configuration

GET /v1/config

Retrieve your current account configuration.

​
Response

​
customerId
string
Your unique customer ID.
​
defaultModels
string[]
Models used when none are specified in requests.
​
defaultThreshold
number
Default classification threshold.
​
webhookUrl
string
URL for webhook notifications (if configured).
​
cacheEnabled
boolean
Whether result caching is enabled.
​
plan
string
Your current plan: free, pro, or enterprise.
​
credits
number
Current credit balance.
curl https://api.tryveri.com/v1/config \
  -H "X-API-Key: your-api-key"

{
  "customerId": "cust_abc123",
  "defaultModels": ["veri_face"],
  "defaultThreshold": 0.5,
  "webhookUrl": null,
  "cacheEnabled": true,
  "plan": "pro",
  "credits": 4850
}

​
Update Configuration

PUT /v1/config

Update your account configuration.

​
Request Body

​
defaultModels
string[]
Set default models for detection requests.
​
defaultThreshold
number
Set default classification threshold (0-1).
​
webhookUrl
string
Set webhook URL for notifications. Set to null to disable.
​
cacheEnabled
boolean
Enable or disable result caching.
curl -X PUT https://api.tryveri.com/v1/config \
  -H "X-API-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "defaultThreshold": 0.7,
    "webhookUrl": "https://your-app.com/webhooks/veri"
  }'

{
  "customerId": "cust_abc123",
  "defaultModels": ["veri_face"],
  "defaultThreshold": 0.7,
  "webhookUrl": "https://your-app.com/webhooks/veri",
  "cacheEnabled": true,
  "plan": "pro",
  "credits": 4850
}

​
Webhooks

When configured, webhooks are sent for:
  • Batch job completion
  • Credit balance alerts

​
Webhook Payload

{
  "event": "batch.completed",
  "timestamp": "2024-01-15T10:32:15Z",
  "data": {
    "jobId": "batch_xyz789abc",
    "status": "completed",
    "totalImages": 10,
    "successCount": 9,
    "failureCount": 1
  }
}

​
Verifying Webhooks

Webhooks include a signature header for verification: 
X-Veri-Signature: sha256=abc123...
Verify by computing HMAC-SHA256 of the request body with your webhook secret.