POST /api/v1/domains/:domain_id/records
Create a record inside a domain
Examples
POST /api/v1/domains/1/records/ auth_token=RDzmeQgUG7scYE3BSUuP&record[name]=xxxx.domain36.com&record[type]=A&record[content]=1.2.3.4&record[ttl]=100000 201 { "change_date": null, "content": "1.2.3.4", "created_at": "2013-02-28T17:49:32+01:00", "domain_id": 1, "id": 11, "name": "xxxx.domain36.com", "prio": null, "ttl": 100000, "type": "A", "updated_at": "2013-02-28T17:49:32+01:00" }
POST /api/v1/domains/1/records/ auth_token=yMTwRXm6eYsLHwrrPvdQ&record[name]=xxxxdomain40.com&record[type]=A&record[content]=1.2.3.4&record[ttl]=100000 422 { "errors": { "name": [ "You can't setup record names out of your domain name" ] } }
Supported Formats
jsonErrors
401 Unauthorized422 Bad parameter
404 Not found
500 Server crashed for some reason
Params
Param name | Description |
---|---|
auth_token required |
API authentication key Value: Must be String |
record required |
Value: Must be a Hash |
record[name] required |
record name Value: Must be String |
record[ttl] required |
Time To Live of the record Value: Must be Fixnum |
record[type] required |
record type: A, MX, SOA, NS, PTR, etc… Value: Must be String |
record[content] required |
record content, validation depends on the record type Value: Must be String |