curl --request GET \
--url https://api.gigstack.io/v2/teams/{id}/email-domain \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.gigstack.io/v2/teams/{id}/email-domain', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.gigstack.io/v2/teams/{id}/email-domain"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"success": true,
"data": {
"team_id": "<string>",
"billing_account_id": "<string>",
"effect_scope": "team_shared",
"provider_environment": "configured_sendgrid_account",
"testmode_isolates_provider": false,
"can_manage": true,
"ownership_status": "verified",
"domain": {
"domain": "<string>",
"subdomain": "<string>",
"full_domain": "<string>",
"valid": true,
"dns_setup": {},
"configured": true
},
"active_operation": {
"id": "<string>",
"action": "set",
"status": "pending",
"created_at": 123,
"started_at": 123,
"completed_at": 123,
"recovery_available_at": 123,
"result": {
"domain": {
"domain": "<string>",
"subdomain": "<string>",
"full_domain": "<string>",
"valid": true,
"dns_setup": {},
"configured": true
},
"previous_provider_domain_retained": true
},
"error_code": "<string>",
"resolution": {
"action": "released_for_new_operation",
"resolved_at": 123
}
}
},
"timestamp": 123
}Read custom email domain and DNS state
Verified personal Firebase/MCP credential required. Team API/OAuth creator identity is not accepted. Scope is shared across live/test; staging may use the same configured SendGrid account. Test mode does not isolate provider effects. Current unblocked members can read domain/DNS state. configured does not mean DNS valid. Missing values are null. full_domain retains the historical subdomain@domain display format. ownership_status is verified or migration_required; unverified legacy records return can_manage false and require operator-verified migration.
curl --request GET \
--url https://api.gigstack.io/v2/teams/{id}/email-domain \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.gigstack.io/v2/teams/{id}/email-domain', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.gigstack.io/v2/teams/{id}/email-domain"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"success": true,
"data": {
"team_id": "<string>",
"billing_account_id": "<string>",
"effect_scope": "team_shared",
"provider_environment": "configured_sendgrid_account",
"testmode_isolates_provider": false,
"can_manage": true,
"ownership_status": "verified",
"domain": {
"domain": "<string>",
"subdomain": "<string>",
"full_domain": "<string>",
"valid": true,
"dns_setup": {},
"configured": true
},
"active_operation": {
"id": "<string>",
"action": "set",
"status": "pending",
"created_at": 123,
"started_at": 123,
"completed_at": 123,
"recovery_available_at": 123,
"result": {
"domain": {
"domain": "<string>",
"subdomain": "<string>",
"full_domain": "<string>",
"valid": true,
"dns_setup": {},
"configured": true
},
"previous_provider_domain_retained": true
},
"error_code": "<string>",
"resolution": {
"action": "released_for_new_operation",
"resolved_at": 123
}
}
},
"timestamp": 123
}Authorizations
Authentication Method: HTTP Bearer token.
The runtime requires the literal Bearer prefix — a bare token in the
Authorization header is rejected with 401 unauthorized.
Header Format: Authorization: Bearer YOUR_API_KEY
Your API key is a JWT. Live keys operate on live data (livemode: true);
test keys operate on isolated test data (livemode: false).
Get your key at: app.gigstack.pro/settings?tab=api
Errors: credential failures are answered by the authentication layer with a raw
{ "message": … } body, not the standardized envelope — 401 for a missing, malformed or
expired token, 403 for a revoked key or a plan without API access. See the Unauthorized
and AuthForbidden responses.