The organization's email domains
GET
/api/v1/email-domains
const url = 'http://localhost:3000/api/v1/email-domains';const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url http://localhost:3000/api/v1/email-domains \ --header 'Authorization: Bearer <token>'The domains its people have their email at, proved or not. Organization admin.
Scope: admin.
Authorizations
Section titled “Authorizations”Responses
Section titled “Responses”Email domains
Media typeapplication/json
object
data
required
Array<object>
object
domain
required
string
verified
required
Proved by its TXT record: single sign-on and joining by domain may use it
boolean
join
required
Anyone whose address is at exactly this domain may join the organization, able to read its landing project
boolean
projectId
required
The project whoever joins lands in, able to read; null for the organization’s oldest
string | null
sso
required
The organization’s single sign-on uses it
boolean
record
required
What proves the domain: add this record at your DNS host
object
type
required
string
name
required
string
value
required
string
Example
{ "data": [ { "record": { "type": "TXT" } } ]}default
Section titled “default”An error
Media typeapplication/json
object
error
required
object
code
required
string
message
required
string
detail
Examplegenerated
{ "error": { "code": "example", "message": "example", "detail": "example" }}