Import domains in bulk
POST/api/v1/domains/import
Adds up to 500 domains, with groups, tags and monitoring, exactly as the Import domains page does. existingDomains: skip (default), add (add groups and tags; a name written as -Name removes one) or match (make groups and tags match; send groups and tags on every domain or on none, with an empty list to clear). unknownNames: skip (default) or create (needs GroupsAdd or TagsAdd). Changing existing domains needs DomainsEdit. dryRun=true returns the plan without changing anything.
Needs the DomainsAdd permission.
Request
Responses
- 200
- 400
- 401
- 403
- 429
- 500
OK
The request couldn't be used. errors names each field that's wrong and why.
No API key was sent, or the key is unknown, expired or revoked.
The key's role doesn't have the permission this operation needs, or the key is limited to certain groups and this would reach outside them. detail says which.
This key has made more requests this minute than dotMARC allows (120 by default). Wait for the number of seconds in the Retry-After header, then try again.
Something went wrong in dotMARC that the request didn't cause. It's safe to retry a read; check before retrying a change. If it keeps happening, dotMARC's logs have the details.