Generate Domain Verification
POST/orgs/me/domains/:domain/validation/_generate
Generate a new file to be able to verify your domain with DNS or HTTP challenge.
Request​
Path Parameters
Header Parameters
The default is always the organization of the requesting user. If you like to get/set a result of another organization include the header. Make sure the user has permission to access the requested data.
- application/json
 - application/grpc
 - application/grpc-web+proto
 
Body
required
Possible values: [DOMAIN_VALIDATION_TYPE_UNSPECIFIED, DOMAIN_VALIDATION_TYPE_HTTP, DOMAIN_VALIDATION_TYPE_DNS]
Default value: DOMAIN_VALIDATION_TYPE_UNSPECIFIED
Body
required
Possible values: [DOMAIN_VALIDATION_TYPE_UNSPECIFIED, DOMAIN_VALIDATION_TYPE_HTTP, DOMAIN_VALIDATION_TYPE_DNS]
Default value: DOMAIN_VALIDATION_TYPE_UNSPECIFIED
Body
required
Possible values: [DOMAIN_VALIDATION_TYPE_UNSPECIFIED, DOMAIN_VALIDATION_TYPE_HTTP, DOMAIN_VALIDATION_TYPE_DNS]
Default value: DOMAIN_VALIDATION_TYPE_UNSPECIFIED
Responses​
- 200
 - default
 
A successful response.
- application/json
 - application/grpc
 - application/grpc-web+proto
 
- Schema
 - Example (from schema)
 
Schema
{
  "token": "ofSBHsSAVHAoTIE4Iv2gwhaYhTjcY5QX",
  "url": "https://testdomain.com/.well-known/zitadel-challenge/ofSBHsSAVHAoTIE4Iv2gwhaYhTjcY5QX"
}
- Schema
 - Example (from schema)
 
Schema
{
  "token": "ofSBHsSAVHAoTIE4Iv2gwhaYhTjcY5QX",
  "url": "https://testdomain.com/.well-known/zitadel-challenge/ofSBHsSAVHAoTIE4Iv2gwhaYhTjcY5QX"
}
- Schema
 - Example (from schema)
 
Schema
{
  "token": "ofSBHsSAVHAoTIE4Iv2gwhaYhTjcY5QX",
  "url": "https://testdomain.com/.well-known/zitadel-challenge/ofSBHsSAVHAoTIE4Iv2gwhaYhTjcY5QX"
}
An unexpected error response.
- application/json
 - application/grpc
 - application/grpc-web+proto
 
- Schema
 - Example (from schema)
 
Schema
Array [
]
details
object[]
{
  "code": 0,
  "message": "string",
  "details": [
    {
      "@type": "string"
    }
  ]
}
- Schema
 - Example (from schema)
 
Schema
Array [
]
details
object[]
{
  "code": 0,
  "message": "string",
  "details": [
    {
      "@type": "string"
    }
  ]
}
- Schema
 - Example (from schema)
 
Schema
Array [
]
details
object[]
{
  "code": 0,
  "message": "string",
  "details": [
    {
      "@type": "string"
    }
  ]
}